Understand what external integrations to CDATA drivers are and how add them to your server environment.
CDATA integrates with a large library of third-party applications and services, including the following:
BambooHR
DocuSign
GitHub
Gmail
Microsoft Excel
Slack
ProcessMaker Platform simplifies integration with CDATA's drivers that seamlessly synchronize real-time data and streamline integration management.
ProcessMaker Platform integrates with CDATA's drivers in the following manner:
Administrators add a supported CDATA driver from Settings. Thereafter, configure authentication for that external integration.
Process Designers see the CDATA External Integration like any other Process model object. They add the external integration to their Process model, and then configure it for that object.
Display all CDATA External Integration settings in one location. This makes it easy to manage these settings.
Follow these steps to view all CDATA External Integration settings to synchronize users in your organization:
Ensure that you are logged on to ProcessMaker Platform.
Click the Admin option from the top menu. The Users page displays.
From the Settings panel on the left, expand the Integrations section.
Select External Integrations to view the following details:
Setting: The Setting column displays the External Integrations setting name.
Configuration: The Configuration column displays the value of the setting and how it is configured.
Follow the next steps to search for an External Integration setting:
In the Search setting, enter the Setting name to filter settings in that External Integration's configuration.
Click the +Driver button to add a CDATA driver. For more information on how to add an External Integration Driver, see Add a CDATA Driver.
Use the +Driver button to add a driver of a CDATA External Registration.
Follow these steps to add a CDATA driver for an External Registration:
​View your External Integrations. The External Registrations tab displays.
From the Select a Driver dropdown, select one of the following CDATA drivers:
BambooHR
DocuSign
GitHub
Gmail
Microsoft Excel
Slack
Click Add Driver.
Check each tab below to configure general information about CDATA External Integrations.
Before proceeding, ensure that you have the API Key from your registered BambooHR server. For information on how to obtain this key, see BamboHR's Getting Started with the API guide.
Follow these steps to connect to the BambooHR server:
​View your External Integrations. The External Integrations tab displays.
In the API Key setting, enter the API Key from your registered BambooHR account. For more information on how to get the API Key, see Authentication.
In the Domain setting, enter the domain from your registered BambooHR account. The domain is the text just before .bamboohr.com
for your domain.
Click Authorize. If authorization is successful, BambooHR will be listed as authorized on the External Integrations page.
Before proceeding, ensure that you have the client ID and client secret from your registered DocuSign driver.
Follow these steps to connect to the DocuSign server:
​View your External Integrations. The External Integrations tab displays.
In the Client ID setting, enter the client ID from your registered DocuSign driver. If testing DocuSign to get the client ID, see Enable OAuth for Connect.
In the Client Secret setting, enter the client secret from your registered DocuSign driver. If testing DocuSign to get client secret, see Enable OAuth for Connect.
Enable Use Sandbox if you are using a sandbox account.
Click Authorize. If authorization is successful, the External Integrations page lists DocuSign as authorized.
Before proceeding, ensure that you have the client ID and client secret from your registered GitHub driver.
Follow these steps to connect to the GitHub server:
​View your External Integrations. The External Integrations tab displays.
In the Client ID setting, enter the client ID from your registered GitHub driver. If testing GitHub to get the client ID, see Creating an OAuth app.
In the Client Secret setting, enter the client secret from your registered GitHub driver. If testing GitHub to get the client secret, see Creating an OAuth app.
In the Repository Name setting, enter the GitHub repository name to restrict query results.
In the User Login setting, enter the GitHub user name to restrict query results.
Click Authorize. If authorization is successful, the External Integrations page lists GitHub as authorized.
Before proceeding, ensure that you have the client ID and client secret from your registered Gmail driver. For information on getting the client ID and secret, see Google's Authentication API guide.
Follow these steps to connect to the Gmail server:
​View your External Integrations. The External Integrations tab displays.
In the Client ID setting, enter the client ID from your registered Gmail driver. For more information about how to get the client ID, see Obtain OAuth 2.0 credentials from the Google API Console.
In the Client Secret setting, enter the client secret from your registered Gmail driver. For more information about how to get the client secret, see Obtain OAuth 2.0 credentials from the Google API Console.
Click Authorize. If authorization is successful, the External Integrations page lists Gmail as authorized.
Before proceeding, ensure that you have the client ID and client secret from your registered Microsoft Excel driver.
Follow these steps to connect to the Microsoft Excel server:
​View your External Integrations. The External Integrations tab displays.
In the Client ID setting, enter the client ID from your registered Microsoft Excel driver. If testing Microsoft Excel to get the client ID, see Add a client ID and client secret.
In the Client Secret setting, enter the client secret from your registered Microsoft Excel driver. If testing Microsoft Excel to get the client secret, see Add a client ID and client secret.
From the Connection Type dropdown, select the service for storing and retrieving Microsoft Excel files such as Amazon S3, Azure Blog Store, Box, Dropbox, Google Cloud Storage, Google Drive, OneDrive, or SharePoint REST.
In the URI setting, enter the Uniform Resource Identifier (URI) for the Microsoft Excel resource location.
Click Authorize. If authorization is successful, the External Integrations page lists Microsoft Excel as authorized.
Before proceeding, ensure that you have the client ID and client secret from your registered Slack driver.
Follow these steps to connect to the Slack server:
​View your External Integrations. The External Integrations tab displays.
In the Client ID setting, enter the client ID from your registered Slack driver. If testing Slack to get the client ID, see Creating a Slack App.
In the Client Secret setting, enter the client secret from your registered Slack driver. If testing Slack to get the client secret, see Creating a Slack App.
Click Authorize. If authorization is successful, the External Integrations page lists Slack as authorized.
Click the Settings icon from the left sidebar to view all settings.
Click the Search icon or press enter to view External Integration settings display that match your entered text.
Click the Edit icon to change a setting. For more information on different External Integration configurations, see Configure a CDATA External Integration.
Click the Delete icon to delete a CDATA External Integration.
The Copy to Clipboard icon is deactivated in External Integrations.
Click the +Driver button. The Add Driver window displays.
Click the Edit icon next to BambooHR to view its settings. If you do not see BamboHR in the list, see instructions on how to dd the driver.
Click the Edit icon for the DocuSign setting. The DocuSign screen displays.
Use the copy icon to copy the URL from the Redirect URL setting, and then provide it to your OAuth identity provider.
Click the Edit icon for the GitHub setting. The GitHub screen displays.
Use the copy icon to copy the URL from the Redirect URL setting, and then provide it to your OAuth identity provider.
Click the Edit icon next to Gmail to view its settings. If you do not see Gmail in the list, see instructions on how to add the driver.
Use the copy icon to copy the URL from the Redirect URL setting, and then provide it to your OAuth identity provider.
Click the Edit icon for the Microsoft Excel setting. The Microsoft Excel screen displays.
Use the copy icon to copy the URL from the Redirect URL setting, and then provide it to your OAuth identity provider.
Click the Edit icon for the Slack setting. The Slack screen displays.
Use the copy icon to copy the URL from the Redirect URL setting, and then provide it to your OAuth identity provider.