Process of Building Adapter using Rapid Adapter Builder (RAB) | Oracle Integration

This article demonstrates the process of building an Adapter using Rapid Adapter Builder (RAB).

The previous article describes what is Rapid Adapter Builder. Please refer to the previous article, before you get into this article.

1. Get the OIC credentials:

   • Create a confidential application in the identity domain with grant type as client credentials.
   • Assign the ServiceDeveloper role to the confidential application.
   • Obtain the client id, client secret, and scope from the generated confidential application.
   • Obtain the OAuth token URL.

2. Ready with the POSTMAN collection:

   • Collect the Open API document / REST APIs of the application you want to develop an adapter for.
   • Postman collection for the operations you want to encapsulate in the adapter.
   • Save sample responses of all the APIs in POSTMAN.
   • Export the collection.

3. Download Visual Studio code and add RAB extension:

   • Download and Install Visual Studio Code (VS Code) on your local machine.
   • Add the Oracle Integration Cloud Rapid Adapter Builder extension in VS Code.

4. Initialize Workspace in VS Code:

   • Prepare the workspace for the adapter using RAB: Initialize Workspace command.
   • The command generates the skeleton for the adapter.
   • A few folders will be generated automatically once the Workspace is initialized.
   • Import the Postman collection under the misc directory.

5. Configure publisher-profiles.yaml:

   • The publisher-profiles.yaml contains the Oracle Integration instance credentials gathered in step#1.
   • These credentials will be used to publish the adapter in a specific Oracle Integration instance.

6. Generate the Adapter Definition Document (ADD):

   • To publish an adapter to Oracle Integration, you must define the specifications and functions of your adapter in a JSON-metadata file, termed the Adapter Definition Document (ADD).
   • An ADD typically describes the design and implementation of an adapter.
   • Right-click the Postman collection and click RAB: Convert Postman Collection. It automatically generates the ADD document by taking all the inputs provided in the Postman collection, along with the security policy, operations, schemas, etc.
   • Modify the generated ADD as required.

7. Validate and Publish the adapter:

   • Once the Adapter Document Definition is ready, validate the ADD to make sure it is correct and valid.
   • Register the adapter once it is validated with an RAB: Register RAB Bundle command.

8. Look at your adapter in Oracle Integration and use it:

   • Find your adapter under the Adapter page.
   • Create a connection and use it.

Please look at the following video, to know more details.

If you found this article valuable, we would greatly appreciate your support through likes, comments, and shares. Additionally, we invite you to subscribe to our YouTube channel for more insightful videos. Don’t miss out on our latest updates – be sure to click the subscribe button to stay informed about our newest content.

Further readings:

Understanding of Rapid Adapter Builder (RAB)

About the Salesforce REST Adapter

Leveraging Salesforce REST adapter to push accounts to Database

OData adapter in Oracle Integration-3

Place the file in ATP from BIP using OIC

Place the file in Object Storage from BIP using OIC

How to write files using an OIC FTP adapter