Executing a Scenario Using a Web Service

20-26 Oracle Fusion Middleware Developers Guide for Oracle Data Integrator 2. Enter the following command to start a scenario. On UNIX systems: .startscenremote.sh scenario_name scenario_version context_code work_repository remote_agent_url odi_ user odi_password -l log_level -s sync_mode -n session_name -k session_keyword -a assign_variable -t timeout -i interval -h http_timeout -v Table 20–9 lists the different parameters of this command, both mandatory and optional. Table 20–9 Startscenremote command Parameters Parameters Description scenario_name Name of the scenario mandatory. scenario_version Version of the scenario mandatory. If the version specified is -1, the latest version of the scenario is executed. context_code Code of the execution context mandatory. -l log_level Level of logging information to retain. This parameter is in the format LEVELn where n is the expected logging level, between 0 and 5. The default log level is 5. Example: startscen.bat SCENAR 1 GLOBAL LEVEL5 work_repository Name of the work repository containing the scenario. remote_agent_url URL of the run-time agent that will run this session. odi_user Name of the user used to run this sessions. odi_password This user’s password. s sync_mode Execution mode: ■ 0: Synchronous ■ 1:Asynchronous Do not wait for session completion ■ 2: Asynchronous Wait for session completion. -n session_name Name of the session -k session_keyword List of keywords attached to this session. These keywords make session identification easier. The list is a comma-separated list of keywords. -a assign_variable Assign variable. Allows to assign a value to a variable for the execution of the scenario. variable is either a project or global variable. Project variables should be named Project Code.Variable Name. Global variables should be called GLOBAL.variable Name. This parameter can be repeated to assign several variables. Do not use a hash sign to prefix the variable name on the startscen command line. For Example: -a PROJ1.VAR1=100 -t timeout Timeout in seconds for waiting for session to complete if sync_ mode = 2. -i interval Polling interval for session status if sync_mode = 2. -h http_timeout HTTP timeout for the web services calls. Running Integration Processes 20-27 Monitoring a Session Status To monitor the status of a session from a command line via the web service: 1. Change directory to the agentbin directory of the Oracle Data Integrator installation. 2. Enter the following command to start a scenario. On UNIX systems: .getsessionstatusremote.sh session_number work_ repository remote_agent_url odi_user odi_password -w wait_mode -t timeout -i interval -h http_timeout -v Table 20–10 lists the different parameters of this command, both mandatory and optional.

20.11.12 Using the Run-Time Web Services with External Authentication

The web services examples in this chapter use an ODI authentication within the SOAP body, using the OdiUser and OdiPassword elements. When external authentication is set up for the repository and container based authentication with Oracle Platform Security Services OPSS is configured See Section 23.3.2, Setting Up External Authentication for more information, the authentication can be passed to the web service using HTTP basic authentication, WS-Security headers, SAML tokens and so forth. OPSS will transparently handle the authentication on the server-side with the identity provider. In such situation, the OdiUser and OdiPassword elements can be omitted. The run-time web services will first try to authenticate using OPSS. If no authentication parameters have been provided, OPSS uses anonymous user and the -v Verbose mode. Table 20–10 GetSessionStatusRemote command Parameters Parameters Description session_number Number of the session to monitor. work_repository Name of the work repository containing the scenario. remote_agent_url URL of the run-time agent that will run this session. odi_user Name of the user used to run this sessions. odi_password This user’s password. -w wait_mode Wait mode: ■ 0: Do not wait for session completion, report current status. ■ 1: Wait for session completion then report status. -t timeout Timeout in seconds for waiting for session to complete if sync_ mode = 2. -i interval Polling interval for session status if sync_mode = 2. -h http_timeout HTTP timeout for the web services calls. -v Verbose mode. Table 20–9 Cont. Startscenremote command Parameters Parameters Description