Integration Instance Mapping

The mapping functionality of an integration instance converts values between Service Manager and the other product automatically. It is based on the following settings:

  • Value mapping - Each value mapping is based on the value mapping group table.
  • Field mapping - Map the value of a source field to the value of a target field and define the direction of the mapping.
  • Default value - Default value is used in the following situations:

    • No value mapping group is defined for this field and the source field value is empty.
    • A value mapping group is defined for this field but the value cannot be mapped within the value mapping group.
  • Callback - SMIS provides four callbacks for complicated field mappings, which provide the flexibility to implement corresponding business logic.
  • Condition - SMIS supports conditional value mappings and enables you to configure conditions.
  • Pre Script - The pre script can initialize variables so that succeeding processes can use these variables.
  • Post Script - If all the previous processes cannot fulfill your need, you can use the post script to perform additional process and store results into the mapObj object.

SMIS processes the above settings in the following sequence:

Field mapping > Pre Script > Value mapping > Default Value > Callback > Post Script

If you selected Import Mapping when adding an integration instance, the mapping template with out-of-box lists of predefined field mappings and value mappings become available.

The out-of-box field mappings and value mappings can be regarded as the minimum default settings for an integration instance to run. However, you can configure these default settings as necessary to suit your needs.

Related topics

Integration Manager
Service Manager Integration Suite (SMIS)
Integration Instance Information fields
Pre script
Post script

Add or delete an integration instance
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
Configure a condition