Inhaltsverzeichnis

Search

  1. Vorwort
  2. Web-Dienste
  3. SOAP-Webdienste
  4. WSDL-Datenobjekt
  5. Schemaobjekt
  6. Vorgehensweise für das Erstellen eines SOAP-Webdiensts
  7. Operation-Mappings
  8. Parsen von Webdienst-SOAP-Meldungen
  9. Generieren von Webdienst-SOAP-Meldungen
  10. Web-Dienst-Verbraucher-Umwandlung
  11. REST-Webdienste
  12. Vorgehensweise für das Erstellen eines REST-Webdiensts
  13. REST-Webdienst-Verbraucher-Umwandlung
  14. REST-Webdienst-Verbraucher-Umwandlung – Anwendungsfälle
  15. Verwaltung von REST- und SOAP-Webdiensten
  16. Anhang A: Datentyp-Kompatibilität

Webdienste-Handbuch

Webdienste-Handbuch

Verwenden von Argumentports zum Erzeugen von URL-Parametern

Verwenden von Argumentports zum Erzeugen von URL-Parametern

Sie können Argumentports verwenden, um Parameter in der URL zum Filtern der vom Webdienst angeforderten Daten zu erzeugen. Bei Verwendung der Get-Methode können Sie beispielsweise weder eine Methodeneingabedefinition noch eine Eingabezuordnung konfigurieren. Dennoch möchten Sie weiterhin einen Filter in der Get-Anfrage verwenden. Sie können Argumentports zum Erstellen eines Filters in der Anfragenachricht verwenden. Erstellen Sie eine URL, wie z. B.
https://sample.com?arg1=val1&arg2=val2
, indem Sie Argumentports zum Erzeugen der URL-Parameter verwenden.
Führen Sie die folgenden Schritte durch, um einen Argumentport nach dem Erstellen der REST-Webdienst-Verbraucher-Umwandlung zu konfigurieren:
  1. Wählen Sie die REST-Webdienst-Verbraucher-Umwandlung aus.
  2. Navigieren Sie zur Ansicht
    Eigenschaften
    und wählen Sie die Registerkarte
    Erweitert
    aus.
  3. Führen Sie zum Konfigurieren der Basis-URL die folgenden Schritte durch:
    • Geben Sie zum Konfigurieren der Eigenschaft
      URL
      die Basis-URL ein.
    • Wählen Sie zum Konfigurieren der Eigenschaft
      Verbindung
      die HTTP-Verbindung aus.
  4. Navigieren Sie zur Registerkarte
    Ports
    .
  5. Markieren Sie die Gruppe
    RequestInput
    und wählen Sie
    Neu
    aus. Wählen Sie
    Argumentports
    im Dropdown-Menü aus.
    Diese Abbildung zeigt die Registerkarte „Ports“ für die REST-Webdienst-Verbraucher-Umwandlung. Die Gruppe „RequestInput“ ist markiert. Die Option „Neu“ ist ausgewählt und das Dropdown-Menü wird angezeigt. Im Dropdown-Menü ist die Option „Argumentports“ ausgewählt.
  6. Geben Sie Werte für
    Argumentname
    und
    Portname
    ein.
    Wenn der Portname Zeichen enthält, die vom Datenintegrationsdienst nicht verarbeitet werden können, ändern Sie den Portnamen.
    Diese Abbildung zeigt das Dialogfeld zum Erstellen eines Argumentports. Sie können die Eigenschaften „Argumentname“ und „Portname“ des Argumentports konfigurieren.
    Die folgende Abbildung zeigt den unter „RequestInput“ verschachtelten Argumentport:
    Diese Abbildung zeigt die Registerkarte „Ports“ für die REST-Webdienst-Verbraucher-Umwandlung. Der URL-Port wird unter der Gruppe „RequestInput“ angezeigt.
  7. Wiederholen Sie die Schritte 3 und 4, um einen zweiten Argumentport hinzuzufügen.
    Der zweite Argumentport wird unter dem ersten Argumentport angezeigt:
    Diese Abbildung zeigt die Registerkarte „Ports“ für die REST-Webdienst-Verbraucher-Umwandlung. Unter „RequestInput“ sind zwei Argumentports verschachtelt. Der erste Argumentport weist den Wert „arg1“ und der zweite Argumentport den Wert „arg2“ auf.
    Die Werte des Argumentports werden im Format
    http://sample.com?arg1=val1&arg2=val2
    an die URL angehängt. Der Portname wird in der URL nicht verwendet. Der Datenintegrationsdienst verwendet den Portnamen zum Identifizierenr Angabe der Argumentports.
  8. Zum Verwenden der Argumentports
    arg1
    und
    arg2
    als Parameter in der Basis-URL verknüpfen Sie Ports aus einem vorgelagerten Zuordnungsobjekt mit den Argumentports in der REST-Webdienst-Verbraucher-Umwandlung.
    Die aus einem vorgelagerten Objekt verknüpften Ports definieren
    val1
    und
    val2
    in der URL
    https://sample.com?arg1=val1&arg2=val2
    .