Manage cross references

This topic describes how to work with cross references. Cross references store the relationship between synchronized items.

Overview

After you synchronize items between data sources in Micro Focus Connect, their relationship is stored internally as a cross reference. Cross references can be exported. You can manually edit cross references in the exported file, and import them back into the same connection.

Cross references are managed at the connection level.

To export or import cross references:

  1. Click the gear-shaped Actions button in the top banner.
  2. Select Import Cross References, Export Cross References, or Export Cross Reference Template.

Back to top

Import/export use-cases

This section describes possible use-cases for exporting and importing cross references.

Use-case 1:

If an item in Product A was deleted, but you want the corresponding item in Product B to be associated with a different item, you can update the cross reference in the xml file, and re-import the file into the connection.

Use-case 2:

You are moving a configuration between Micro Focus Connect systems, but are not moving the whole configuration.

  1. In the originating system, export the cross references.
  2. In the destination system, export the cross reference template. For details, see Cross reference file format.

  3. Copy the syncset guid from the template and use it to replace the appropriate guid in the cross reference file from the originating system. These guids identify the Project Type Criteria that identifies a set.
  4. Import the modified file into the destination system.

Back to top

Cross reference file format

A cross reference file represents the relationship between the synchronized items. Use the code below as a template for a cross reference file.

  • The "adds" section includes the source-target references to be added.
  • The "removes" section includes source-target references to be removed.
Copy code
<?xml version="1.0" encoding="UTF-8"?>
<sets>
   <set syncsetguid="f5d70a92-eb4c-4de1-b9f5-de83968d9760">
      <source type="Defect" project="scen2_workspace" criteria="Type Rule: AND Application modules EQUALS 3002" />
      <target type="Bug" project="MFCSER:MFCSER board" criteria="Type Rule: " />
      <adds>
         <items>
            <item>
               <source>a source item id</source>
               <target>a target item id</target>
            </item>
         </items>
      </adds>
      <removes>
         <items>
            <item>
               <source>a source item id</source>
               <target>a target item id</target>
            </item>
         </items>
      </removes>
   </set>
   <set syncsetguid="a5d75269-4cce-46e0-8fa4-571cb7dd909f">
      <source type="Defect" project="scen2_workspace" criteria="Type Rule: AND Application modules EQUALS 3001" />
      <target type="Bug" project="MFCRES:MFCRES board" criteria="Type Rule: " />
      <adds />
   </set>
</sets>

Back to top