Schedule BI Publisher Report through OIC | Oracle Integration Cloud

In this article I have mentioned the steps to develop an Integration that can invoke "Schedule Report" operation and can check the status of submitted schedule report operation i.e. Job Status.

When to use Schedule Report & when to use run report operation ❓🤔   

• In laymen term , use 'Run Report' operation if report output size  is <10 MB and use 'Schedule Report' if report content size is >10 MB. Run Report operation can provide the report output in the webservice response but Schedule Report will generate the report output in FTP , UCM etc. ( know as report bursting )

Lets develop the  integration in two parts :

In Part 1 : we will see the development steps to invoke 'Schedule Report' operation and in Part 2 : we will see the development steps to check the Status of 'Schedule Report' operation.

Prerequisite : 'Schedule Service SOAP WSDL' Connection. Please access this link and create the connection. We will use the same connection while developing the integration below.

- Advertisement -

PART - 1 : Invoke Schedule Report Operation

Step 1 : Login to OIC Instance, click on Navigation Menu (top left) then click Integrations and then again click Integrations. Click on Create (top right) and select Scheduled Orchestration. Enter any meaningful name to the Integration.

Step 2 : Search for the Schedule Service Connection which we have created above in prerequisite section ( if you have not created it yet, you can access this link to create this connection ) and select it. Adapter endpoint configuration wizard will get opened :

• Enter any meaningful name (ex - ScheduleBIReport ) for the endpoint and click Next

- Advertisement -

• Select ScheduleReport operation from drop down list and then click Next

• Header configuration not require for this POC , so leave it as it is , just click Next

Knowledge :  😇

Headers are optional elements that pass extra information about your application requirements. For Example, the header element can be used to specify digital signature for password protected services.

• Adapter configuration completed. You can see the connection summary. Now click Done to close the configuration window.

- Advertisement -

Step 3 : Now open the mapper. Here we will pass the parameters name and its values that will be require to Schedule the Report.

• Below Columns Mappings are require to invoke Schedule BI Report operation

• Once the mapping completed, Click Validate and Close the mapping window.

- Advertisement -

PART - 2 : Schedule Report Job Status Check 

Step 4 :  Add Assign action to declare some variables.

• Click '+' to declare Variable to store count (i.e. while loop count ). Enter any meaningful name to the variable then click Edit 🖉 and hardcode value '1' for the variable

• Similar declare one more variable and initialize its value to '' (i.e. empty string) . You can take reference from below image. In this variable we will save 'GetSchedeuledReportStatus' operation response.

- Advertisement -

Step 5 : Add While Action. Enter any meaningful name.

• Click 'Expression Mode' and write the below expression. The while loop will keep running till the time below expression is true. ( Take reference from below image )

not(contains($GetScheduleReportStatus,"Success"))  and not( contains($GetScheduleReportStatus, "Error"))  and not( contains($GetScheduleReportStatus, "Failed")) and  xsd:integer($CounterVariable) <  xsd:integer('30')

- Advertisement -

Step 6 : In this step we will invoke 'getScheduledReportStatus' operation to get the status of the 'Schedule Report' operation (which we configured in PART 1, above). 

• Again search for the Schedule Report Service connection which we have created above in prerequisite section ( if you have not created it yet, you can access this link to create this connection ) and Select it.

• Adapter configuration window will get opened, enter any meaningful name and click Next

• Select 'getScheduledReportStatus' and click Next

• Header configuration is not require for this POC, just click Next.

• Adapter configuration completed. Click Done.

- Advertisement -

Step 7 : Open the mapper and map the 'ScheduleReportResponse' to 'ScheduledJobId' along with SaaS application credentials. ( take reference from below image )

Step 8 : Now add one more assign activity in which we will Increase the counter variable value and assign the 'GetScheduledReportStatus' operation response to the variable.

• Select the counter variable from drop down list, click Edit🖉 and increase the variable value by '1'.  Note : Make sure to use Integer function, Take reference from below image .

• Similarly select the another variable, click Edit🖉  and the map the *jobStatus element of 'GetScheduledReportStatus' Response.

• Click Validate and then click Close

- Advertisement -

Step 9 : Add Wait activity for 30 seconds inside While Loop. So that status check call happen after certain interval of time only otherwise While loop keep invoking status check  operation continuously, which is not a correct practice.

Step 10 :  Enable Tracking for the Integration.

Step 11 : Save and close the Integration window. Activate the integration. Your have successfully develop an Integration to Schedule BI Report and can check its status.

Thank you ! 😊 , TADA !! 👋.