Share this page

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

## Example

The web_url call contains a call to the nca_configurator_parameterize_url function, which replaces the %-encoded URL parameter data (saved during Oracle Configuration initialization with the nca_configurator_start function and with the nca_oracle_set_ui_data function) into internal parameters (including, for example, the value for the icx_session_ticket).

Copy code

    nca_configurator_start("ORDER_CONTROL_BEANAREA_0", "CFG");
    web_reg_save_param("nca_cfg_first_page", "LB=", "RB=", LAST );
    web_url("CZInitialize.jsp",
             nca_configurator_parametrize_url("URL=http://myServer.myLab.ad:8000/OA_HTML/CZInitialize.jsp?getUiType=%3Cinitialize%3E%3Cparam+name%3D%22terminate_msg_behavior%22%3Ebrief%3C%2Fparam%3E%3Cparam+name%3D%22database_id%22%3Evis%3C%2Fparam%3E%3Cparam+name%3D%22context_org_id%22%3E204%3C%2Fparam%3E%3Cparam+name%3D%22config_creation_date%22%3E11-24-2008-15-09-52%3C%2Fparam%3E%3Cparam+name%3D%22calling_application_id%22%3E660%3C%2Fparam%3E%3Cparam+name%3D%22responsibility_id%22%3E21623%3C%2Fparam%3E%3Cparam+name%3D%22model_id%22%3E137%3C%2Fparam%3E%3Cparam+name%3D%22ui_type%22%3Ereturnui%3C%2Fparam%3E%3Cparam+name%3D%22pricing_package_name%22%3EOE_Config_Price_Util%3C%2Fparam%3E%3Cparam+name%3D%22price_mult_items_proc%22%3EOE_Config_Price_Items%3C%2Fparam%3E%3Cparam+name%3D%22atp_package_name%22%3Ecz_om_atp_callback%3C%2Fparam%3E%3Cparam+name%3D%22get_atp_dates_proc%22%3Ecall_atp%3C%2Fparam%3E%3Cparam+name%3D%22warehouse_id%22%3E204%3C%2Fparam%3E%3Cparam+name%3D%22requested_date%22%3E11-24-2008%3C%2Fparam%3E%3Cparam+name%3D%22customer_id%22%3E1290%3C%2Fparam%3E%3Cparam+name%3D%22customer_site_id%22%3E1425%3C%2Fparam%3E%3Cparam+name%3D%22configurator_session_key%22%3E196305%23180078%3C%2Fparam%3E%3Cparam+name%3D%22model_quantity%22%3E1%3C%2Fparam%3E%3Cparam+name%3D%22icx_session_ticket%22%3E3A48B1F1C6F55B27BB56865717B08AB5%3C%2Fparam%3E%3Cparam+name%3D%22save_config_behavior%22%3Enew_revision%3C%2Fparam%3E%3Cparam+name%3D%22read_only%22%3Efalse%3C%2Fparam%3E%3Cparam+name%3D%22client_header%22%3E94236%3C%2Fparam%3E%3Cparam+name%3D%22client_line%22%3E196305%3C%2Fparam%3E%3Cparam+name%3D%22sbm_flag%22%3ETRUE%3C%2Fparam%3E%3C%2Finitialize%3E&redirectFromJsp=true"),
            "Resource=0",
            "RecContentType=text/html",
            "Referer=",
            "Snapshot=t4.inf",
            "Mode=HTML",
            LAST );
    nca_configurator_set_ui_data("{nca_cfg_first_page}");

The corresponding icx_session_ticket data is found in the data sent by the server during replay:

    Server Message Properties: action=2 handlerClassId=0x10F handlerId=507
        property=402 type=0xE008 value=Message

    Sub Message Properties: action=2 handlerClassId=0x10F handlerId=507

            property=403 type=0x4000 value="+"

            property=404 type=0x4000 value="CFG:oracle.apps.cz.javaRenderer.BACfgClient:managerURL=http\//labmyServer.myLab.ad\8000/configurator/oracle.apps.cz.servlet.UiServlet:xmlAction=<initialize><param name="terminate_msg_behavior">brief</param><param name="database_id">labm1orcl05_vis</param><param name="context_org_id">204</param><param name="config_creation_date">10-27-2008-23-24-15</param><param name="calling_application_id">660</param><param name="responsibility_id">21623</param><param name="model_id">137</param><param name="ui_type">Applet</param><param name="pricing_package_name">OE_Config_Price_Util</param><param name="price_mult_items_proc">OE_Config_Price_Items</param><param name="atp_package_name">cz_om_atp_callback</param><param name="get_atp_dates_proc">call_atp</param><param name="warehouse_id">204</param><param name="requested_date">10-27-2008</param><param name="ship_to_org_id">1425</param><param name="configurator_session_key">159033#139880</param><param name="model_quantity">1</param><param
    name="icx_session_ticket">5261B7F4B8CD8767A27D30C9CBFC8A2D</param>
    <param name="save_config_behavior">new_revision</param><param name="read_only">false</param><param name="client_header">76156</param><param name="client_line">159033</param><param name="sbm_flag">TRUE</param></initialize>"

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: