提出这个函数来让自己记住：web_reg_save_param

Theweb_reg_save_paramfunction is aService functionused for correlating HTML statements in Web scrīpts.

Clickherefor an overview on Correlation.

web_reg_save_paramis a registration type function. It registers a request to find and save a text string within the server response. The operation is performed only after executing the nextaction function, such as web_url.

web_reg_save_paramis only recorded when correlation during recording is enabled (see VuGen's Recording Options). VuGen must be in either URL-based recording mode, or in HTML-based recording mode with theA scrīpt containing explicit URLs onlyoption checked (see VuGen's Recording Options).

This function registers a request to retrieve dynamic information from the downloaded page, and save it to a parameter. For correlation, enclose the parameter in braces (e.g. "{param1}") in ensuing function calls which use the dynamic data. The request registered byweb_reg_save_paramlooks for the characters between (but not including) the specified boundaries and saves the information that begins at the byte after the left boundary and ends at the byte before the right boundary. If you expect leading and trailing spaces around the string and you do not want them in the parameter, add a space at the end of the left boundary, and at the beginning of the right boundary. For example:

For example, if the Web page contains the string, "Where and when do you want to travel?", the call:

web_reg_save_param("When_Txt", "LB=Where and ", "RB= do",

              LAST);

with a space after "and" and before "do", will result in "when" as the value of When_Txt. However,

web_reg_save_param("When_Txt", "LB=Where and", "RB=do",

              LAST);

without the spaces, will result in a value of " when ".

Embedded boundary characters are not supported.web_reg_save_paramresults in a simple search for the next occurrence after the most recent left boundary. For example, if you have defined the left boundary as the character `{` and the right boundary as the character `}', then with the following buffercissaved:

          {a{b{c}

The left and right boundaries have been located. Since embedded boundaries are not supported, the `}' is matched to the most recent `{` appearing just before thec. The ORD attribute is 1. There is only one matching instance.

Theweb_reg_save_paramfunction also supports array type parameters. When you specify ōRD=All, all the occurrences of the match are saved in an array. Each element of the array is represented by theParamName_index. In the following example, the parameter name isA:

web_reg_save_param("A", "LB/ic=<a href=", "RB=\'>", "Ord=All", LAST);

The first match is saved asA_1, the second match is saved asA_2, and so forth. You can retrieve the total number of matches by using the following term:ParamName_count. For example, to retrieve the total number of matches saved to the parameter array, use:

TotalNumberOfMatches=atoi(lr_eval_string("{A_count}"));

The following table indicates how to use the boundary parameters to save portions of the parameter string:

This function is supported for all Web scrīpts, and for WAP scrīpts running in HTTP or Wireless Session Protocol (WSP) replay mode.

List of Attributes