XML-Aufrufdetails

XML-Aufrufelemente umfassen Inhalt und Transportinformationen des Aufrufs. Der Inhalt besteht aus einfachem XML, das über ein HTTP- oder JMS-Transportprotokoll übertragen wird. Die Transportinformationen beziehen sich auf die Informationen, die je nach ausgewähltem Protokoll zum Senden, Empfangen und Beantworten erforderlich sind.

Knotenname automatisch aktualisieren: Wenn diese Option aktiviert ist, wird der Name des XML-Aufrufelements in den Testinhalten aktualisiert.
Unidirektional: Diese Option gibt an, dass nach dem Aufruf vom Server keine Antwort erwartet wird. Dadurch wird die Schaltfläche Rückgabe aktualisieren inaktiviert.
Zeitlimit (ms): Dies ist der Zeitlimitwert in Millisekunden. Wenn nach der angegebenen Frist keine Antwort empfangen wurde, wird ein Fehler erzeugt.
Bedenkzeit (ms): Diese gibt die vom Programm berechnete Zeitverzögerung an, die bei Ausführung dieses Tests mit mehreren virtuellen Benutzern für jeden Benutzer eingehalten wird. Bei der Bedenkzeit handelt es sich um eine statistische Emulation der Zeitdauer, die reale Benutzer zum Lesen oder Nachdenken benötigen, bevor sie eine Aktion ausführen.
Rückgabe aktualisieren: Dadurch wird das Fenster "Vorschau der Rückgabe" geöffnet. Über dieses Fenster können Sie den Aufruf von der Workbench aus starten, um die dem Aufruf zugeordnete Nachrichtenrückgabe zu erstellen oder zu aktualisieren.

Nachricht

Auf diesen Seiten werden die XML-Inhalte des Aufrufs dargestellt und der Zugriff auf die Datenkorrelation in drei verschiedenen Formularen bereitgestellt.

Formular

Diese Sicht bietet eine vereinfachte Darstellung der Nachricht und dient hauptsächlich zum Bearbeiten der Werte des XML-Inhalts. Über das Menü Schema können Sie die Unterstützung beim Bearbeiten von XML-Inhalten aktivieren, damit die XML-Inhalte gültig sind und der XSD-Spezifikation entsprechen.

In der Sicht Formular fügen Sie die XML-Header hinzu, die für Web-Service-Standardaufrufe erforderlich sind. Klicken Sie in der Leiste Header auf Hinzufügen ( Schaltfläche 'Hinzufügen' ), um die XML-Header-Standardstruktur für WS-Addressing-, WS-ReliableMessaging- oder WS-Coordination-Anforderungen zu erstellen, oder klicken Sie auf Weitere, um andere Standards anzuzeigen. Sie können XML-Header-Elemente aktivieren oder inaktivieren und die richtigen Werte für jedes XML-Element angeben. Es werden Prüfungen durchgeführt, um sicherzustellen, dass der XML-Inhalt gültig ist.

Anmerkung: Wenn Sie XML-Header zu Aufrufen in IBM® Security AppScan hinzufügen möchten, fügen Sie einen Algorithmus des Typs Statische XML-Header auf der Registerkarte Anforderungsstapel der Anforderung hinzu.

Baum

Diese Sicht bietet eine hierarchische Darstellung der XML-Struktur der Nachricht, 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.

Verwenden Sie die Spalte Überspringen wenn leer, um die leeren XML-Elemente auszuwählen, die übersprungen werden sollen. Diese Spalte ist nur sichtbar, wenn Sie das Markierungsfeld Spalte 'Skip if Empty' im XML Tree Viewer anzeigen in Fenster > Benutzervorgaben > Test > Testeditor > Servicetest ausgewählt haben.

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 Anforderungen 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 Verweise erstellen) für das gesamte XML-Fragment anstatt nur für den Wert durchführen.

Quelle

In dieser Sicht wird der XML-Quelleninhalt der Nachricht oder einfacher Textinhalt angezeigt. Klicken Sie auf XML-Text formatieren, um XML-Inhalt zu formatieren. Klicken Sie zum Anzeigen von XML-Inhalt in einer einzigen Zeile ohne Umbrüche auf XML-Text in eine einzige Zeile packen. Ähnliche Steuerelemente sind für JSON-Inhalt verfügbar.

Wichtig: Bearbeiten Sie in der Sicht "Quelle" nicht die Tags, die mit SoaTag beginnen. Das 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 neu erstellt werden.

Anhänge

Auf dieser Seite werden die dem Aufruf zugeordneten MIME-Anhänge aufgelistet. 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.

Die Inhalts-ID ist die Kennung, die vom Aufruf für den Verweis auf Anhänge verwendet wird. Das Verfahren zur Verwendung dieser Kennung hängt von Ihren Servervoraussetzungen ab.

Protokoll

Auf dieser Seite wird das zum Senden des Aufrufs verwendete Protokoll behandelt. Dabei kann es sich um ein HTTP- oder JMS-Protokoll (Java™ Message Service) auf einer nachrichtenweisen Basis handeln.

HTTP

Über diese Seite können Sie die HTTP-Einstellungen außer Kraft setzen, die dem Aufruf für eine lokale HTTP-Konfiguration zugeordnet sind.

Methode

Mithilfe dieser Option können Sie die HTTP-Methode des XML-Aufrufs aus der folgenden Liste von Methoden angeben:

POST
GET
PUT
DELETE

Version

Mithilfe dieser Option können Sie entweder HTTP 1.0 oder HTTP 1.1 angeben.

URL

In diesem Feld können Sie die URL des XML-Aufrufs angeben.

Header

In diesem Abschnitt können Sie dem Aufruf Header hinzufügen. Header müssen mit der angegebenen HTTP-Methode kompatibel sein.

Folgende Header werden von der Anwendung verwaltet und können nicht hinzugefügt werden:

User Agent (Benutzeragent)
Host Connection (Hostverbindung)
Cache-Control (Cachesteuerung)
Pragma
Content-Type (Inhaltstyp)
Content-Length (Inhaltslänge)

Cookies

Mithilfe dieses Abschnitts können Sie Cookies verwalten. Sie können Cookies hinzufügen, bearbeiten und entfernen sowie Referenzen erstellen.

JMS

Über diese Seite können Sie Zeichenfolgeneigenschaften hinzufügen, die dem Aufruf für eine lokale JMS-Konfiguration zugeordnet sind. Diese werden über JMS als Nachrichteneigenschaften gesendet.

MQ

Über diese Seite können Sie die Einstellungen außer Kraft setzen, die dem Aufruf für eine lokale WebSphere MQ-Konfiguration zugeordnet sind.

Name

Dieser Name wird im Aktivierungsaufruf als Link zu dieser Protokollkonfiguration angezeigt.

Name des WS-Managers

Gibt den Namen des Warteschlangenmanagers an, an den der Aufruf gesendet werden soll.

Name der Warteschlange

Gibt den Namen der Warteschlange an, die vom Warteschlangenmanager verwaltet wird.

Lokalen WS-Manager verwenden

Gibt an, ob der WebSphere MQ-Server auf dem lokalen Computer aktiv ist. Wenn sich der Server auf einem fernen Computer befindet, heben Sie die Markierung dieser Option auf, um die Details des fernen MQ-Servers anzugeben.

Adresse des WS-Managers

Gibt die IP-Adresse oder den Hostnamen des fernen MQ-Servers an.

Port des WS-Managers

Gibt den Listener-Port des fernen MQ-Servers an.

Clientkanal

Gibt den Kanal des Serververbindungsmodus des fernen WS-Managers an.

Temporäre Warteschlange verwenden

Gibt an, ob der MQ-Server eine temporäre Warteschlange erstellt. Bei ausgewählter Option wird die temporäre Warteschlange nur für den Empfang bestimmter Nachrichten erstellt und dann gelöscht.

Name der Warteschlange

Wenn die Markierung der Option Temporäre Warteschlange verwenden aufgehoben ist, gibt sie den Namen der Warteschlange an, in der Nachrichtenrückgaben vom MQ-Server eingehen. Der im Feld Name des WS-Managers angegebene Warteschlangenmanager muss diese Warteschlange verwalten.

Die Aufrufe und Nachrichtenrückgaben werden über die Korrelations-ID in der MQ-Nachricht zugeordnet. Dies bedeutet, dass die Berichtseinstellung der Nachricht auf MQC.MQRO_COPY_MSG_ID_TO_CORREL_ID festgelegt ist. Der Server muss dieser Einschränkung folgen. Dadurch wird die von WebSphere MQ bereitgestellte Funktion "Transport für SOAP" unterstützt.

Zielservice

Diese Option ist für die Verwendung von Microsoft .NET mit der IBM WebSphere MQ-Funktion "Transport für SOAP" gedacht. Dadurch wird der Name der ASPX-Datei innerhalb des .NET Listener-Verzeichnisses angegeben.

RFH2-Header verwenden

Gibt an, ob die SOAP-Nachrichten einen RFH2-Header verwenden, der ein vorgegebenes MQ-Nachrichtenformat nutzt. Bei Auswahl dieser Option sind andere Optionen von Nachrichtendeskriptor inaktiviert. Verwenden Sie diese Option für die WebSphere MQ-Funktion "Transport für SOAP". Wenn Sie die MQ-Bindung von WebSphere Integration Developer (WID) verwenden, erkennt die Bindung Nachrichten mit oder ohne RFH2-Header.

Nachrichtendeskriptor

Mithilfe dieses Abschnitts können Sie die Felder des Aktivierungsaufrufs konfigurieren. Sie können eine Untergruppe eines MQ-Nachrichtendeskriptors für die Verwendung mit anderen Servertypen durch ein benutzerdefiniertes Format ersetzen, insbesondere bei Verwendung eines XML-Aktivierungsaufrufs. Weitere Informationen über Nachrichtendeskriptoren finden Sie in der WebSphere MQ-Dokumentation.

Temporäre Warteschlange verwenden

In diesem Abschnitt können Sie einen Benutzernamen und ein Kennwort für die Basisauthentifizierung auf dem Anwendungsserver angeben.

SSL-Verbindung

Wählen Sie diese Option aus, um eine SSL-Konfiguration zu verwenden, wenn die Einstellung Clientkanal auf einen sicheren Kanal verweist. Klicken Sie auf SSL-Editor öffnen, um eine neue SSL-Konfiguration zu erstellen, oder klicken Sie auf Ändern, um die dem aktuellen Test zugeordnete SSL-Konfiguration zu ändern.

Wenn die zum Erstellen des Aktivierungsaufrufs verwendete WSDL (Web Services Description Language) eine unterstützte JMS URI verwendet, um auf den WebSphere MQ-Server zu verweisen, wird die SSL-Konfiguration automatisch erstellt. Wenn der Testgenerator die SSL-Konfiguration nicht erstellen konnte, müssen Sie eine neue Konfiguration manuell erstellen.

Wenn die WSDL mithilfe des WebSphere MQ-Services (amqwdeployWMService) generiert wurde, bearbeiten Sie die WSDL, um die Transportbindung von HTTP in JMS zu ändern, damit der Testgenerator am Erzeugen einer HTTP-Konfiguration gehindert wird.

Cipher Suite

Geben Sie die Cipher Suite an, die bei der Kanalkonfiguration verwendet wird.

Lokale XML-Sicherheit

Mithilfe dieser Seite können Sie einen benutzerdefinierten Sicherheitsalgorithmus hinzufügen, der in einer Java-Klasse implementiert ist. Es können angepasste Algorithmen auf die XML-Inhalte angewendet werden, die an den Server gesendet und von diesem empfangen werden.

Hinzufügen, Einfügen, Entfernen, Nach oben und Nach unten

Mithilfe dieser Schaltflächen können Sie einen Stack für Sicherheitsalgorithmen erstellen. Die einzelnen Algorithmen werden nacheinander auf den Stack angewendet. Klicken Sie auf Hinzufügen, um einen angepassten Sicherheitsalgorithmus hinzuzufügen.

Tools

Mithilfe dieser Schaltfläche können Sie die Art der Anzeige für den Algorithmusstack ändern.

Angepasster Sicherheitsalgorithmus

Nach dem Hinzufügen eines angepassten Sicherheitsalgorithmus zum Stack: Sie können über dieses Fenster die Java-Klasse angeben, die den Algorithmus implementiert. Die Java-Klasse verwendet die folgende Schnittstelle:

/**
* ***************************************************************
* IBM Confidential
* 
* (c) Copyright IBM Corporation. 2008. Alle Rechte vorbehalten.
* 
* The source code for this program is not published or otherwise
* divested of its trade secrets, irrespective of what has been
* deposited with the U.S. Copyright Office.
* *************************************************************** 
* 
*/

package com.ibm.rational.test.lt.models.wscore.datamodel.security.xmlsec;

import java.util.Properties;
import org.w3c.dom.Document;


public interface ICustomSecurityAlgorithm {
	
	/**
	 * The following methods can be used in both case:
	 * Execution in the workbench and execution of the test.
	 */
	
	
	/**
	 * Called to process de Document that is sent over a transport.
	 * @param subject
	 */
	void process(Document subject);
	/**
	 * Called to un process a document that is received from a server.
	 * @param subject
	 */
	void unProcess(Document subject);
	
	/**
	 * Properties defined in the UI of the CustomSecurityAlgorithm.
	 * @param map
	 */
	void setProperties(Properties map);
	
	/**
	 * The following methods can only be used in terms of cast to test service interface,
	 * or in terms of access to the previous XML  information, when the jar containing
	 * the custom security algorithm is deployed in the performance test project. In
	 * this case you cannot use the algorimth directly from the workbench.
	 */
	
	/**
	 * This object corresponds to the ITestExecutionService object.
	 * This applies only to an algorithm that must link to the execution of the test.
	 * If you plan to use this object you will need to deploy the jar containing the
	 * implementation into your performance test project and not directly into the JRE.
	 * 
	 * In case of a need of the previous xml document received from the execution you can 
	 * obtain the value using:
	 * IDataArea area = ((ITestExecutionService)executionObject).findDataArea(IDataArea.VIRTUALUSER);
	 *String previousXML = (String) area.get("PREVIOUS_XML"); //$NON-NLS-1$
	 * 
	 */
	void setExecutionContext(Object executionObject);

Mit der Methode process werden die XML-Daten modifiziert, bevor diese an den Server gesendet werden.
Mit der Methode unprocess werden die XML-Daten modifiziert, nachdem diese vom Server empfangen wurden.
Mit der Methode setProperties werden sämtliche Eigenschaften abgerufen, die für diese angepasste Sicherheitsschnittstelle im Sicherheitseditor definiert sind.
Die Methode setExecutionContext wird während des Tests mit dem Objekt ITestExecutionServices aufgerufen, das der Nachricht entspricht, die diese angepasste Sicherheitsschnittstelle verwendet.

Angepasster Klassenname für Sicherheitsalgorithmus: Gibt die Klasse an, die den Sicherheitsalgorithmus implementiert. Klicken Sie auf Klasse durchsuchen, um eine Klasse aus dem Arbeitsbereich auszuwählen.
Algorithmenname: Gibt den Namen des aktuellen Algorithmus an.
Eigenschaften: In dieser Liste sind die Eigenschaften angegeben, die von der Methode setProperties im Algorithmus verwendet werden. Verwenden Sie Hinzufügen, Entfernen oder Bearbeiten, um die Eigenschaftenliste zu erstellen.

Feedback