SOAP Connector 8.0.0
Webservice (SOAP) Connector: Sendet eine SOAP-Anfrage (SOAP Request) via HTTP(S) zu der URL eines WebServices und gibt die zurückgelieferte SOAP-Antwort (SOAP Response) aus. Er kommuniziert mit Servern über HTTP (Hyper Text Transfer Protocol) oder HTTPS (HTTP Secure).
Falls eine Authentifizierung erforderlich ist, muss diese SOAP-basiert über den SOAP Header erfolgen. Der Aufbau (zertifikats-, token-basiert etc.) muss zunächst mit der Gegenstelle geklärt werden. Es werden HTTP-Server unterstützt. Für die HTTP-Authentifizierung muss der HTTP(S) Connector verwendet werden.
Eigenschaften (Properties)
| Operation | Bestimmt, welche Operation der Adapter durchführt Mögliche Werte:
|
Parameter
| Adapter | Hauptklasse des Adapters (nicht verändern!) Mögliche Werte: de.softproject.integration.nativeadapter.NativeAdapter: Hauptklasse (Standard) |
| Repository | Virtuelles Repository des Adapterprojekts |
| protocol | Verwendetes Protokoll (HTTP oder HTTPS) Mögliche Werte:
|
| host | IP-Adresse oder Host-Name des physikalischen Servers Hinweis: Der Parameter Mögliche Werte: Beliebige gültige Zeichenkette ohne Protokollangabe (z. B. |
| vHost | Host-Name eines logischen Servers (virtual host), falls dieser durch die physikalische Angabe in Parameter host nicht eindeutig identifiziert werden kann Hinweis: Der Parameter Hier können die Ports angegeben werden, ausgenommen der Ports 80 (Standard für HTTP-Verbindungen) und 443 (Standard für HTTPS-Verbindungen). Mögliche Werte: Beliebige gültige Zeichenkette ohne Protokollangabe (z. B. |
| port | Portnummer des HTTP(S)-Dienstes Mögliche Werte:
|
| path | Ordnerpfad auf dem Server, beginnend mit einem Schrägstrich Mögliche Werte: Beliebige Pfadangabe (z. B. |
| authenticationEncoding | Zeichenkodierung für die Anmeldedaten Mögliche Werte: Angabe einer Zeichenkodierung, z. B.
|
| query | Argument(e) für die HTTP(S)-Anfrage Mögliche Werte: Beliebige URL-kodierte Argumente ohne führendes Fragezeichen (z. B. |
| username | Benutzername für eine Basic-, Digest- oder NTLM-Authentifizierung Mögliche Werte:
|
| password | Passwort für eine Basic-, Digest- oder NTLM-Authentifizierung Mögliche Werte: Beliebige Zeichenkette |
| usePreemptiveBasicAuth | Präemptive Authentifizierung (mit den Zugangsdaten aus Parameter username und password) für HTTP(S)-Aufrufe aktivieren (nur für Basic-Authentifizierung, siehe Parameter allowBasic) Mögliche Werte:
|
| allowBasic | HTTP(S)-Basic-Authentifizierung verwenden Mögliche Werte:
|
| useProxy | Proxy-Server für den Verbindungsaufbau verwenden Mögliche Werte:
|
| proxyHost | IP-Adresse oder Host-Name eines Proxy-Servers Mögliche Werte: Beliebige gültige Zeichenkette (z. B. |
| proxyPort | Portnummer des Proxy-Servers Mögliche Werte:
|
| proxyUsername | Benutzername für eine Basic-, Digest- oder NTLM-Authentifizierung am Proxy-Server Mögliche Werte:
|
| proxyPassword | Passwort für den Proxy-Server Mögliche Werte: Beliebige Zeichenkette |
| proxyAllowBasic | Basic-Authentifizierung für den Proxy verwenden Mögliche Werte:
|
| connectTimeout | Timeout-Wert für den Verbindungsaufbau in Millisekunden Mögliche Werte:
|
| socketTimeout | Timeout-Wert zwischen zwei eingehenden Datenpaketen in Millisekunden; Dieser sagt nichts über die Gesamt-Anfragezeit aus. Mögliche Werte:
|
| acceptAllCertificates | Zertifikatsprüfung abschalten Mögliche Werte:
|
| acceptAllSslHostnames | Hostname-Überprüfung für Zertifikate abschalten Mögliche Werte:
|
| useClientCertificate | Client-Zertifikate zur Validierung des Requests verwenden Mögliche Werte:
|
| keystoreType | Keystore-Typ für die Speicherung von Client-Zertifikaten (gemäß http://docs.oracle.com/javase/6/docs/technotes/guides/security/StandardNames.html#KeyStore) Mögliche Werte:
|
| keystoreURL | URL zum Keystore für die Validierung des Requests über Client-Zertifikate Mögliche Werte: Beliebige gültige URL, z.B. |
| keystorePassword | Passwort für den Keystore zur Validierung des Requests über Client-Zertifikate Mögliche Werte: Beliebige gültige Zeichenkette |
| keyAlias | Schlüssel-Alias zur Zugriff auf einen bestimmten Schlüssel innerhalb des Keystores Mögliche Werte: Beliebige gültige Zeichenkette |
| aliasPassword | Zugehöriges Passwort für einen bestimmten Schlüssel innerhalb des Keystores Mögliche Werte: Beliebige gültige Zeichenkette |
| SoapAction | HTTP-Header des SOAP-Requests. Der Wert dieses Parameters ist eine URL, die die abgefragte Operation identifiziert. |
| toXml | Alle Header als Elemente und den Inhalt des Bodys als Base64-kodierten Text in einem XML-Dokument ausgeben Mögliche Werte:
|
Mithilfe dieses Parameters können auch Umlaute in den Anmeldedaten verwendet werden.Statuswerte
1 | Die Operation wurde erfolgreich ausgeführt. |
-1 | Die Operation ist aufgrund eines technischen Fehlers fehlgeschlagen. |
SOAP-Anfrage
Die SOAP-Anfrage ist wie im folgenden Beispiel aufgebaut:
<?xml version = "1.0"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://www.w3.org/2001/12/soap-envelope"
SOAP-ENV:encodingStyle="http://www.w3.org/2001/12/soap-encoding">
<SOAP-ENV:Body xmlns:m="http://www.xyz.org/quotations">
<m:GetQuotation>
<m:QuotationsName>MicroSoft</m:QuotationsName>
</m:GetQuotation>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>SOAP-Antwort
Die SOAP-Antwort enthält die angeforderten Information im Body der Nachricht:
<?xml version = "1.0"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://www.w3.org/2001/12/soap-envelope"
SOAP-ENV:encodingStyle="http://www.w3.org/2001/12/soap-encoding">
<SOAP-ENV:Body xmlns:m="http://www.xyz.org/quotation">
<m:GetQuotationResponse>
<m:Quotation>Here is the quotation</m:Quotation>
</m:GetQuotationResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>