语法：
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 script 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虚拟用户。
例子：
下面的例子中，web_submit_form 函数的名字是“employee.exe”。此函数提交了一个请求,此请求包含雇员信息John Green。此函数没有使用属性（Attributes）是因为通过数据项已经能唯一的标识这个Form了。
web_submit_form("employee.exe",
ITEMDATA,
"name=persons", "value=John Green - John", ENDITEM,
"name=go_page", "value=Go to Page", ENDITEM,
LAST);
web_submmit_data
语法：
Int web_submit_data ( const char *StepName,
- , ITEMDATA,
- , [ EXTRARES,
- ,] LAST );
返回值
返回LR_PASS（0）代表成功，LR_FAIL（1）代表失败。
参数：
StepName：步骤名称，VuGen中树形视图显示的名称。
List of Attributes：支持以下属性：
1. Action：Form中的ACTION属性，指定了完成Form中的操作用到的URL。
2. Method：表单提交方法：POST或GET（默认是POST）。
3. EncType：编码方式。
4. EncodeAtSign：是否使用ASCII值对符号“@”编码。Yes或者 No。
5. TargetFrame：包含当前链接或资源的Frame。参见List of Attributes的同名参数。
6. Referer、Mode：参见List of Attributes的同名参数。
ITEMDATA：数据域和属性的分隔符。
List of Data：
数据域列表定义了表单提交的内容。由于此请求是上下文无关的，因此数据域包含了所有的隐含域。使用Form的编码规则组织数据域。
数据域列表可以使用下面任意一种格式：
"name=n1", "value=v1", ENDITEM,
"name=n2", "EncryptedValue=qwerty", ENDITEM,
EXTRARES：分隔符，标记下一个参数将是资源属性的列表。
List of Resource Attributes：参见List of Resource Attributes。
LAST：结束标记符。
说明
web_submit_data函数处理无状态或者上下文无关的表单提交。它用来生成表单的GET或POST请求，这些请求与Form自动生成的请求是一样的。发送这些请求时不需要表单上下文。
当VuGen设为基于URL的录制模式，或者基于HTML的录制方式但是Recording Options—HTML Advanced 下的A script containing explicit URLs only 选项被选中时，web_submmit_data函数才会录制到。
不论你采用URL查询的方式（GET），还是采用请求体发送（POST）的方式，此函数都指示出Form中的数据是如何发送到服务器的。
如果VuGen处于HTTP录制模式下，此时记录Web进程时，会产生此函数。在提交Form时，如果无法生成web_submit_form函数，VuGen也会生成web_submit_data函数。
在录制选项中，Toos—Recording Option下—Recording选项中，有一个Advanced HTML选项，可以设置是否录制非HTML资源。只有选择了“Record within the current script step”时，List of Resource Attributes才会被录制到。非HTML资源的例子是gif和jpg图象文件。
EncType属性给出一个内容类型，指定其做为“Content-Type”请求头的值。它指示了根据参数生成HTTP请求时使用的编码类型（不是URL-encoding就是multi-part）可以是下面的格式：
1. “EncType=application/x-www-form-urlencoded”
2. “EncType=multipart/form-data” （任何的“; boundary=”都会被默认忽略掉）
3. “EncType=” (空串，表明没有产生内容类型（“Content-Type”）请求头）
任何对于“EncType”的指定都会覆盖web_add_[auto_]header函数指定的Content-Type。当省略了“EncType”时，任何一个web_add_[auto_]header函数都会起作用。如果既没有指定EncType也没有web_add_[auto_]header函数，且“Method=POST”，“application/x-www-form-urlencoded”会做为默认值来使用。其他情况下，不会产生Content-Type请求头。
ContentType：文件类型标识符，如果“EncType”是“multipart/form-data”用来上传文件时，需要用到“ContentType”。当在ITEMDATA中的Data子句中指定了“File=Yes”，且文件也在此子句中，ContentType才适用，此时它会作为同一个子句的值来传递。
正常情况下，“Content-Type”根据所上传文件的扩展名自动生成。例如：
7d025e2b16b064e\r\n Content-Disposition: form-data; name="uploaded_file"; filename="D:\\temp\\a.txt"\r\n Content-Type: text/plain\r\n \r\n
无论如何，对于非浏览器的程序来说是特殊的，根据文件类型生成的“ContentType”不一定是正确的。这时，通过手工指定来覆盖默认的“ContentType”。如果指定了空值，那么“Content-Type”头将不包含在文件中。
如果没有显示的指定“ContentType”的值，当上传的文件为空时，不管文件扩展名是什么，都默认使用“application/x-unknown-content-type”做为”ContentType”的值。
VuGen不会检查指定的ContentType是否有效。
通常情况下，如果录制了web_submit_data 函数，VuGen会把“name”和“value”一起录制到ITEMDATA一节中。如果不想在脚本中以明文显示“value”，可以对它进行加密。把“Value”改为“EncryptedValue”,然后把录制到的值改为加密后的值。请参考web_submit_form中相关的内容。
所有的Web虚拟用户，运行在HTTP模式下的WAP用户，运行在WSP回放模式下的WAP用户都可以使用本函数。
例子
下面的例子中，web_submit_data函数使用POST方法提交了一个表单。
web_submit_data("default.aspx",
"Action=http://lazarus/flightnet/default.aspx",
"Method=POST",
"TargetFrame=",
"RecContentType=text/html",
"Referer=http://lazarus/flightnet/",
"Snapshot=t7.inf",
"Mode=HTML",
ITEMDATA,
"Name=grpType", "Value=radRoundtrip", ENDITEM,
"Name=lstDepartingCity", "Value=DEN", ENDITEM,
"Name=lstDestinationCity", "Value=LAX", ENDITEM,
"Name=txtDepartureDate", "Value=8/19/2003", ENDITEM,
"Name=txtReturnDate", "Value=8/19/2003", ENDITEM,
"Name=txtQuantity", "Value=1", ENDITEM,
"Name=radClass", "Value=1", ENDITEM,
"Name=radSeat", "Value=1", ENDITEM,
"Name=btnAvailableFlights", "Value=Next >", ENDITEM,
LAST)；
下面的例子， web_submit_data函数使用POST方法提交了2个文件。
web_submit_data("Attachments",
"Action=http://barton.cottage@.Devonshire.uk/Attachments?YY=45434",
"Method=POST",
"EncType=multipart/form-data",
"TargetFrame=",
"RecContentType=text/html",
"Referer=http:///barton.cottage@.Devonshire.uk/Compose?YY=20435",
"Snapshot=t5.inf",
"Mode=HTML",
ITEMDATA, "Name=userFile0",
"Value=E:\\sense_sensibility\\Elinor.txt",
"File=yes",
"ContentType=text/html", // 覆盖了文本文件默认的“text/plain” 值。
ENDITEM,
"Name=userFile1",
"Value=E:\\sense_sensibility\\Marianne.jpg",
"File=yes",
ENDITEM,
LAST)；
没有评论:
发表评论