Synchronizing CA Project and Portfolio Management [pre Sync 4.1] with IBM Rational Team Concert (using IBM Rational Team Concert SDK)

This section shows some common mappings between CA PPM® standard task attributes and IBM® Rational Team Concert™ standard task attributes.

Task mapping

For CA Project and Portfolio Management and IBM Rational Team Concert, this task-mapping should be used:

     <task-mapping conflict-notification-policy="Log">

Comment should not be used as a conflict notification policy, as CA Project and Portfolio Management does not support comments.

Required Repository Properties

Project

The project attribute identifies the project area of the repository to be used for synchronization. It is required for both IBM Rational Team Concert and CA Project and Portfolio Management.

ProxyStorageAttribute

The proxyStorageAttribute identifies an attribute that Tasktop Sync will use to store proxy information. It is required for CA Project and Portfolio Management. It is not necessary for IBM Rational Team Concert.

Required Attribute Mappings

In order for Tasktop Sync to synchronize new IBM Rational Team Concert objects into CA Project and Portfolio Management, the External Task ID attribute in CA Project and Portfolio Management must be mapped in an initialization-only configuration. See the CA Project and Portfolio Management Connector For Sync section for full information on the requirements for the External Task ID attribute. Here is an example of a mapping that could be used for External Task ID:

IBM Rational Team Concert Attribute CA Project and Portfolio Management Attribute
ID External Task ID

The mapping would be one way (from IBM Rational Team Concert to CA Project and Portfolio Management) and would have a mapping strategy of initialize.

The synchronizer.xml snippet corresponding to the above example would appear as:

        <attribute-mapping>
            <attribute id="task.common.key" strategy="initialize"/>
            <attribute id="id" strategy="ignore"/>
        </attribute-mapping>

Strings

String attributes do not need to be transformed with a caster and can be directly synchronized. Here is an example of a simple string mapping that could be used:

IBM Rational Team Concert Attribute CA Project and Portfolio Management Attribute
Summary Summary

Dates

A date caster is not needed when synchronizing between CA Project and Portfolio Management Attribute and IBM Rational Team Concert repositories. Dates may be synchronized directly.

Booleans

Boolean attributes do not need to be transformed with a caster and can be directly synchronized.

Value mapped attributes

Status and % Complete attributes

In CA Project and Portfolio Management, the values of the Status and % Complete attributes are linked. See the CA Project and Portfolio Management Connector For Sync section for details. This is a possible value mapping that can be used for Status:

IBM Rational Team Concert’s Internal State CA Project and Portfolio Management’s Status
Resolved Completed
Closed Completed
New Not Started
In Progress Started
Reopened Started

The synchronizer.xml snippet corresponding to the above example would appear as the following:

        <attribute-mapping>
            <attribute caster="value-map" id="status">
                <caster-configuration>
                    <map>
                        <entry value="1" key="2"/>
                        <entry value="0" key="1"/>
                        <entry value="2" key="3"/>
                        <entry value="1" key="6"/>
                        <entry value="" key="4"/>
                        <entry value="2" key="5"/>
                        <entry value="" key="7"/>
                    </map>
                </caster-configuration>
            </attribute>
            <attribute caster="value-map" id="internalState">
                <caster-configuration>
                    <map>
                        <entry value="2" key="1"/>
                        <entry value="1" key="0"/>
                        <entry value="3" key="2"/>
                    </map>
                </caster-configuration>
            </attribute>
        </attribute-mapping>

IBM Rational Team Concert does not have an attribute with equivalent behavior to % Complete. Therefore, it is recommended that the % Complete attribute either not be mapped or be mapped one way, from CA Project and Portfolio Management to IBM Rational Team Concert.

Other single select attributes

Other single select attributes, like EV Calculation Method, should be mapped using an appropriate value mapping, similar to that shown for Status above.

Limitations

Please check the Limitations sections of the CA Project and Portfolio Management and IBM Rational Team Concert documentation for details.