How to Map the CI Attribute to a Service Manager Web Service Field

The integration uses an adapter to transform UCMDB CI attributes to web services objects recognized by Service Manager. The adapter in turn specifies what XML transformation files the integration should use to convert UCMDB queries into properly formatted Service Manager web services messages.

Out-of-the-box, each integration query has a corresponding XML configuration file that maps to a particular CI type in UCMDB. In addition, each attribute for which you enabled calculation requires its own entry in the XML configuration file. Without an XML transformation entry, Service Manager cannot receive any CI attribute updates from your UCMDB system.

If you want to add a new attribute to the integration, you must edit the XML configuration file for the parent CI type and add an entry for the CI attribute. For information about which CI types each query manages, see Queries for Push.

The following steps illustrate how to map UCMDB CI attribute Comments (which you added previously) to the MyComments Service Manager attribute (which you created in the previous step).

To map a UCMDB CI attribute to an SM CI attribute:

  1. Log in to UCMDB as an administrator.
  2. Navigate to Data Flow Management > Adapter Management > ServiceManagerEnhancedAdapter9.41 > Configuration Files.
  3. Double-click the XML configuration file that manages the parent CI type of your CI attribute. For example, open SM Business Service Push 2.0.xml to add an attribute to the SM Business Service Push 2.0 query.
  4. Select the relevant CI type in the External Class Model pane (bizservice in this example), and drag and drop the attribute (mycomments) from the left-side Attributes pane into the Visual Mapping pane.

  5. Select the relevant Node in the Local Query panel (Root in this example), and drag and drop the attribute (comments in this case) into the mapping entry that you created in the previous step.

  6. Save the XML configuration file. The Comments attribute in UCMDB is now mapped to the MyComments attribute in Service Manager.

    Note When you create or edit and then save a configuration file in Adapter Management, UCMDB automatically restarts the adapter with the new configuration file.