7.2.8 Conditions of Variable String window

The Conditions of Variable String window is used to set variable strings and substitute strings, which enable PFM - Agent for Service Response to support the dynamic session management. In the Variable String page in the Properties window, click the Add or Edit button this window appears. This window consists of tabs for two pages:

Variable String page
Substitute String page

In this window, the following button is displayed:

Import button: Imports the settings of the variable string and substitute string. You can import the settings of the variable strings and substitute strings defined in another step. When you click this button, the Select Source of Variable String Settings window appears. When you import the variable string settings, the corresponding substitute string settings are also imported.

The following subsections describe the items displayed on each page.

Organization of this subsection

(1) Variable String page
(2) Substitute String page

(1) Variable String page

The Variable string page is used to specify which part of the recorded URL, message body, or Cookie is the variable string.

Figure 7‒18: Conditions of Variable String window (Variable String page)

The following describes the displayed items.

Setting of variable string:

Specifies the location containing a variable string and the variable string at the time of the record.

Location containing variable string

Select the location containing variable string from URL, Message body, or Cookie. URL is selected by default.

Variable string at the time of the record:

Specifies the variable string within the range from 1 to 4,095 bytes when recording. This is a required setting.

If there are multiple matched strings with the string specified in the Variable string at the time of the record in the URL, message body, or Cookie, the setting is applied to the first matching string from the beginning. If you substitute the other matched strings in the same way, it is recommended that you should replace the variable string part of the recorded URL, message body, or Cookie with $VAR1$ , $VAR2$ , or so. Modify the variable string part of the URL, message body, or Cookie in the Properties window of the modify target step.

Information at the time of the record:

Displays the information when recording.

Displays the URL, message body, or Cookie when recording on each section. You cannot edit this information.

To Page Top

(2) Substitute String page

The Substitute String page is used to specify the substitute string to substitute the variable string specified in the Variable String page.

Figure 7‒19: Conditions of Variable String window (Substitute String page)

The following describes the displayed items.

From HTML or HTTP header:

Select this to acquire the substitute string from the HTML file or HTTP header acquired earlier than this step.

List of substitute string settings:

Lists the settings of the substitute strings. When the Substitute string page appears, none is selected.

Note that when you specify the From Command, each substitute string setting is given as arguments to the command specified in the Command from top to bottom.

Add button

Add another substitute string. When you click this button, the Conditions of Substitute String window appears.

Note that when you specify the From HTML or HTTP header and already set the substitute strings, this button is deactivated.

Edit button

Edit the selected substitute string setting in the List of substitute string settings. When you click this button, the Conditions of Substitute String window appears. If you do not select the substitute string setting, displays an error message.

Delete button

Delete the selected substitute string setting in the List of substitute string settings. If you do not select the substitute string setting, displays an error message.

From Command:

Select this to acquire the substitute string from the command.

Command:

Specifies the absolute path name of the command and fixed arguments within the range from 1 to 4,095 bytes. When you specify the From Command, this is a required item. Note that any spaces, tabs, or linefeed characters preceding or following the entered character string are deleted

Note:

It is recommended that you specify the path name of the command enclosed by double-quotation mark (").

The command may be able to be executed incorrectly if the path name of the command is not enclosed by double-quotation mark and the path name contains space characters.

List of substitute string settings:

Displays the list of substitute string settings. When the Substitute String page appears, none is selected.

Note that when you specify the From Command, each substitute string setting is given as arguments to the command specified in the Command from top to bottom.

Add button

Add another substitute string setting. When you click this button, the Conditions of Substitute String window appears.

Note that when you specify the From HTML or HTTP header and set substitute string settings, this button is deactivated.

Edit button

Edit the selected substitute string setting in the List of substitute string settings. When you click this button, the Conditions of Substitute String window appears. If you do not select a substitute string setting, displays an error message.

Delete button

Delete the selected substitute string setting in the List of substitute string settings. If you do not select the substitute string setting, displays an error message.

URL encode at time of substitution. check box

Select this check box if you URL-encode all the strings when substituting the substitute string for the variable string. If this check box is not selected, PFM - Agent for Service Response does not URL-encode. This check box is not selected by default.

The following shows that PFM - Agent for Service Response URL-encodes:

Substitute string	Encoding procedure
Alphanumeric characters	Not encoded
Following characters: `* - . @ _`	Not encoded
Space characters	Encoded into `+`
Characters not listed above	Encoded into three-character string in the format of `%xy` for each byte (`x` and `y` are the hex numbers with each one representing 4-bits)

Note:

When you specify the From HTML or HTTP header, you can set only one substitute string. When you specify the Command, you can set multiple substitute strings.

Reference note:

From HTML or HTTP header is selected by default.

To Page Top