Sie können Daten aus REST-Datenquellen extrahieren, indem Sie die Rational-REST-Get-Spezifikation bereitstellen.
Vorbereitende Schritte
Für die Konfiguration einer REST-Datenquelle ist ein URL zur Ressource erforderlich.
Wenn sich die Ressource auf einem sicheren Server befindet,
werden ein Benutzername und ein Kennwort benötigt.
Informationen zu diesem Vorgang
Zum Entwerfen von Vorlagen und Generieren von Dokumenten ist ein Schema erforderlich.
Schemas für REST-Datenquellen werden über das Feature
Schemaerkennung von Document Studio abgerufen.
Vorgehensweise
- Klicken Sie im Fenster
Dokumentspezifikation auf
.
- Klicken Sie mit der rechten Maustaste auf die Datenquelle, und wählen Sie Datenquelle konfigurieren aus.
- Geben Sie die Ressourceninformationen für die REST-Ressource an:
- Geben Sie den URL für die REST-Ressource an. Wenn Ihnen der URL nicht bekannt ist, klicken Sie auf
Erkennen, um die Ressource aufzufinden.
- Wenn sich die Ressource in einer gesicherten Position befindet, geben Sie den Benutzernamen und das Kennwort ein.
- Klicken Sie auf OK.
- Klicken Sie im Fenster Willkommen auf Weiter.
- Geben Sie die Verbindungsdetails an:
- URL: Geben Sie den Basis-URL für die Ressource an.
- Benutzer: Wenn die Ressource ein sicherer Server ist, geben Sie den Benutzernamen an.
- Kennwort: Wenn die Ressource ein sicherer Server ist, geben Sie das Kennwort an.
- Authentifizierung: Wählen Sie den Authentifizierungstyp aus, der für Ihre Datenquelle gültig ist. Sie können einen der folgenden Authentifizierungstypen auswählen:
Accept-Header:
Geben Sie einen Accept-Typ für Ihre Formatvorlage ein.
Beispiele:
- image/jpeg
- text/html
- application/xml
- */*
Weitere Informationen zum Basis-URL und zu den Berechtigungsnachweisen finden Sie unter
REST-Datenquellenschema mit dem Schemaerkennungsassistenten hinzufügen.
- Klicken Sie auf Weiter.
- Geben Sie im Fenster
Ressource erstellen die Details für die neue Ressource an:
- Name: Geben Sie einen Namen für die neue Ressource an.
- Beschreibung: Geben Sie eine Beschreibung für die neue Ressource an.
- Relativer Pfad: Geben Sie einen relativen Pfad für die neue Ressource an.
Wenn die REST-Datenquelle über die Anwendung "Data Services"
zugänglich ist, wählen Sie
Locate using data service aus, um die Ressource aufzufinden.
Die Ressourcennavigation ist für Ressourcen mit einem
href-Attribut verfügbar. Erweitern Sie die Liste, um die Ressource zu finden.
- Gehen Sie wie folgt vor, um die Ressourcen auszuwählen:
- Wählen Sie in der Baumstruktur des XML-Schemas ein Element aus.
- Wählen Sie in der Attributliste
den Wert href aus.
- Klicken Sie auf Weiter. Der Ressourcen-URL für die ausgewählte Ressource wird angezeigt.
- Wählen Sie den URL aus, und klicken Sie auf
Fertigstellen, oder verwenden Sie den URL, um die untergeordnete Ressource aufzufinden.
Gehen Sie wie folgt vor, um die untergeordnete Ressource aufzufinden:
- Wählen Sie den Ressourcen-URL aus, und klicken Sie auf
Weiter.
- Wählen Sie in der Baumstruktur des XML-Schemas ein Element aus.
- Wählen Sie in der Attributliste
den Wert href aus.
- Klicken Sie auf Fertigstellen. Der Assistent wird ausgeführt, und der URL
wird im Fenster Konfiguration angezeigt.
Wenn die Ressource auf einem sicheren Server gespeichert ist,
geben Sie im Fenster
Konfiguration einen Benutzernamen und ein Kennwort ein.
- Klicken Sie auf OK. Der REST-Datenkonfigurationsprozess wird ausgeführt, und die Informationen
werden dem Fenster Dokumentspezifikation hinzugefügt.