Running ESS Job Set using OIC

Page 1 of 19
Table of Contents
1. Objectives..........................................................................................................................................3
2. Use Case............................................................................................................................................4
3. Create an ESS Job Set in Fusion.........................................................................................................5
3.1. Prerequisites to create an ESS Job Set........................................................................................5
3.1.1. Get the Short Names...........................................................................................................5
3.2. Creating an ESS Job Set...............................................................................................................6
4. How to call this ESS Job Set using Oracle Integration Cloud..............................................................9
4.1. Create the SOAP connection.......................................................................................................9
4.2. Get the details needed to do the mapping to submit the ESS Job Set......................................11
4.2.1. Get Name and Package Name...........................................................................................11
4.2.2. Get Application..................................................................................................................11
4.2.3. Get Parameters..................................................................................................................12
4.3. Create the OIC Integration to Call the Job Set..........................................................................12
5. Testing the Integration....................................................................................................................17
5.1. Run the Integration...................................................................................................................17
5.2. Get the Request ID....................................................................................................................17
5.3. Search for the request in the scheduled processes..................................................................18
6. References.......................................................................................................................................19
6.1. For ESS Job Set Creation...........................................................................................................19
6.2. For WSDL creation and ESS Job Set submission from OIC.........................................................19

Page 2 of 19
1. Objectives

This document is expected to give the step-by-step instructions on how to do the below.

1. Create an ESS Job Set in Fusion

2. How to call this ESS Job Set using Oracle Integration Cloud

Note: The normal REST adapter that is used to submit ESS Jobs could not be used for ESS Job Set as
the esswebservice was not available in this.

Page 3 of 19
2. Use Case

For explaining the creation of the ESS Job set I will be creating a Job Set with the below Jobs.

1. Validate Payables Invoices

2. Initiate Payment Process Request

This ESS Job set will then be called from an OIC Integration.

Page 4 of 19
3. Create an ESS Job Set in Fusion

3.1. Prerequisites to create an ESS Job Set

Before creating the ESS Job Set the below steps in collecting the information about the ESS Jobs that
are to be added to the Job Set need to be done.

3.1.1. Get the Short Names

1. Go to Setup and Maintenance -> Global Search

2. Search for “Manage Enterprise Scheduler Job Definitions and Job Sets for Financial, Supply

Chain Management, and Related Applications”

3. Now search for the Jobs to be added to the Job set.

4. Note down the Name and Job Application Name

Page 5 of 19
3.2. Creating an ESS Job Set

Steps to create the ESS Job set are.

1. Go to Setup and Maintenance -> Global Search

2. Search for “Manage Enterprise Scheduler Job Definitions and Job Sets for Financial, Supply

Chain Management, and Related Applications”.

3. Now go to the tab “Manage Job Sets”.

4. Click on Add (+)

5. Provide a Name, Display Name and a Custom Package Name (If required)

6. Under Job Set Steps choose serial/parallel depending on how you want your Jobs to run.

7. Click on Add Step (+)

8. Provide a Step ID (This will later be the scope name when running from OIC), and search for

the job with the short name.

Page 6 of 19
9. Add more steps as required

10. In the System Properties give the below

a. Name -> SYS_effectiveApplication

Page 7 of 19
 b. Value -> The job application name that was retrieved.

11. Save and Close.

12. Run the ESS Job Set to make sure it is working fine.

Page 8 of 19
4. How to call this ESS Job Set using Oracle Integration
Cloud

4.1. Create the SOAP connection

1. Login to Oracle Integration.

2. Go to Design -> Connections -> Create.

3. Search for the SOAP adapter.

4. Provide the name and click on create.

5. Provide the below details

a. For the WSDL instead of giving a WSDL URL a WSDL file will need to be created.

Follow the below steps for creating the WSDL.

i. Paste the link https://<host_name>/ess/esswebservice?wsdl in the browser

URL and download that WSDL.

ii. Paste the link https://<host_name>/ess/esswebservice?

WSDL=ESSWebServiceAbstract.wsdl in the browser URL and download that

WSDL.

iii. Now in the first WSDL search for “<import

namespace="http://xmlns.oracle.com/scheduler"

location="https://<host_name>/ess/esswebservice?

WSDL=ESSWebServiceAbstract.wsdl"/>” and replace this line with the

content of the second WSDL starting from <types> to end of the file

excluding the </definitions>

iv. Save this file and upload this file to the adapter.

Page 9 of 19
b. Now provide the security that you want to use.

c. Test the connection. Do a Validate and Test.

d. Save

Page 10 of 19
Note: The normal REST adapter that is used to submit ESS Jobs could not be used for ESS Job Set as
the esswebservice was not available in this.

4.2. Get the details needed to do the mapping to submit the ESS Job
Set

4.2.1. Get Name and Package Name

1. Login to Oracle ERP Cloud.

2. Go to Setup and Maintenance -> Global Search

3. Search for “Manage Enterprise Scheduler Job Definitions and Job Sets for Financial, Supply

Chain Management, and Related Applications”.

4. Now go to the tab “Manage Job Sets”.

5. Search for the Job Set to submit.

6. Get the name and package name from the below.

4.2.2. Get Application

1. Login to Oracle ERP Cloud.

Page 11 of 19
 2. Run the below query for the request ID of the Job set that was previously submitted.

SELECT requestid,

application,

definition

FROM fusion.ess_request_history

WHERE requestid = :requested

3. The application with be your application.

4.2.3. Get Parameters

1. Login to Oracle ERP Cloud.

2. Run the below query for the request ID of the Job set that was previously submitted.

SELECT *

FROM fusion.ess_request_property

WHERE requestid = :requestid

AND name LIKE 'submit.argument%'

AND name NOT LIKE '%.attribute%'

ORDER BY scope

3. Note down the Name, Value, Data Type and Scope.

4. These details will be mapped for the values that are not to be null.

4.3. Create the OIC Integration to Call the Job Set

1. Login to Oracle Integration.

2. Go to Design -> Integrations -> Create -> Application.

Page 12 of 19
3. Provide the name and click on create.

4. Given a connection to start the integration with action as POST.

Page 13 of 19
5. Add the ESS Job Set connection that was created. And do the below configurations.

a. Give a name and click on continue.

b. Select the ESSWebService and Operation submitRequest click on continue.

Page 14 of 19
c. Enable configure Custom SOAP Headers

d. Use the below xsd to create the MessageID and Actions SOAP Headers. You will

need to choose the file multiple times to add both the headers.

Page 15 of 19
 e. Continue and Finish.

6. Do the mapping using the data that was collected in the previous step.

a. For the Header give the MessageID as the instance ID and the action as

“submitRequest”.

b. Under Body -> jobDefinitionId give the name, package and application that was

collected earlier. Give the type as "JOB_SET".

c. Under requestParameters make the parameters to repeat as many times as the

number of parameters to pass. Use the datatype, name, value and scope that was

collected in the earlier step.

d. Validate the mapping and save the Integration.

Page 16 of 19
5. Testing the Integration

5.1. Run the Integration

5.2. Get the Request ID

Page 17 of 19
5.3. Search for the request in the scheduled processes

Page 18 of 19
6. References

6.1. For ESS Job Set Creation

1. https://medium.com/@amodjjoshi/how-to-create-ess-job-set-in-oracle-fusion-

ea5a1779f93e

2. https://docs.oracle.com/en/cloud/saas/financials/24d/fafcf/create-job-sets.html

6.2. For WSDL creation and ESS Job Set submission from OIC

1. https://support.oracle.com/epmos/faces/DocumentDisplay?

_afrLoop=330728318936792&id=2730653.1&_afrWindowMode=0&_adf.ctrl-

state=oefhwdtol_53

2. https://soavijaya.blogspot.com/2020/07/oic-invoke-oracle-fusion-ess-

scheduler.html#google_vignette

3. https://www.w3.org/2005/08/addressing/ -> To get the latest xsd file for the SOAP custom

Headers.

Page 19 of 19