Creating an RA Oracle ERP Cloud Agent Job or Job Set

This section describes how to declare an RA Oracle ERP Cloud Agent job or job set in AWI.

The RA Oracle ERP Cloud Agent job or job set should already exist in RA Oracle ERP Cloud Agent. The job is submitted to RA Oracle ERP Cloud Agent and run in the SAAS environment.

Connection

• Connection

  Enter the name of the RA Oracle ERP Cloud Agent Connection Object used to connect to the RA Oracle ERP Cloud Agent system.

• Process ID

  Optional. To automatically retrieve the job definition information, including parameters, run the job once in RA Oracle ERP Cloud Agent, copy the RA Oracle ERP Cloud Agent process ID and paste it in this field. 

  Then click Populate. The RA agent requests the job details from RA Oracle ERP Cloud Agent. The RA agent gets the job submission settings: its name, package etc, as well as the parameters of the job. AWI populates the corresponding fields with this data.

  If Populate fails, that could mean the Connection data or the request ID is not valid .

Job Definition

This section should contain the job identification in RA Oracle ERP Cloud Agent for the RA agent to submit the job in RA Oracle ERP Cloud Agent.

To automatically populate these fields, refer to Process ID.

• Job name

  Enter the name of the RA Oracle ERP Cloud Agent job or job set to submit. This name must exist in RA Oracle ERP Cloud Agent for the job / job set to be successfully submitted.

• Application name

  Enter the name of the RA Oracle ERP Cloud Agent application the job / job set belongs to.

• Package name

  Enter the name of the RA Oracle ERP Cloud Agent package the job / job set belongs to.

• Type

  You can choose either to create a Job or a Job Set.

Job Parameters

The job may need some parameters to run properly. The order of the parameters in the list is not relevant. The maximum number of parameters is 1000.

To automatically populate these fields, refer to Process ID. Then, only used submission parameters are loaded with the value they had during the job submission with the given process ID.

Click Add Row to display a new line where you can enter the parameter information.

For each parameter, enter:

• Position

  This setting is used to identify the job parameter. The position of the parameter must be the same as the parameter position in the RA Oracle ERP Cloud Agent job.

• Scope

  This setting is only displayed in case of a job definition of type Job Set.

• Type

  Optional. The type may be: String (by default), Boolean, Number or Date. The type must comply to the job parameter type in RA Oracle ERP Cloud Agent. Due to technical constraints, the agent can not retrieve the parameter type from RA Oracle ERP Cloud Agent, it is the user responsibility to enter the right type.

• Value

  The value is optional: The job can be successfully submitted with a parameter without value. 

  The value format depends on the parameter type. Start entering the value to display the help tools for data entry:

  • String: Enter a free text

  • Boolean: Select True or False (by default)

  • Number: Use the spinner arrows or enter the number directly in the value field. (0 by default)

  • Date: Enter the date and time. The interface checks that the format complies with those approved by Oracle, but - due to technical constraints - can not retrieve the right parameter format, it is the user responsibility to use the right format.

• Name

  The parameter name does not have to be the same as the parameter name in the RA Oracle ERP Cloud Agent job. It is entered as an information, it is not used to submit the job.

  It must be unique. The maximum length is 255 characters. It can contain special characters as / @ - _ é è à ç ç \ blank { } # ....