Web常用函數介紹(LoadRunner相關)

介紹大綱：
1. web_url
2. web_image
3. web_link
4. web_submmit_form

詳細介紹：

一. web_url

文法：
Int Web_url(const char *name, const char * url, , [EXTRARES,,LAST)

傳回值
成功時返回LR_PASS (0)，失敗時返回 LR_FAIL (1)。

參數：
Name：VuGen中樹形視圖中顯示的名稱，在自動交易處理中也可以用做事務的名稱。

url：頁面url地址。

List of Attributes

EXTRARES：分隔字元，標記下一個參數是資源屬性的列表了。

List of Resource Attributes

LAST：屬性列表結束的標記符。

說明

Web_url根據函數中的URL屬性載入對應的URL，不需要上下文。

只有VuGen處於URL-based或者HTML-based（此時A scrīpt containing explicit URLs only選項被選中時）的錄製模式時，web_url才會被錄製到。

可以使用web_url 類比從FTP伺服器上下載檔案。web_url 函數會使FTP伺服器執行檔案被真實下載時的操作。除非手工指定了"FtpAscii=1"，下載會以二進位模式完成。

在錄製選項中，Toos—Recording Option下，Recording選項中，有一個Advanced
HTML選項，可以設定是否錄製非HTML資源，只有選擇了“Record within the current scrīpt
step”時，List of Resource Attributes才會被錄製到。非HTML資源的例子是gif和jpg圖象檔案。

通過修改HTTP頭可以傳遞給伺服器一些附加的請求資訊。使用HTTP頭允許請求中包含其他的內容類型（Content_type），象壓縮檔一樣。還可以只請求特定狀態下的web頁面。

所有的Web Vusers ，HTTP模式下的WAP Vusers或者回放模式下的Wireless Session Protocol（WSP），都支援web_url函數。

二. web_image

文法：
Int web_image (const char *StepName, , [EXTRARES, ,] LAST );

傳回值
成功時返回LR_PASS (0)，失敗時返回 LR_FAIL (1)。

參數：
StepName：VuGen中樹形視圖中顯示的名稱，在自動交易處理中也可以用做事務的名稱。

List of Attributes（伺服器端和用戶端映射的圖片）：SRC屬性是一定會被錄製到的，其他的ALT、Frame、TargetFrame、Ordinal則是有的話會被錄製到。

1、ALT：描述圖象的元素。用滑鼠指向圖象時，所浮出來的文字提示。

2、SRC：描述圖象的元素，可以是圖象的檔案名稱. 如： button.gif。也可以使用SRC/SFX來指定圖象路徑的尾碼。所有擁有相同此尾碼的字串都會被匹配到。

3、Frame：錄製操作時所在的Frame的名稱。

4、TargetFrame：見List of Attributes的同名參數。

5、Ordinal：參見Web_link的同名參數。

List of Attributes（用戶端映射的圖片）：

1、AreaAlt：按一下滑鼠地區的ALT屬性。

2、AreaOrdinal：按一下滑鼠地區的順序號。

3、MapName：圖象的映射名。

List of Attributes（伺服器端映射的圖片）：儘管點擊座標不屬於屬性，但還是以屬性的格式來使用。

1、Xcoord：點擊圖象時的X座標。

2、Ycoord：點擊圖象時的Y座標。

EXTRARES：分隔字元，標記下一個參數是資源屬性的列表了。

List of Resource Attributes：參見List of Resource Attributes一節。

LAST：屬性列表結束的標記符。

說明

web_image類比滑鼠在指定圖片上的單擊動作。此函數必須在有前置操作的上下文中使用。

在Toos—Recording Option，如果錄製層級設為基於HMTL的錄製方式時，web_image才會被錄製到。

web_image支援用戶端（client-side）和伺服器端server-side的圖片映射。

在錄製選項中，Toos—Recording Option下，Recording選項中，有一個Advanced
HTML選項，可以設定是否錄製非HTML資源，只有選擇了“Record within the current scrīpt
step”時，List of Resource Attributes才會被錄製到。非HTML資源的例子是gif和jpg圖象檔案。

通過修改HTTP頭可以傳遞給伺服器一些請求附加資訊。使用HTTP頭允許請求中包含內容，如同壓縮檔一樣。還可以只請求特定狀態的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)；

下面的例子類比使用者在服務端映射的圖片上單擊：

web_image(“The Web Developer’s Virtual Library”,

“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, , [EXTRARES, ,] LAST )；

傳回值
成功時返回LR_PASS (0)，失敗時返回 LR_FAIL (1)。

參數：
StepName：VuGen中樹形視圖中顯示的名稱，在自動事務設定中也被用做事務名稱。

List of Attributes：支援下列的屬性：

1.Text：超連結中的文字，必須精確匹配。

2.Frame：錄製操作時所在的Frame的名稱。

3.TargetFrame、ResourceByteLimit：見List of Attributes一節。

4.Ordinal：如果用給出的屬性（Attributes）篩選出的元素不唯一，那麼VuGen使用此屬性來指定其中的一個。例如：“SRC=abc.gif”，“Ordinal=3”標記的是SRC的值是“abc.gif”的第3張圖片。

EXTRARES：表明下面的參數將會是list of resource attributes了。

LAST：結尾標示符。

說明

類比滑鼠在由若干個屬性集合描述的連結上進行單擊。此函數必須在前置動作的上下文中才可以執行。

web_link 僅僅在基於HTML的錄製方式中才會被VuGen捕捉到。

非HTML產生的資源的例子有.gif 和.jpg映像。對於List of Resource
Attributes參數來說，僅僅當Recording Options–Recording –HTML-based scrīpt– Record
within the current scrīpt step選項被選中時，它們才會被插入到代碼中。

可以通過改變HTTP頭資訊給伺服器傳遞一些附加資訊。使用HTTP頭資訊可以，允許響應體中包含其他的內容類型（Content-Type），例如壓縮檔，或者只有滿足了特定的狀態才去請求web頁。

此函數值支援Web虛擬使用者，不支援WAP虛擬使用者。

四. web_submmit_form

文法：
Int web_submit_form (const char *StepName, , , ITEMDATA, , [ EXTRARES, ,] LAST );

傳回值
成功時返回LR_PASS (0)，失敗時返回 LR_FAIL (1)。

參數：
StepName：Form的名字。VuGen中樹形視圖中顯示的名稱，在自動交易處理中也可以用做事務的名稱。
List of Attributes：支援以下屬性：

1.Action：Form中的ACTION屬性，指定了完成Form中的操作用到的URL。也可以使用“Action/sfx” 表示使用此尾碼的所有Action。

2.Frame：錄製操作時所在的Frame的名稱。

3.TargetFrame、ResourceByteLimit：見List of Attributes的同名參數。

4.Ordinal：參見Web_link的同名參數。

VuGen通過記錄資料域唯一的標識每個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是通過屬性和資料來共同識別的。

使用下面的格式來表示資料域列表

“name=n1″, “value=v1″, ENDITEM,

“name=n2″, “value=v2″, ENDITEM,

ITEMDATA：Form中資料和屬性的分隔字元。

EXTRARES：一個分隔字元，標記下一個參數是資源屬性的列表了。

List of Resource Attributes：參見List of Resource Attributes一節。

LAST：屬性列表結束的標記符。

說明

web_submit_form 函數用來提交表單。此函數可能必須在前一個操作的上下文中執行。在Toos—Recording Option，只有錄製層級設為基於HMTL的錄製方式，web_image才會被錄製到。

在錄製選項中，Toos—Recording Option下，Recording選項中，有一個Advanced
HTML選項，可以設定是否錄製非HTML資源，只有選擇了“Record within the current scrīpt
step”時，List of Resource Attributes才會被錄製到。非HTML資源的例子是gif和jpg圖象檔案。

通常情況下，如果錄製了web_submit_form
函數，VuGen會把“name”和“value”一起錄製到ITEMDATA屬性中。如果不想在指令碼中以明文顯示“value”，可以對它進行加密。把
“Value”改為“EncryptedValue”,然後把錄製到的值改為加密後的值。

例如：可以把 “Name=grpType”, “Value=radRoundtrip”, ENDITEM

改為：”Name=grpType”, EncryptedValue=409e41ebf102f3036b0549c799be3609″, ENDITEM

如果你完整的安裝了LoadRunner，那麼開啟開始菜單–Mercury LoadRunner—Tools–Password
Encoder，這個小工具是用來加密字串的。把需要加密的值粘貼到Password一欄，再點Generate按鈕。加密後的字串會出現在
Encoded string框中。接著點Copy按鈕，然後把它粘貼到指令碼中，覆蓋原來顯示的“Value”。

加密的另一種方法時使用lr_decrypt函數。方法：選擇整個字串，例如“Value=radRoundtrip”（注意不要選擇引號），右擊滑鼠，選擇Encrypt string選現，指令碼會變為：

“Name=grpType”, lr_decrypt(“40d176c46f3cf2f5fbfaa806bd1bcee65f0371858163″), ENDITEM,

web_submit_form支援Web虛擬使用者，不支援WAP虛擬使用者。

以上是loadrunner錄製、閱讀、編輯、增強指令碼時，常用到的。