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則是有的話會被錄製到。

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

二、SRC：描述圖象的元素，能夠是圖象的文件名. 如： button.gif。也可使用SRC/SFX來指定圖象路徑的後綴。全部擁有相同此後綴的字符串都會被匹配到。

三、Frame：錄製操做時所在的Frame的名稱。

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

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

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

一、AreaAlt：鼠標單擊區域的ALT屬性。

二、AreaOrdinal：鼠標單擊區域的順序號。

三、MapName：圖象的映射名。

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

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

二、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錄製、閱讀、編輯、加強腳本時，經常使用到的。