Custom Connectors

Connectors help you connect to and exchange data with an application such as NetSuite, SAP, and Salesforce. While Adeptia Connect offers you some pre-bundled connectors, it also gives you the flexibility to add your custom connectors. 

You can add a REST or JDBC based custom connector to the application. 

This section guides you on how to add a custom connector and what all you need to have to accomplish this task. 

Adding a REST based Custom Connector

To add a REST based custom connector to your version of Adeptia Connect, you need to make sure that you have the Connector Package and the Implementation Package for that connector ready with with you. The instructions to create these packages are laid out in the following pages:

• Creating the Connector Package
• Creating Implementation Package

Complete the following steps to add a REST based custom connector.

1. Click Account > My Company.
2. In the left pane, click Connectors.
3. On the connectors' manage page, click Add Connector.
4. On the Add Connector page, provide a name and description for the connector in the respective fields with self-explanatory labels.

5. In the Select Connector Type field, select REST as the type of the connector.

6. In the Select Authentication Type field, select the authentication type/mode.

   For a REST type of Connector, there are two modes of Authentication, OAuth Based and API Token Based. Select Authentication Type as OAuth if the Connector requires OAuth authentication. Select Authentication Type as API Token based if you already have an access token and/or refresh Token.

   
   

7. Based on your selection of Authentication Type in the previous field, select either the OAuth Profile to be used or enter a comma separated list of key value pairs of Authentication Parameters.

   You also need to select the OAuth profile to be used for the OAuth process if you select OAuth based authentication.

   You need to provide the comma separated list of key value pairs of Authentication Parameters If you select Authentication Type as API Token based. The value of Authentication Parameters will be in the following format DisplayName:ParameterName. For example:

   Access Token:accessToken, RefreshToken:refreshToken

8. Click Browse..., navigate to the location of the Connector Package zip file, and select the file to upload. 

9. In the Provide Date Format field, enter the date format.

10. In the Provide Time Zone field, enter the time zone. 

    The previous two fields, Provide Date Format and Provide Time Zone are optional and used to fetch incremental data. 
11. Click Save.
    The newly added connector will now be visible on the connectors manage page. 
12. Add the Connector Implementation Package by completing the following steps:
    1. On the connectors manage page, click More Action (screenshot) against the new connector and select Add Implementation.
    2. Upload the zip file containing the connector runtime classes.

Adding a CDATA based Custom Connector

Follow the steps below to add a CDATA based custom connector.

1. Obtain the CDATA Accelerator for the required Connector from Support team.
2. Deploy this Accelerator using the Install Accelerator option of Migration Utility. 
3. Once the Accelerator is deployed, the new CDATA driver is added to the list of available Database drivers for creating DBInfos.
4. Click Account > My Company.
5. In the left pane, click Connectors.
6. On the connectors' manage page, click Add Connector.
7. On the Add Connector page, provide a name and description for the connector in the respective fields with self-explanatory labels.

8. In the Select Connector Type field, select JDBC as the type of the connector.

9. In the Select Database Driver field, Select the Database driver to be used for this connector

   The selected Database driver should be the one deployed through Migration Utility.

10. In the Provide Date Format field, enter the date format.

11. In the Provide Time Zone field, enter the time zone. 

    The previous two fields, Provide Date Format and Provide Time Zone are optional and used to fetch incremental data. 

12. Click Save.