Develop > SMIS > Developing an Integration Template > Register an integration template in SMIS

Register an integration template in SMIS

You need to register an integration as a template in SMIS before it is available in the template list in SMIS. You can view or edit an integration template after it is registered in SMIS.

Register an integration template

To register an integration as a template, follow these steps:

  1. Register the general information of the integration template.

    1. Log on to Service Manager as a system administrator.
    2. From Database Manager, open the SMISRegistry.g form.
    3. On the General tab, enter the following information of the integration:

      Field Description
      Name Name of the integration template.
      Version Version of the integration template.
      Manager Class Name Script name of the manager of the integration.
      Controller Class Name Script name of the controller of the integration. If this field is left blank, a default controller is used.
      SM Adapter Name of the Service Manager adapter.
      Endpoint Adapter Name of the endpoint adapter.
      Instance Count Maximum allowed number of instances of the integration.
      Category Category of the integration (Schedule-based or UI-based).

      See the following screenshot for an example.

  2. Enter parameters required for the integration.

    1. Select the Parameters tab.
    2. If necessary, enter parameter categories for the integration.
    3. On the General Parameters and Secure Parameters tabs, enter parameters of the integration.

      Note Newly added parameter categories are not available in the Category list until the form is saved and then reopened.

      There is a default Global category. SMIS will initialize all parameters of this category to global variables, which can be used in Service Manager. These parameters can only be set to true or false.

  3. Edit the out-of-box mappings.

    1. On the General tab, click the Go to Configure Field Mapping link. The Registry Field Mapping page opens.

    2. On the Field Mapping tab, add or edit field mappings.

    3. On the Field Mapping tab, click Edit Callback to edit callbacks, or click Clear Callback to delete callbacks.

    4. On the Value Mapping tab, add or edit value mappings.

    5. Click Finish.

    Note The default fields in the drop-down list are defined in the getFields method of the Service Manager adapter and endpoint adapter. Each mapping value can be calculated by combining the direct mapping value, default value, value mapping table, and callback value. For information about the processing logic of mapping, see Processing Logic of the Mapping Functionality.

View or edit a registered integration template

Once you have registered an integration template in SMIS, a record is created in the SMISRegistry.g form. You can view or edit the integration template.

To view or edit a registered integration template, perform the following steps:

  1. Log on to Service Manager as a system administrator.
  2. From Database Manager, open the SMISRegistry.g form.
  3. Select the Parameters tab, and remove the Global category from the Parameter Category Definition pane.

    Note The Global category is a default category, which displays on the Parameters tab by default. If you do not clear it before performing a search, the search returns only those records with global parameters.

  4. Click Search. A list of integration templates displays.

  5. Select a record to view or edit the details. See Register an integration template.