Managing Internal Integrations

In order to deploy an integration through Pandium, you must first create the integration. The steps below will walk you through how to do so.

What Are Internal Integrations?

An Internal Integration within Pandium refers to an integration where the code is running on the Pandium platform itself. In his scenario, developers will direct Pandium by providing the repository URL housing the integration code.

Pandium then creates images of the integration through Source Control, overseeing the authentication process, and handling all associated activities, or runs.

Managing Internal Integrations

After creating an internal integration, you will be directed to the primary integration detail page, where you can view and manage the integration. Here, you gain access to the the ‘Details’ section, housing relevant settings for the integration. These settings will automatically adjust to reflect any changes in the information. Additionally, the page features a table in the lower section, displaying relevant integration activities, tenants, and releases..

You will also see three tabs: Configure, Marketplace Setup, and Reprovision Connectors.

Configure

To access the configuration edit page, simply click on the 'Configure' option located at the top right corner of the integration detail page. Once clicked, you will be directed to a page that closely resembles the setup page used for internal integration creation.

Remote Repository Settings

Within the configuration edit page, you have the flexibility to modify the repository information associated with the integration. This includes the ability to change the source, branch, or yaml location, providing you with the control to tailor the integration to your specific needs.

Default Release

Under ‘Default Release’, you have the option to modify default release for the integration as well as the default release behavior for new tenants. To learn more about how each of our default release behaviors work, please view here.

Sync Schedule

Next, let’s explore the Sync Schedule configuration. These options determine the sync intervals available for end users configuring the integration. While Pandium provides commonly used sync intervals by default, you have the flexibility to fully customize these options. To edit the cron string, please use cron format. For assistance in creating cron strings, you can use the following tool: crontab guru.

Upon installation of an integration by an end user, these options will be viewed as a drop down that your customer may choose between. You are also able to choose whether the integration should be paused by default or set to automatically begin running upon installation.

Marketplace Settings

Moving on to Marketplace settings, clicking the ‘Marketplace Settings’ tab on the integration detail page will lead you to a page where various content, copy, and media relevant to the integration's display are set. Check out this article to learn more about how these settings work.

Reprovision Connectors

To manage connector provisioning, navigate to the ‘Reprovision Connectors’ tab on the integration detail page. Clicking this tab will redirect you to a separate edit page. If any of the connectors you selected during your integration configuration require credential changes at the integration level, those adjustments can be made or reset from this page.

Each connector features a 'Show Secret Keys' button. Clicking this button reveals the relevant environment variable formats used for this connector, useful for development of the integration.

To learn more about these secrets, please view the article on Environment Variable Secrets.

There is also the option to ‘Edit Connectors’, allowing you to add or remove connectors associated with the integration. Follow the prompts to make the desired changes, establish connections with new connectors if needed, and then close the page to save the modifications and return to the integration detail page. It is important to use caution when editing connectors on an active integration.

Last updated