c语言版本:
int web_custom_request(const char *RequestName, ,
[EXTRARES, ,] LAST );
参数说明:
RequestName step名称,即请求名。
List of Attributes 属性列表
注意:属性名称大小写敏感
EXTRARES 界定参数,表名接下来的参数将是个资源属性列表
LAST 表名列表结束的标记
List of Attributes
URL - 统一资源定位器,通常为请求链接地址
Method - 请求方法:POST、GET
TargetFrame - 包含当前链接或资源的frame的名称
EncType - 提交请求使用的编码类型(type of encoding)。EncType指定“Content-Type”请求头的值,比如“text/html”。web_custom_request不处理未编码的请求体。Body参数指定的请求体会使用指定的编码。因此,如果指定的Enctype如果不匹配请求体,可能会引发服务端错误。通常情况下,按照录制所得,不对Enctype进行编辑。
如果指定了“EncType”,那么它将会覆盖web_add_[auto_]header函数指定的Content-Type。如果“EncType=”(空值),不会生成“Content-Type” 请求头;如果省略了“EncType”时,那么使用web_add_[auto_]header函数指定的。如果既没有指定EncType也没使用web_add_[auto_]header函数设定请求头,且“Method=POST”,那么,将使用“application/x-www-form-urlencoded”做为默认值。其他情况下,不会生成Content-Type请求头。
RecContentType - 指定了Content–Type 响应头的类型,比如text/html,application/x-javascript。当没有设置Resource属性时,用它来确定目标URL是否是可录制的资源。
Refer - 指定引用的页面
Body - 请求体
Raw Body - 请求体被当作指向数据的指针来传递
BodyFilePath - 需要作为请求体传递的文件路径,不能和Body一起使用,或者任何Body、Raw Body Attribute的属性: BodyBinary, BodyUnicode, RAW_BODY_START 或 Binary=1
Resource - 一个表明URL是否资源的值
Resouce=1,表明URL为一个资源,意味着当前操作与所在脚本的成功与否关系不大。在下载资源时如果发生错误,将当作警告而不是错误来处理的
是否下载URL受“Run-Time Setting—Browser Emulation--Download non-HTML resources” 这个选项的影响。勾选该选项,则不按HTML的形式解析响应信息。
“Resource=0”,表明此URL是重要的,不受发送请求(RTS)的影响,在需要时也会解析它。
ResourceByteLimit - 下载web页面资源的极限大小。当达到设置的极限后,不再下载资源,仅仅对需要下载的资源起作用。
Snapshot - 快照的文件名(.inf为后缀
Mode - 录制级别:HTML、HTTP
HTML级别:在当前Web界面上直观的录制HTML操作。这些操作被录制为web_url、web_link、web_image、web_submit_form等step。VuGen仅仅录制返回HTML页面的请求,不处理脚本和应用程序。
HTTP级别:VuGen把所有的请求录制为web_url step,不生成web_link、web_image、web_submit_form这些函数。这种方法更为灵活,但是生成的脚本不够直观。
ContentEncoding - 请求使用指定的方法(gzip或者deflate)对请求体进行编码,相应的“Content-Encoding:”HTTP头会随此请求一起发送。仅适用于web_custom_request和web_submit_data。
List of Resource Attributes
list of Attributes由非HTML机制的web页面生成,包含Javascript,Activex,Java applets和Flash请求的资源。VuGen Recording Options中可设置,把这些元素录制在当前脚本step中或者单独的step(查看Recording in HTML–Based Mode)
当录制在当前脚本的step中时,额外的资源被当作参数列出,支持以下资源属性:
URL 需要加载的web资源
Referer URL引用的web页面
ENDITEM 表示list中,每个资源结束的标记
相比录制每个资源为一个单一的step,按这种模式录制non-HTML元素可以精简脚本,增加可读性。
当遇到一个附加的资源时,例如,一个Javascript,VuGen录制器添加资源到附加资源列表(Resource Attributes参数列表)。当回放脚本时,会请求该资源。如果资源规律性变化,可使用关联函数参数化该资源。
例子:
web_reg_save_param("extrares_11",
"LB=loadrunner <wbr> 脚本开发-web_custom_requests函数详细介绍”
"RB=\"",
"Ord=11",
LAST );
web_url("web_url",
"URL=http://lazarus/html/links.html",
"TargetFrame=",
"Resource=0",
"Referer=",
"Mode=HTTP",
EXTRARES,
"URL={extrares_11}", ENDITEM,
LAST );
函数使用范围:
支持所有Web脚本,和以HTTP协议或者无线会话协议(WSP,Wireless Session Protocol)运行的WAP脚本