Wenn eine Anwendung REST-konforme APIs unterstützt, können Sie in
dieser Anwendung Artefakte aus den Geschäftsanforderungen in
IBM® Rational Focal Point
erstellen. Sie können beispielsweise Anforderungen in der Anwendung
'Requirements Management' von
Rational solution for
Collaborative Lifecycle Management
aus den Geschäftsanforderungen in
Rational Focal Point
erstellen.
Vorbereitende Schritte
- Stellen Sie sicher, dass Sie über den entsprechenden Zugriff auf die
Anwendung verfügen, in der Sie Artefakte aus
Rational Focal Point
erstellen.
- Fügen Sie die Anwendung als abgehenden Freund in
Rational Focal Point
hinzu. Weitere Informationen finden Sie in
Verbindung zum Rational solution for Collaborative Lifecycle Management-Anwendungsserver herstellen.
- Stellen Sie sicher, dass der Inhalt der Anwendung, die REST-APIs
unterstützt, XML-Format hat.
- Beachten Sie die XML-Struktur der Anwendungsartefakte und stellen Sie
sicher, dass Sie über die Zugriffsberechtigung für die Artefakte verfügen.
Vorgehensweise
- Öffnen Sie den Arbeitsbereich in
Rational Focal Point.
- Klicken Sie auf
und dann auf Sichtbefehl hinzufügen.
- Wählen Sie eine Sicht aus, der der Sichtbefehl hinzugefügt werden soll.
- Führen Sie im Bereich 'REST-Clientbefehlskonfiguration' diese Schritte
aus:
- Geben Sie bei Verbindungsname für REST-Client einen
Namen zur Identifikation der Verbindung ein.
- Wählen Sie bei REST-Anforderungsmethode die Methode
POST aus. Informationen zur Verwendung jeder Methode enthält der Abschnitt
'Unterstützte Methoden zur Verwaltung von Ressourcen'.
- Wählen Sie bei Liste der Freunde die Anwendung aus,
die Sie
Rational Focal Point
als Freund hinzugefügt hatten.
- Klicken Sie bei Eindeutiges Attribut für POST
auswählen auf Auswählen und wählen Sie ein
Attribut aus. Dieses Attribut ist leer. Nach der ersten Operation POST wird die
Antwort-URL von der Anwendung in dem Attribut gespeichert. Das heißt, bei
nachfolgenden Operationen POST mit identischer URL wird die Operation POST für
diese URL nicht ausgeführt.
- Geben Sie bei Anforderungs-URL für REST-Anwendung
die URL der höchsten Ebene für den Bereich in der Anwendung an, in der Sie
Artefakte erstellen. Verwenden Sie beispielsweise für die Anwendung 'Requirements Management'
die URL der Requirement-Creation-Factory. Um diese URL abzurufen, verwenden
Sie normalerweise die Root-Service-URL, um die RMCatalog-URL abzurufen.
Mithilfe der RMCatalog-URL können Sie die URL des Projektbereichs abrufen; dann
können Sie mithilfe der URL des Projektbereichs die URL der Requirement-Factory
abrufen.
- Führen Sie im Bereich 'Konfiguration der Schablonen-XML für REST-Client'
diese Schritte aus:
- Geben Sie bei REST-Anwendungs-URL zur
Schablonen-XML die URL ein, die auf ein Artefakt in der Anwendung
verweist, und klicken Sie auf Schablonen-XML abrufen. Die XML wird in das Textfenster Schablonen-XML für
REST-Anwendung geladen. Wenn die XML nicht dynamisch geladen werden
soll, können Sie die XML in das Textfenster Schablonen-XML für
REST-Anwendung kopieren.
Anmerkung: Bei der Operation POST müssen Sie die XML-Struktur der Anwendung, an die
Artefakte übergeben werden, kennen. So können Sie die XML entweder dynamisch
oder manuell abrufen. Nachdem Sie den Code abgerufen haben, muss diese XML die
Übergabe neuer Daten an die Anwendung unterstützen. Wenn die XML dies nicht
unterstützt, müssen Sie in einigen Anwendungen die XML manuell erstellen oder
bearbeiten.
- Klicken Sie bei Root-XPath zum
REST-Anwendungsartefakt auf Auswählen und
wählen Sie die Root-XPath für Attribute aus. Die Schaltfläche Auswählen ist nur aktiviert, wenn
die XML im Textfenster Schablonen-XML für REST-Anwendung
korrekt ist.
- Klicken Sie im Bereich Attributzuordnung auf
Hinzufügen und ordnen Sie die
Rational Focal Point-Attribute
den Attributen der Anwendung zu. Wenn Sie beispielsweise das Attribut 'Titel' von
Rational Focal Point
dem Attribut 'Name' der Anwendung zuordnen, wird das Attribut 'Name' in der
Anwendung nach der Ausführung der Operation POST in
Titel geändert.
- Führen Sie im Bereich 'Antwort' diese Schritte aus:
- Geben Sie bei Schablonen-XML für REST-Anwendung die
XML an, die als Antwort auf die Methode GET empfangen wird, oder geben Sie eine
andere XML der Anwendung an. Geben Sie bei Root-XPath zum
REST-Anwendungsartefakt die Root-XPath zu Attributen an und klicken
Sie dann bei Antwortattributzuordnung auf
Hinzufügen, um die Attribute zuzuordnen.
- Klicken Sie im Bereich 'Antwortheaderzuordnung' auf
Hinzufügen, um den Anwendungsheader einem
Rational Focal Point-Attribut
zuzuordnen. Im Anwendungsheader ist die XML dieser Anwendung gespeichert. Normalerweise
lautet der Header der
Rational solution for CLM-Anwendungen
Location.
- Führen Sie im Bereich 'Konfiguration' diese Schritte aus:
- Geben Sie bei Von der REST-Anwendung unterstütztes
Datumsformat das Datumsformat ein, das von der externen Anwendung
verwendet wird.
- Geben Sie bei Focal Point-Trennzeichen einen
Trennzeichenwert wie z. B. ein Komma (,) oder
ein Semikolon (;) ein. Die Einträge für Mehrfachauswahl und Linkliste
werden durch das angegebene Trennzeichen voneinander getrennt.
- Um die IDs der Attribute zwischen
Rational Focal Point
und der Anwendung zuzuordnen, klicken Sie im Bereich
'Anforderungsparametertabelle' auf Hinzufügen und wählen
Sie ein Rational Focal Point-Attribut
aus. Geben Sie die ID der Anwendung in die Spalte
Schlüssel ein. Wenn Sie beispielsweise Projekt-ID für
Rational Focal Point
in der Spalte Schlüssel auswählen, geben Sie die ID ein,
die für die Projekt-ID in der Anwendung verwendet wird.
- Klicken Sie im Bereich 'Anforderungsheaderzuordnung' auf
Hinzufügen und geben Sie den Namen und den Wert des
Headers ein. Für die
Rational solution for CLM-Anwendungen
lauten die Header wie folgt:
| Headername |
Headerwert |
| Accept |
application/rdf+xml |
| Content-Type |
application/rdf+xml |
| OSLC-Core-Version |
2.0 |
- Klicken Sie auf Speichern.
- Wählen Sie im Menü Anzeigen die Sicht aus, deren
Elemente in der anderen Anwendung erstellt werden sollen.
- Um alle in der Sicht verfügbaren Artefakte zu erstellen, klicken Sie in
der Symbolleiste der Sicht auf die Dropdown-Liste, wählen Sie den
Sichtbefehl POST aus und klicken Sie dann auf das Symbol
Start
.
- Um ein einzelnes Artefakt zu erstellen, wählen Sie in der
Symbolleiste für das Artefakt den Sichtbefehl POST aus und klicken Sie
dann auf das Symbol Start
.