Share this page

# nca_configurator_parameterize_data

Oracle Configurator Functions

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

    LPCSTR nca_configurator_parameterize_data( LPCSTR data );

data | The XML string containing data whose contents should be correlated. The XML string is not %-encoded (URL-encoded).

nca_configurator_parameterize_data is a service function that substitutes parameter values 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_submit_data.

This function is recorded when the data that must be correlated is not based on a call to a URL and is in text XML format (not %-encoded).

Because the data are delimited by the XML < and > symbols, data that contain special values such as the # symbol (as used in the configurator_session_key) can be processed without conversion.

This function is similar to nca_configurator_parameterize_url, which correlates data that are %-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

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

## Example

The web_submit_data call contains a call to the nca_configurator_parameterize_data function, which substitutes the saves the data received during Oracle Configuration initialization with the nca_configurator_start function and with the nca_oracle_set_ui_data function into internal parameters.

Copy code

    web_reg_save_param("nca_cfg_dhtml_session_id", "LB=<input type=\"hidden\" id=\"sessionId\" name=\"sessionId\" value=\"DHTML", "RB=\"", LAST );
    web_submit_data("oracle.apps.cz.servlet.UiServlet_4",
            "Action=http://myServer.myLab.ad:8000/servlets/oracle.apps.cz.servlet.UiServlet",
            "Method=POST",
            "RecContentType=text/html",
            "Referer=http://myServer.myLab.ad:8000/OA_HTML/czCntnt.jsp",
            "Snapshot=t8.inf",
            "Mode=HTML",
            ITEMDATA,
            "Name=XMLmsg", nca_configurator_parametrize_data("Value=<client-event session-id='DHTML{nca_cfg_dhtml_session_id}'><show-config/><dhtml-cookie>oracle.uix=0^^GMT+2:00; JServSessionIdrootmyServer=aqjjrb4y51.okLGmk9JqAbGa34In6jQp65w/A5ycAzGp65wpR9xp30L/AfzrALvmwTvn3CLbx0Ka0--</dhtml-cookie></client-event>"), ENDITEM,
            "Name=sessionId", "Value=DHTML{nca_cfg_dhtml_session_id}", ENDITEM,
            LAST );

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