web.convertFromFormatted

Converts a string created with one or more data format extensions back to the source format.

Syntax

             web.convertFromFormatted ( {object} );

JavaScript Object

{  
   formattedData:"<string>",
   targetParam:"<string>",
   extensions:"<string>"
}

Argument	Description
formattedData	The data to convert. If the extensions argument is omitted, include the wrapping XML tags that specify the extensions. Additional information about the formatted data can be provided with Data Format Qualifiers.
targetParam	The name of a parameter. The converted string will be saved in this parameter.
extensions	A comma separated list of the names of the data format extensions that generated the formatted data. The extensions are listed in the reverse order to the order used to create the formatted string. The extension names are the values of the `Extensionname` parameter from the extension INI files. For example, if the formatted data was generated by applying extension B on the output of extension A, the extension list is "A,B".

Return Values

Not applicable

Parameterization

You cannot use standard parameterization for any arguments in this function.

General Information

The web.convertFromFormatted function converts a string created with one or more data format extensions back to the source format.

This function can be used if Data Format extensions are enabled in the Runtime Settings.

For details of the data format extensions provided and of the settings required to use this feature, see the Virtual User Generator Help Center (select the relevant version).

Data Format Qualifiers

Formatted data can be qualified. Only one qualifier can be used. For formatted text, no qualifier is used. The qualifiers are:

formattedData/Escapedbinary - The data is a null-terminated string containing binary code represented with escaped characters. This data is converted to binary before being passed to the first data format extension. See Using binary code.

formattedData/binaryParam - The data is the name of a parameter containing the formatted data in binary format.

Example

web.convertFromFormatted ({
	formattedData:"username=dfe&password=dfe&login.x=17&login.y=8",
	targetParam:"Param",
	extensions:"Base64"
	} );