Creating or Editing a Mapping File
Windchill Integrations for Embedded Software allows for the creation of additional mapped attributes between Windchill and the second-party or third-party defect tracking system for a Software Defect object.
Every DTS adapter context association must have an associated mapping file. The mapping file is selected from the pull-down list of mapping files in the Map Attributes step of the Associate Objects window during the procedure to associate a context to a DTS adapter.
Using an OOTB Mapping File
Standard OOTB mapping files are available from the list of mapping files for Integrity Defects, Bugzilla and Atlassian JIRA adapters in the Adapters Administration utility.
The Site or Organization administrator performs the setup of mapping files before customers can use
Windchill Integrations for Embedded Software. Refer to
Managing Context Associations and Mapping Files for more information.
If you want a customized attribute for a DTS adapter, update the OOTB mapping file.
1. From the Windchill server path for XML mapping files, locate the mapping file you want to use.
2. Open the mapping file in any text editor to modify it.
3. Add the mapping for the attributes in <DtsPdmMap>
Example: <DtsPdmMap dts=”cf_dtsAttribute” pdm=”ootb_attribute” type=”String” />
4. To save a new mapping file for a DTS adapter context association, save to a new file name.
5. To save changes to the existing mapping file, save with the same file name.
6. Ensure the mapping file is copies to the Windchill server path for XML mapping files. This is required so that it becomes available as a mapping file selection in Windchill Integrations for Embedded Software.
Using an OOTB Mapping Template
Standard OOTB mapping templates for Integrity Defects, Bugzilla and Atlassian JIRA adapters allow you to create a new mapping file for an adapter. These templates are installed locally during the server installation of Windchill Integrations for Embedded Software.
1. From the Windchill installation directory, locate the OOTB mapping file template you want to use.
2. Open the mapping file template in any text editor to modify it.
3. Add the mapping for the attributes in <DtsPdmMap>
Example: <DtsPdmMap dts=”cf_dtsAttribute” pdm=”ootb_attribute” type=”String” />
4. To save a new mapping file for a DTS adapter context association, save to a new file name.
5. To save changes to the existing mapping file template, save with the existing file name.
6. Copy the mapping file template to the Windchill server path for XML mapping files. This is required so that it becomes available as a mapping file selection in Windchill Integrations for Embedded Software.