External Source Mapping Files

The data in the external source is mapped to a CI's attributes in UCMDB by means of a mapping file. The mapping files are located in the Adapter Management > Resources pane > Packages > External_source_import > Configuration Files folder:

  • mapping_template.xml. A template that serves as a source for creating the mapping file.

  • mapping_schema.xsd. The XML schema used to validate the XML mapping file. The XML mapping file must be compliant with this schema.

  • mapping_doc.xml. A file that contains Help on creating a mapping file, including all valid elements.

The mapping file describes the mapping only and does not include information about how data should be obtained. In this way, you can use one mapping file across different jobs.

All the adapter files in the External_source_import package include a mappingFile parameter, for example:

<parameter name="mappingFile" type="string" description="Mapping file located in &quot;Configuration Files&quot; folder of this package" />

name="mappingFile". The value of this parameter is the mapping XML file. The mapping file is always located on the server and is downloaded to the Data Flow Probe machine upon job execution.