JavaScript Functions > Alphabetical Listing of Web Functions > web.convertFromFormatted

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 Run-Time Settings.

For details of the data format extensions provided and of the settings required to use this feature, see the VuGen User Guide.

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"
	} );