How to Enable or Disable UCMDB ID Pushback for a CI Type

When a new CI is created in UCMDB, a UCMDB ID value is assigned to the CI. When CIs are synchronized from Service Manager (SM) to UCMDB through population, the UCMDB ID Pushback feature can push their UCMDB ID values back to SM. The UCMDB ID field is then used as a flag to indicate if a CI has already been synchronized to UCMDB through population.

There are also cases when you do not want to enable the UCMDB ID pushback feature. For example, the scheduled_downtime CI type in UCMDB does not physically exist in SM. Instead, the integration retrieves Scheduled Downtime information from several entities in SM and then synchronizes the information to scheduled_downtime CIs in UCMDB. For this reason, the UCMDB ID Pushback feature is disabled by default for scheduled_downtime CIs; otherwise a pushback error will occur during population.

To enable UCMDB ID pushback for a CI type, follow these steps:

1. Add the following entries to your population configuration file for the CI type (for example, My Business Service Population.xml).

   <target_mapping name="sm_id" datatype="STRING" value="bizservice['CIName']"/>

   <target_mapping name="global_id" datatype="STRING" value="bizservice['UCMDBId']"/>

   Note In this example, bizservice is the CI Type display name defined in Service Manager and also the external class model name displayed in the UCMDB Visual Mapping interface, as shown in the following figures.

   

   

2. Save the XML configuration file.

3. Open the smPopConf.xml file, and make sure that the UCMDB ID Pushback setting for the CI type is either not present or is set to true:

   <pushback>

      <type name="business_service" enable="true"/>

   </pushback>

   Where: <type name> is the name of the CI type in UCMDB.

To disable UCMDB ID Pushback feature for a CI type, follow these steps:

1. Open the smPopConf.xml file.

2. In the <pushback> section, insert one line for the CI type:

    <config>
       <pushback>
           <type name="scheduled_downtime" enable="false"/>
           <type name="business_service" enable="false"/>
       </pushback>
       <mapping>
           <tql name="SM Business Service Population 2.0">
           ...
           </tql>
            …
       </mapping>
   </config>