Partner Guide

To deploy an integration through Pandium, you must first create the integration, and get it approved. The steps below will walk you through how to do so.

As a partner to an organization using Pandium, you have the ability to create, submit, and maintain integrations and marketing content from directly within the Pandium Admin Dashboard.
After your integration has been approved (which may include custom and/or required questions by the organization you are a part of), you will be able to create new tenants on behalf of your customers. Further, you are able to manage and maintain all tenants associated with your integration moving forward, thus making it easier than ever to support your shared customers.
Step 1: Navigate to the "Integrations" resource within the Admin Dashboard and hit "Create"
Step 2: Select the Type of Integration
Internal vs. External Integrations 
Internal integrations are fully powered by the platform, and require more advanced configuration. Pandium creates releases based on changes to your repository.
External Integrations are for creating integration tiles for pre-existing and third-party integrations. This is most relevant when embedding the marketplace, and wanting to show integrations that Pandium doesn't know are installed. See Embedding the Marketplace for more information.
External integrations are simple to setup, only requiring a link to the landing page, and an ID for how we should refer to this integration programmatically.
Step 3: Integration Setup
Connector Settings
If you've clicked 'Internal Integration', you'll be brought to the initial configuration page. The first step is to tell Pandium the connectors that your integration will be using. If you select the Global option, then you will only need to connect to it once, and then all of your tenants will share the same global secrets. 
Integration Details
Applying to both types of integrations, here is where you fill in the information you want displayed for end-user discovery as well as a unique identifier for your integration.
Repository Settings
Next is the repository settings, which is where you tell us where your integration code lives.
Repository URL:  A link to the repository Bitbucket, Azure, or Github. 
Repository Tracking Branch: You can tell us the branch to track for releases. Every time we see this branched pushed we will create a new Release.
Repository Path: Path to PANDIUM.yaml relative to the root of the repository. If left blank, we will look for the file in the root.
Scheduling
Here, you set the default schedule that the end-customer user will be able to select when setting up their integration. You can also set up a drop-down schedule so that your end-customer users are able to pick for themselves. In either case, you can use simple intervals, or use cron string format to define the frequency.

Lastly, you can determine if the tenant schedule is active or not on initial install by toggling the sync schedule.
Submission and Partner Questions
Once you've clicked 'Create' your configuration settings will be saved. If your Pandium admin partner has the option to set custom integration-level questions, and if there are any, you will see them on a following tab:
Selecting 'Save' will save your integration in your Drafts tab so that you may come back and finalize your integration later, while selecting 'Submit for Review' will move your integration to the In Review tab, and alert your partner manager that your integration has been submitted and is ready for approval.
Feedback
Your partner manager is able to send feedback on your integration if there is a need to edit or add information. You will see any feedback in a yellow box at the top of your integration configuration pages, as well as have an 'Requires Review' badge on your integration in the 'Pending' tab. 
Marketplace Setup
Once you've submitted the base configuration options for you integration, you'll be taken to the integration detail page. Here, you'll see 'Marketplace Setup' as an option near the top right. You'll be able to add/edit the theme and content of the actual marketplace tile that will show your integration. Your partner manager will also be able to edit this information on their end to better fit their theme if needed. 
More information on the specific options within these settings can be found in Marketplace Settings.
Once your integration is approved, you'll be able to view it under the 'Published' tab, create tenants, and view relevant metrics. 

GitHub

Next - Developing An integration

Anatomy of an Integration

Last modified 11d ago

Copy link

On this page

Step 1: Navigate to the "Integrations" resource within the Admin Dashboard and hit "Create"

Step 2: Select the Type of Integration

Internal vs. External Integrations

Step 3: Integration Setup