January 15, 2021

Invoke BI Report in OIC



In this article we will see the steps to invoke a BI Report in an Integration and then the steps to read its base64 encoded output.


we will do the development by breaking it into 2 parts :

PART 1 : Steps to invoke a BI Report
PART 2 : Steps to read the base64 encoded report output. 




Lets start the development : ~

PART 1 :  Steps to invoke a BI Report :

Lets develop one schedule integration where we will configure a soap adapter connection to call the BI Report using runReport Operation and then do the mappings. First we will create the connection and then create the integration.




Create Connection : 
Here we will configure  " ExternalReprtWSSService WSDL URL " which can be used to run a report. The same connection we will use in below steps while developing integration.
    • Navigate to connection window and select SOAP adapter, give any meaningful name for connection.



    • Enter the ExternalReportWSSService WSDL URL  and Select the TLS Version. TLS Version depends on your ERP Cloud Application Instance. Mostly it is TLSv1.1
WSDL URL Format : https://<your oracle cloud application instance domain>/xmlpserver/services/ExternalReportWSSService?WSDL


    • Enter the *Username and *Password of the Oracle Cloud Application Instance. Click SAVE and TEST the Connection.

 


Create Integration :
Here we will create the integration using the above configured SOAP connection, do the mappings of required field and then do one round of testing.
    • Create one Scheduled Integration by giving some meaningful name.

    • Search for the connection which we have created above and select it.

    • Enter some meaning full name(ex: invoke BI Report) and then click NEXT.


    • Select the operation = runReport and then click NEXT

    • In headers configuration window, select Accept attachments in response. Click Next
    • SOAP Endpoint configuration completed. Click Done.


STEP 2 :
Now let's do the MAPPINGS. We will pass all the required fields to invoke BI report ( like Report Path, Report Parameters Name and its Value etc.)



    • Expand the "parameterNameValues" element

    • Expand "Item" and then enter your BI Report Parameter name in name* element (as shown in below image)
    • Now expand values* and map or pass Parameter Values in Item element (as shown in below image)
    • Parameter names and its values configuration completed

*Note : suppose you have multiple parameters for your BI Report then you have to repeat the Item tag and then pass the Parameter name and its Values similar as in above Step 2.
(check below image for reference)



    • enter your report path in reportAbsolutePath* element

    • enter "-1" sizeOfDataChunkDownload*



Step 3 : Inside this step we will enable the tracking and do one round of testing.

    • Enable the Tracking



    • BI Report call configuration completed. Click save and Close the integration edit window.

    • Activate the integration 

    • Submit the integration by clicking Submit now and then click on Instance Id to track the flow 

    • Once processing succeeded , open the flow by clicking start time
    • Click on active stream and check the payload received as output from report



We have successfully develop and tested the BI Call in Integration πŸ˜€. Now in next blog we will further see the steps to read this base64 encoded output data i.e. PART 2 of development work. Click to see next blog.

2 comments:

If you have any doubts, Please let me know.

close