Create Oracle Cloud API Service Follow

AuraPlayer service manager include special support for integrating with Oracle Cloud APIs. Watch the following video to get some basic understanding of this integration.

Demo video of Service Manager integration with Oracle Cloud APIs

In this article we will try to specify few more technical details on how to configure this integration and use it. 

How to load Oracle Cloud Module API's to Service Manager

Oracle Cloud API system is divided into few modules (e.g. HCM, Financials etc.). To create SM service for an Oracle Cloud API you first need to verify that this module API description file (Swagger file) is loaded. into the system. 

To do that, go to the "Studio" pane, click on the "Launch" button in the Oracle Cloud card and verify the module in the API list (see snapshot below)

If the request module is not in the list you need to do the following:

- Go to Oracle Cloud site (https://docs.oracle.com/en/cloud/saas/index.html)

- Get into the requested module (for example Inventory Management)

- Select "APIs & Schema" on the left side menu

- Select the group of API's you need 

- Press on the "Download" button on the left to download the swagger file

- Once you have downloaded the swagger file, go your ServiceManager admin section and press on the "Server Files" button

- On the server files pange, focus on the "Swagger" directory and press the upload button, select the API's file that you just downloaded from the Oracle site

- After uploading the file the new Module will be added to the list of available Oracle Cloud modules in Service Manager (see the first snapshot in this article)

How to create a new SM OCloud service

Creating of a new SM Oracle Cloud service is done from the Studio pane.  

Press on the "Launch" button in the Oracle Cloud card and select the requested API's module (if the module does not exist in the list, load it as described in the previous section)  

Once the module is selected, a window with the list of available API's for this module will be displayed and you will need to select a specific API

After pressing the "Create Task" button, a new service a pane will open

The first field you need to fill is the base URL of you Oracle Cloud module instance (for Example,  ORACLE_CLOUD_API = https://fa-eqih-dev17-saasfademo1.ds-fa.oraclepdemos.com/hcmRestApi/resources/11.13.18.05/). It is recommended to set this value as Environment variable as would need to be used in every service that you will create. 

Next you would need to set values to the relevant Input parameters. 

For clarity,  It is recommended to delete input and output parameters that are not going to be used for this service. 

Now you can click the "Create Service" button and test the service with different inputs.

The new ServiceManager service can now invoke specific Oracle Cloud API and will be managed as any other SM Service. The new service can be now integrated in any ServiceManager Mobile Application, RPA or Test.