loadrunner Web_类函数之web_create_html_param（）

web_create_html_param（）

从HTML页面创建动态数据的参数。从LoadRunner 6.5开始已弃用。使用web_reg_save_param函数。
int web_create_html_param（const char * ParamName，const char * LeftBoundary，
const char * RightBoundary）;
 参数说明:
object:一个表达式，求值到类型为WebApi的对象。通常是web for Java和Visual Basic。另请参见函数和常量前缀。
ParamNam:要创建的新参数的名称。
LeftBoundary:指示参数或动态数据的左边界的字符串。边界参数区分大小写。输入空值（“”）以保存从参数中的页面开始到右边界的所有内容。
RightBoundary:指示参数或动态数据的右边界的字符串。边界参数区分大小写。输入空值（“”）以保存从参数中的左边界到页面结尾的所有内容。
web_create_html_param函数是一个用于在Web脚本中关联HTML语句的Service函数。 web_create_html_param函数检索重放期间生成的动态信息，然后将第一次出现的动态信息保存到参数。

注意：此功能对于6.5及更高版本已弃用，但支持向后兼容性。使用web_reg_save_param函数。
运行脚本时，web_create_html_param函数将扫描脚本访问的下一个HTML页面。 web_create_html_param函数搜索页面（包括其关联的HTTP响应标头），以查找左边界的出现，后跟任何字符串，后跟右边界。发现此类事件时，脚本将检索左右边界之间的字符串，并将该字符串保存到web_create_html_param语句中指定的参数。找到单个事件后，web_create_html_param函数将终止其搜索。
您可以使用web_set_max_html_param_len函数设置要保存的数据的最大大小。如果您的数据超过最大字符数（默认为256），此函数将失败。
要对动态数据的多次出现的语句进行关联，请使用web_create_html_param_ex。使用扩展版本的函数，可以指定将哪个数据实例保存为参数。
由于web_create_html_param函数仅在其后的Web步骤上生效，因此请确保在生成包含动态数据的HTML代码的步骤之前直接插入语句。
每个web_create_html_param语句仅检索动态数据一次。这意味着如果要在脚本中重新捕获另一个运行时值，则必须插入第二个web_create_html_param语句以检索参数的新值。
web_create_html_param_ex函数先搜索HTTP响应标头，然后再在相关HTML页面内搜索所需的字符串。
参数化与相关语句的不同之处在于，通过参数化，任何参数的可能值的完整列表在运行脚本之前是已知的。使用相关语句，只有在运行脚本时才确定参数的值。
所有Web脚本以及以HTTP或无线会话协议（WSP）重放模式运行的WAP脚本支持此功能。
单击关联HTML语句以了解在浏览Web脚本时关联HTML语句的主要步骤。

 

实例1，拷贝下面的HTML代码段。
首次访问：

<a href=/exec/obidos/subst/help/first–time–visitors.html/002–8481703–4784428>Buybooks for a penny </a>.</b>

 

当用户点击链接“Buybooks for a penny”时，

浏览器在/exec/obidos/subst/help/first-time-visitors.html/002-8481703-4784428上显示HTML页面。编号002-8481703-4784428是每次用户访问站点时更改的参考号，并且仅对该会话有效。要将此动态数字保存到参数，您可以使用create_html_param函数，其中“first-time-visitors.html /”是左边界，“>Buy booksfor a penny”是右边界。左边界和右边界（002-8481703-4784428）之间的字符串保存到名为“user_access_number”的参数。检索此动态数字后，您可以在脚本中的任何位置使用它。

The output is:

Notify: Saving Parameter "user_access_number =002–8481703–4784428"

web_create_html_param(

"user_access_number",

"first–time–visitors.html/",

">Buy books for a penny");