Using CA Agile Central - QC connector to link CA Agile Central story to CA Agile Central test case

Document ID : KB000047896
Last Modified Date : 14/02/2018
Show Technical Document Details

Resolution

1.???? Create a test in QC:

User-added image
?
Notice a Formatted ID of CA Agile Central user story ?US93? in the CA Agile Central WorkProduct field that references a real story in CA Agile Central in the same CA Agile Central workspace/project indicated in the config file:
?
User-added image

The goal of this setup is to make sure that when a test is copied from QC to CA Agile Central, it is linked to a pre-existing user story in CA Agile Central by following the steps below. On CA Agile Central side the linking happens via a WorkProduct field of TestCase object.?
?
a)???? Create a user field in QC for Test artifact to hold CA Agile Central Formatted ID. The field must be of type String:

User-added image
?
b)???? Add this mapping to the <FieldMapping> section of the config file for tests/test cases:

<Field><CA Agile Central>WorkProduct</CA Agile Central><Other>TS_USER_02</Other></Field>
?
c)???? Add <RallyReferenceFieldHandler> to the <RallyFieldHandlers> section of the same config:
?
<RallyReferenceFieldHandler>
??? <FieldName>WorkProduct</FieldName>
??? <ReferencedFieldLookupID>FormattedID</ReferencedFieldLookupID>
??? </RallyReferenceFieldHandler>
</RallyFieldHandlers>
?
Here is an example of the syntax in the context of <Connector> section of the xml config file
?
<Connector>
??? <FieldMapping>
????? <Field><CA Agile Central>Name</CA Agile Central><Other>TS_NAME</Other></Field>
????? <Field><CA Agile Central>WorkProduct</CA Agile Central><Other>TS_USER_02</Other></Field>
????? <Field><CA Agile Central>Description</CA Agile Central><Other>TS_DESCRIPTION</Other></Field>
??? </FieldMapping>
??? <RallyFieldHandlers>
??? <RallyReferenceFieldHandler>
??? <FieldName>WorkProduct</FieldName>
??? <ReferencedFieldLookupID>FormattedID</ReferencedFieldLookupID>
??? </RallyReferenceFieldHandler>
??? </RallyFieldHandlers>
? </Connector>
?
2.???? Run the connector:

User-added image

User-added image

The? test case is created in CA Agile Central, linked to a CA Agile Central story:
?
User-added image
?