nca_configurator_parameterize_url

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

LPCSTR nca_configurator_parameterize_url( LPCSTR URL );

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

    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>"