Register Erweitert im Web Services Connector

Proxy-Einstellungen

(Nur Medium und Output Connector)

Proxy-Einstellungen können Sie nur definieren, wenn Sie die Option Kompatibilitätsmodus mit Version 5.0 (Einsatz des Axis2-Frameworks) aktivieren. Wenn der Kompatibilitätsmodus aktiviert ist, werden folgende Bedienfelder angezeigt:

  • Globale Proxy-Konfiguration überschreiben

    Wenn die Option nicht markiert ist, wird der Proxyserver verwendet, der für die INUBIT Process Engine konfiguriert wurde.

    Wenn die Option markiert ist, werden die folgenden Bedienfelder aktiviert und Sie können die globalen Proxy-Einstellungen überschreiben.

  • Servername/Port

    Adresse und Portnummer des Proxy-Servers.

  • Domäne

    Domäne, aus welcher der Zugriff über den Proxyserver erfolgen soll.

  • Ausnahmen

    Proxy-Einstellungen gelten nicht für die hier aufgeführten Systeme.

  • Authentifizierung erforderlich

    Ist aktiviert, wenn der Proxyserver eine Authentifizierung fordert.

  • Benutzername

    Benutzername für den Proxyserver.

  • Passwort

    Passwort

Anhänge/Binärdaten

Mit diesen Optionen können Sie den Versand und den Empfang von Binärdaten, wie z.B. PDF- oder JPG-Dateien, als Anhang von SOAP-Nachrichten optimieren.

Die Optionen für den Umgang mit Binärdaten haben nur dann einen Effekt, wenn in der eingehenden bzw. ausgehenden SOAP-Nachricht ein Element mit dem Attribut xmime:contentType enthalten ist.

  • MTOM-Anhänge für ausgehende Nachricht aktivieren

    (nur Medium/Output Connector)

    Aktivieren Sie diese Option, wenn Sie in der Ausgangsnachricht den Inhalt von Elementen mit dem Typ xmime:base64Binary als MTOM-Anhänge verschicken möchten. Die Daten stammen aus WSAttachment*- Variablen.

  • Binärdaten aus Antwort-Nachricht extrahieren und als Variablen-Inhalte setzen

    (nur Medium/Output Connector)

    Wenn diese Option aktiviert ist, wird die empfangene SOAP-Nachricht nach Elementen mit dem Attribut xmime:contentType durchsucht. Die Inhalte werden in WSAttachment*-Variablen geschrieben.

  • Anhänge ins Dateisystem speichern

    (nur Medium/Output Connector)

    Wenn der aufgerufene Web-Service Anhänge sendet, befinden sich diese in den entsprechenden MTOM-Variablen. Markieren Sie diese Option, um die Anhänge in das Dateisystem zu speichern. Die Pfade finden Sie in den MTOM-Variablen.

    Wenn die Option nicht markiert ist, dann bleiben die Anhänge in den Workflow-Variablen erhalten.

  • Binärdaten aus Eingabenachricht extrahieren und als Variablen-Inhalte setzen

    (nur Input Listener Connector)

    Wenn diese Option aktiviert ist, wird die empfangene SOAP-Nachricht nach Elementen mit dem Attribut xmime:contentType durchsucht. Die Elementinhalte werden in WSAttachment*-Variablen geschrieben.

  • MTOM-Anhänge für Antwort-Nachricht aktivieren

    (nur Input Listener Connector)

    Aktivieren Sie diese Option, wenn Sie in der Ausgangsnachricht den Inhalt von Elementen vom Typ xmime:base64Binary als MTOM-Anhänge verschicken (mit Daten aus WSAttachment* Variablen) möchten.

  • Referenzierte Dateien nach Antwort löschen

    (nur Input Listener Connector)

    Aktivieren Sie diese Option, um die über die Variablen WSAttachmentFileName.* referenzierten Dateien nach der Antwortgenerierung zu löschen.

Authentifizierung

(nur Input Listener Connector)

  • Authentifizierung erforderlich

    Zu aktivieren, wenn der Service nur über eine HTTP-Basic-Authentifizierung zugänglich sein soll.

    • Statische Zugangsdaten verwenden

      • Benutzername: Benutzername

      • Passwort: Passwort

    • Aus dem Credentials Manager auswählen

      Für die Authentifizierung können Sie auch Zugangsdaten verwenden, die im Credentials Manager verwaltet werden.

  • Bei Fehler eine Antwort mit Status 500 (Interner Server Fehler) senden (anstelle von Status 401):

    Bei aktivierter Option verhält sich der Connector wie in früheren INUBIT-Versionen und liefert einen HTTP-Status 500 bei fehlgeschlagener Authentifizierung. Im Client muss in diesem Fall eine präemptive Authentifizierung eingestellt sein, das heißt, mit der Anfrage müssen die Authentifizierungsdaten mitgeschickt werden, anstatt auf eine HTTP-Status-401-Antwort zu warten.

W3C Standards

  • WS-Security

    Zur sicheren Übertragung von Web-Service-Nachrichten. Setzt die Authentifizierung am Service über Zertifikate voraus. Die Authentifizierung des Service-Konsumenten ist optional.

    • Input Listener Connector

      Markieren Sie die Option, um WS-Security zu aktivieren. Zum Importieren der Zertifikate klicken Sie auf den Button Einstellungen.

    • Medium/Output Connector

      Sie erhalten beim Import der WSDL eine Meldung, falls der aufzurufende Web-Service WS-Security verwendet. Klicken Sie auf den Button WS-Security, um die geforderten Zertifikate zu importieren.

  • WS Reliable Messaging

    (nur Input Listener Connector)

    • Bei asynchroner Web-Service-Kommunikation

      Wenn markiert, dann wird das WS Reliable Messaging-Protokoll zur sicheren Übertragung der Web-Service Calls an die INUBIT-Software genutzt.

      Der erfolgreiche Empfang eines Requests wird bestätigt, sobald die Nachricht in dem Workflow angekommen ist, in dem der Input Listener Connector verwendet wird.

    • Bei synchroner Web-Service-Kommunikation

      Für die gesicherte Übertragung ist WS Reliable Messaging nicht erforderlich, weil der Empfang der Web-Service Response den Empfang des Calls signalisiert.

      Der Einsatz von WS Reliable Messaging ist trotzdem möglich, um die korrekte Abarbeitungsreihenfolge von Calls sicherzustellen.

Validierung

Die Validierung ist nützlich in Testphasen. Beachten Sie jedoch, dass die Validierung Performance kostet. Es kann daher sinnvoll sein, die Validierung im Produktivsystem abzuschalten.

  • Anfragenachricht validieren

    • Input Listener Connector

      Wenn markiert, dann werden alle eingehenden Requests gegen die WSDL validiert.

    • Output/Medium Connector

      Wenn markiert, dann wird der ausgehende Requests gegen die WSDL validiert.

  • Antwortnachricht validieren

    • Input Listener Connector

      Wenn markiert, dann werden die ausgehenden Responses gegen die WSDL validiert.

    • Output/Medium Connector

      Wenn markiert, dann wird die eingehende Response gegen die WSDL validiert.

  • Workflow starten trotz nicht valider Anfrage (Validierungsergebnis wird zum Workflow-Input)

    (nur Input Listener Connector, nur im Kompatibilitätsmodus)

    Fügt das Ergebnis der Validierung der Ausgangsnachricht hinzu. Startet unabhängig vom Ergebnis der Validierung den Workflow und übergibt das Validierungsergebnis an das nachfolgende Modul.

Asynchroner Nachrichtenaustausch

  • Unterstützung für asynchronenen Antwort-Versand

    (nur Callback Listener Connector)

    Siehe Callback Listener Connector anlegen im Abschnitt Asynchronen Web-Service aufrufen

Callback-Listener-spezifische Einstellung

  • Listener nimmt Antwortnachrichten entgegen (anstelle Anfrage-Nachrichten)

    (nur Callback Listener Connector)

    Ein- und ausgehende Nachrichten werden in folgende Logdatei geschrieben: <inubit-installdir>/inubit/server/ibis_root/log/webservice.log

    Siehe Callback Listener Connector anlegen im Abschnitt Asynchronen Web-Service aufrufen

Fehlerbehandlung

  • Bei Fehlerantwort Fehler werfen

    Wenn markiert, dann wird ein Fehler bei der Workflow-Ausführung ausgelöst, wenn der Output Connector eine Fehlerantwort (Nachricht mit SOAPFault) empfängt.

    Wenn der Fehler in der WSDL als mögliche Fehlerantwort definiert ist, bekommt der ausgelöste Fehler den in der WSDL angegebenen Namen.

  • HTTP-Response-Code vom Web-Service als Feld in der SOAP-Nachricht zurückgeben

    Wenn diese Option aktiviert wurde, werden detailliertere Fehlerinformationen zurückgeliefert.

Namensräume

Weitere Optionen

  • Automatische Anpassung der Service-Adresse in der WSDL deaktivieren

    • Wenn die Option markiert ist:

      Der Host/Port-Teil der Service-Adresse in der publizierten WSDL wird nicht angepasst.

    • Wenn die Option nicht markiert ist:

      Der Host/Port-Teil der Service-Adresse wird aus der URL der WSDL-Anforderung übernommen. Die Service-Adresse in der publizierten WSDL wird wie folgt angepasst:

      • WSDL wird per https://<server>:<port>/ibis/ws/HelloWorld?wsdl abgerufen

        In der WSDL steht die Service-Adresse https://<server>:<port>/ibis/ws/HelloWorld

      • WSDL wird per https://<server>:<port>/ibis/ws/HelloWorld?wsdl abgerufen

        In der WSDL steht die Service-Adresse https://<server>:<port>/ibis/ws/HelloWorld

  • Logging der SOAP-Nachrichten aktivieren (webservice.log)

    (nur für METRO Framework aktivierbar)

  • Kompatibilitätsmodus mit Version 5.0 (Axis2-Framework verwenden)

    Aktivieren Sie diese Option, um sicherzustellen, dass Web Services Connectoren, die mit einer INUBIT-Version < 5.1 angelegt wurden, auch in der aktuellen Version laufen.

    In der aktuellen Version wird Metro als Standard Web-Service Framework eingesetzt, während in INUBIT-Versionen < 5.1 das Axis2-Framework verwendet wurde.