《lr工具常用函数》由会员分享，可在线阅读，更多相关《lr工具常用函数（8页珍藏版）》请在金锄头文库上搜索。
1、事务函数：事务函数：lr_start_transaction();/标记事务的开始lr_end_transaction();/*标记事务的结束,一般情况下，事务开始与结束联合使用*/lr_get_transaction_think_time();/得到事务的指定思考时间，事务时间=整体事务时间-事务的lr_stop_transaction();/停止事务lr_end_sub_transaction/标记子事务的结束以便进行性能分析lr_end_transaction_instance/标记事务实例的结束以便进行性能分析lr_fail_trans_with_error/将打开事务的状态设置为 L
2、R_FAIL 并发送错误消息lr_get_trans_instance_duration/获取事务实例的持续时间（由它的句柄指定）lr_get_trans_instance_wasted_time/获取事务实例浪费的时间（由它的句柄指定）lr_get_transaction_duration/获取事务的持续时间（按事务的名称）lr_get_transaction_think_time/获取事务的思考时间（按事务的名称）lr_get_transaction_wasted_time/获取事务浪费的时间（按事务的名称）lr_resume_transaction/继续收集事务数据以便进行性能分析lr_
3、resume_transaction_instance/继续收集事务实例数据以便进行性能分析lr_set_transaction_instance_status/设置事务实例的状态lr_set_transaction_status/设置打开事务的状态lr_set_transaction_status_by_name/设置事务的状态lr_start_sub_transaction/标记子事务的开始lr_start_transaction_instance/启动嵌套事务（由它的父事务的句柄指定）lr_stop_transaction/停止事务数据的收集lr_stop_transaction_ins
4、tance/停止事务（由它的句柄指定）数据的收集lr_wasted_time/消除所有打开事务浪费的时间lr_end_sub_transaction/标记子事务的结束以便进行性能分析lr_end_transaction/标记 LoadRunnerLoadRunner 事务的结束lr_end_transaction_instance/标记事务实例的结束以便进行性能分析lr_fail_trans_with_error/将打开事务的状态设置为 LR_FAIL 并日志日志函数：函数：lr_debug_message();/发送调试信息到日志文件lr_error_message();/发送错误信息到 L
5、R 输入窗口或日志文件里lr_get_debug_message();/返回当前调试的信息lr_log_message();/发送信息到用户日志文件lr_output_message();/发送信息到输出窗口或日志文件lr_vuser_status_message();/发送虚拟用户的状态到 LR 的 Controller运行时函数：运行时函数：lr_abort();/终止执行的脚本lr_continue_on_error();/当发生错误后运行的事件lr_exit();/从 scirpt.ation.iteration 中退出lr_rendezvous_ex();/设置集合点lr_think
6、_time();/设置思考时间，在性能测试性能测试中为了更好模拟以后操作，可以根据实际生产环境设置思考时间。lr_rendezous();/集合点，可以设置虚拟用户相同操作之前进行集合，通过集合点可以增加被测试应用的压力，从而达到压力测试的目的。lr_load_dll();/调用 DLL 文件例子：lr_load_dll(“user32.dll“);MessageBoxA(NULL,“This is Testing Message“,“message_caption“,0);return 0;系统信息函数：系统信息函数：lr_get_master_host_name();/返回运行 Contr
7、oller 主机的名称lr_get_vser_ip();/返回虚拟用户的 IP 地址lr_user_data_point();/录制用户自定义的数据样例lr_user_data_point();/ 记录自己的数据来进行分析，每次要记录一个点时，请使用该函数记录采样名称和值。系统将自动记录采样的时间。执行之后，可以使用用户等义的数据，点击图形分析结果lr_get_host_name();/返回主机名例子；char * host;host=lr_get_host_name();lr_output_message(“Computer Name %s“,host);return 0;WEBWEB 应用
8、中常见函数应用中常见函数web_url();/根据函数中的 URL 属性加载对应的 URL，不需要上下文。Web_url(“在测试结果中显示的名称”,”URL=需要访问的超链接地址”,LAST)Web_url()函数可以模拟用户请求，这是我们脚本中最常用的函数之一“URL=http:/127.0.0.1:1080/WebTours/login.pl?username= /说明这个函数的结束web_image();/模拟鼠标在指定图片上的单击动作。此函数必须在有前置操作的上下文中使用。Tips：在 ToosRecording Option，如果录制级别设为基于 HMTL 的录制方式时，web_i
9、mage 才会被录制到。Web_link();/模拟鼠标在由若干个属性集合描述的链接上进行单击。此函数必须在前置动作的上下文中才可以执行。Web_link(“在测试结果中显示的名称”,”Text=需要点击的超链接名”,LAST)Web_link()函数用来模拟用户点击一个超链接的操作web_link(“sign up now“, /在测试结果中显示的名称“Text=sign up now“, /需要点击的超链接名“Snapshot=t2.inf“, /操作后的内容会被抓图保存到 t2.inf 文件中LAST);/说明这个函数的结束web_submit_form ();/函数用来提交表单。此函数
10、可能必须在前一个操作的上下文中执行。web_submit_form()是作为用户行为模拟的函数，会自动检测在当前页面是不是存在 form，然后将后面的 itemdata 数据对应传送web_submit_form(“login.pl“,“Snapshot=t2.inf“,ITEMDATA,“Name=username“, “Value=jojo“, ENDITEM,“Name=password“, “Value=bean“, ENDITEM,“Name=login.x“, “Value=0“, ENDITEM,“Name=login.y“, “Value=0“, ENDITEM,LAST);T
11、ips：支持 Web 虚拟用户，不支持 WAP 虚拟用户。 web_submit_data();/函数处理无状态或者上下文无关的表单提交。它用来生成表单的GET 或 POST 请求，这些请求与 Form 自动生成的请求是一样的。发送这些请求时不需要表单上下文。web_submit_data()函数无需页面支持，直接发送给对应的页面相关数据，隐藏表单的数据也会被记录下来作为 Itemdata 数据提交给服务器web_submit_data(“login.pl“,“Action=http:/127.0.0.1:1080/WebTours/login.pl“, /“Method=POST“, /提交
12、数据的方式“TargetFrame=body“,“RecContentType=text/html“,“Referer=http:/127.0.0.1:1080/WebTours/nav.pl?in=home“,“Snapshot=t2.inf“,“Mode=HTML“,ITEMDATA,“Name=userSession“, “Value=106174.10854597ftzVDDApHAiDDDDDDcHzHpQitcf“, ENDITEM,“Name=username“, “Value=jojo“, ENDITEM,“Name=password“, “Value=bean“, ENDIT
13、EM,“Name=JSFormSubmit“, “Value=off“, ENDITEM,“Name=login.x“, “Value=0“, ENDITEM,“Name=login.y“, “Value=0“, ENDITEM,LAST);web_find();/此函数的作用是在 HTML 页面中查找指定的字符串。当指定的 HTML 请求全部完成以后，开始执行搜索过程，比 web_reg_find 要慢。web_find 函数在 C 语言的脚本中已经被 web_reg_find 所替代，web_reg_find 运行速度比较快，而且在 HTML-based 和 URL-based 的录制方式
14、中都可以使用。 在 C 语言脚本中，web_find 是向后兼容的。Java 和 Visual Basic 脚本中不再支持它。web_add-filter();/ 过滤函数，用于对指定的 URL 进行过滤，分析 URL 加载那部分对性能有影响。界面操作 Run-time Settings 下的 Internet Protocol 的 Download Filters。web_custom_request();/ 自定义请求函数，可以编写自定义请求格式进行接口功能测试功能测试。web_image_check();/检查指定的图象是否在 HTML 页面中出现，此函数仅仅支持基于HTML 的脚本。w
15、eb_reg_add_cookie();/是注册类型的函数。它首先注册一个搜索文本字符串的请求。检查动作在后续的 Action 函数之后进行。如果字符串被找到，就添加到 cookie 中。web_reg_find();/属于注册函数，注册一个在 web 页面中搜索文本字符串的请求，在接下来的 Action（象 web_url）类函数中执行搜索。web_concurrent_start();/函数是并发组开始的标记。组中所有的函数是并发执行的。并发组的结束 web_concurrent_end 函数。Intweb_reg_save_param(“参数名“,“LB=左边界“,“RB=右边界“,LA
16、ST);/注册函数，在参数值出现的前面使用，注册成功时返回值为 0，注册失败时返回值为 1。左右边界需根据TreeView 里相关步骤的 SeverResponse 代码来确定。用以上函数能获取第一个符合条件的数值。web_reg_save_param(“参数名”,“LB=左边界”,“RB=右边界“,“Ord=All“,LAST);/关联函数，通过关联可以在测试中保持动态值，从服务器返回的数据库数据库中查找需要关联的数据。当参数有多个值时，加上“Ord=All”后可获取所有的数值。注册成功后，参数名_count表示取得的数值个数，参数名_1为第一个数值，参数名_2为第二个数值。lr_save_string(“字符串变量”,“参数名“)/将字符变量里的值传递给指定参数。通过该函数来改变 DataFile 类型参数的数值。 lr_eval_string(“参数名“)/取得参数的数值。可取得已注册参数或 DataFile 类型参数的数值。eval 就是 evaluation（估价, 评价, 赋值）的缩写。
