May 18, 2022

Migrate Payroll Flows Pattern between Environments | Oracle HCM Cloud

In this article I have mentioned the steps to Import and Export the Payroll Flow Patterns from one environment to another. I have broken the whole article into two parts


Part 1 :   Contain the steps to Export the Payroll Flows from Source Environment.
Part 2 :  Contain the steps to Import the Payroll Flows to the Target Environment


PART 1 : EXPORT PAYROLL FLOWS :


Export process contain two things , first we have to 'Create Implementation Project' and then using this implementation project we have to 'Create Configuration Package '. Lets see the steps in detail :


 πŸ–Έ Create Implementation Project 

  • Sign In to the source environment and navigate to setup and Maintenance


  • Click on Manage Implementation Projects.



  • Click on ➕  to create a new Implementation Project.



  • Enter any meaningful Project Name inside section *Name. Click save and open project.

  • Click on ➕ to add Task to the implementation project.



  • Select ' Tasks ' in the search drop down menu list and in Name box enter 'Payroll Flow Patterns' and then click search button. Select the search result (Payroll Flow Patternsand then click Apply and then click Done.

  • Task successfully got added in the implementation project. Click on Done button ( at top right ). The implementation project creation is completed.


  


 πŸ–Έ Create Configuration Package 


Now lets Create and Export the Configuration Package from the Source Environment :  
  • Sign In to the target environment and navigate to setup and Maintenance


  • Click on ‘Manage configuration Packages’.



  • Click on ➕  to create a new configuration Package

  • Select the Implementation Project which we have created above and then click Next.

  • Now we need to select the object for export. Select the Payroll Flow Definition from the list and then click on ➕ icon 



  • Now search for the Payroll Flow Pattern which you want to migrate and once the search completed, select the flow and click on apply. Similarly add all the other flow which you want to migrate. Once all the flows are added , click Save and Close.


  • Click on Submit button ( top right ). Click Yes.

  • Export process will get started. Click on refresh πŸ”„ until the status is ‘Completed Successfully’.



  • Click on the download icon πŸ’ƒ and select ‘Download Configuration Package’.

One Note : It may complete with warning but still you can download it. Actually in one case I face the same issue but when I import it to target environment  it worked without any issue. So you can go ahead even if some warning is coming.


  • Configuration Package ( as a zip file ) will get downloaded. Export is completed and the configuration package is ready for migration.




PART 2 : IMPORT PAYROLL FLOWS :

Now Lets Import the configuration Package (which we have exported above, the zip file) from our local machine to the Target Environment.

  • Navigate to the Setup and Maintenance area under the Others tab on the Home Page.


  • From the tasks list, select Manage Configuration Packages and click Upload.


  • Click Browse to search and select the Zip file previously exported onto your local computer.




  • Click Get Details and then Submit.


  • Click ok and then click Import Setup Data at the bottom of the page



  • Just click Next, Next & then click Submit




  • Wait till the import process completes successfully. Click on RefreshπŸ”„ until the status changes to ‘Completed Successfully’.




This way we have Successfully Exported and Imported Payroll Flows from one environment to another. You can then use the Payroll Flow Patterns task and can search for the imported flow pattern. ✌

April 24, 2022

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.


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



    • 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.


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.


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.



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')




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.


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

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 !! πŸ‘‹.