Verbindung zur REST-Datenquelle herstellen

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 eine URL zur Ressource erforderlich. Wenn sich die Ressource auf einem sicheren Server befindet, werden ein Benutzername und ein Kennwort benötigt.

Weitere Informationen dazu, wie die Benutzernamen und Kennwörter gespeichert werden, finden Sie unter Sicherheitsaspekte für IBM® Rational Publishing Engine.

Vorgehensweise

  1. Klicken Sie im Fenster Dokumentspezifikation auf Vorlagen > Datenquellen.
  2. Klicken Sie mit der rechten Maustaste auf die Datenquelle und wählen Sie eine Konfigurationsoption aus:
    • Wenn es Konfigurationsschichtmetadaten für die Datenquelle gibt, klicken Sie auf Verwendung von Metadaten konfigurieren.
      1. Wenn zum Herstellen einer Verbindung zu der in den Konfigurationsschichtmetadaten angegebenen Datenquelle eine Authentifizierung erforderlich ist, erscheint ein Fenster, in dem Sie Ihren Benutzernamen, das Kennwort und den Authentifizierungstyp angeben können. Klicken Sie auf OK.
      2. Wählen Sie den zu verwendenden Wert aus der Konfigurationsschicht aus und klicken Sie auf OK.

        Nachdem Sie einen Wert aus der Konfigurationsschicht ausgewählt haben, ist die Datenquelle konfiguriert. Sie müssen daher keine weiteren Schritte dieser Aufgabe ausführen.

    • Wenn es keine Konfigurationsschichtmetadaten für die Datenquelle gibt, klicken Sie auf Datenquelle konfigurieren und fahren Sie mit dem nächsten Schritt fort.
  3. Geben Sie die Ressourceninformationen für die REST-Ressource an:
    1. URL: Geben Sie die Basis-URL für die Ressource an. Wenn Ihnen die URL nicht bekannt ist, klicken Sie auf Erkennen, um die Ressource aufzufinden. Wenn Sie auf Erkennen geklickt haben, fahren Sie mit dem Schritt 4 fort, ohne die verbleibenden untegeordneten Schritte in diesem Schritt auszuführen.
    2. Benutzer: Wenn die Ressource ein sicherer Server ist, geben Sie den Benutzernamen an.
    3. Kennwort: Wenn die Ressource ein sicherer Server ist, geben Sie das Kennwort an.
    4. Authentifizierung: Wählen Sie den Authentifizierungstyp aus, der für Ihre Datenquelle gültig ist. Sie können einen der folgenden Authentifizierungstypen auswählen:
      • Auto
      • basic
      • form
      • OAuth
    5. Accept-Header: Geben Sie einen Accept-Typ für Ihre Formatvorlage ein. Beispiele:
      • image/jpeg
      • text/html
      • application/xml
      • */*
    6. Klicken Sie auf OK.
  4. Wenn Sie auf Erkennen geklickt haben, um die Ressource zu lokalisieren, führen Sie den Assistenten aus:
    1. Klicken Sie im Fenster Willkommen auf Weiter.
    2. Geben Sie im Fenster "Basiskonfiguration" die Details für die Datenquelle an:
      • Name: Geben Sie einen Namen für die Datenquelle an.
      • Beschreibung: Geben Sie eine Beschreibung für die Datenquelle an.
      • Basis-URL: Die Ressourcennavigation ist für Ressourcen mit einem href-Attribut verfügbar.
      • Authentifizierungstyp: Wählen Sie den Authentifizierungstyp aus, der für Ihre Datenquelle gültig ist.
      • Benutzer und Kennwort: Die Berechtigungsnachweise, die Sie für die Authentifizierung bei Ihrer Datenquellenanwendung verwenden.
      • Kontext auswählen: Für Design Management-Datenquellen.
    3. Wählen Sie eine Ressource aus. An die Basis-URL, die Sie eingegeben haben, wird automatisch ?metadata=schema angehängt. Gehen Sie wie folgt vor, um die Ressourcen auszuwählen:
      • Blenden Sie im Fenster "Locate resource using Data" im Abschnitt "XML-Schema" die Ressourcenliste ein.
      • Wählen Sie im Abschnitt "Elementattribute" einen href-Wert aus und klicken Sie auf Weiter.
      • Klicken Sie auf Weiter. Die Ressourcen-URL für die ausgewählte Ressource wird angezeigt.
    4. Wählen Sie die URL aus und klicken Sie auf Fertigstellen oder verwenden Sie die URL, um die untergeordnete Ressource zu lokalisieren. Der Assistent wird ausgeführt, und die 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.
  5. Klicken Sie auf OK. Der REST-Datenkonfigurationsprozess wird ausgeführt, und die Informationen werden dem Fenster Dokumentspezifikation hinzugefügt.

Beispiel

Weitere Informationen zur Ermittlung einer Basis-URL finden Sie unter Integration in der Dokumentation für Ihre Datenquelle.

Feedback