Oracle NCA Vuser Functions (NCA) > Alphabetical List of Functions > nca_configurator_parameterize_url

nca_configurator_parameterize_url

Example: nca_configurator_parameterize_url Oracle Configurator Functions

Returns the input URL after substituting Oracle Configurator-related information.

LPCSTR nca_configurator_parameterize_url( LPCSTR URL );

URL The string containing a URL in whose contents should be correlated. The string is in %-encoded (URL-encoded) XML format.

nca_configurator_parameterize_url is a service function that replaces parameter values in an XML string that is %-encoded (URL-encoded) with session-specific data from the Oracle Configurator engine.

Session-specific information is received from the server during the Oracle Configurator initialization and subsequent HTTP service requests. This information is saved as internal parameters by the nca_configurator_start and nca_configurator_set_ui_data functions. The internal parameters are released when the Oracle Configurator session ends.

This function is used to create an input argument to another function, such as web_url.

Examples of %-encoded data that are correlated include icx_session_ticket and configurator_session_key.

Because the data processed by this function are %-encoded, data that contain special values such as the # symbol (as used in the configurator_session_key) must be converted (for example, to %23) so they can be processed.

This function is similar to nca_configurator_parameterize_data, which correlates data that are in text XML format (not %-encoded).

This function minimizes the amount of manual correlation the user must do. There is usually no need to insert this function or change its argument values after recording.

Return Values

This function returns the value of the specified string.

Parameterization

All arguments can be parameterized using standard parameterization.