Add or delete an integration instance

Applies to User Roles:

System Administrator

Before you can use an integration that is configurable in Integration Manager, you must add (and then enable) an instance of this integration.

To add an integration instance:

  1. Click Tailoring > Integration Manager. Integration Instance Manager opens.
  2. Click Add. The Integration Template Selection wizard opens.
  3. Select a template from the Integration Template list.
  4. If you want to use the field mappings provided with the template, select Import Mapping.

    Note A template becomes unavailable when the number of integration instances based on this template reaches a maximum value predefined in the template.

  5. Click Next. The Integration Instance Information page opens. Verify or complete the fields as necessary. For the description of each field on this page, see the related topics.

    Note Some fields are automatically populated with the information from the integration template. However, you can modify their values as necessary.

  6. Click Next. The Integration Instance Parameters page opens. This page contains all predefined parameters for the integration: General Parameters and Secure Parameters. You may set confidential parameters on the Secure Parameters tab, and the parameter values will appear as asterisks (*) for data security.

    Note You can modify the predefined parameter values as necessary. However, it is not recommended to add new parameters, modify parameter names or categories.

  7. Click Next. The Integration Instance Fields page opens. This page contains all predefined fields available for the integration:

    • SM Fields: Contains a list of fields at the Service Manager server side that can be mapped to endpoint fields.
    • Endpoint Fields: Contains a list of fields at the endpoint side that can be mapped to Service Manager server fields.
  8. Click Next. The Integration Instance Mapping page opens. This page contains all field mappings and value mappings between Service Manager server fields and endpoint fields. Review the mappings and make modifications to suit your needs if necessary.

    Note The field mappings are available if you selected Import Mapping in step 4. Otherwise, the Field Mapping tab is empty. You may need to add field mappings manually. For detailed instructions about how to configure mappings, see the related topics.

  9. Click Finish. The new integration instance is added.

To delete an integration instance:

Note Only integration instances in Disabled status can be deleted.

  1. Click Tailoring > Integration Manager. Integration Instance Manager opens.
  2. Select the integration instance you want to delete.
  3. Click Delete. This will delete the integration instance record, the corresponding Field Mapping records, and the scheduler record (for schedule-based integrations only).

Related topics

Integration Manager
Service Manager Integration Suite (SMIS)
Integration Instance Mapping
Integration Instance Information fields

Edit an integration instance
Add or delete field mappings
Edit field mappings
Configure value mappings
Enable or disable an integration instance
Monitor integration instance status
Monitor failover tasks
Configure a callback