ASSERTEQUALS

Die Funktion ASSERTEQUALS überprüft, ob der Wert eines Feldes auf einer TestPage (TestPage) mit dem angegebenen Wert übereinstimmt.

Parameter

Die Funktion ASSERTEQUALS wird als Feld-Funktion einer TestPage aufgerufen. Dementsprechend bezeichnet der Parameter „TestPage” eine Variable vom Typ TestPage, mit der gearbeitet wird, und der Parameter „Field” ein bestimmtes Feld auf dieser TestPage. Der Parameter „Value” entspricht dem Wert, mit dem der Wert des bezeichneten Feldes verglichen werden soll.

Hinweise zur Verwendung

Wenn die Überprüfung von ASSERTEQUALS fehlschlägt, wird eine Fehlermeldung vom Muster „AsserEquals für Feld Feldname: erwartet Value; vorhanden: Wert des Feldes” ausgegeben. Hierbei ist mit Feldname tatsächlich der Name des Feldes gemeint, eine Caption wird nicht ausgegeben.

Bei der Durchführung von Test-Codeunits ist darauf zu achten, dass die von Microsoft erstellten Tests nur funktionieren, wenn die Sprache in Dynamics NAV auf Englisch umgestellt wird, da für erwartete Fehlermeldungen keine Übersetzungen angelegt wurden.

Beispiel

Für unser Beispiel erstellen wir eine neue Test-Codeunit. Hierfür legen wir eine neue Codeunit an und legen als Subtype den Wert „Test” fest. In dieser legen wir eine neue Funktion an, deren Functiontype wir ebenfalls auf den Wert „Test” setzen. In AL reicht es aus, ein [Test] in die Zeile oberhalb der Funktion einzutragen, in C/AL muss der Wert in den Eigenschaften der Funktion gesetzt werden. Dieser Testfunktion geben wir folgende lokale Variablen mit:

Name Typ Subtyp
Customer Record Customer
SalesHeader Record Sales Header
SalesOrder TestPage Sales Order
SalesLib Codeunit Library - Sales

Anschließend fügen wir folgenden Code in unsere neue Testfunktion ein:

SalesLib.CreateCustomer(Customer);
SalesLib.CreateSalesHeader(SalesHeader,SalesHeader."Document Type"::Order,Customer."No.");

SalesOrder.OpenView();
SalesOrder.GoToKey(SalesHeader."Document Type"::Order, SalesHeader."No.");
SalesOrder."Sell-to Customer No.".ASSERTEQUALS(Customer."No.");

Dieser Code überprüft, ob die von Microsoft in der Codeunit Library - Sales bereitgestellte Funktion CreateSalesHeader den Verkaufskopf tatsächlich nach den eingegebenen Parametern erstellt. Führen wir unsere neue Test-Codeunit jetzt mittels des Test-Tools in Microsoft Dynamics 365 Business Central aus, sollten wir folgendes Ergebnis erhalten:

Wenn wir als erwarteten Wert für die Überprüfung statt der Nummer des Debitoren beispielsweise 'Test' in den Code eintragen und unsere Codeunit auf demselben Weg wieder ausführen, wird das Ergebnis stattdessen wie folgt aussehen: