Add and enable an integration instance

Applies to User Roles:

System Administrator

To add an integration instance, follow these steps:

  1. Click Tailoring > Integration Manager. Integration Instance Manager opens.
  2. Click Add. The Integration Template Selection wizard opens.
  3. Select CaseExchangeSM_SM_Push from the Integration Template list, select the Import Mapping check box, and then click Next.

  4. Complete the fields on the Integration Instance Information page as necessary, and then click Next.

    For more information on how to configure this page, see Integration Instance Information fields.

  5. In the Integration Instance Parameters page, configure the following settings and use the default setup for all the other settings.

    Note You can modify the other fields according to your needs. For more information about how to modify the fields in this page, see Configuration details

    1. In the General tab, configure the following fields or options:

      Endpoint System runs Process Designer on the exchanged Object: Select this option if Process Designer is implemented in the endpoint system. Otherwise, do not select this option.

      Base URL: The value of this field represents the base URL of the endpoint API. For example, http://{endpoint server}:13080/SM/9

      User Name and Password: The credentials of the integration account in the endpoint system.

      Note  

      • The Password field must not be empty.
      • This account must be properly configured in the endpoint system. For more information, see Configure the integration account.

    2. On the Outbound tab, set the <Endpoint_instance_ID> in all rows of the Additional path column:

      {"CEIncidentPush": {"InstanceID": "<Endpoint_instance_ID>","InternalID":"${context.externalId}", "ExternalID": "${context.internalId}", "IncidentID":"${context.externalId}", "ExternalStatus":"${context.internalObject['problem.status']}"}}

      <Endpoint_instance_ID> is the ID of the SMIS integration instance in the other Service Manager system. You can find this ID under the Id column when you open Integration Manager in the other Service Manager system.

    3. If you need to exchange attachments, select the Activate attachment exchange option on the Attachment Handling tab.

  6. Click Next. The Integration Instance Fields page opens.
  7. Modify the default entries in the SM Fields and Endpoint Fields if you have customized fields. Otherwise, go to the next step.

    Note Endpoint field names must be the same as the caption names in web service CEIncidentsPush. For more information about the caption names configured in CEIncidentsPush, click Tailoring > Web Service > Web Service Configuration in Service Manager. In addition, you can refer to the out-of-box settings of the Field Name field in the Endpoint Fields tab.

  8. Click Next. The Integration Instance Mapping page opens.
  9. Configure field and value mappings if you have customized fields. Otherwise, go to the next step.

    For more information about how to edit the settings in this page, see the topics under Integration Instance Mapping.

  10. Click Finish.

To enable the integration instance, follow these steps:

  1. Click Tailoring > Integration Manager. Integration Instance Manager opens.

  2. Select the integration instance that you want to enable.
  3. Click Enable.
  4. Click Yes.