Einige ClearQuest-Datensatztypen
enthalten Felder, die Verweise auf Felder in anderen Datensätzen darstellen.
Wenn diese Referenzfelder
verbindlich sind, müssen Sie eine Methode bereitstellen, die diesen Feldern bei der Synchronisation einen
Wert zuordnet.
Sie können ein angepasstes Attribut eines Arbeitselements einem Feld eines Verweisdatensatzes
zuordnen. Zur Einrichtung dieser Zuordnung müssen Sie die Konfiguration des Projektbereichsprozesses
und die Synchronisationsregel für den Datensatztyp bearbeiten. Das Beispiel in den folgenden Schritten geht
davon aus, dass das Schema einen statusunabhängigen Datensatztyp mit dem Namen 'OS' enthält, der wiederum
ein Feld mit dem Namen 'Name' enthält. Der Datentyp 'Defect' ('Fehler') enthält ein Feld mit dem Namen
'FoundInPlatform', das ein Verweis auf einen OS-Datensatz darstellt.
Gehen Sie wie folgt vor, um ein Verweisfeld zuzuordnen:
Animation
- Öffnen Sie im
Rational Team Concert-Client
die Ansicht Teamartefakte.
- Klicken Sie mit der rechten Maustaste auf Ihren Projektbereich und wählen Sie Öffnen aus.
- Klicken Sie im Projektbereichseditor auf die Registerkarte Prozesskonfiguration. Erweitern Sie
Projektkonfiguration, Konfigurationsdaten und anschließend
Arbeitselemente. Klicken Sie auf Typen und Attribute.
Wählen Sie
die Kategorie für den Arbeitselementtyp aus. Klicken Sie im Bereich Angepasste Attribute auf
Hinzufügen. Geben Sie einen Namen für das Attribut ein und wählen Sie einen Typ aus, der mit
dem Typ des entsprechenden ClearQuest-Felds
kompatibel ist. Beispiel: 'Gefunden in Plattform' und 'smallString'. Klicken Sie auf OK.
Klicken
Sie auf Speichern, um Ihre Änderungen an diesem Arbeitselementtyp zu speichern.
- Klicken Sie in der Ansicht Teamartefakte mit der rechten Maustaste auf die Repository-Verbindung
und wählen Sie aus. Klicken Sie in der Ansicht Synchronisationsregeln mit der rechten Maustaste
auf den Projektbereich und wählen Sie
aus.
- Geben Sie im Editor für Synchronisationsregeln einen Namen für die Regel ein. Beispiel: com.ibm.rational.clearquest.sample_schema_repo.FoundInPlatform.
Lassen Sie die Felder Elementtyp und Elementmanager
leer. Geben Sie einen Namen in das Feld Externer Typ ein, der den
ClearQuest-Datensatztyp
bezeichnet. Beispiel: 'com.ibm.rational.clearquest.sample_schema_repo.OS' bezeichnet den Datensatztyp
'OS', der das Feld enthält, auf das vom Feld 'FoundInPlatform' verwiesen wird. Wählen Sie im Feld
Externer Manager die Option ClearQuest-Manager (keine Benutzerdatensätze)
aus.
Klicken Sie im Abschnitt 'Eigenschaftszuordnungen' auf Hinzufügen.
Geben Sie im Feld Externe Eigenschaft den Namen des Felds in dem Datensatz ein, auf
den von dem anderen Feld verwiesen wird. Beispiel: Das Feld 'FoundInPlatform' verweist auf das Feld 'Name' im
Datensatztyp 'OS'. Wählen Sie Externe Kennung aus. Klicken Sie auf OK.
Klicken Sie auf Speichern, um die Synchronisationsregel zu speichern.
- Klicken Sie in der Ansicht Synchronisationsregeln doppelt auf die Synchronisationsregel
für den Datensatztyp, der das Verweisfeld enthält, um den Editor für Synchronisationsregeln zu öffnen.
- Klicken Sie auf Hinzufügen, um eine Eigenschaftszuordnung hinzuzufügen.
Wählen Sie im
Feld Elementeigenschaft das angepasste Attribut aus, das Sie erstellt haben. Beispiel: Gefunden in
Plattform. Wählen Sie im Feld Externe Eigenschaft das Verweisfeld für den
ClearQuest-Datensatz
und ein Feld im Datensatz aus, auf das er verweist. Beispiel: FoundInPlatform.Name verweist auf das Feld
'FoundInPlatform', das auf das Feld 'Name' in einem anderen Datensatz verweist. Wählen Sie
im Feld Synchronisation die Option Eingehend/Abgehend
aus. Wählen Sie Keine Umsetzung ab.
Wählen Sie im Feld
Werttransformer die Option für den Transformer für Verbindung von Feld zu
angepasstem Attribut aus.
- Klicken Sie auf Hinzufügen, um eine zweite Eigenschaftszuordnung zu definieren. Wählen Sie im Feld Externe Eigenschaft das Verweisfeld aus. Beispiel: FoundInPlatform. Lassen
Sie das Feld Elementeigenschaft leer. Wählen Sie Keine Umsetzung ab.
Wählen
Sie im Feld Synchronisationsregel für Verweis die Synchronisationsregel aus, die Sie zuvor
definiert haben. Beispiel: com.ibm.rational.clearquest.sample_schema_repo.FoundInPlatform. Klicken Sie auf Speichern, um die geänderte Synchronisationsregel zu speichern.
Sie können Wertzuordnungen für die Eigenschaftszuordnung angeben, die den Werttransformer
Transformer für Verbindung von Feld zu angepasstem Attribut verwendet.
Für sowohl eingehende als auch abgehende Werte wendet der
ClearQuest-Connector
die Wertzuordnung nach der Umsetzung an. Beispiel: Für einen Feldverweis wie Priority.Name sucht der
ClearQuest-Connector
den Wert des Feldes 'Name' im Datensatz 'Priority' und wendet anschließend die Wertzuordnungen auf diesen
Wert an. In der abgehenden Richtung wendet der
ClearQuest-Connector
die Wertzuordnungen an, nachdem er die entsprechende
Rational Team Concert-Elementeigenschaft
gefunden hat.