Share this page

# 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.

Tips to improve your search results... VuGen Function Reference Version 25.1-25.3 Function Reference 25.1-25.3 All View Local Help Center View Online Help Center Version: