Mapping Reference Fields from CA Agile Central with a Connector
book
Article ID: 47904
calendar_today
Updated On:
Products
Rally On-PremiseRally SaaS
Issue/Introduction
These fields are found in artifacts (Hierarchical Requirement, Defect, Test Case, etc.) and are basically URLs which point to the another artifact in Rally. However, in the other system, those fields may appear to the connector as a string containing the actual name.
For the following Rally reference fields, the connector has special syntax when they are to be mapped:
mapping Iteration
mapping Parent
mapping Project
mapping Release
mapping Requirement
mapping TestCase
mapping TestCaseResult
mapping TestFolder
mapping WorkProduct
Cause
In Rally, some fields within an object (an artifact) are string values while other fields are actually pointers (called a "reference") to other objects.
Resolution
Mapping Reference Fields from CA Agile Central with a Connector
In order to map one of these fields:
Within the <Connector> section of the configuration file, specify the field to be mapped in the <FieldMapping> section
Within the <Connector> section of the configuration file, create a <RallyFieldHandlers> section
Within this section, specify the field in a <RallyReferenceFieldHandler> element
optionally, within this <RallyReferenceFieldHandler> element, specify a <ReferencedFieldLookupID> which will be used to represent this referenced object. Typical fields used here are "DisplayName", "FormattedID", "MiddleName", "Name", "ObjectID", etc. If this <ReferencedFieldLookupID> is not specified, then "Name" is used by default.