Generic Service Client-Aufruf - Details

Im generischen Service-Client enthalten Serviceaufrufe den Inhalt und die Transportinformationen für den Aufruf. Der Inhalt besteht aus der SOAP-Rahmenanweisung. Die Transportinformationen beziehen sich auf die Informationen, die je nach ausgewähltem Protokoll zum Senden, Empfangen und Beantworten erforderlich sind.

Nachricht

Auf dieser Seite werden die XML-Inhalte der Anforderung dargestellt und kann auf die Datenkorrelation zugegriffen werden. Die gleichen Inhalte werden auf drei verschiedene Arten dargestellt.

Formular
Diese Sicht bietet eine vereinfachte Sicht der Nachricht, in der die Werte für den XML-Inhalt bearbeitet werden können.
Baum

Diese Sicht bietet eine Detailsicht der XML-Struktur, einschließlich Elementen, Namensbereichen und zugeordneten Werten. Mithilfe von Hinzufügen, Einfügen, Entfernen, Nach oben und Nach unten können Sie die XML-Elemente und Namensbereiche im Baum bearbeiten.

Klicken Sie auf Filter, um Namensbereichs-, Attribut- oder Textknoten je nach Ihren Anforderungen aus- oder einzublenden.

Klicken Sie auf Nur gültige Änderungen zulassen, um das intelligente Bearbeiten auf Basis eines XML-Schemadokuments (XSD) zu aktivieren. Klicken Sie mit der rechten Maustaste auf das Projekt und wählen Sie Eigenschaften und Schemakatalog aus, um verschiedene XSD-Dokumente für die Workbench anzugeben. Inaktivieren Sie Nur gültige Änderungen zulassen, wenn Sie über kein XSD-Dokument verfügen oder wenn Sie das Schema umgehen möchten.

Sie können mit der rechten Maustaste auf ein XML-Element klicken, um es in ein XML-Fragment zu konvertieren. Auf diese Weise können Sie eine Datenkorrelation (Datenpools verwenden und Referenzen erstellen) für das gesamte XML-Fragment anstatt nur für den Wert ausführen.

Quelle
In dieser Sicht wird der XML-Quelleninhalt der Nachricht oder einfacher Textinhalt angezeigt.
Wichtig: In der Sicht "Quelle" dürfen die mit SoaTag beginnenden Tags nicht bearbeitet werden. Ein Löschen oder Ändern dieser Tags führt zu einer Beschädigung von Verweisen und Ersetzungen im Test. Diese Tags können nach dem Löschen nicht erneut erstellt werden.

Anhänge

Auf dieser Seite werden die MIME-Anhänge aufgelistet, die der Anforderung zugeordnet sind. Die Inhalte dieser Sicht entsprechen der MIME-Spezifikation (Multipurpose Internet Mail Extensions). Mithilfe dieser Seite können Workbench-Ressourcen als MIME-Anhänge hinzugefügt und Eigenschaften geändert werden.

Anmerkung: Wenn Sie Web-Service-Anhänge verwenden möchten, müssen Sie eine Reihe von Java™-Bibliotheken zu der Java Runtime Environment (JRE) hinzufügen, die von der Workbench verwendet wird. Weitere Informationen finden Sie in Umgebung zur Handhabung von Dateianhängen konfigurieren.
Die Inhalts-ID ist die Kennung, die von der Anforderung für den Verweis auf die Anhänge verwendet wird. Das Verfahren zur Verwendung dieser Kennung hängt von Ihren Servervoraussetzungen ab.
MTOM-Übertragungsmechanismus verwenden
Von der Anforderung wird standardmäßig SwA (SOAP Messages with Attachments) zur Handhabung von Anhängen verwendet. Wählen Sie diese Option aus, wenn Anhänge mithilfe des SOAP-Übertragungsmechanismus MTOM (Message Transmission Optimization Mechanism) gehandhabt werden sollen.

Transport

Auf dieser Seite werden die Transporteinstellungen konfiguriert, die zum Senden der Anforderung verwendet werden. Die Transportprotokolleinstellungen beziehen sich auf eine Transportkonfiguration, bei der es sich um ein HTTP-, JMS- (Java Message Service) oder WebSphere MQ-Protokoll handeln kann. Sie können mehrere Konfigurationen für jedes Protokoll erstellen und auf diese Weise ohne großen Aufwand zwischen Protokollen oder Protokollvarianten wechseln.

HTTP
Wählen Sie HTTP aus, um den HTTP-Transport für die Anforderung zu verwenden. Auf der Anforderungsebene können Sie eine URL- oder SOAP-Aktion sowie den Verweis auf die globale Konfiguration eines Tests aktualisieren.
Protokollkonfiguration
Klicken Sie auf Ändern, um eine vordefinierte Transportkonfiguration anzugeben oder eine Konfiguration zu erstellen. HTTP- Transportkonfigurationen enthalten wiederverwendbare Proxy- und Authentifizierungseinstellungen.
Methode und Version
Hier geben Sie die HTTP-Methode und -version an, die zum Aufrufen der Serviceanforderung verwendet werden sollen.
URL
Hier geben Sie den URL-Endpunkt der Serviceanforderung an.
Header
Hier geben Sie die Namen und Werte der angepassten HTTP-Header an, die vom Service benötigt werden. Klicken Sie auf Hinzufügen, Bearbeiten oder Entfernen, um die Headerliste zu ändern.
Cookies
Hier geben Sie die Namen und Werte der Cookies an, die vom Service benötigt werden. Klicken Sie auf Hinzufügen, Bearbeiten oder Entfernen, um die Cookieliste zu ändern.
JMS

Wählen Sie JMS aus, um den JMS-Transport (Java Messaging Service) für die Anforderung zu verwenden. Über diese Seite können Sie Zeichenfolgeneigenschaften hinzufügen, die der Anforderung für eine JMS-Konfiguration zugeordnet sind. Diese werden über JMS als Nachrichteneigenschaften gesendet.

Protokollkonfiguration
Klicken Sie auf Ändern, um eine vordefinierte Transportkonfiguration anzugeben oder eine Konfiguration zu erstellen. JMS-Transportkonfigurationen enthalten Einstellungen für den generischen Endpunkt, den Empfangspunkt und Adapter, die wiederverwendet werden können.
Eigenschaften
Hier geben Sie die Namen und Werte aller Zeichenfolgeeigenschaften an, die für die Anforderung für die aktuelle JMS-Transportkonfiguration erforderlich sind. Diese Eigenschaften werden über JMS als Nachrichteneigenschaften gesendet. Klicken Sie auf Hinzufügen, Bearbeiten oder Entfernen, um die Liste der Eigenschaften zu ändern.
WebSphere MQ
Wählen Sie MQ aus, wenn für die Anforderung der IBM® WebSphere MQ-Transport verwendet werden soll. Über diese Seite können Sie die SOAP-Aktion angeben und die Einstellungen für die WebSphere MQ-Konfiguration auf der Teststufe außer Kraft setzen.
Protokollkonfiguration
Klicken Sie auf Ändern, um eine vordefinierte Transportkonfiguration anzugeben oder eine Konfiguration zu erstellen. MQ-Transportkonfigurationen enthalten Einstellungen für die generische Warteschlange, den Header und SSL, die wiederverwendet werden können.
SOAP-Aktion
Gibt die SOAP-Aktion an, die zum Aufrufen der MQ-Anforderung verwendet werden soll.
Werte der MQ-Protokollkonfiguration überschreiben
Wählen Sie diese Option aus, um die Felder der MQ-Nachricht zu konfigurieren. Sie können eine Untergruppe eines MQ-Nachrichtendeskriptors für die Verwendung mit anderen Servertypen durch ein benutzerdefiniertes Format ersetzen, insbesondere bei Verwendung einer XML-Aktivierungsanforderung. Weitere Informationen zu Nachrichtendeskriptoren finden Sie in der WebSphere MQ-Dokumentation. Diese Einstellungen ersetzen den Nachrichtendeskriptor und die Headereinstellungen in der MQ-Protokollkonfiguration.
Angepassten Header verwenden
Wählen Sie diese Option aus, um angepasste Header für das in WebSphere MQ enthaltene Feature "Transport für SOAP über MQ" anzugeben. Diese Funktion verwendet ein vorgegebenes MQ-Nachrichtenformat (RFH2), daher sind bei Auswahl dieser Funktion andere Optionen von Nachrichtendeskriptor inaktiviert.

Sicherheit für Anforderung

Auf dieser Seite können Sie die Sicherheitsalgorithmusstacks bearbeiten, die vom Sicherheitsprotokoll auf Serviceanforderungen angewendet werden, bevor diese gesendet werden. Sicherheitsstacks bestehen aus einer Reihe von Algorithmen, die in einer vorgegebenen Reihenfolge ausgeführt werden.
Einstellungen des WSDL Security Editor überschreiben
Standardmäßig bearbeiten Sie den einer bestimmten WSDL-Datei zugeordneten Sicherheitsalgorithmusstapel im WSDL Security Editor. Wählen Sie diese Option aus, um einen anderen Sicherheitsalgorithmusstapel nur für die aktuelle Serviceanforderung festzulegen.
Details zu Sicherheitsalgorithmen
Klicken Sie auf Hinzufügen, Einfügen oder Entfernen, um Sicherheitsalgorithmen zum Stack hinzuzufügen oder aus diesen zu entfernen. Klicken Sie auf Nach oben und Nach unten, um die Reihenfolge der ausgewählten Algorithmen im Sicherheitsstack zu ändern. Die folgenden Sicherheitsalgorithmen können zum Sicherheitsstack hinzugefügt werden:
Zeitmarke
Der Sicherheitsalgorithmus "Zeitmarke" fügt dem XML-Dokument in der Antwort Zeitmarkeninformationen hinzu. Weitere Informationen zu Sicherheitsalgorithmen finden Sie in der Spezifikation zur Web-Service-Sicherheit.
Actor-/Rollenname
Geben Sie bei Bedarf den Namen des Actors an.
Verständnis muss vorliegen
Wählen Sie aus, ob der Sicherheitsalgorithmus verstanden werden muss.
Zeitmarke
Geben Sie die Verzögerung vor dem Hinzufügen der Zeitmarke an.
Benutzernamenstoken
Mit dem Sicherheitsalgorithmus "Benutzernamenstoken" wird dem XML-Dokument in der Antwort ein Benutzernamenstoken hinzugefügt. Weitere Informationen zu Sicherheitsalgorithmen finden Sie in der Spezifikation zur Web-Service-Sicherheit.
Actor-/Rollenname
Geben Sie bei Bedarf den Namen des Actors an.
Verständnis muss vorliegen
Wählen Sie aus, ob der Sicherheitsalgorithmus verstanden werden muss.
Name
Geben Sie den Namen des Benutzers ein.
Kennwort
Geben Sie das Kennwort des Benutzers ein.
Kennworttyp
Geben Sie den Kennworttyp für den Sicherheitsalgorithmus an.
XML-Verschlüsselung
Der Sicherheitsalgorithmus "XML-Verschlüsselung" gibt an, wie das XML-Dokument verschlüsselt wird. Weitere Informationen zu Sicherheitsalgorithmen finden Sie in der Spezifikation zur Web-Service-Sicherheit.
Actor-/Rollenname
Geben Sie bei Bedarf den Namen des Actors an.
Verständnis muss vorliegen
Wählen Sie aus, ob der Sicherheitsalgorithmus verstanden werden muss.
Kennungstyp
Wählen Sie den Typ der gewünschten Schlüsselkennung für die Verschlüsselung aus:
  • ISSUER_SERIAL
  • BST_DIRECT_REFERENCE
  • X509_KEY_IDENTIFIER
  • SKI_KEY_IDENTIFIER
  • EMBEDDED_KEYNAME
  • THUMBPRINT_IDENTIFIER
Benutzerauswahl des XPath-Teils
Mithilfe dieser Option können Sie eine XPath-Abfrage angeben, die Teile des XML-Dokuments beschreibt, die Thema des Algorithmus sein können. Standardmäßig ist der Hauptteil das Thema.
Schlüssel
Wählen Sie den für die Verschlüsselung verwendeten Schlüssel aus. Die Details der jeweiligen Schlüssel können sich ändern.
  • X509-Schlüssel: Gibt den Namen und das Kennwort des X509-Schlüssels sowie den Keystore an, in dem sich dieser befindet.
  • Unaufbereiteter Schlüssel: Gibt den Namen und den Bytewert des Schlüssels in hexadezimaler Form an.
  • Schlüssel für Benutzernamenstoken: Gibt einen Benutzernamen und ein Kennwort für den Token an.
  • Verschlüsselter Schlüssel: Gibt einen verschlüsselten Schlüssel an, der zuvor im Sicherheitsstack definiert wurde. Klicken Sie auf Neuen verschlüsselten Schlüssel einfügen, wenn Sie einen neuen Block für die Definition eines verschlüsselten Schlüssels erstellen möchten.
Verschlüsselungsalgorithmus für Schlüssel
Geben Sie den Standardalgorithmus für ein Verschlüsseln des Transportschlüssels an.
XML-Signatur
Der Sicherheitsalgorithmus "XML-Signatur" gibt an, wie das XML-Dokument signiert wird. Weitere Informationen zu Sicherheitsalgorithmen finden Sie in der Spezifikation zur Web-Service-Sicherheit.
Actor-/Rollenname
Geben Sie bei Bedarf den Namen des Actors an.
Verständnis muss vorliegen
Wählen Sie aus, ob der Sicherheitsalgorithmus verstanden werden muss.
Kennungstyp
Wählen Sie den Typ der gewünschten Schlüsselkennung für die Verschlüsselung aus:
  • ISSUER_SERIAL
  • BST_DIRECT_REFERENCE
  • X509_KEY_IDENTIFIER
  • SKI_KEY_IDENTIFIER
  • EMBEDDED_KEYNAME
  • KEY_VALUE
  • USER_NAME_TOKEN
  • CUSTOM_SYMM_SIGNATURE
Benutzerauswahl des XPath-Teils
Geben Sie eine XPath-Abfrage an, die Teile des XML-Dokuments beschreibt, die Thema des Algorithmus sein können. Standardmäßig ist der Hauptteil das Thema.
Schlüssel
Wählen Sie den für die Verschlüsselung verwendeten Schlüssel aus. Die Details der jeweiligen Schlüssel können sich ändern.
  • X509-Schlüssel: Gibt den Namen und das Kennwort des X509-Schlüssels sowie den Keystore an, in dem sich dieser befindet.
  • Unaufbereiteter Schlüssel: Gibt den Namen und den Bytewert des Schlüssels in hexadezimaler Form an.
  • Schlüssel für Benutzernamenstoken: Gibt einen Benutzernamen und ein Kennwort für den Token an.
  • Verschlüsselter Schlüssel: Gibt einen verschlüsselten Schlüssel an, der zuvor im Sicherheitsstack definiert wurde. Klicken Sie auf Neuen verschlüsselten Schlüssel einfügen, wenn Sie einen neuen Block für die Definition eines verschlüsselten Schlüssels erstellen möchten.
Name des Signaturalgorithmus
Geben Sie den Standardalgorithmus an, der für die Signatur verwendet werden soll.
Kanonisierung
Geben Sie den gewünschten Algorithmus für Kanonisierung an.
Verschlüsselter Schlüssel
In diesem Block wird ein verschlüsselter Schlüssel definiert, der in einem XML-Signatur- oder XML-Verschlüsselungsblock verwendet werden kann. Der Block mit dem verschlüsselten Schlüssel muss sich vor einem Block befinden, in dem der verschlüsselte Schlüssel verwendet wird.
Actor-/Rollenname
Geben Sie bei Bedarf den Namen des Actors an.
Verständnis muss vorliegen
Wählen Sie aus, ob der Sicherheitsalgorithmus verstanden werden muss.
Schlüsselname
Geben Sie den Namen des verschlüsselten Schlüssels ein.
Kennungstyp
Wählen Sie den Typ der gewünschten Schlüsselkennung für die Verschlüsselung aus:
  • ISSUER_SERIAL
  • BST_DIRECT_REFERENCE
  • X509_KEY_IDENTIFIER
  • EMBEDDED_KEYNAME
  • THUMBPRINT_IDENTIFIER
  • SKI_KEY_IDENTIFIER
Schlüsselgröße
Geben Sie die Größe des Schlüssels in Bit an.
Verschlüsselungsalgorithmus für Schlüssel
Geben Sie den Algorithmus an, der zum Verschlüsseln des Schlüssels verwendet werden soll.
Keystore
Wählen Sie einen Keystore (Schlüsselspeicher) aus oder klicken Sie auf Sicherheitskeystore bearbeiten, wenn Sie einen neuen Keystore definieren oder die vorhandenen Keystores verwalten möchten.
Name
Wählen Sie einen Schlüssel aus, der im angegebenen Keystore enthalten ist.
Kennwort
Geben Sie das Kennwort für den ausgewählten Schlüsselnamen ein.
Angepasster Sicherheitsalgorithmus
Wenn Sie eine Java-Klasse als angepassten Sicherheitsalgorithmus implementiert haben, können Sie den angepassten Algorithmus mithilfe dieses Stapelelements auf den Service anwenden.
Name
Geben Sie den Namen des angepassten Sicherheitsalgorithmus an.
Implementierungsklasse
Geben Sie den Namen der Klasse an, mit der der angepasste Sicherheitsalgorithmus implementiert wird. Klicken Sie auf Durchsuchen, um eine Java-Klasse aus dem Arbeitsbereich auszuwählen.
Eigenschaften
Über diese Tabelle können Sie bestimmte Eigenschaften und die zugeordneten Werte an den angepassten Sicherheitsalgorithmus senden.
WS-Addressing
Fügen Sie diesen Stapel hinzu, wenn Ihr Service den Standard "WS-Addressing 2004/08" oder "WS-Addressing 1.0 Core" verwendet.
Namensbereich
Geben Sie den Namensbereich für "WS-Addressing 2004/08" oder "WS-Addressing 1.0 Core" an.
Aktion, wenn Anforderung WS-Adressierung verwendet
Wählen Sie die Aktion aus, die ausgeführt werden soll, wenn sich WS-Addressing (WS-Adressierung) bereits in der Anforderung befindet.
Anonyme Adresse in ReplyTo ersetzen durch
Wählen Sie diese Option aus, wenn im Reply-to-Header anstelle einer anonymen Adresse die angegebene Adresse generiert werden soll.
WS-Adressierung aus Antwort entfernen
Wählen Sie diese Option aus, um alle WS-Adressierungs-Header aus der Antwort zu entfernen.

Sicherheit für Antwort

Auf dieser Seite können Sie die Sicherheitsalgorithmusstacks bearbeiten, die vom Sicherheitsprotokoll auf Antworten angewendet werden, nachdem diese empfangen wurden. Sicherheitsstacks bestehen aus einer Reihe von Algorithmen, die in einer vorgegebenen Reihenfolge ausgeführt werden.
Einstellungen des WSDL Security Editor überschreiben
Standardmäßig bearbeiten Sie den einer bestimmten WSDL-Datei zugeordneten Sicherheitsalgorithmusstapel im WSDL Security Editor. Wählen Sie diese Option aus, um einen anderen Sicherheitsalgorithmusstapel nur für die aktuelle Antwort festzulegen.
Details zu Sicherheitsalgorithmen
Klicken Sie auf Hinzufügen, Einfügen oder Entfernen, um Sicherheitsalgorithmen zum Stack hinzuzufügen oder aus diesen zu entfernen. Klicken Sie auf Nach oben und Nach unten, um die Reihenfolge der ausgewählten Algorithmen im Sicherheitsstack zu ändern. Die folgenden Sicherheitsalgorithmen können zum Sicherheitsstack hinzugefügt werden:
XML-Verschlüsselung
Der Sicherheitsalgorithmus "XML-Verschlüsselung" gibt an, wie das XML-Dokument verschlüsselt wird. Weitere Informationen zu Sicherheitsalgorithmen finden Sie in der Spezifikation zur Web-Service-Sicherheit.
Actor-/Rollenname
Geben Sie bei Bedarf den Namen des Actors an.
Verständnis muss vorliegen
Wählen Sie aus, ob der Sicherheitsalgorithmus verstanden werden muss.
Kennungstyp
Wählen Sie den Typ der gewünschten Schlüsselkennung für die Verschlüsselung aus:
  • ISSUER_SERIAL
  • BST_DIRECT_REFERENCE
  • X509_KEY_IDENTIFIER
  • SKI_KEY_IDENTIFIER
  • EMBEDDED_KEYNAME
  • THUMBPRINT_IDENTIFIER
Benutzerauswahl des XPath-Teils
Mithilfe dieser Option können Sie eine XPath-Abfrage angeben, die Teile des XML-Dokuments beschreibt, die Thema des Algorithmus sein können. Standardmäßig ist der Hauptteil das Thema.
Schlüssel
Wählen Sie den für die Verschlüsselung verwendeten Schlüssel aus. Die Details der jeweiligen Schlüssel können sich ändern.
  • X509-Schlüssel: Gibt den Namen und das Kennwort des X509-Schlüssels sowie den Keystore an, in dem sich dieser Schlüssel befindet.
  • Unaufbereiteter Schlüssel: Gibt den Namen und den Bytewert des Schlüssels in hexadezimaler Form an.
  • Schlüssel für Benutzernamenstoken: Gibt einen Benutzernamen und ein Kennwort für den Token an.
  • Verschlüsselter Schlüssel: Gibt einen verschlüsselten Schlüssel an, der zuvor im Sicherheitsstack definiert wurde. Klicken Sie auf Neuen verschlüsselten Schlüssel einfügen, wenn Sie einen neuen Block für die Definition eines verschlüsselten Schlüssels erstellen möchten.
Verschlüsselungsalgorithmus für Schlüssel
Geben Sie den Standardalgorithmus für ein Verschlüsseln des Transportschlüssels an.
Verschlüsselter Schlüssel
In diesem Block wird ein verschlüsselter Schlüssel definiert, der in einem XML-Signatur- oder XML-Verschlüsselungsblock verwendet werden kann. Der Block mit dem verschlüsselten Schlüssel muss sich vor einem Block befinden, in dem der verschlüsselte Schlüssel verwendet wird.
Actor-/Rollenname
Geben Sie bei Bedarf den Namen des Actors an.
Verständnis muss vorliegen
Wählen Sie aus, ob der Sicherheitsalgorithmus verstanden werden muss.
Schlüsselname
Geben Sie den Namen des verschlüsselten Schlüssels ein.
Kennungstyp
Wählen Sie den Typ der gewünschten Schlüsselkennung für die Verschlüsselung aus:
  • ISSUER_SERIAL
  • BST_DIRECT_REFERENCE
  • X509_KEY_IDENTIFIER
  • EMBEDDED_KEYNAME
  • THUMBPRINT_IDENTIFIER
  • SKI_KEY_IDENTIFIER
Schlüsselgröße
Geben Sie die Größe des Schlüssels in Bit an.
Verschlüsselungsalgorithmus für Schlüssel
Geben Sie den Algorithmus an, der zum Verschlüsseln des Schlüssels verwendet werden soll.
Keystore
Wählen Sie einen Keystore (Schlüsselspeicher) aus oder klicken Sie auf Sicherheitskeystore bearbeiten, wenn Sie einen neuen Keystore definieren oder die vorhandenen Keystores verwalten möchten.
Name
Wählen Sie einen Schlüssel aus, der im angegebenen Keystore enthalten ist.
Kennwort
Geben Sie das Kennwort für den ausgewählten Schlüsselnamen ein.
Angepasster Sicherheitsalgorithmus
Wenn Sie eine Java-Klasse als angepassten Sicherheitsalgorithmus implementiert haben, können Sie den angepassten Algorithmus mithilfe dieses Stapelelements auf den Service anwenden.
Name
Geben Sie den Namen des angepassten Sicherheitsalgorithmus an.
Implementierungsklasse
Geben Sie den Namen der Klasse an, mit der der angepasste Sicherheitsalgorithmus implementiert wird. Klicken Sie auf Durchsuchen, um eine Java-Klasse aus dem Arbeitsbereich auszuwählen.
Eigenschaften
Über diese Tabelle können Sie bestimmte Eigenschaften und die zugeordneten Werte an den angepassten Sicherheitsalgorithmus senden.

Feedback