Beispiel: Artefakte aus Anwendungen abrufen, die die REST-konforme API unterstützen

In diesem Beispiel wird beschrieben, wie Artefakte aus der Anwendung 'Requirements Management' von Rational solution for Collaborative Lifecycle Management abgerufen und Elemente in IBM® Rational Focal Point erstellt werden.

Zweck

Wenn in der Anwendung 'Requirements Management' Anforderungen vorhanden sind und diese in Rational Focal Point priorisiert werden sollen, können Sie die Anforderungen mithilfe des REST-Clientsichtbefehls abrufen.
Voraussetzungen:
  • Definieren Sie die IP-Adresse und den Hostnamen des Rational solution for CLM-Servers in der Hostdatei des Computers, auf dem Sie die Integration konfigurieren. Bei Windows befindet sich die Hostdatei normalerweise in C:\Windows\System32\drivers\etc, bei Linux in /etc/hosts.
  • Fügen Sie die Anwendung 'Requirements Management' als abgehenden Freund (Freunde (abgehend)) in Rational Focal Point hinzu. Weitere Informationen finden Sie in Verbindung zum Rational solution for Collaborative Lifecycle Management-Anwendungsserver herstellen.
  • Beachten Sie die XML-Struktur der Artefakte der Anwendung 'Requirements Management' und stellen Sie sicher, dass Sie über die Zugriffsberechtigung für die Artefakte verfügen.

Beispiel

In diesem Beispiel wird vorausgesetzt, dass in Rational Focal Point ein Arbeitsbereich FP-RRC und eine Sicht RRC-Anforderungen anzeigen vorhanden sind. In der Tabelle werden einige der Attribute angezeigt, die in Rational Focal Point und der Anwendung 'Requirements Management' verfügbar sind.
Tabelle 1. Attribute für Rational Focal Point und die Anwendung 'Requirements Management'
Rational Focal Point-Attribute Attribute der Anwendung 'Requirements Management'
Fuel choice rrm:description
Fuel efficiency rrm:collaboration/rrm:attributes/attribute:objectType/attribute:customAttribute/@attribute:isEnumeration
Integration Link rrm:collaboration/rrm:attributes/attribute:objectType/@attribute:projectAreaName
Title ds:location/ds:project/rrm:title
  1. Öffnen Sie in Rational Focal Point den Arbeitsbereich FP-RRC, in den die Artefakte abgerufen werden sollen.
  2. Klicken Sie auf Konfigurieren > REST-Clientsichtbefehl und dann auf Sichtbefehl hinzufügen.
  3. Geben Sie bei Verbindungsname für REST-Client eine RRC-Verbindung zur Identifikation der Verbindung ein.
  4. Wählen Sie bei REST-Anforderungsmethode die Methode GET aus.
  5. Wählen Sie bei Liste der Freunde RRC aus.
  6. Geben Sie bei Anforderungs-URL für REST-Anwendung die Anwendungs-URL ein, die die abzurufenden Artefakte enthält. Um beispielsweise die Artefakte aus der Anwendung 'Requirements Management' abzurufen, geben Sie https://<Hostname>:<Portnummer>/rm/<Projektname>/<Objektgruppenname> ein.
    Tipp: Öffnen Sie einen Web-Browser und geben Sie die URL ein, die Sie beim Hinzufügen der Anwendung 'Requirements Management' als Freund verwendet hatten. Eine Liste der übergeordneten Artefakte wird angezeigt. Suchen Sie nach dem Artefakt, das abgerufen werden soll, und kopieren Sie seine URL in das Feld Anforderungs-URL für REST-Anwendung.
  7. Klicken Sie auf Verbinden.
  8. Klicken Sie auf Root-XPath auswählen, um Ihre Suche nach Artefakten auf eine Objektgruppe zu beschränken. Wählen Sie /ds:dataSource/ds:artifact aus. XPath dient zum Eingrenzen der Suche nach den Artefakten. XPath gibt die hierarchische XML-Struktur einer Anwendung wieder.
  9. Um sicherzustellen, dass die Artefakte nicht dupliziert werden, klicken Sie im Bereich Identifikationszuordnung auf Hinzufügen und ordnen Sie das Attribut Fuel choice von Rational Focal Point und das Attribut rrm:description der Anwendung 'Requirements Management' einander zu. Sie können nur ein einziges Attribut zuordnen.
  10. Klicken Sie im Bereich Attributzuordnung auf Hinzufügen, um die folgenden Attribute der Anwendung 'Requirements Management' und die entsprechenden Attribute von Rational Focal Point einander zuzuordnen. Die zugeordneten Attribute werden für das aus der Anwendung abgerufene Element angezeigt. Stellen Sie sicher, dass die Attribute bearbeitbar sind.
    Anmerkung: Das Attribut, das Sie im Bereich Identifikationszuordnung ausgewählt haben, wird nicht im Bereich Attributzuordnung angezeigt, da dieses Attribut intern zugeordnet wird und für die abgerufenen Elemente verfügbar ist.
    Tabelle 2. Zuordnung von Attributen zwischen Rational Focal Point und der Anwendung 'Requirements Management'
    Rational Focal Point-Attribute Attribute der Anwendung 'Requirements Management'
    Fuel efficiency rrm:collaboration/rrm:attributes/attribute:objectType/attribute:customAttribute/@attribute:isEnumeration
    Integration Link rrm:collaboration/rrm:attributes/attribute:objectType/@attribute:projectAreaName
    Title ds:location/ds:project/rrm:title
  11. Geben Sie im Feld Von der REST-Anwendung unterstütztes Datumsformat das Datum 2012-08-18 ein.
  12. Behalten Sie im Feld Focal Point-Trennzeichen die Angabe , bei.
  13. Klicken Sie auf Speichern.
  14. Öffnen Sie die Sicht RRC-Anforderungen anzeigen und wählen Sie RRC-Verbindung aus der Dropdown-Liste aus. Eine Liste der Anforderungen und Attribute wird abgerufen und die Anforderungen und Attribute werden als Elemente in der Sicht erstellt.

Feedback