Serviceschnittstelle entwickeln

Ein Beispiel für die Entwicklung einer Serviceschnittstelle mit dem Serviceeditor.

Vorbereitungen

Lesen Sie die Konzeptinformationen zu Integrationsservicesund erstellen Sie einen völlig neuen Service. Siehe Integrationsservice völlig neu erstellen.

Informationen zu dieser Task

Ein Dienst in „ IBM® App Connect Enterprise “ ist eine spezialisierte Anwendung, die eine Webdienstlösung enthält. Sie definiert eine Schnittstelle mit Operationen, die als separate untergeordnete Nachrichtenflüsse implementiert werden. Das folgende Beispiel zeigt, wie Sie eine Schnittstelle erstellen und Operationen definieren. Die vollständige Schnittstelle wird im Abschnitt Beispiel einer Serviceschnittstelleerläutert.

Vorgehensweise

  1. Öffnen Sie Ihren Integrationsservice im Serviceeditor, indem Sie doppelt auf die Servicebeschreibung in der Ansicht Anwendungsentwicklungklicken oder indem Sie mit der rechten Maustaste klicken und Öffnenauswählen.
  2. Zeigen Sie die Serviceschnittstelle an, indem Sie zur Registerkarte Schnittstelle im Serviceeditor wechseln.
  3. Bei der Erstellung des Service wird die Standardanforderungsantwortoperation operation1erstellt. Benennen Sie operation1 in getApproval um.
  4. Benennen Sie die Eingaben und Ausgaben um und bearbeiten Sie deren Typen.
    1. Benennen Sie input1 in balanceum. Wählen Sie im Feld Typ den Standardwert Zeichenfolge aus. Wählen Sie im Kontextmenü die Option Doppelt aus.
      Der Typ wird entsprechend geändert.
    2. Ändern Sie output1 in approval und übernehmen Sie den Typ string.

      Klicken Sie in das Feld Typ und wählen Sie "double" aus.

  5. Fügen Sie zwei Fehler hinzu zu getApproval Verwendung der Fehler hinzufügen Symbol: ein Auszeit Fehler mit einem Schnur Typ und Systemfehler, ebenfalls mit einem Schnur Typ.

    Klicken Sie auf das Symbol "Fehler hinzufügen", um einen Fehler hinzuzufügen, oder klicken Sie mit der rechten Maustaste auf die Operation und wählen Sie im Kontextmenü "Fehler hinzufügen" aus.

    Diese Fehler werden in den Eigenschaften der Bindungen angezeigt, die Ihre Schnittstelle verwenden. Anschließend können Sie die Fehler mit dem Fehlerselektor implementieren.
  6. Fügen Sie eine weitere Request-Response-Operation hinzu. Klicken Sie dazu auf das Symbol Request-Response-Operation hinzufügen oder klicken Sie mit der rechten Maustaste und wählen Sie im Kontextmenü aus. Daraufhin wird eine Anforderung/Antwort-Operation mit einer Eingabe und einer Ausgabe erstellt. aufgerufen getHistory mit einer Eingabe von customerName mit dem Typ string und einer Ausgabe von customerHistory mit dem Typ string . Wähle aus Schnur Art der customerHistory und ändern Sie das Feld Name in customerPastHistory.

    Klicken Sie auf das Symbol "Request-Response-Operation hinzufügen", um eine Request-Response-Operation hinzuzufügen, oder klicken Sie mit der rechten Maustaste auf die Operation und wählen Sie "Request-Response-Operation hinzufügen" aus.

  7. Fügen Sie in dieser Operation dieselben Fehler timeout und systemFailure wie in der vorherigen Operation hinzu. Diese Fehler geben entsprechende Fehlernachrichten zurück, wenn eine Zeitlimitüberschreitung oder ein Systemfehler auftritt.
  8. Fügen Sie eine Einwegoperation namens UpdateKreditRating, entweder über die Symbole durch Auswahl Einwegvorgang hinzufügen oder klicken Sie mit der rechten Maustaste auf den Canvas-Bereich im Schnittstelleneditor und wählen Sie aus dem Kontextmenü. Benennen Sie die Eingabe in currentRating (Aktuelle Bewertung) um und weisen Sie den Typ Zeichenfolge zu. Unidirektionale Operationen senden nur eine Eingabe, weil keine Antwort erforderlich ist.

    Die Schnittstelle ist vollständig mit definierten Operationen.

Nächste Schritte

Implementieren Sie die im Integrationsservice definierten Operationen als separate untergeordnete Nachrichtenflüsse. Weitere Informationen finden Sie unter Integrationsserviceoperation implementieren.