loadrunner脚本经常用到的函数归纳

一. 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录制、阅读、编辑、增强脚本时，常用到的。

五：web_submit_data()

处理无状态或者上下文无关的表单提交。它用来生成表单的GET或POST请求，这些请求与Form自动生成的请求是一样的。发送这些请求时不需要表单上下文。

函数语法：Int web_submit_data ( const char *StepName, , ITEMDATA, , [ EXTRARES, ,] LAST );

返回值：LR_PASS（0）代表成功，LR_FAIL（1）代表失败

六、web_reg_find

代码一：

web_reg_find("Text=Payment Details",LAST);

代码思路：

1."Payment Details" 为你要检查的文本；

2. 脚本执行到此处，若在页面上找到了这几个字符串，那脚本继续执行下去；若没有找到，脚本将在此报错并且结束。

代码二：

web_reg_find("Text=Payment Details", "SaveCount=para_count", LAST); //check 的函数

web_submit_form("reservations.pl_2", //要check的页面的录制时的代码

"Snapshot=t22.inf",

ITEMDATA,

"Name=outboundFlight", "Value=003;0;06/23/2007", ENDITEM,

"Name=reserveFlights.x", "Value=61", ENDITEM,

"Name=reserveFlights.y", "Value=2", ENDITEM,

LAST);

if (atoi(lr_eval_string("{para_count}"))>0) //验证是否找到了页面上的要检查的字符串

lr_output_message("we find the string!");

else

lr_output_message("sorry,don't find the string!");

代码思路：

1."Payment Details" 为你要检查的文本；

2. 脚本执行到此处，不管页面上是否存在你要检查的字符串，脚本都不会报错，而是执行下去。

3. 此段代码将找到的你要检查的字符串的个数，存为一个参数。 然后在页面代码的后面，通过检查这个参数的值是否大于0，来判断是否找到了你所要检查的字符串。

代码三：

A. web_reg_find("Text=Payment Detdils", "Fail=NotFound",LAST);或者

B. web_reg_find("Text=Payment Detdils", "Fail=Found",LAST);

代码思路：

1."Payment Details" 为你要检查的文本；

2. 若是A代码：脚本执行到此处，若没有找到check的字符串，脚本将FAIL， 并且停止执行下去。反之，则一直执行下去。

3. 若是B代码：脚本执行到此处，若找到check的字符串，脚本将FAIL， 并且停止执行下去。反之，则一直执行下去。

七：lr_think_time(40)

思考时间

八、atoi()

将字符串转化为int类型

int i;

char * s = "7 dollars";

i =atoi(s);

lr_output_message ("Price $%d", i);

九、itoi()

将整数类型转化为字符串类型

for (i=0;i<10;i++) {

itoa(i,str,10);

lr_save_string(str,"ID")

}