Behauptungen in SoapUI: Tutorial zu Skripten, XQuery, XPath-Typen

Was ist eine Behauptung?

Unter Behauptung versteht man den Akt der Bestätigung oder Aussage. Es kann auch als Kontrollpunkt oder Validierungspunkt interpretiert werden.

Sobald eine Anfrage an einen Webserver gesendet wird, wird eine Antwort empfangen. Wir müssen überprüfen, ob die Antwort die Daten enthält, die wir erwarten. Um die Antwort zu validieren, müssen wir Behauptungen verwenden.

Arten von Behauptungen

Es gibt verschiedene Möglichkeiten, eine Antwort durchzusetzen; Bei der Validierung einer Antwort konzentrieren wir uns jedoch auf die häufig verwendeten SoapUI-Assertions-Typen. Nachfolgend finden Sie diejenigen, die in der Open-Source-Version von SoapUI verfügbar sind.

1. Eigenschaftsinhalt
2. Compliance-Statusstandard
3. Skript
4. SLA
5. JMS
6. Sicherheit

Abgesehen von den oben aufgeführten Funktionen verfügt die PRO-Version auch über eine integrierte JDBC-Assertion, mit der wir feststellen können, ob der Webdienst die Datenbank korrekt aktualisiert hat.

ENTHÄLT BEHAUPTUNG

Sucht nach der Existenz der angegebenen Zeichenfolge. Es unterstützt auch reguläre Ausdrücke.

Wir werden mit dem gleichen Beispiel aus dem vorherigen Tutorial mit WSDL-Anfrage fortfahren http://www.dneonline.com/calculator.asmx.

Schritt 1: Standardmäßig gibt es keine Behauptungen.

• Die Anzahl der Behauptungen wird auf der Registerkarte „Behauptungen“ angezeigt.
• Um eine neue Behauptung hinzuzufügen, klicken Sie auf die Schaltfläche „Neue Behauptung hinzufügen“.

Schritt 2: Jetzt,

1. Wählen Sie die Behauptungskategorie aus.
2. Wählen Sie den Behauptungstyp aus.
3. Klicken Sie auf "Hinzufügen".

Schritt 3: Lassen Sie uns überprüfen, ob die Zeichenfolge „46“ in der Antwort vorhanden ist. OK klicken'

Hinweis: Wir können die Groß-/Kleinschreibung auch ignorieren und einen regulären Ausdruck hinzufügen.

Schritt 4: Beim Hinzufügen wird die Behauptung sofort ausgeführt und zeigt an, ob sie GÜLTIG oder UNGÜLTIG ist.

Schritt 5: Nehmen wir nun an, wir ändern den Inhalt von „Contains Assertion in SoapUI“ in „47“ und sehen, was passiert.

Schritt 6: Die Behauptung wird ausgeführt und das Ergebnis wird an den Benutzer weitergeleitet. Da die Zeichenfolge „47“ nicht in der Antwort enthalten ist, ist die Behauptung fehlgeschlagen.

ENTHÄLT KEINE BEHAUPTUNG

Sucht nach der Nichtexistenz der angegebenen Zeichenfolge. Es unterstützt auch reguläre Ausdrücke.

Schritt 1: Nachdem Sie nun auf die Schaltfläche „Neue Behauptungen hinzufügen“ geklickt haben,

1. Wählen Sie die Behauptungskategorie aus.
2. Wählen Sie den Behauptungstyp aus – in diesem Fall „NICHT enthält“.
3. Klicken Sie auf "Hinzufügen".

Schritt 2: Lassen Sie uns überprüfen, ob die Zeichenfolge „intA“ in der Antwort vorhanden ist. Geben Sie die Zeichenfolge „FromCurrency“ ein und klicken Sie auf „OK“.

Schritt 3: Sobald eine Assertion hinzugefügt wird, wird sie ausgeführt und das Ergebnis angezeigt. Bisher haben wir zwei Assertions hinzugefügt, daher werden beide Assertions ausgeführt und das Ergebnis angezeigt.

Schritt 4: Lassen Sie uns nun den Inhalt der „Not Includes Assertion“ ändern und sehen, was passiert. Wir prüfen, ob die Zeichenfolge „AddResult“ nicht vorhanden ist.

Schritt 5: Die Zeichenfolge „AddResult“ ist tatsächlich in der Antwort vorhanden, daher schlägt die „NOT Contains“-Behauptung fehl, wie unten gezeigt.

XPATH-MATCH-ASSERTION

Verwendung XPath Ausdruck, um den Zielknoten und seine Werte auszuwählen. XPath ist eine XML-Abfragesprache zum Auswählen von Knoten aus einem XML-Dokument.

Schritt 1: Nachdem Sie nun auf die Schaltfläche „Neue Behauptungen hinzufügen“ geklickt haben,

1. Wählen Sie die Behauptungskategorie aus.
2. Wählen Sie den Assertionstyp – in diesem Fall „XPath Match“.
3. Klicken Sie auf "Hinzufügen".

Schritt 2: Das Fenster „XPath hinzufügen“ wird geöffnet.

Bevor wir SoapUI XPath hinzufügen, müssen wir den NameSpace deklarieren. Ein XML-Namespace ist eine Sammlung von Namen, die durch eine URI-Referenz (Uniform Resource Identifier) ​​identifiziert werden und in XML-Dokumenten als Element- und Attributnamen verwendet werden. Dasselbe wird in der SOAP UI XPath Assertion verwendet.

Um den XML-Namespace zu deklarieren, müssen wir nur auf die Schaltfläche „Deklarieren“ klicken, was die Arbeit für uns erledigt. Andernfalls können wir auch selbst manuell einen Namespace deklarieren.

Nachdem wir den Namespace deklariert haben, müssen wir den XPath mithilfe des erstellten Namespace referenzieren.

Wenn Sie auf die Schaltfläche „Deklarieren“ klicken, werden zwei Namespaces angezeigt, da wir zwei URIs haben. Eine davon ist die Schema-URL und die andere entspricht der tatsächlichen Webdienst-URL. Wir müssen den tatsächlichen Namespace verwenden, in dem sich der Webdienst befindet, und NICHT den Schema-Namespace, während wir auf XPath verweisen.

Deklarieren Sie den Namensraum Soap='http://schemas.xmlsoap.org/soap/envelope/';

Namensraum deklarieren ns1='http://tempuri.org/';

Schritt 3: Jetzt müssen wir den XPath des XML-Knotens eingeben, den wir validieren müssen.

//ns1:AddResult Gibt uns den Wert des dazwischen eingeschlossenen Knotens & und ns1 entspricht dem deklarierten Namespace, der auf „http://tempuri.org/“ verweist.

Nachdem wir das XML eingegeben haben, müssen wir auf „Aus aktueller Antwort auswählen“ klicken, damit der Wert aus der aktuellen Antwort zum künftigen Vergleich übernommen wird.

Schritt 4: Bisher

1. Nachdem wir die Namespaces deklariert haben, haben wir den XPath des XML-Knotens eingegeben, den wir validieren müssen.
2. Wir müssen auf „Aus aktuellem Wert auswählen“ klicken, um den aktuellen Wert als erwarteten Wert festzulegen.
3. Dem Benutzer wird der aktuelle Wert angezeigt, den wir bei Bedarf ändern können.
4. Klicken Sie auf „Speichern“.

Schritt 5: Die hinzugefügte Assertion in SoapUI wird wie unten dargestellt angezeigt.

Skript-Assertions

Diese Behauptungstechnik ist die am weitesten verbreitete Technik, da es äußerst schwierig ist, Hunderte von Behauptungen zu verwalten und aufrechtzuerhalten.

SOAP UI verwendet entweder Groovy Scripting oder JavaSkript für Skriptbehauptungen. Die Skripttechnik wird zur Entwicklung eines Frameworks zum Testen von SOAP eingesetzt. Skriptbehauptungen werden unter folgenden Umständen verwendet.

Mithilfe von Skripten kann der Benutzer vor und nach der Ausführung eines Testfalls einige Vorgänge ausführen, indem er die Methoden „Setup“ bzw. „Teardown“ verwendet. „Setup“ ist ein Vorgang, der vor der Ausführung einer bestimmten Methode ausgeführt wird (Beispiel: Objekterstellung und -initialisierung), während „Teardown“ ein Vorgang ist, der nach der Ausführung der Methode ausgeführt wird (z. B.: Objekte zerstören und bereinigen). Diese Funktion ist bei anderen Assertion-Typen nicht verfügbar und kann nur durch Codierung ausgeführt werden.

Es ermöglicht Benutzern das Öffnen/Schließen eines Projekts, um projektbezogene Einstellungen zu initialisieren oder zu bereinigen und auch mit Umgebungsvariablen zu arbeiten, was bei der Skripterstellung sehr hilfreich ist.

Es hilft uns bei der Durchsetzung eines dynamischen Antwortinhalts.

Skript-Assertionen werden zum Erstellen benutzerdefinierter Assertionen verwendet, die NICHT von der SOAP-Benutzeroberfläche vordefiniert sind.

Um die Skript-Assertion in SoapUI zu demonstrieren, verwenden wir den WSDL-Rechner, den Testfall „Hinzufügen“, den wir zuvor erstellt haben.

Schritt 1: Die Schritte zum Hinzufügen von Groovy-Skripten sind dieselben wie bei anderen Behauptungen, mit der Ausnahme, dass die Behauptung nicht vordefiniert ist. Stattdessen handelt es sich um eine benutzerdefinierte Behauptung, die größere Flexibilität bietet als die integrierten.

Wählen Sie den Testschritt aus, zu dem die Behauptung hinzugefügt werden soll.

Klicken Sie wie unten gezeigt auf die Schaltfläche „Behauptung hinzufügen“.

Schritt 2: Wählen Sie nun die Kategorie Behauptung aus.

1. In diesem Fall handelt es sich um Script.
2. Wählen Sie SoapUI Script Assertion aus und es sind keine Untertypen damit verknüpft.
3. Klicken Sie auf „Hinzufügen“.

Schritt 3: Der Skriptdialog wird geöffnet, in dem der Benutzer ein benutzerdefiniertes Skript schreiben kann, um die Antwort-XML zu validieren.

Schritt 4: Lassen Sie uns nun ein tolles Skript schreiben, um die Conversion-Rate zu validieren. Das Skript ist unten mit den eingebetteten Kommentaren angehängt. Es wird empfohlen, Kenntnisse darüber zu haben Java Skript oder Groovy Skript, bevor Sie versuchen, Ihr eigenes Skript zu schreiben.

//Define Groovy Utils and holder for validating the XML reponse content
def groovyUtils = new com.eviware.soapui.support.GroovyUtils(context)
def holder = groovyUtils.getXmlHolder(messageExchange.responseContent)

//Define the NameSpace
holder.namespaces["ns1"] = "http://tempuri.org/"

//Get the Value of the Node 'AddResult' and assign to a variable
def addResult = holder.getNodeValue("//ns1:AddResult")

//print the value of the result in the Output panel
log.info "The result value for integers is " + addResult

//Comparing the value to print 'Pass' or 'Fail'
if(addResult=="46")
{ log.info "Pass" }
else
{ log.info "fail"}

1. Klicken Sie auf die Schaltfläche „Ausführen“, um die Ausführung auszulösen.
2. Die Ausgabe des Skripts wird im Ausgabebereich angezeigt. Es wurden sowohl der Conversion-Wert als auch das Endergebnis (Bestanden oder Nicht bestanden) gedruckt.
3. Es wird die Information angezeigt, dass die Skript-Assertion erfolgreich war. Klicken Sie auf „OK“.

Hinweis: Das endgültige Informations-Popup wird immer mit der Meldung „Skript-Assertion bestanden“ angezeigt, solange das Skript syntaktisch korrekt ist. Es hat keinen Zusammenhang mit Ihrer Aussage im Skript.

klicken Sie auf OK

Schritt 5: Auf der Registerkarte „Assertion“ werden nun alle Assertionen angezeigt, die wir für diese Testsuite hinzugefügt haben, mit dem Status für jede einzelne davon.

Schritt 6: Aktuell

1. Wählen Sie die Testsuite aus der Navigatorstruktur aus
2. Klicken Sie auf die Schaltfläche „Ausführen“.
3. Die Ergebnisse werden für die gesamte Testsuite angezeigt.

Xquery-Match-Assertion

Es verwendet einen Xquery-Ausdruck, um Inhalte aus der Zieleigenschaft auszuwählen. Wir benötigen ein viel größeres Antwort-XML, um die XQuery-Assertion in SoapUI besser zu verstehen. Lassen Sie uns eine weitere WSDL importieren, wie unten gezeigt: http://www.webservicex.net/medicareSupplier.asmx?WSDL

Schritt 1: Führen Sie einen Rechtsklick auf das vorhandene Projekt aus und wählen Sie „WSDL hinzufügen“.

Schritt 2: Führen Sie einen Rechtsklick auf das vorhandene Projekt aus und wählen Sie „WSDL hinzufügen“. Belassen Sie die anderen Optionen als Standard und klicken Sie auf die Schaltfläche „OK“.

Schritt 3: Alle Vorgänge sind wie unten gezeigt aufgelistet.

Schritt 4: Fügen wir nun a hinzu Testfall innerhalb derselben Testsuite, für die wir erstellt hatten Tests der Währungsumrechner.

Schritt 5: Geben Sie den Namen des Testfalls ein und klicken Sie auf die Schaltfläche „OK“.

Schritt 6: Der Testfall wird wie unten gezeigt erstellt.

Schritt 7: Speichern
einen neuen Testschritt vom Typ „Soap Test Request“, wie unten gezeigt.

Schritt 8: Geben Sie den Namen des Testschritts ein. Sagen wir – Lieferant_nach_Stadt, was aussagekräftiger wäre. Klicken Sie auf „OK“.

Schritt 9: Wähle aus Operation, die wir validieren möchten. In diesem Fall ist es „MedicareSupplierSoap -> GetSupplierByCity“. Klicken Sie auf „OK“.

Schritt 10: Geben Sie den Namen des Testfalls ein und klicken Sie auf „OK“.

Schritt 11: Die XML-Gliederung der Anforderung wird wie unten dargestellt angezeigt.

Schritt 12: Lassen Sie uns nun alle Lieferanteninformationen für die Stadt „New York“ finden.

Fügen Sie dazu Ihrem Code die folgenden Zeilen hinzu.

<GetSupplierByCity xmlns="http://www.webservicex.net/">

<City>New York</City>

</GetSupplierByCity>

WSDL in der folgenden URL – http://www.webservicex.net/medicareSupplier.asmx?op=GetSupplierByCity

Schritt 13: Nach der Durchführung des Tests erhalten wir die folgende Antwort

Schritt 14: Nehmen wir an, wir müssen die gesamte Lieferantennummer validieren. Wir können XPath Assertion nicht verwenden, da wir Hunderte von XPath Assertion benötigen. Daher ist der Einsatz von XQuery in diesem Fall unumgänglich.

XQuery Assertion hilft uns, eine Gruppe von XML-Antworten zu validieren, die sich wiederholender Natur sind.

Schritt 15: Klicken Sie nun auf „Behauptung hinzufügen“,

1. Wählen Sie in diesem Fall die „Assertionskategorie“ – Eigenschaftsinhalt.
2. Wählen Sie den Assertionstyp als „XQuery Assertion“ aus.
3. Klicken Sie auf „Hinzufügen“.

Schritt 16: Ähnlich wie bei XPath Assertion müssen wir den Namespace deklarieren.

1. Klicken Sie auf die Schaltfläche „Deklarieren“, damit SOAP UI den Namespace automatisch deklarieren kann. Wenn Sie auf die Schaltfläche „Deklarieren“ klicken, wird dem Benutzer ein „POP-up“ mit der Meldung „Stattdessen Namespace aus Schema deklarieren“ angezeigt. Klicken Sie auf „Ja“, um wie unten gezeigt fortzufahren.

   Hinweis: Wenn Sie auf die Schaltfläche „Deklarieren“ klicken, erhalten Sie möglicherweise unterschiedliche URLs als Namespace-Deklaration. Für die Codierung wird jedoch der tatsächliche Namespace des Webdienststandorts berücksichtigt.

   

2. Um die gesamte Lieferantennummer abzurufen, müssen wir eine XPath-Abfrage schreiben und diese innerhalb von <SupplierNumber> und platzieren Stichworte.
3. Klicken Sie auf „Aus aktueller Antwort auswählen“, um die Ausführung anhand der aktuellen Antwort durchzuführen.
4. Wenn Sie auf „Aus aktuellem auswählen“ klicken, werden alle Lieferantennummern aufgelistet.
5. Klicken Sie auf „Speichern“.

// Namespace declaration
declare namespace soap='http://schemas.xmlsoap.org/soap/envelope/';
declare namespace ns1='http://www.webservicex.net/';
declare namespace x = '';

// Placing the result in Myresult Tags

{
// Iterating through all the supplier number 
for $x in //ns1:GetSupplierByCityResponse/ns1:SupplierDataLists/ns1:SupplierDatas/ns1:SupplierData

//Return all the Supplier number within ‘SupplierNumber’ Tags.
return {data($x/ns1:SupplierNumber)}
}

Schritt 17: XQuery Assertion wird ausgeführt und zeigt das Endergebnis im Fenster „Assertion“ an, wie unten dargestellt. Jetzt haben wir erfolgreich eine Xquery-Behauptung hinzugefügt, mit der wir alle Informationen zur Lieferantennummer validiert haben. Das Gleiche wird jedes Mal mit den tatsächlichen Werten verglichen, wenn die Anfrage an den Webserver gesendet wird.

Hinweis: Die tatsächlichen Werte werden nicht angezeigt. Wenn alle tatsächlichen Werte mit den erwarteten Werten übereinstimmen, wird „VALID“ angezeigt, andernfalls „Failed“.

Wann sollte die integrierte Behauptung verwendet werden?

• Wenn eine Antwort so kurz ist, dass sie mithilfe einer dieser integrierten Behauptungen validiert werden kann.
• Wir können Inbuilt Assertion auch verwenden, wenn die vom Webserver gesendete Antwort immer statischer Natur ist. Wenn es dynamisch ist, können wir es nicht mithilfe integrierter Behauptungen behaupten.
• Wenn die Verwendung integrierter Zusicherungen wie Timeout-Zusicherungen und Sicherheitszusicherungen unumgänglich wird.
• Eingebaute Behauptungen eignen sich ziemlich gut für den einmaligen Gebrauch, bei dem Tests nicht wiederholt werden müssen.

Behauptungsoptionen

Die erstellten Behauptungen können am besten mit Hilfe des unten hervorgehobenen Kontrollfelds gesteuert werden.

Die erstellten Behauptungen ermöglichen es Testern, folgende Dinge aus der Behauptungs-Toolbox zu konfigurieren.

• Nachfolgend sind die Funktionen aufgeführt, die ausschließlich in der PRO-Version von SOAP UI verfügbar sind. Die PRO-Version hilft uns auch beim Gruppieren von Behauptungen, sodass wir den erstellten Behauptungen eine weitere Validierungsebene hinzufügen können.

UND: Alle Behauptungen werden als GÜLTIG-Behauptung ausgewertet, was zur Gruppenbedingung PASSED führt. ODER: Mindestens eine der Behauptungen innerhalb der Gruppe muss GÜLTIG sein, um eine Gruppenbedingung PASSED zu bestätigen.

• Pro-Version erlaubt auch Klonen von Behauptungen: Mit dieser Option können Tester das Kopieren einer Behauptung in einen anderen Testschritt im selben oder einem anderen Projekt zulassen.
• Behauptungen deaktivieren/aktivieren: Mit dieser Option können Sie jede gruppierte oder nicht gruppierte Behauptung deaktivieren oder aktivieren. Wenn eine Behauptung deaktiviert ist, wird sie ausgegraut und wenn ein Testfall ausgeführt wird, werden deaktivierte Behauptungen nicht ausgeführt.
• Gruppierung von Behauptungen aufheben: Alle gruppierten Behauptungen können aufgehoben werden, wenn Tester dies beschließen.

Vollständige Liste der Methoden, die in verschiedenen Behauptungstypen verfügbar sind

Laden Sie das SOAPUI-Projekt herunter, das die oben genannten Behauptungen enthält

Häufige Fehler und Fehlerbehebung

Verwenden Sie den richtigen Namespace. Der Namensraum sollte die URL sein, unter der sich der Webdienst befindet.

Wenn beim Entwickeln einer Skript-Assertion ein Fehler auftritt, verwenden Sie „log.info“, um den Inhalt der Variablen auszudrucken

Wenn Sie nicht die gewünschte Ausgabe erhalten, überprüfen Sie, ob in der Anforderung eine gültige Eingabe übergeben wird.

Wenn Sie beispielsweise im Währungsumrechner „intA“ als „x“ eingeben, was keine Ganzzahl ist, gibt die Ausgabe einen Fehlercode als „SOAP-Client“ aus, was bedeutet, dass das Problem mit dem Parameter zusammenhängt, der von übergeben wird Client-Seite.

Stellen Sie sicher, dass Sie bei der Verwendung von XPATH und XQuery-Assertion die richtige Syntax verwenden. Sie sollten NICHT Punkt(.) anstelle von Doppelpunkt(:) verwenden, während Sie die obige Behauptung verwenden. Die Syntax lautet //namespace:Tagname und NICHT //namespace.tagname. Dadurch erhalten Sie möglicherweise die Meldung „KEINE Übereinstimmung in der aktuellen Antwort“, obwohl der Tag-Name korrekt ist.