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.

Siehe Proxy-Server zwischen INUBIT Process Engine und entfernten Rechnern konfigurieren

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.

Siehe https://www.w3.org/TR/2005/REC-soap12-mtom-20050125/

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.

Siehe Nachrichten mit binären Attachments versenden
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.

Siehe Nachrichten mit binären Attachments empfangen
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.

Siehe Nachrichten mit binären Attachments empfangen
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.

Siehe Nachrichten mit binären Attachments versenden
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. Siehe Credentials Manager für die Authentifizierung verwenden.
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.
  
  Siehe Dialog WS-Security Konfiguration - Input
- 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.
  
  Siehe Dialog WS-Security Konfiguration - Medium/Output
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.
  
  Siehe Dialog WS Reliable Messaging Konfiguration

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

Namensräume bearbeiten

(nur Input Listener Connector)

Öffnet den Dialog Namensräume bearbeiten.

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)

Siehe SOAP-Nachrichten protokollieren
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.