nca_configurator_set_ui_data

Saves Oracle Configurator data from an HTTP service response as internal parameters for correlation during replay.

int nca_configurator_set_ui_data( LPCSTR ui_data_string );

nca_configurator_set_ui_data is an service function for Oracle Configurator that parses data received from HTTP service requests and creates internal parameters for each value to correlate when the script is replayed.

During replay, any session-specific values saved as internal parameters are converted into the relevant nca_configurator_parameterize_data and nca_configurator_parameterize_url functions.

The internal parameters are released when the Oracle Configurator session ends.

This function is recorded when HTTP service request data containing dynamic values are received, and the data will be needed for subsequent calls to the server. For example:

• When Oracle Configurator is started, one of the first web requests, getUiType, returns dynamic values for the Terminate ID and the Session ID. These values must be correlated.The web_url function includes a query for the getUiType special service. Text is returned that will be incorporated in a subsequent UI-related step and must be correlated. An example would be the terminateId and returnUisessionId values in the following sample text:

ui_type=DHTML

appletWindowMessage=applet message

terminateId=3038

txtDone=Done

look_and_feel=BLAF

returnUisessionId=returnui130

 

We recommend that the ui_data_string argument be a parameter created using the web_reg_save_param function to save the entire HTTP response.

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

Oracle NCA Error Codes

Parameterization

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