Mapping system definitions across repositories

You can set up dependency builds in two different repositories, and duplicate the system definitions required for the builds. To ensure that files are built correctly in the separate repositories requires that you set up a system mapping for the repositories.

About this task

You have the same source files, streams, build definitions, and system definitions in two repositories for a build. They have the same contents, properties, and characteristics. However, the items in these repositories have different universally unique identifiers (UUID). When you deliver a source file from one repository to a stream in the other repository, the file fails to build because it is referenced to a language definition UUID that does not exist in this repository. A system definition mapping file enables the dependency builds of the files to be built correctly in both repositories.

Procedure

  1. In the Eclipse client, click the File > Export menu.
  2. In the Export window, expand System Definitions, select System Definition IDs, and click Next.
  3. In the Export System Definitions window, the Repository Connections field displays the repository connection. Select the types of system definitions to export from the repository, enter the path and the name of the XML file to be created, and click Finish.
    If an XML file already exists for this repository, click Browse to locate the file.
  4. Import the system definitions into the second repository using the XML file you created. In the Eclipse client, click the File > Import menu.
  5. In the Import window, expand System Definitions, select System Definition IDs, and click Next.
    Note: You must have the JazzAdmins authority and the permissions to save translators, language definitions, and resource definitions.
  6. In the Import System Definitions window, the Repository Connections field displays the second repository connection. Enter the location and name of the XML file to import.
    To use an existing XML file in this repository, click Browse to locate the file. To replace an existing system definition mapping file with the same name and location, select Overwrite existing system definition mappings.
  7. Click Finish.
    The system definitions are imported into the second repository.
  8. In the Team Artifacts view of the second repository, expand your project, right-click the System Definitions node, and select Edit System Definition Mappings from the menu.
  9. In the System Definition Mappings window, select a tab for one of the types of system definitions you are importing. Click one of the imported definitions and specify an existing definition in the second repository for mapping the imported definition.
  10. Select each tab for the types of system definition you are importing, select the imported definitions, and specify the existing definitions for the mappings of the definitions.
  11. When you have completed all of the mappings for the definitions, click Save.
    Note: You must have the JazzAdmins authority and the permissions to save translators, language definitions, and resource definitions.
    The system definitions are mapped into the second repository, and you can use them to run builds with the system definitions.