给出一部分常用的 LoadRunner 函数,供大家参考。
LR 函数:
lr_start_transaction 为性能分析标记事务的开始
lr_end_transaction 为性能分析标记事务的结束
lr_rendezvous 在 Vuser 脚本中设置集合点
lr_think_time 暂停 Vuser 脚本中命令之间的执行
lr_end_sub_transaction 标记子事务的结束以便进行性能分析
lr_end_transaction 标记 LoadRunner 事务的结束
Lr_end_transaction("trans1",Lr_auto); lr_end_transaction_instance 标
记事务实例的结束以便进行性能分析
lr_fail_trans_with_error 将打开事务的状态设置为 LR_FAIL 并发送错误消
息 lr_get_trans_instance_duration 获取事务实例的持续时间(由它的句柄指
定) lr_get_trans_instance_wasted_time 获取事务实例浪费的时间(由它的
句柄指定) lr_get_transaction_duration 获取事务的持续时间(按事务的名
称)
lr_get_transaction_think_time 获取事务的思考时间(按事务的名称) lr_g
et_transaction_wasted_time 获取事务浪费的时间(按事务的名称)
lr_resume_transaction 继续收集事务数据以便进行性能分析
lr_resume_transaction_instance 继续收集事务实例数据以便进行性能分析 l
r_set_transaction_instance_status 设置事务实例的状态
lr_set_transaction_status 设置打开事务的状态
lr_set_transaction_status_by_name 设置事务的状态
lr_start_sub_transaction 标记子事务的开始
lr_start_transaction 标记事务的开始
Lr_start_transaction("trans1"); lr_start_transaction_instance 启动嵌
套事务(由它的父事务的句柄指定)
lr_stop_transaction 停止事务数据的收集
lr_stop_transaction_instance 停止事务(由它的句柄指定)数据的收集
lr_wasted_time 消除所有打开事务浪费的时间
lr_get_attrib_double 检索脚本命令行中使用的 double 类型变量
lr_get_attrib_long 检索脚本命令行中使用的 long 类型变量
lr_get_attrib_string 检索脚本命令行中使用的字符串
lr_user_data_point 记录用户定义的数据示例
lr_whoami 将有关 Vuser 脚本的信息返回给 Vuser 脚本
lr_get_host_name 返回执行
Vuser 脚本的主机名
lr_get_master_host_name 返回运行 LoadRunner Controller 的计算机名
lr_eval_string 用参数的当前值替换参数
lr_save_string 将以 NULL 结尾的字符串保存到参数中
lr_save_var 将变长字符串保存到参数中
lr_save_datetime 将当前日期和时间保存到参数中
lr _advance_param 前进到下一个可用参数
lr _decrypt 解密已编码的字符串
lr_eval_string_ext 检索指向包含参数数据的缓冲区的指针
lr_eval_string_ext_free 释放由 lr_eval_string_ext 分配的指针
lr_save_searched_string 在缓冲区中搜索字符串实例,并相对于该字符串实例,
将该缓冲区的一部分保存到参数中
lr_debug_message 将调试信息发送到输出窗口
lr_error_message 将错误消息发送到输出窗口
lr_get_debug_message 检索当前消息类
lr_log_message 将消息发送到日志文件
lr_output_message 将消息发送到输出窗口
lr_set_debug_message 设置调试消息类
lr_vuser_status_message 生成带格式的输出,并将其写到 ControllerVuser
状态区域
lr_message 将消息发送到 Vuser 日志和输出窗口 lr_load_dll 加载外部 DLL
lr_peek_events 指明可以暂停 Vuser 脚本执行的位置
lr_think_time 暂停脚本的执行,以模拟思考时间(实际用户在操作之间暂停以
进行思考的时间) lr_continue_on_error 指定处理错误的方法 lr_continue_
on_error (0);lr_continue_on_error (1);
lr_rendezvous 在 Vuser 脚本中设置集合点
TE_wait_cursor 等待光标出现在终端窗口的指定位置
TE_wait_silent 等待客户端应用程序在指定秒数内处于静默状态
TE_wait_sync 等待系统从 X-SYSTEM 或输入禁止模式返回
TE_wait_text 等待字符串出现在指定位置
TE_wait_sync_transaction 记录系统在最近的 X SYSTEM 模式下保持的时间
WEB 函数列表:
web_custom_request 允许您使用 HTTP 支持的任何方法来创建自定义 HTTP 请
求
web_image 在定义的图像上模拟鼠标单击 web_link 在定义的文本链接上模拟
鼠标单击 web_submit_data 执行“无条件”或“无上下文”的表单
web_submit_form 模拟表单的提交
web_url 加载由“URL”属性指定的 URL
web_set_certificate 使 Vuser 使用在 Internet Explorer 注册表中列出的
特定证书 web_set_certificate_ex 指定证书和密钥文件的位置和格式信息
web_set_user 指定 Web 服务器的登录字符串和密码,用于 Web 服务器上已验
证用户身份的区域 web_cache_cleanup 清除缓存模拟程序的内容
web_find 在 HTML 页内搜索指定的文本字符串
web_global_verification 在所有后面的 HTTP 请求中搜索文本字符串
web_image_check 验证指定的图像是否存在于 HTML 页内
web_reg_find 在后面的 HTTP 请求中注册对 HTML 源或原始缓冲区中文本字符
串的搜索 web_disable_keep_alive 禁用 Keep-Alive HTTP 连接
web_enable_keep_alive 启用 Keep-Alive HTTP 连接
web_set_connections_limit 设置 Vuser 在运行脚本时可以同时打开连接的最
大数目 web_concurrent_end 标记并发组的结束
web_concurrent_start 标记并发组的开始
web_add_cookie 添加新的 Cookie 或修改现有的 Cookie
web_cleanup_cookies 删除当前由 Vuser 存储的所有 Cookie
web_remove_cookie 删除指定的 Cookie
web_create_html_param 将 HTML 页上的动态信息保存到参数中。(LR 6.5 及
更低版本) web_create_html_param_ex 基于包含在 HTML 页内的动态信息创建
参数(使用嵌入边界)(LR 6.5 及更低版本)。
web_reg_save_param 基于包含在 HTML 页内的动态信息创建参数(不使用嵌入
边界) web_set_max_html_param_len 设置已检索的动态 HTML 信息的最大长度
web_add_filter 设置在下载时包括或排除 URL 的条件
web_add_auto_filter 设置在下载时包括或排除 URL 的条件
web_remove_auto_filter 禁用对下载内容的筛选
web_add_auto_header 向所有后面的 HTTP 请求中添加自定义标头
web_add_header 向下一个 HTTP 请求中添加自定义标头
web_cleanup_auto_headers 停止向后面的 HTTP 请求中添加自定义标头 web_r
emove_auto_header 停止向后面的 HTTP 请求中添加特定的标头
web_revert_auto_header 停止向后面的 HTTP 请求中添加特定的标头,但是生
成隐性标头 web_save_header 将请求和响应标头保存到变量中
web_set_proxy 指定将所有后面的 HTTP 请求定向到指定的代理服务器
web_set_proxy_bypass 指定 Vuser 直接访问(即不通过指定的代理服务器访问)
的服务器列表 web_set_proxy_bypass_local 指定 Vuser 对于本地 (Intranet)
地址是否应该避开代理服务器 web_set_secure_proxy 指定将所有后面的 HTT
P 请求定向到服务器
web_set_max_retries 设置操作步骤的最大重试次数
web_set_timeout 指定 Vuser 等待执行指定任务的最长时间
web_convert_param 将 HTML 参数转换成 URL 或纯文本
web_get_int_property 返回有关上一个 HTTP 请求的特定信息
web_report_data_point 指定数据点并将其添加到测试结果中
web_set_option 在非 HTML 资源的编码、重定向和下载区域中设置 Web 选项
web_set_sockets_option 设置套接字的选项
LoadRunner 函数中文翻译系列之一--Action
2009 年 09 月 26 日 星期六 上午 09:45
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 script 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 script 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 script 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=../../gifs/buttons/Home.gif", LAST);
下面的例子模拟用户在客户端映射的图片上单击:
web_image("dpt_house.gif",
"Src=../gifs/dpt_house.gif",
"MapName=dpt_house",
"AreaOrdinal=4",
LAST);