Editing the configuration item XML file

<Configuration item>.xml files are used to configure the mapping attributes for transferring TADDM discovery data to ServiceNow CMDB and to establish relationships between TADDM and ServiceNow CIs. Typically, these XML files have the same name as the configuration items that they map.

These XML files are preconfigured. You can customize the elements and associated attributes based on your requirements.

Open the <IntegrationPlugin path>/resources/config/mappingFiles/<CI>.xml file.
Based on your requirements, edit the elements and their attributes.
Note: Elements and attributes described in this section are preconfigured. Change them only if required.
You can edit following attributes of the <configurationItem> element:

[name] CI name or the name of the child CI

[targetTable] Target table at ServiceNow instance

You can edit following child elements of the <configurationItem> element:

[relationship] If set true, finds the relationship with parent CI

[outbound] or [inbound] Represents the type of relationship. For example, AppServer.xml contains outbound relation, FileSystem.xml contain inbound relation

[relation] Indicates the relation type or name of a CI at ServiceNow side

Configure Attribute [type] with value “dependent” for the dependent relationships of Service Now.

If Attribute [type] is not present, then the relation is taken as dependent relationship.

Configure Attribute [type] with value “suggested” for the suggested relationships of ServiceNow. For more details, refer PacemakerNode.xml file and below example 2.

[srcRelationType] Defines the relationship name at TADDM side

[srcAttributeType] Defines the relationship with other CI among the CIs. Defines the other CI (at TADDM side) with which the relationship exists for this CI

[targetAttributes] Represents the other CI with the relationship is being drawn. This finally results in the sys_ID of the other CI.

[targetRelationType] Represents the sys_id of the relationship (defined at ServiceNow side)

[targetClass] Represents the ServiceNow table name with which the relationship exists for this CI

[srcAttribute] CI attribute mapping

Child elements of the <srcAttribute > element:

[targetAttr] Represents the target attribute at ServiceNow.

[defaultValue] Default value of the target attribute.

[defaultValue] Default value of the target attribute.
Restart the plugin to apply the changes.

The following is an example of sample code:

<ciMapping> 
<configurationItem name="AppServer" targetTable="cmdb_ci_appl"> 
<!-- AppServer relation with Computer System --> 
<relationship value="true"> 
<outbound value="true"> 
<relation name="outbound_relations"> 
<srcRelationType name="RunsOn" /> 
<srcAttributeType name="ComputerSystem" /> 
<targetAttribute name="target" value="Host.Guid" /> 
<targetRelationType name="type" value="Runs on" /> 
<targetClass name="sys_class_name" value="cmdb_ci_hardware" /> 
</relation> 
</outbound> 
</relationship> 
<srcAttribute name="ConfigFile.URI" type="String"> 
<targetAttribute>config_directory</targetAttribute> 
<defaultValue></defaultValue> 
<magicMethod></magicMethod> 
</srcAttribute> 
</configurationItem> 
<!-- Sql Server --> 
<configurationItem name="SqlServer" targetTable="cmdb_ci_db_mssql_server"> 
<srcAttribute name="Name" type="String"> 
<targetAttribute>instance</targetAttribute> 
<defaultValue></defaultValue> 
<magicMethod></magicMethod> 
</srcAttribute> 
</configurationItem> 
</ciMapping>

<ciMapping>
	<configurationItem name="PacemakerNode"
		targetTable="cmdb_ci_unix_cluster_node">

		<!-- ComputerSystemCluster relationship -->
		<relationship value="true">
			<outbound value="true">
				<relation name="outbound_relations" type="suggested">
					<srcRelationType name="contains" />
					<srcAttributeType name="PacemakerCluster" />
					<targetAttribute name="target" value="Parent.Guid" />
					<targetRelationType name="type" value="Cluster of" />
					<targetClass name="sys_class_name" value="cmdb_ci_unix_cluster" />
				</relation>
				<relation name="outbound_relations" type="suggested">
					<srcRelationType name="realizes" />
					<srcAttributeType name="ComputerSystem" />
					<targetAttribute name="target" value="System.Guid" />
					<targetRelationType name="type" value="Hosted on" />
					<targetClass name="sys_class_name" value="cmdb_ci_server" />
				</relation>
			</outbound>
		</relationship>
		<srcAttribute name="Name" type="String">
			<targetAttribute>name</targetAttribute>
			<defaultValue></defaultValue>
			<magicMethod></magicMethod>
		</srcAttribute>

	</configurationItem>
</ciMapping>