You can create a synchronization rule so that when a ClearQuest® record is synchronized
with a Rational Team Concert™ item,
any attachments to the record and item are also synchronized.
Before you begin
Start the ClearQuest Gateway
before you use the Synchronization Rule editor.
About this task
After you create a synchronization rule for attachments,
reference that rule in the synchronization rules for mapping the ClearQuest record types to
Rational Team Concert items.
To
create a synchronization rule for attachments:
Show Me
Procedure
- In the Team Artifacts view, right-click
the repository connection and select . In the Synchronization
Rules view, right-click the project area and select .
- In the Synchronization Rule editor, enter a unique name
for the rule in the Name property.
- In the Type Mapping section, select
the Attachment - com.ibm.team.workitem item
type. The Item manager property is set to the manager that processes
attachments, Work Item Attachments Manager.
In the External manager property, select ClearQuest Manager
(non-user records). Select the external repository connection
in the External repository field. Select the
attachment record type in the External type field.
- In the Property Mappings section, click Initialize.
Select Name in the Property Mappings table.
Change Synchronization to In.
- Do not add a mapping for the Description property; it is
not supported and causes synchronization to fail with the error, "Invalid
Attachment property name: Description." If you added a mapping for
the Description property while using a previous release of the ClearQuest Connector,
remove it from the attachment synchronization rule.
- Click Save to save your synchronization
rule.
- Within the synchronization rule for the ClearQuest record type to which you want
to support synchronization of attachments, click Add to
add a property mapping. Select Attachment as
the Item property and Attachments as the External
property. Deselect No Transformation. In the Reference
synchronization rule list, select the rule that you created
for attachments. Select the Value transformer Work Item
Attachment Transformer. Click Save to
save your changes.