web虚拟用户脚本常用函数

1）cookie

web_add_cookie	添加新的cookie或修改已经存在的cookies
web_remove_cookie	删除指定的cookies
web_cleanup_cookies	删除所有被vuser保存的cookies
web_reg_add_cookie	如果找到某些特定文字，则添加到cookies中

在录制web虚拟用户脚本时，vugen会检测发送到浏览器的所有cookie，然后将永久cookie的详细信息直接录制成脚本，使用web_add_cookie将永久cookie保存在vuser脚本中。vugen不保存在录制会话期间所使用的会话cookie，而是在录制时缓存会话cookie，然后停止录制时丢弃

2）检查点

文本检查点

图像检查点

全局检查点

web_find	需要在run-time settings中开启图像与文本检查点功能后，才能对前面请求后返回的页面进行检查 web_image_check("web_image_check", "Src=http://statics.verycd.com/images/v3/emule.png", LAST);	html-based
web_image_check		html-based
web_reg_find	web_reg_find("Search=Body", "SaveCount=count1", "Text=LoadRunner", LAST);	html-based url-based	尽量检查英文关键字 不要开启fail if属性 设置savecount属性
web_global_verification	web_global_verification("Text=HTTP/1.1 500", "Search=ALL", LAST);	html-based url-based	默认找到指定文本时脚本将发生错误，导致vuser失败，可以修改fail if属性为找不到失败

3）关联函数

int web_reg_save_param(const char *ParamName,<list of Attributes>,LAST);	该函数只有当vugen录制选项中关联设置部分“在录制期间启用关联”被选中时才会在脚本中被自动录制，录制模式必须是基于url，或基于html但html-based高级设置中的“仅包含明确url的脚本”选项必须选中
int web_save_param_length(const char* param, LAST);	创建一个名为<Param>_Length"的新参数，并将参数param的长度保存到<Param>_Length中，长度值用十六进制表示

4）动作函数

int web_custom_request(const char *RequestName,<list of Attributes>,[EXTRARES,<list of Resource Attributes>,] LAST);	该函数创建一个http客户请求，它支持http协议中的所有请求方法。默认情况下，只有当其他web请求函数不能被解释应用时，loadrunner才会利用该函数创建请求，且该函数通常会和其他函数配合应用，如先利用web_add_header函数添加http请求信息头，然后再利用该函数发送客户请求等。
int web_image(const char *StepName,<list of Attributes>,[EXTRARES,<list of Resource Attributes>,] LAST);	模拟鼠标在指定图片上的点击动作,仅vugen为基于html的录制模式时有效，必须在前置动作的上下文才可以执行
int web_link(const char *StepName,<list of Attributes>,[EXTRARES,<list of Resource Attributes>,] LAST);	模拟用户点击链接的行为，仅vugen为基于html的录制模式时有效，必须在前置动作的上下文才可以执行
int web_submit_data(const char *StepName,<list of Attributes>,ITEMDATA,<list of data>,[EXTRARES,<list of Resource Attributes>,] LAST);	处理无状态或上下文无关的表单提交，生成表单的get或post请求，这些请求与form自动生成的请求时一样的 只有选择 recording options>Advanced下的“a script containing explicit ULRS only”选项后，vugen才会使用该函数进行录制
int web_submit_form(const char *StepName,<list of Attributes>,<list of Hidden Fields>,ITEMDATA,<list of data>,[EXTRARES,<list of Resource Attributes>,] LAST);	该函数用来提交表单，此函数必须在前一个操作的上下文中执行。基于html的录制模式。
int web_url(const char *Name, const char *url,<list of Attributes>,[EXTRARES,<list of Resource Attributes>,]LAST);	根据url属性加载对应的url，该函数不需要上下文。仅当选择 recording options>Advanced下的“a script containing explicit ULRS only”选项后，vugen才会使用该函数进行录制。可以模拟从ftp服务器上下载文件，它会使ftp服务器执行文件被真实下载时的操作

5）授权函数

int web_set_user(const char *username, const char *password, const char *host:port);	指定web认证服务器的登录用户和密码
int web_set_certificate(const char *CertificateNumber);
int web_set_certificate_ex(const char *option_list, LAST);	指定证书的密钥文件的位置和格式信息

6）其他函数

int web_get_int_property(const int HttpInfoType);	HTTP_INFO_RETURN_CODE返回上一次http响应信息中的状态码 HTTP_INFO_DOWNLOAD_SIZE返回以字节为单位的最后下载信息的大小 HTTP_INFO_DOWNLOAD_TIME返回以毫秒为单位的最后下载信息的时间
int web_concurrent_start([ConcurrentGroupName，]NULL);	标记一个并发组的开始，所有在该组内的函数都将同时被执行，包括在web_concurrent_start中的函数并不会立即执行，只是先被注册为并发函数，只有当并发组被关闭，即遇到web_concurrent_end时才会被同时执行
int web_concurrent_end(reserved);

7）常见问题

迭代次数大于1时，发生错误

8）http协议相关函数

HTTP协议	HEAD设置	Web_add_header Web_clean_header
	点击链接	Web_link(点击文字链接） Web_image（点击图片链接）
	提交表单	web_submit_data web_submit_form
Web系统设置	cache设置	web_cache_leanup web_load_cache
	cookie设置	web_add_cookie web_cleanup_cookies
	Proxy设置	web_set_proxy web_set_secure_proxy
LoadRunner框架支持	检查点	web_find web_image_check
	关联	web_create_html_param web_create_html_param_ex web_reg_save_param web_set_max_html_param_len
	控制	lr_start_transaction lr_end_transaction lr_rendezvous lr_thinktime