Data Mapping for Importing
By using a mapping file, you can import the configuration components that have different names or codes in the source system from the target system. Data mapping supports the following entities:• QXI receivers
• QXO source applications
• QXO subscribers
• QXO message publishers
Before importing data, you can either create a mapping file or generate one from an exported bundle file. A mapping file is an XML file with the extension of .mapping.xml. See the following examples for the structure of mapping files.Example:
• Structure for QXI mapping file
<?xml version="1.0" encoding="UTF-8"?>
<qxiCfgBundleActionMapping xmlns="urn:schemas-qad-com:qxtend-configuration">
<receiverMapping module="QADEE" source="RVR1" target="RVR_A"/>
<receiverMapping module="QADEE" source="RVR2" target="RVR_B"/>
</qxiCfgBundleActionMapping>
• Structure for QXO mapping file
<?xml version="1.0" encoding="UTF-8"?>
<qxoCfgBundleActionMapping xmlns="urn:schemas-qad-com:qxtend-configuration">
<sourceApplicationMapping sourceApplicationType="QADEE" source="SA1" target="SA_A"/>
<sourceApplicationMapping sourceApplicationType="QADEE" source="SA2" target="SA_B"/>
<subscriberMapping source="SB1" target="SB_A"/>
<subscriberMapping source="SB2" target="SB_B"/>
<messagePublisherMapping source="MP1" target="MP_A"/>
<messagePublisherMapping source="MP2" target="MP_B"/>
</qxoCfgBundleActionMapping>
Generating a Mapping File
To generate a mapping file from an exported bundle file:1 Copy the bundle file that you want to generate a mapping file from and paste it to
• <TOMCAT_HOME>/webapps/<QXI webapp>/WEB-INF/import for QXI
• <QXOServer_install_dir>/import for QXO
2 Locate the qxocfgbundle.sh file at
• <TOMCAT_HOME>/webapps/<QXI webapp>/WEB-INF/scripts for QXI
• <QXOServer_install_dir>/scripts for QXO
3 Run the following command.
• For QXI, run
./qxicfgbundle.sh -gm [bundle_file] -m [mapping_file]
• For QXO, run
./qxocfgbundle.sh -gm [bundle_file] -m [mapping_file]
The mapping file with the specified name is generated in the import folder. If you do not specify the mapping file name, the process fails.
Example: If you want to generate a mapping file named qxi_mapping.xml for QXI import, use the command:
./qxicfgbundle.sh -gm -m qxi_mapping.xml
Defining the Mapping Rules
In the mapping file you created or generated, define the source attribute and the target attribute for the configuration entities you want to map. See the examples for mapping file structure on here.