Creating Integration Models
  • 18 Oct 2024
  • Dark
    Light
  • PDF

Creating Integration Models

  • Dark
    Light
  • PDF

Article summary

Integration Models UI

The main user interfaces (UI) for creating and using Integration Models in Admin Essentials are described below. Please note that available views, features, and interactions in the UI can be limited based on user permissions.

How to Create an Integration Model

To create (import) an Integration Model:

  1. Login to IAP and navigate to Admin Essentials.

  2. Click the Import icon in the top toolbar to display the Import dialog.

  3. Select Integration Model from the dropdown. The Import File modal will display.

    Figure 1: Import Dialog
    01_importDialog

  4. You can upload your Integration Model File by drag-and-drop, or click Browse Files to find and select the file you want to upload.

    Figure 2: Import File Upload
    02_importFileUpload

  5. Once the file is uploaded, the Name of the Integration Model will pre-populate from the specification file, along with a description. You can change the description, as needed, to provide specific information for your import and to better communicate what this integration is used for within your platform.

  6. When you upload a Swagger 2.0 or OpenAPI 3.0 specification file, you can run validation on it using the Validate (✓) button. The OpenAPI specification file must be obtained from the targeted integration. For example, gitlab, amazon, and jenkins provide OpenAPI specifications that properly describe their APIs. Admin Essentials can ingest these files and enable integration with these technologies within IAP.

    Figure 3: Import Swagger File
    03_importSwaggerFile

  7. Once you click the Import button, and upon successful import, the Integration Model will be added to the collection list in the left sidebar.

    Figure 4: Integration Models
    04_IntegrationModels

  8. When you select the Integration Model from the collection list you will be redirected to the Integration Model Details page.

    Figure 5: Integration Model Details
    05_IntegrationModelDetails

Further Reading

Please refer to Current Limitations for additional information when creating Integration Models.


Was this article helpful?

Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.