web_url
語法:
Int Web_url(constchar *name, const char * url, <Lists of Attributes>,
[EXTRARES,<Listsof Resource Attributes>,LAST)
返回值:成功時返回 LR_PASS (0)邪乍,失敗時返回 LR_FAIL (1)。
參數(shù):
Name:VuGen 中樹形視圖中顯示的名稱,在自動事務(wù)處理中也可以用做事務(wù)的名稱。
url:頁面 url 地址江耀。
List of Attributes
EXTRARES:分隔符遂填,標記下一個參數(shù)是資源屬性的列表了族展。
List of Resource Attributes
LAST:屬性列表結(jié)束的標記符缎脾。
說明
Web_url 根據(jù)函數(shù)中的 URL 屬性加載對應(yīng)的 URL,不需要上下文游昼。
只有 VuGen 處于 URL-based 或者 HTML-based(此時 A scriptcontaining explicit URLs
only 選項被選中時)的錄制模式時甘苍,web_url 才會被錄制到。
可以使用 web_url 模擬從 FTP服務(wù)器上下載文件烘豌。web_url 函數(shù)會使 FTP服務(wù)器執(zhí)行文件
被真實下載時的操作载庭。除非手工指定了"FtpAscii=1",下載會以二進制模式完成廊佩。
在錄制選項中囚聚,Toos—RecordingOption 下,Recording 選項中标锄,有一個 Advanced HTML
選項顽铸,可以設(shè)置是否錄制非 HTML 資源,只有選擇了“Record within the current script step”
時料皇,List of Resource Attributes 才會被錄制到谓松。非 HTML 資源的例子是 gif 和 jpg 圖象文件星压。
通過修改 HTTP頭可以傳遞給服務(wù)器一些附加的請求信息。使用 HTTP頭允許請求中包含
其他的內(nèi)容類型(Content_type)鬼譬,象壓縮文件一樣娜膘。還可以只請求特定狀態(tài)下的 web 頁
面。
所有的 Web Vusers 拧簸,HTTP模式下的 WAP Vusers 或者回放模式下的 Wireless
SessionProtocol(WSP),都支持 web_url 函數(shù)男窟。
web_image
語法:
Int web_image(const char *StepName, <List of Attributes>, [EXTRARES, <List
ofResource Attributes>,] LAST );
返回值
成功時返回 LR_PASS (0)盆赤,失敗時返回 LR_FAIL (1)。
參數(shù):
StepName:VuGen 中樹形視圖中顯示的名稱歉眷,在自動事務(wù)處理中也可以用做事務(wù)的名稱牺六。
List of Attributes(服務(wù)器端和客戶端映射的圖片):SRC 屬性是一定會被錄制到的,其他
的 ALT汗捡、Frame淑际、TargetFrame、Ordinal 則是有的話會被錄制到扇住。
1春缕、ALT:描述圖象的元素。用鼠標指向圖象時艘蹋,所浮出來的文字提示锄贼。
2、SRC:描述圖象的元素女阀,可以是圖象的文件名.如: button.gif宅荤。也可以使用 SRC/SFX
來指定圖象路徑的后綴。所有擁有相同此后綴的字符串都會被匹配到浸策。
3冯键、Frame:錄制操作時所在的 Frame 的名稱。
4庸汗、TargetFrame:見 List of Attributes 的同名參數(shù)惫确。
5、Ordinal:參見 Web_link 的同名參數(shù)蚯舱。
List of Attributes(客戶端映射的圖片):
1雕薪、AreaAlt:鼠標單擊區(qū)域的 ALT 屬性。
2晓淀、AreaOrdinal:鼠標單擊區(qū)域的順序號所袁。
3、MapName:圖象的映射名凶掰。
List of Attributes(服務(wù)器端映射的圖片):盡管點擊坐標不屬于屬性燥爷,但還是以屬性的格
式來使用蜈亩。
1、Xcoord:點擊圖象時的 X坐標前翎。
2稚配、Ycoord:點擊圖象時的 Y坐標。
EXTRARES:分隔符港华,標記下一個參數(shù)是資源屬性的列表了道川。
List of Resource Attributes:參見 List of Resource Attributes 一節(jié)。
LAST:屬性列表結(jié)束的標記符立宜。
說明
web_image 模擬鼠標在指定圖片上的單擊動作冒萄。此函數(shù)必須在有前置操作的上下文中使用。
在 Toos—RecordingOption橙数,如果錄制級別設(shè)為基于 HMTL 的錄制方式時尊流,web_image 才
會被錄制到。
web_image 支持客戶端(client-side)和服務(wù)器端 server-side 的圖片映射灯帮。
在錄制選項中崖技,Toos—RecordingOption 下,Recording 選項中钟哥,有一個 Advanced HTML
選項迎献,可以設(shè)置是否錄制非 HTML 資源,只有選擇了“Record within the current script step”
時腻贰,List of Resource Attributes 才會被錄制到忿晕。非 HTML 資源的例子是 gif 和 jpg 圖象文件。
通過修改 HTTP頭可以傳遞給服務(wù)器一些請求附加信息银受。使用 HTTP頭允許請求中包含內(nèi)
容践盼,如同壓縮文件一樣。還可以只請求特定狀態(tài)的 web 頁面宾巍。
web_image 支持 Web 虛擬用戶咕幻,不支持 WAP虛擬用戶。
例子
下面的例子模擬用戶單擊 Home 圖標以回到主頁(黑體部分):
web_url("my_home", "URL=http://my_home/",LAST)顶霞;
web_link("Employees","Text=Employees", LAST)肄程;
web_image("Home.gif","SRC=../gifs/Buttons/Home.gif", LAST);
web_link("Library", "Text=Library",LAST)选浑;
web_image("Home.gif","SRC=http://www.cnblogs.com/gifs/buttons/Home.gif", LAST)蓝厌;
下面的例子模擬用戶在客戶端映射的圖片上單擊:
web_image("dpt_house.gif",
"Src=../gifs/dpt_house.gif",
"MapName=dpt_house",
"AreaOrdinal=4",
LAST);
下面的例子模擬用戶在服務(wù)端映射的圖片上單擊:
web_image("The Web Developer's VirtualLibrary",
"Alt=The Web Developer's Virtual Library",
"Ordinal=1",
"XCoord=91",
"YCoord=17",
LAST)古徒;
下面是一個使用文件名后綴的例子:它指定了 dpt_house.gif 作為后綴拓提,所以
象../gifs/dpt_house.gif、/gifs/dpt_house.gif隧膘、gifs/dpt_house.gif代态、/dpt_house.gif 等都會匹
配到寺惫。
web_image("dpt_house.gif","Src/sfx=dpt_house.gif",LAST);
web_link
語法:
Int web_link(const char *StepName, <List of Attributes>, [EXTRARES, <List
ofResource Attributes>,] LAST ) 蹦疑;
返回值
成功時返回 LR_PASS (0)西雀,失敗時返回 LR_FAIL (1)。
參數(shù):
StepName:VuGen 中樹形視圖中顯示的名稱歉摧,在自動事務(wù)設(shè)置中也被用做事務(wù)名稱艇肴。
List of Attributes:支持下列的屬性:
1. Text:超鏈接中的文字,必須精確匹配叁温。
2. Frame:錄制操作時所在的 Frame 的名稱再悼。
3. TargetFrame、ResourceByteLimit:見 List of Attributes 一節(jié)券盅。
4. Ordinal:如果用給出的屬性(Attributes)篩選出的元素不唯一帮哈,那么 VuGen 使用此屬
性來指定其中的一個膛檀。例如:“SRC=abc.gif”锰镀,“Ordinal=3”標記的是 SRC 的值是“abc.gif”的
第 3 張圖片。
EXTRARES:表明下面的參數(shù)將會是 list of resourceattributes 了咖刃。
LAST:結(jié)尾標示符泳炉。
說明
模擬鼠標在由若干個屬性集合描述的鏈接上進行單擊。此函數(shù)必須在前置動作的上下文
中才可以執(zhí)行嚎杨。
web_link 僅僅在基于 HTML 的錄制方式中才會被 VuGen 捕捉到花鹅。
非 HTML 生成的資源的例子有.gif 和.jpg 圖像。對于 List of ResourceAttributes 參數(shù)來說枫浙,
僅僅當 RecordingOptions--Recording --HTML-based script-- Record within the current
script step 選項被選中時刨肃,它們才會被插入到代碼中。
可以通過改變 HTTP頭信息給服務(wù)器傳遞一些附加信息箩帚。使用 HTTP頭信息可以真友,允許響
應(yīng)體中包含其他的內(nèi)容類型(Content-Type),例如壓縮文件紧帕,或者只有滿足了特定的狀
態(tài)才去請求 web 頁盔然。
此函數(shù)值支持 Web 虛擬用戶,不支持 WAP虛擬用戶是嗜。
web_submmit_form
語法:
Intweb_submit_form (const char *StepName, <List of Attributes>, <List ofHidden
Fields>, ITEMDATA, <List of Data Fields>, [ EXTRARES, <Listof Resource
Attributes>,] LAST );
返回值
成功時返回 LR_PASS (0)愈案,失敗時返回 LR_FAIL (1)。
參數(shù):
StepName:Form的名字鹅搪。VuGen 中樹形視圖中顯示的名稱站绪,在自動事務(wù)處理中也可以
用做事務(wù)的名稱。
List of Attributes:支持以下屬性:
1. Action:Form中的 ACTION屬性丽柿,指定了完成 Form中的操作用到的 URL崇众。也可以使
用“Action/sfx”表示使用此后綴的所有 Action掂僵。
2. Frame:錄制操作時所在的 Frame 的名稱。
3. TargetFrame顷歌、ResourceByteLimit:見 List of Attributes 的同名參數(shù)锰蓬。
4. Ordinal:參見 Web_link 的同名參數(shù)。
VuGen 通過記錄數(shù)據(jù)域唯一的標識每個 Form眯漩。如果這樣不足以識別 Form芹扭,VuGen 會記
錄 Action 屬性。如果還不足以識別赦抖,則會記錄 Ordinal 屬性舱卡,這種情況下不會記錄 Action
屬性。
List of Hidden Fields:補充屬性(Serves)队萤。通過此屬性可以使用一串隱含域來標識
Form轮锥。使用下面的格式:
STARTHIDDENS,
"name=n1", "value=v1", ENDITEM,
"name=n2", "value=v2", ENDITEM,
ENDHIDDENS,
List of Data Fields
Data 項用來標識 form。Form是通過屬性和數(shù)據(jù)來共同識別的要尔。
使用下面的格式來表示數(shù)據(jù)域列表
"name=n1", "value=v1", ENDITEM,
"name=n2", "value=v2", ENDITEM,
ITEMDATA:Form中數(shù)據(jù)和屬性的分隔符舍杜。
EXTRARES:一個分隔符,標記下一個參數(shù)是資源屬性的列表了赵辕。
List of Resource Attributes:參見 List of Resource Attributes 一節(jié)驮吱。
LAST:屬性列表結(jié)束的標記符盔粹。
說明
web_submit_form 函數(shù)用來提交表單。此函數(shù)可能必須在前一個操作的上下文中執(zhí)行。在
Toos—Recording Option牧氮,只有錄制級別設(shè)為基于 HMTL 的錄制方式奠涌,web_image 才會被
錄制到娃殖。
在錄制選項中定庵,Toos—RecordingOption 下,Recording 選項中锣光,有一個 Advanced HTML
選項笆怠,可以設(shè)置是否錄制非 HTML 資源,只有選擇了“Record within the current script step”
時嫉晶,List of Resource Attributes 才會被錄制到骑疆。非 HTML 資源的例子是 gif 和 jpg 圖象文件。
通常情況下替废,如果錄制了 web_submit_form函數(shù)箍铭,VuGen 會把“name”和“value”一起錄制
到 ITEMDATA屬性中。如果不想在腳本中以明文顯示“value”椎镣,可以對它進行加密诈火。把
“Value”改為“EncryptedValue”,然后把錄制到的值改為加密后的值。
例如:可以把"Name=grpType", "Value=radRoundtrip", ENDITEM
改為:"Name=grpType",EncryptedValue=409e41ebf102f3036b0549c799be3609",
ENDITEM
如果你完整的安裝了 LoadRunner状答,那么打開開始菜單--Mercury LoadRunner—Tools--
PasswordEncoder冷守,這個小工具是用來加密字符串的刀崖。把需要加密的值粘貼到 Password
一欄,再點 Generate 按鈕拍摇。加密后的字符串會出現(xiàn)在 Encoded string 框中亮钦。接著點 Copy
按鈕,然后把它粘貼到腳本中充活,覆蓋原來顯示的“Value”蜂莉。
加密的另一種方法時使用 lr_decrypt 函數(shù)。方法:選擇整個字符串混卵,例如
“Value=radRoundtrip”(注意不要選擇引號)映穗,右擊鼠標,選擇 Encrypt string 選現(xiàn)幕随,腳本
會變?yōu)椋?/p>
"Name=grpType",
lr_decrypt("40d176c46f3cf2f5fbfaa806bd1bcee65f0371858163"),ENDITEM,
web_submit_form支持 Web 虛擬用戶蚁滋,不支持 WAP虛擬用戶。
例子:
下面的例子中赘淮,web_submit_form函數(shù)的名字是“employee.exe”辕录。此函數(shù)提交了一個請
求,此請求包含雇員信息 John Green。此函數(shù)沒有使用屬性(Attributes)是因為通過數(shù)據(jù)
項已經(jīng)能唯一的標識這個 Form了拥知。
web_submit_form("employee.exe",
ITEMDATA,
"name=persons", "value=John Green -John", ENDITEM,
"name=go_page", "value=Go to Page",ENDITEM,
LAST);
web_submmit_data
語法:
Intweb_submit_data ( const char *StepName, <List of Attributes>, ITEMDATA,<List
of data>, [ EXTRARES, <List of Resource Attributes>,] LAST );
返回值
返回 LR_PASS(0)代表成功踏拜,LR_FAIL(1)代表失敗碎赢。
參數(shù):
StepName:步驟名稱低剔,VuGen 中樹形視圖顯示的名稱。
List of Attributes:支持以下屬性:
1. Action:Form中的 ACTION屬性肮塞,指定了完成 Form中的操作用到的 URL襟齿。
2. Method:表單提交方法:POST 或 GET(默認是 POST)。
3. EncType:編碼方式枕赵。
4. EncodeAtSign:是否使用 ASCII值對符號“@”編碼猜欺。Yes 或者 No。
5. TargetFrame:包含當前鏈接或資源的 Frame拷窜。參見 List of Attributes 的同名參數(shù)开皿。
6. Referer、Mode:參見 List of Attributes 的同名參數(shù)篮昧。
ITEMDATA:數(shù)據(jù)域和屬性的分隔符赋荆。
List of Data:
數(shù)據(jù)域列表定義了表單提交的內(nèi)容。由于此請求是上下文無關(guān)的懊昨,因此數(shù)據(jù)域包含了所有
的隱含域窄潭。使用 Form的編碼規(guī)則組織數(shù)據(jù)域。
數(shù)據(jù)域列表可以使用下面任意一種格式:
"name=n1", "value=v1", ENDITEM,
"name=n2", "EncryptedValue=qwerty",ENDITEM,
EXTRARES:分隔符酵颁,標記下一個參數(shù)將是資源屬性的列表嫉你。
List of Resource Attributes:參見 List of Resource Attributes月帝。
LAST:結(jié)束標記符。
說明
web_submit_data 函數(shù)處理無狀態(tài)或者上下文無關(guān)的表單提交幽污。它用來生成表單的 GET
或 POST 請求嚷辅,這些請求與 Form自動生成的請求是一樣的。發(fā)送這些請求時不需要表單
上下文距误。
當 VuGen 設(shè)為基于 URL 的錄制模式潦蝇,或者基于 HTML 的錄制方式但是
RecordingOptions—HTML Advanced 下的 A scriptcontaining explicit URLs only 選項被選
中時,web_submmit_data 函數(shù)才會錄制到深寥。
不論你采用 URL 查詢的方式(GET)攘乒,還是采用請求體發(fā)送(POST)的方式,此函數(shù)都
指示出 Form中的數(shù)據(jù)是如何發(fā)送到服務(wù)器的惋鹅。
如果 VuGen 處于 HTTP錄制模式下则酝,此時記錄 Web 進程時,會產(chǎn)生此函數(shù)闰集。在提交
Form時沽讹,如果無法生成 web_submit_form函數(shù),VuGen 也會生成 web_submit_data 函
數(shù)武鲁。
在錄制選項中爽雄,Toos—RecordingOption 下—Recording 選項中,有一個 Advanced HTML
選項沐鼠,可以設(shè)置是否錄制非 HTML 資源挚瘟。只有選擇了“Record within the current script step”
時,List of Resource Attributes 才會被錄制到饲梭。非 HTML 資源的例子是 gif 和 jpg 圖象文件乘盖。
EncType 屬性給出一個內(nèi)容類型,指定其做為“Content-Type”請求頭的值憔涉。它指示了根據(jù)
參數(shù)生成 HTTP請求時使用的編碼類型(不是 URL-encoding 就是 multi-part)可以是下面
的格式:
1. “EncType=application/x-www-form-urlencoded”
2. “EncType=multipart/form-data” (任何的“; boundary=”都會被默認忽略掉)
3. “EncType=” (空串订框,表明沒有產(chǎn)生內(nèi)容類型(“Content-Type”)請求頭)
任何對于“EncType”的指定都會覆蓋 web_add_[auto_]header 函數(shù)指定的 Content-Type。
當省略了“EncType”時兜叨,任何一個 web_add_[auto_]header 函數(shù)都會起作用穿扳。如果既沒有
指定 EncType 也沒有 web_add_[auto_]header 函數(shù),且“Method=POST”国旷,“application/x-
www-form-urlencoded”會做為默認值來使用矛物。其他情況下,不會產(chǎn)生 Content-Type 請求
頭议街。
ContentType:文件類型標識符泽谨,如果“EncType”是“multipart/form-data”用來上傳文件時,
需要用到“ContentType”。當在 ITEMDATA中的 Data 子句中指定了“File=Yes”吧雹,且文件也
在此子句中骨杂,ContentType 才適用,此時它會作為同一個子句的值來傳遞雄卷。
正常情況下搓蚪,“Content-Type”根據(jù)所上傳文件的擴展名自動生成。例如:
7d025e2b16b064e\r\n Content-Disposition: form-data;name="uploaded_file";
filename="D:\\temp\\a.txt"\r\n Content-Type:text/plain\r\n \r\n
無論如何丁鹉,對于非瀏覽器的程序來說是特殊的妒潭,根據(jù)文件類型生成的“ContentType”不一定
是正確的。這時揣钦,通過手工指定來覆蓋默認的“ContentType”雳灾。如果指定了空值,那么
“Content-Type”頭將不包含在文件中冯凹。
如果沒有顯示的指定“ContentType”的值谎亩,當上傳的文件為空時,不管文件擴展名是什么宇姚,
都默認使用“application/x-unknown-content-type”做為”ContentType”的值匈庭。
VuGen 不會檢查指定的 ContentType 是否有效。
通常情況下浑劳,如果錄制了 web_submit_data 函數(shù)阱持,VuGen 會把“name”和“value”一起錄制
到 ITEMDATA一節(jié)中。如果不想在腳本中以明文顯示“value”魔熏,可以對它進行加密衷咽。把
“Value”改為“EncryptedValue”,然后把錄制到的值改為加密后的值。請參考
web_submit_form中相關(guān)的內(nèi)容道逗。
所有的 Web 虛擬用戶兵罢,運行在 HTTP模式下的 WAP用戶献烦,運行在 WSP回放模式下的
WAP用戶都可以使用本函數(shù)滓窍。
例子
下面的例子中,web_submit_data 函數(shù)使用 POST 方法提交了一個表單巩那。
web_submit_data("default.aspx",
"Action=http://lazarus/flightnet/default.aspx",
"Method=POST",
"TargetFrame=",
"RecContentType=text/html",
"Referer=http://lazarus/flightnet/",
"Snapshot=t7.inf",
"Mode=HTML",
ITEMDATA,
"Name=grpType", "Value=radRoundtrip",ENDITEM,
"Name=lstDepartingCity", "Value=DEN",ENDITEM,
"Name=lstDestinationCity","Value=LAX", ENDITEM,
"Name=txtDepartureDate","Value=8/19/2003", ENDITEM,
"Name=txtReturnDate","Value=8/19/2003", ENDITEM,
"Name=txtQuantity", "Value=1",ENDITEM,
"Name=radClass", "Value=1", ENDITEM,
"Name=radSeat", "Value=1", ENDITEM,
"Name=btnAvailableFlights", "Value=Next>", ENDITEM,
LAST)吏夯;
下面的例子, web_submit_data 函數(shù)使用 POST 方法提交了 2 個文件即横。
web_submit_data("Attachments",
"Action=http://barton.cottage@.Devonshire.uk/Attachments?YY=45434",
"Method=POST",
"EncType=multipart/form-data",
"TargetFrame=",
"RecContentType=text/html",
"Referer=http:///barton.cottage@.Devonshire.uk/Compose?YY=20435",
"Snapshot=t5.inf",
"Mode=HTML",
ITEMDATA, "Name=userFile0",
"Value=E:\\sense_sensibility\\Elinor.txt",
"File=yes",
"ContentType=text/html", // 覆蓋了文本文件默認的“text/plain”值噪生。
ENDITEM,
"Name=userFile1",
"Value=E:\\sense_sensibility\\Marianne.jpg",
"File=yes",
ENDITEM,
LAST);
web_custom_request
語法:
Intweb_custom_request (const char *RequestName, <List of Attributes>,
[EXTRARES,<List of Resource Attributes>,] LAST );
返回值
返回 LR_PASS(0)代表成功东囚,LR_FAIL(1)代表失敗跺嗽。
參數(shù):
RequestName:步驟的名稱,VuGen 中樹形視圖中顯示的名稱。
List of Attribute:支持的屬性有以下幾種:
1. URL:頁面地址桨嫁。
2. Method :頁面的提交方式植兰,POST 或 GET。
3. TargetFrame:包含當前鏈接或資源的 frame 的名稱璃吧。參見 List of Attributes 的同名參
數(shù)楣导。
4. EncType:編碼類型。
5. RecContentType:響應(yīng)頭的內(nèi)容類型畜挨。參見 List of Attributes 的同名參數(shù)筒繁。
6. Referer:參見 List of Attributes 的同名參數(shù)。
7. Body:請求體巴元。參見 List of Attributes 的同名參數(shù)毡咏。
8. RAW BODY:參見 List of Attributes 的同名參數(shù)。
9. BodyFilePath:作為請求體傳送的文件的路徑逮刨。它不能與下面的屬性一起使用:Body血当,
或者其他 Body 屬性或 Raw Body 屬性包括 BodyBinary,BodyUnicode禀忆,
RAW_BODY_START 或 Binary=1臊旭。
10. Resource、ResourceByteLimit箩退、Snapshot离熏、Mode:參見 List of Attributes 的同名參
數(shù)。
11. ExtraResBaseDir:參見 List of Attributes 的同名參數(shù)戴涝。
12. UserAgent:用戶代理滋戳,它是一個 HTTP頭的名字,用來標識應(yīng)用程序啥刻,通常是瀏覽器奸鸯,
它呈現(xiàn)的是用戶和服務(wù)器的交互。
例如:頭信息“User-Agent:Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.0)”識別的是
Window NT 下的 IE瀏覽器 6.0可帽。其他的 User-Agent 的值用來描述其他的瀏覽器娄涩,或者非
瀏覽器程序。通常映跟,一個應(yīng)用程序中所有的請求都使用相同的用戶代理蓄拣,錄制者作為一個
運行時參數(shù)來指定(Run-TimeSetting—Browser Emulation—User Agent)。不管怎么說努隙,
即使是在一個簡單的瀏覽器進程中球恤,仍有可能會用到直接與服務(wù)器交互的非瀏覽器組件
(例如 ActiveX控件),通常他們有著不同于瀏覽器的用戶代理屬性荸镊。指定“UserAgent”表
示這是一個非瀏覽器的請求咽斧。指定的字符串被 HTTP 頭“User-Agent:”使用堪置,在某些情況下,
它同時會影響回放腳本時的行為张惹。例如晋柱,不使用瀏覽器緩存,假設(shè)指定的 URL 屬于資源等
等诵叁。
LoadRunner 本身不檢查指定的字符串與瀏覽器本身的值是否相同雁竞。
13. Binary:“Binary=1”表示頁面請求體中的每一個以\\x##形式出現(xiàn)的值(在這里“##”代表
2 個十六進制數(shù)字),都會被替換為單字節(jié)的十六進制的值拧额。
如果“Binary=0”(默認值)碑诉,所有的字符序列只是按照字面的值傳遞。
需要注意雙斜杠的用法侥锦。在 C 編譯器中雙斜杠被解釋為單斜杠进栽。如果不需要零字節(jié),單斜
杠可以在 Binary 不等于 1 的情況下使用(例如恭垦,使用\x20 代替\\x20)快毛。如果需要零字節(jié),
那么只能使用\\x00 且設(shè)置 “Binary=1”番挺,\x00 在邏輯上會被截斷唠帝。
14. ContentEncoding
指定請求體的使用指定的方式(gzip 或者 deflate)進行編碼(例如,壓縮)玄柏,相應(yīng)的
“Content-Encoding:” HTTP 頭會和此請求一起發(fā)送襟衰。這個參數(shù)適用于
web_custom_request 和 web_submit_data。
EXTRARES:表明下面的參數(shù)將會是 List Of ResourceAttributes 了粪摘。
LAST :結(jié)尾的標示符瀑晒。
List of Attributes
FtpAscii:“1”使用 ASCII模式處理 FTP操作;"0"使用二進制模式徘意。
TargetFrame:當前鏈接或資源所在 Frame 的名稱苔悦。除了 Frame 的名字,還可以指定下面
的參數(shù):
_BLANK:打開一個空窗口椎咧。
_PARENT:把最新更改過的的 Frame 替換為它的上級玖详。
_SELF:替換最新更改過的的 Frame。
_TOP:替換整個頁面邑退。
RecContentType:錄制腳本時響應(yīng)頭的內(nèi)容類型竹宋。例如 text/html、 application/x-
javascript 等地技。當沒有設(shè)置 Resource 屬性時,用它來確定目標 URL 是否是可記錄的資源秒拔。
此屬性包含主要的和次要的資源莫矗。最頻繁使用的類型是 text、application、image作谚。次要的
類型根據(jù)資源不同變化很多三娩。例如:"RecContentType=text/html":表示 html 文本。
"RecContentType=application/msword":表示當前使用的是 Msword妹懒。
Referer: 當前頁面關(guān)聯(lián)的頁面雀监。如果已經(jīng)顯式指定了 url 的地址,此項可以省略眨唬。
Resource:指示 URL 是否屬于資源会前。1 是;0 不是匾竿。設(shè)置了這個參數(shù)后瓦宜,
RecContentType 參數(shù)被忽略×胙“Resource=1”临庇,意味著當前操作與所在腳本的成功與否關(guān)
系不大。在下載資源時如果發(fā)生錯誤昵慌,是當作警告而不是錯誤來處理的假夺;URL 是否被下載
受“Run-Time Setting—BrowserEmulation--Download non-HTML resources” 這個選項的
影響。此操作的響應(yīng)信息是不做為 HTML 來解析的斋攀≈对螅“Resource=0”,表明此 URL 是重要
的蜻韭,不受發(fā)送請求(RTS)的影響悼尾,在需要時也會解析它。
ResourceByteLimit:web 頁面下載資源的極限大小肖方。當達到設(shè)置的極限后闺魏,無法下載其他
資源。僅僅對需要下載的資源有效俯画。
下載過程:如果總計下載大小小于極限值析桥,則正常開始下載。如果當下載時達到了設(shè)置的
極限值艰垂,資源大小可知(在 HTTP響應(yīng)頭中指定了 Content-Length)泡仗,這中情況下,如果
只需要一個緩沖區(qū)猜憎,那么下載可以正常完成娩怎。如果需要的不止一個緩沖區(qū),或者資源大小
不可知胰柑,下載就會中斷同時關(guān)閉當前連接截亦。
這個特性可以用來模擬用戶不等待一個頁面下載完成時導航到另一個頁面的情況爬泥。
ResourceByteLimit 在 HTTP模式中無法使用,在 Concurrent Groups(Vuser 腳本中的一
個區(qū)崩瓤,此區(qū)中的所有函數(shù)并發(fā)執(zhí)行)區(qū)中也無法使用袍啡。僅僅適用于 Sockets 的回放,
WinInet 也是不適用的却桶。
Snapshot:快照的文件名境输,關(guān)聯(lián)時使用。
Mode:兩種錄制級別 HTML颖系、HTTP嗅剖。
HTML 級別:在當前 Web 界面上錄制直觀的 HTML 動作。以一步步的 web_url集晚、web_link窗悯、
web_image、web_submit_form來錄制這些動作偷拔。VuGen 僅僅錄制返回 HTML 頁面的請
求蒋院,不處理腳本和應(yīng)用程序。
HTTP級別:VuGen 把所有的請求錄制為 web_url 指令莲绰,不生成 web_link欺旧、web_image、
web_submit_form這些函數(shù)蛤签。這種方法更為靈活辞友,但是生成的腳本不夠直觀。
ExtraResBaseDir(目前僅適用與 web_custom_request 函數(shù)):根 URL震肮,放在
EXTRARES 組里称龙。它是用來解析相對 URL 的(譯者加:類似于 Windows 的相對路徑和
絕對路徑)。
URL 可以是絕對路徑(例如
http://weather.abc.com/weather/forecast.jsp?locCode=LFPO)戳晌,也可以是相對路徑(例
如“forecast.jsp?locCode=LFPO”)鲫尊。
真正的 URL 的下載是通過絕對路徑進行的,所以相對 URL 路徑必須使用根路徑 URL 去解
析沦偎。例如疫向,使用 http://weather.abc.com/weather/做為根路徑來解析
“forecast.jsp?locCode=LFPO”,最后的 URL 是:
http://weather.abc.com/weather/forecast.jsp?locCode=LFPO豪嚎。如果沒有指定
“ExtraResBaseDir”搔驼,默認的根 URL 是主頁面的 URL。
Body(目前僅適用與 web_custom_request 函數(shù)):請求體侈询。不同的應(yīng)用中舌涨,請求體分別
通過 Body、BodyBinary 或者 BodyUnicode 參數(shù)來傳遞妄荔。請求體可以只使用其中一個參數(shù)泼菌,
也可以使用一連串的分開的參數(shù)組成多請求體谍肤。例如:
web_custom_request(
……
"BodyUnicode=REPRICE"
"BodyBinary=\\x08\\x00\\xCC\\x02\\x00\\x00"
"Body=.\r\n"
"-dxjjtbw/(.tp?eg:ch/6--\r\n",
LAST)啦租;
在上面的代碼中哗伯,使用了 3 個參數(shù)來劃分請求體,一個是 Unicode 段篷角,一個是二進制段焊刹,
最后一個是常規(guī)的字符串。最終的請求體是這 3 個參數(shù)按照在函數(shù)中的順序連接起來的值恳蹲。
還有一個很少用到的參數(shù)虐块,Binary。它也能描述二進制請求體嘉蕾,但只允許函數(shù)中只有一個
請求體參數(shù)贺奠。
所有的請求體都是 ASCII字符,以 null 結(jié)束错忱。
Body:表示規(guī)則的儡率,可打印的字符串。無法表示空字節(jié)以清。所有的字符都以一個反斜杠表示儿普。
注意:在舊的腳本中,可以看見不可打印的字符在請求體中以 16 進制方式進行編碼。(例
如 “\\x5c”)掷倔,在這種情況下眉孩,必須使用“Binary=1”來標識±沾校空字節(jié)使用"\\00"來表示浪汪。相反,
新腳本則會把把請求體分開放在不同的參數(shù)中("Body=...","BodyBinary=...", Body=...")凛虽。
BodyBinary :表示二進制代碼死遭。不可打印的字符在請求體中以 16 進制方式\\xHH進行編
碼。在這里 HH表示十六進制值涩维⊙晷眨空字節(jié)使用"\\00"來表示。
BodyUnicode:美國英語瓦阐,特指拉丁 UTF-16LE(little-endian)編碼蜗侈。這種編碼方式會在
在每個字符末尾附加一個 0 字節(jié),以便使字符更可讀睡蟋。但是在 VuGen 中實際的參數(shù)把所
有的 0 字節(jié)都去掉的踏幻。但是在發(fā)送給 Web 服務(wù)器之前, web_custom_request 函數(shù)會重新
添加 0 字節(jié)的。對于不可打印的字符,使用單反斜杠表示戳杀,無法表示空字節(jié)该面。
注意:如果請求體大于 100K,會使用一個變量來代替 Body 參數(shù)夭苗。變量是在
lrw_custom_body.h 中定義的。
Raw Body(目前僅適用與 web_custom_request 函數(shù)):請求體是作為指針傳遞的隔缀,此指
針指向一串數(shù)據(jù)题造。二進制的請求體可以使用 BodyBinary 屬性來發(fā)送(或者使用 Body 屬性
來傳遞,前提是必須設(shè)置"Binary=1" )。無論如何,這種方法需要使用轉(zhuǎn)義字符反斜杠把不可
打印的字符轉(zhuǎn)換為 ASCII字符猾瘸。為了能有一種更簡便的表現(xiàn)原始數(shù)據(jù)的方式界赔,Raw Body
屬性應(yīng)運而生,可以傳遞指向二進制數(shù)據(jù)的指針牵触。
使用 4 個連續(xù)的參數(shù)集來表示指針淮悼,而且必須按照順序排列:
RAW_BODY_START
指向數(shù)據(jù)緩沖區(qū)的指針
(int)長度
RAW_BODY_END
例子:
char *abc= .../* a pointer to the raw data */
web_custom_request("StepName",
"URL=http://some.url ",
"Method=POST",
RAW_BODY_START,
"abc",
3,
RAW_BODY_END,
LAST);
在應(yīng)用中,即使設(shè)置了數(shù)據(jù)的長度為 0揽思,指針也必須有值袜腥,不能為空。
在“Binary=1”時钉汗,不能使用上面的語法傳遞原始數(shù)據(jù)羹令。
數(shù)據(jù)緩沖區(qū)中的數(shù)據(jù)不能使用參數(shù)化。也就時說儡湾,緩沖區(qū)中的任何參數(shù)(例如 "{MyParam}")
不能被正確的替代為相應(yīng)的值特恬,只會以字面值發(fā)送。
List of Resource Attributes
Web 頁面中的非 HTML 機制產(chǎn)生了資源列表徐钠,包含了 Javascript, ActiveX, Java applets
andFlash 所請求的資源癌刽。VuGen's 的 Recording 選項中,可以設(shè)置把這些資源錄制在當前
的操作中(默認是此設(shè)置)還是作為單獨的步驟來錄制尝丐。
支持以下資源:
URL
要加載的 web 資源的 url显拜。
Referer
關(guān)聯(lián)的 url。
ENDITEM
每個資源的結(jié)束標記
相對于把每個資源都錄制為單獨的步驟來說爹袁,不錄制非 HTML 元素使腳本更加簡短和可讀远荠,
特別是在 VuGen 的 Tree 視圖下更為突出。
當 VuGen 錄制過程中發(fā)現(xiàn)附加的資源(比如 JS)時失息,會以列表的形式加到附加資源項中譬淳。
回放腳本時,這些資源文件也是請求的一部分盹兢×诎穑可以對一些按規(guī)則變化的資源使用關(guān)聯(lián)。
LoadRunner 函數(shù)中文翻譯系列之二—Check
web_find
語法:
int web_find(const char *StepName, <Attributes and Specifications list>,
char*searchstring, LAST );
參數(shù):
1绎秒、StepName:步驟名稱浦妄,在 Tree 視圖中出現(xiàn)。
2、Attributes andSpecifications list:
支持的屬性有:
Frame:在多 Frame 的情況下剂娄,定義要查找 Frame 的范圍蠢涝。
Expect:定義在什么情況下函數(shù)檢查成功:找到了指定的搜索標準或者沒有找到。例如說阅懦,
可以檢查指定的錯誤信息是否出現(xiàn)在 web 頁面中和二。合法的值有 2 個:found 和 notfound。
默認值是“found”故黑。
Matchcase:指定搜索是否區(qū)分大小寫儿咱。
Repeat:指定當?shù)谝淮伟l(fā)現(xiàn)要查找的字符串時庭砍,搜索是否繼續(xù)场晶。當一個 web 頁面中包含多
個被查找的字符串時,此參數(shù)是非常有用的怠缸。合法的值有 2 個:yes诗轻,no。默認值是“yes”揭北。
Report:指定在什么情況下扳炬,VuGen 在執(zhí)行日志中顯示此函數(shù)的檢查結(jié)果。合法的值有:
success搔体,failure恨樟,always。默認值是“always”疚俱。
Onfailure:此參數(shù)決定在函數(shù)檢查失敗后劝术,Vuser 是否中斷。參數(shù)值是 abort呆奕。如果指定了
Onfailure=abort,當函數(shù)檢查失敗時,不論在運行時設(shè)置中的 error-handling 是什么,腳本
都會中斷帖族。
如果沒有指定 Onfailure=abort,那么運行時設(shè)置中 error-handling 將會起作用祭往。
支持的特性有:RightOf, LeftOf(不支持 7.x及更高版本)。
RightOf:要查找的字符串右邊的內(nèi)容姆泻。
LeftOf:要查找的字符串左邊的內(nèi)容零酪。
3、Searchstring:需要查找的字符串拇勃,格式為“What=stringxyz”四苇。此搜索不區(qū)分大小寫。
4潜秋、LAST:屬性列表結(jié)束符蛔琅。
返回值
整型。成功時返回 LR_PASS(0)峻呛,失敗時返回 LR_FAIL (1)罗售。
說明
此函數(shù)的作用是在 HTML 頁面中查找指定的字符串辜窑。
此函數(shù)只能在基于 HTML 錄制的腳本中使用。當指定的 HTML 請求全部完成以后寨躁,開始執(zhí)
行搜索過程穆碎,比 web_reg_find 要慢。
web_find 函數(shù)在 C 語言的腳本中已經(jīng)被 web_reg_find 所替代职恳,web_reg_find 運行速度比
較快所禀,而且在 HTML-based 和 URL-based 的錄制方式中都可以使用。在 C 語言腳本中放钦,
web_find 是向后兼容的色徘。Java 和 Visual Basic 腳本中不再支持它。
運行在 HTTP模式下的 WAP用戶都和運行在 WSP回放模式下的 WAP用戶都不支持此函
數(shù)操禀。
web_global_verification
語法:
intweb_global_verification (<List of Attributes>, LAST ) 褂策;
參數(shù):
List of Attributes:
1、Text:此屬性是一個非空的颓屑,以 NULL 結(jié)尾的字符串斤寂,表示要查找的內(nèi)容。語法
是”Text=string”揪惦。還可以使用 text flags 自定義字符串遍搞。
2、TextPfx:沒有指定 Text 的情況下使用此屬性器腋。要查找的字符串的前綴溪猿。語法是”
TextPfx =string”。還可以使用 text flags 自定義字符串蒂培。
3再愈、TextSfx:沒有指定 Text 的情況下使用此屬性。要查找的字符串的后綴护戳。語法是”
TextSfx =string”翎冲。還可以使用 text flags 自定義字符串。
4媳荒、Search:可選項抗悍,在哪里查找字符串∏恚可選的值是:Headers缴渊,Body,
NORESOURCE 或 All鱼炒。默認值是 NORESOURCE衔沼。語法是“Search=value”。
5、Fail:當字符串找不到時的處理選項:Found(默認值)或 NotFound指蚁。Found 表示當
找到對應(yīng)的字符串時發(fā)生了錯誤(例如“Error”)菩佑。NotFound 表示當找不到字符串時發(fā)生了
錯誤。語法是“Fail=value“凝化。
6稍坯、ID:在日志文件中標識當前函數(shù)。
LAST:屬性列表結(jié)束符搓劫。
注:text flags:/IC 表示忽略大小寫瞧哟;/BIN表示指定的是二進制數(shù)據(jù)。
返回值
整型枪向。成功時返回 LR_PASS(0)勤揩,失敗時返回 LR_FAIL (1)。
說明
web_global_verification 屬于注冊函數(shù)遣疯,注冊一個在 web 頁面中搜索文本字符串的請求雄可,
與 web_reg_find 只在下一個 Action 函數(shù)中執(zhí)行搜索不同的是,它是在之后所有的 Action
類函數(shù)中執(zhí)行搜索的缠犀。可以搜索頁面的 body聪舒,headers辨液,html 代碼或者是整個頁面。
在檢測一些應(yīng)用程序級別(不通過 http 狀態(tài)碼來表現(xiàn))的錯誤時箱残,web_global_verification
是非常有用的滔迈。如果要定位通過 HTTP 狀態(tài)碼表現(xiàn)的錯誤時,使用 web_get_int_property被辑。
查找范圍:all:這個 HTML 頁面燎悍;Headers:頁面的頭;body:頁面的體盼理,包含所有的資
源但不包含頭谈山;NORESOURCE(默認選項):僅僅包含頁面的體,把包括頭和資源宏怔。
如果不知道要查找的精確的文本奏路,或者要查找的多個文本不是完全相同的,可以使用前綴和
后綴來表示。這時需要用到 TextPfx和 TextSfx屬性臊诊。這 2 個屬性必須同時指定鸽粉,一旦指
定了其中一個,就不能指定 Text 屬性了抓艳。
注意:web_global_verification在 WAP協(xié)議下不能運行触机。
web_image_check
語法:
intweb_image_check(const char *CheckName, <List of Attributes>,<"Alt=alt"||
"Src=src">, LAST );
參數(shù):
1、CheckName:名稱,在 Tree 視圖中出現(xiàn)儡首。
2销斟、List of Attributes:
支持的屬性有:Frame(在多 Frame 的情況下,定義要查找 Frame 的范圍)椒舵。
支持的選項有:expect, matchcase,repeat, report, onfailure蚂踊。
Tip:選項跟屬性的區(qū)別,大部分選項都只允許設(shè)置預定義的值笔宿,其他的值都是無效的犁钟。
3、Alt:檢查圖象的 ALT 標記泼橘。不允許空值涝动。
4、Src:檢查圖象的 SRC 標記炬灭。不允許空值醋粟。
5、LAST:參數(shù)列表結(jié)束的指示符重归。
返回值
整型米愿。
說明
web_image_check 檢查指定的圖象是否在 HTML 頁面中出現(xiàn)。
Alt 或者 Src 兩者必須有一個在參數(shù)列表中出現(xiàn)鼻吮。如果兩項都通過育苟,那么檢查成功。
此函數(shù)僅僅支持基于 HTML 的腳本椎木。
web_reg_add_cookie
語法:
intweb_reg_add_cookie(const char * cookie, const char * searchstring, LAST );
參數(shù):
1违柏、Cookie:定義需要增加或修改的 Cookie。
Cookie 的參數(shù)格式為:<name>=VALUE;(required)香椎;domain=DOMAIN_NAME;(required)漱竖;
expires=DATE;path=PATH畜伐;(default path is"/")馍惹;secure。
此參數(shù)中的 cookie 元素和 HTTP 響應(yīng)頭中的 Set-Cookie 是相同的烤礁。例如“Session=1234讼积;
domain=sanditon.com”,在這里脚仔,“Session”是 cookie 的名稱勤众。
2、Searchstring:要查找的文本字符串鲤脏。字符串不能為空们颜,以 null 結(jié)尾吕朵。格式為
“Text=string”。
3窥突、LAST:屬性列表的結(jié)束符努溃。
返回值
整型。成功時返回 LR_PASS(0)阻问,失敗時返回 LR_FAIL (1)梧税。
說明
web_reg_add_cookie 是注冊類型的函數(shù)。它首先注冊一個搜索文本字符串的請求称近。檢查
動作在后續(xù)的 Action 函數(shù)之后進行第队。如果字符串被找到,就添加到 cookie 中刨秆。
需要注意凳谦,盡管 web_reg_add_cookie 在功能上跟 HTTP Set_Cookie 頭相似,它們還是有
個明顯的區(qū)別衡未。根據(jù) HTTP標準尸执,domain 屬性在 Set-Cookie 頭中是可選的。如果沒有指
定缓醋,默認的 domain 的值是產(chǎn)生 cookie 的服務(wù)器的 host name如失。當使用
web_reg_add_cookie 函數(shù)時,服務(wù)器的 hostname 對于壓力測試的機器來說是不可用的改衩,
所以 domain 屬性是必選項岖常。
此函數(shù)在 HTML-based 和 URL-based 的腳本中都可以使用。(參照錄制選項的錄制標簽
頁)葫督。此函數(shù)是在服務(wù)器內(nèi)容到達客戶端之前注冊搜索請求的,所以當所請求的內(nèi)容一到
就會執(zhí)行搜索操作板惑,腳本會比較高性橄镜。
web_reg_add_cookie 是用戶手動添加的,無法錄制冯乘。
web_reg_find
語法:
int web_reg_find(const char *attribute_list, LAST);
參數(shù):
1洽胶、attribute_list:
通過 Name=Value 對來傳遞參數(shù)。例如“Text=string”裆馒。Text姊氓,TextPfx,TextSfx三個必須
有一個出現(xiàn)喷好。其他的屬性是可選的翔横。
a) Text:要搜索的字符串,字符串必須非空梗搅,以 NULL 結(jié)尾禾唁⌒Ю溃可以使用 text flags 自定義
搜索字符串。
b) TextPfx:要搜索的字符串的直接前綴荡短。
c) TextSfx:要搜索的字符串的直接后綴丐枉。
d) Search:搜索的范圍【蛲校可選的值是:Headers瘦锹、Body(在請求體中搜索)、
Noresource (僅僅在 HTML 請求體中搜索闪盔,不包括頭和資源)弯院、ALL(在請求體、頭和資源
中搜索)锭沟,默認值是“BODY”抽兆。
e) SaveCount:匹配的個數(shù)。
f) Fail:設(shè)置函數(shù)檢查在什么狀態(tài)下失敗族淮。
g) ID:日志文件中標識此函數(shù)的一個字符串辫红。
h) RelFrameId:相關(guān)聯(lián)的 FrameId。注意:此參數(shù)在 GUI級別的腳本中不受支持祝辣。
2贴妻、LAST:屬性列表結(jié)束的標記符。
返回值
整型蝙斜。成功時返回 LR_PASS(0)名惩,失敗時返回 LR_FAIL (1)。
說明
web_reg_find 屬于注冊函數(shù)孕荠,注冊一個在 web 頁面中搜索文本字符串的請求娩鹉,在接下來的
Action(象 web_url)類函數(shù)中執(zhí)行搜索。
通過查找期望的字符是否存在來驗證是否返回了期望的頁面稚伍。例如弯予,通過查找“Welcome”
來檢查主頁是否完全打開了。也可以查找“Error”檢查瀏覽器是否發(fā)生錯誤个曙。還可以使用此
函數(shù)注冊一個請求來統(tǒng)計特定字符串出現(xiàn)的次數(shù)锈嫩。
如果檢查失敗,在接下來的 Action 類的函數(shù)中會報告錯誤垦搬。此函數(shù)僅僅注冊請求呼寸,并不執(zhí)
行。函數(shù)的返回值只表明注冊是否成功猴贰,并不表示檢查的結(jié)果对雪。
此函數(shù)不僅能夠查找 text,還能查找到圍繞著 text 的 strings糟趾。不要同時指定 text 和前綴后
綴慌植。
Fail甚牲,處理選項,可以是“Found 或“NotFound”蝶柿。默認是“NotFound”丈钙。
“Fail=Found” 指示當對應(yīng)的字符找到時,函數(shù)檢查失敗交汤。例如雏赦,查找單詞“Error”,如果找
到了芙扎,說名 web 請求沒有成功星岗,你想把函數(shù)檢查設(shè)置為失敗。
“Fail=NotFound”指示當對應(yīng)的字符找不到時戒洼,函數(shù)檢查失敗俏橘。如果查找的是 web 請求成
功時出現(xiàn)的字符串時,需要使用 NotFound圈浇。
SaveCount 參數(shù)指示保存到參數(shù)中的匹配的字符串的個數(shù)寥掐。使用這個屬性,需要指定
“SaveCount=param”磷蜀。檢查操作被執(zhí)行后召耘,param的值是 null 結(jié)尾的數(shù)字類型的值。
如果指定了 SaveCount褐隆,且沒有使用 Fail 參數(shù)污它,檢查不會失敗,無論需要查找的字符串是
否找到庶弃。通過檢查 SaveCount 的值確定字符串是否被找到衫贬。如果param是 0,說明沒有找
到對應(yīng)的字符串歇攻。
如果同時指定了 SaveCount和 Fail祥山,指定的錯誤處理選項和 SaveCount 協(xié)同工作。
handling optionspecified works together with the SaveCount. Thus,如果指定了
SaveCount 且指定了“Fail=NotFound”掉伏,但是字符串被找到,SaveCount 被賦值為字符串
出現(xiàn)的次數(shù)澳窑,檢查成功斧散。如果字符串找不到,SaveCount 被賦值為 0摊聋,檢查失敿琛(注意,
參數(shù)的 0 值只在運行時設(shè)置中 Continue on error 選中時才有意義)麻裁。
此函數(shù)在 HTML-based 和 URL-based 的腳本中都可以使用箍镜。此函數(shù)是在所請求內(nèi)容到達
之前注冊搜索請求的源祈,所以當所請求內(nèi)容一到達后就會執(zhí)行搜索,產(chǎn)生的腳本比較高效色迂。
LoadRunner 函數(shù)中文翻譯系列之三--Concurrent Group
web_concurrent_start
語法:
intweb_concurrent_start ( [char * ConcurrentGroupName,] NULL );
參數(shù):
ConcurrentGroupName:可選的香缺,并發(fā)組的標識符。
NULL:參數(shù)列表結(jié)束的標記符歇僧。
返回值
整型图张。返回 LR_PASS (0)表示成功,返回 LR_FAIL (1)表示失敗诈悍。
說明
web_concurrent_start 函數(shù)是并發(fā)組開始的標記祸轮。組中所有的函數(shù)是并發(fā)執(zhí)行的。并發(fā)組
的結(jié)束 web_concurrent_end 函數(shù)侥钳。在并發(fā)組中适袜,可以包含的函數(shù)有:web_url、
web_submit_data舷夺、web_custom_request苦酱、web_create_html_param、
web_create_html_param_ex冕房、web_reg_save_param躏啰、web_add_header。
在并發(fā)組中的函數(shù)不是立即執(zhí)行的耙册。在并發(fā)組開始時给僵,所有的函數(shù)首先被記錄下來,當并
發(fā)組結(jié)束時详拙,所有的函數(shù)并發(fā)執(zhí)行帝际。
所有的 Web 用戶,HTTP模式下的 WAP用戶持本函數(shù)饶辙。運行在 Wireless
SessionProtocol(WSP)回放模式下的 WAP虛擬用戶蹲诀,不支持本函數(shù)。
web_concurrent_start
語法:
intweb_concurrent_end ( reserved );
參數(shù):
reserved:保留的供擴展的字段弃揽。
返回值
整型脯爪。返回 LR_PASS (0)表示成功,返回 LR_FAIL (1)表示失敗矿微。
說明
web_concurrent_end痕慢,并發(fā)組結(jié)束的標記。腳本執(zhí)行時涌矢,碰到 web_concurrent_end 函數(shù)
時掖举,開始并發(fā)執(zhí)行所有記錄的函數(shù)。
在并發(fā)組中的函數(shù)不是立即執(zhí)行的娜庇。在并發(fā)組開始時塔次,所有的函數(shù)首先被記錄下來方篮,當并
發(fā)組結(jié)束時,所有的函數(shù)并發(fā)執(zhí)行励负。
可以并發(fā)執(zhí)行的函數(shù)的個數(shù)是有限制的藕溅,使用運行時設(shè)置-Netword 標簽頁的 Concurrent
Connection 來設(shè)置。