Verweisfelder zuordnen

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

  1. Öffnen Sie im Rational Team Concert-Client die Ansicht Teamartefakte.
  2. Klicken Sie mit der rechten Maustaste auf Ihren Projektbereich und wählen Sie Öffnen aus.
  3. 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.
  4. Klicken Sie in der Ansicht Teamartefakte mit der rechten Maustaste auf die Repository-Verbindung und wählen Sie Verwalten > Synchronisationsregeln aus. Klicken Sie in der Ansicht Synchronisationsregeln mit der rechten Maustaste auf den Projektbereich und wählen Sie Neu > Synchronisationsregel aus.
  5. 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.
  6. 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.
  7. 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.
  8. 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.


Feedback

War dies eine Hilfe? Sie können Ihr Feedback bei Jazz.net (Registrierung erforderlich) geben: Geben Sie Ihre Kommentare in den Foren oder senden Sie einen Bug.