1.2 Skripte testen
Beachten Sie bitte, dass Skripte, die für den enaio® webclient als Desktop Anwendung und/oder enaio® mobile gleichermaßen lauffähig sein sollen, zum einen kompatibel zur integrierten Chromium Version der Desktop-Anwendung sein müssen (aktuell Chromium 83) sowie kompatibel zu den Versionen der im Einsatz befindlichen mobilen Endgeräte. Die Lauffähigkeit ist im Detail zu prüfen.
Testen von Javaskript Code
enaio® webclient-Skripte werden je nach Art in enaio® client oder enaio® editor-for-workflow geschrieben. Da die Programme kein direktes Testen des Skriptcodes ermöglichen, muss dieser im enaio® webclient und somit im Browser getestet werden.
Der enaio® webclient unterstützt aktuell folgende Browser:
Google Chrome (neueste Version)
Mozilla Firefox (neueste Version)
Microsoft Edge (neueste Version)
Apple Safari (neueste Version)
Nicht alle diese Browser ermöglichen das Testen der enaio® webclient-Skripte gleich komfortabel und einfach. Wir empfehlen auf Entwicklungs- und Testsystemen den Google Chrome.
In Google Chrome, sowie allen anderen Browsern, kann zum Testen die Entwicklerkonsole über die Funktionstaste F12 geöffnet werden.
Die Namen der Skriptdateien setzen sich aus dem Begriff des Maskenelements und gefolgt vom Namen des Events zusammen. Durch Anklicken einer Skriptdatei öffnet sich der Skriptcode im Debugger und es können Breakpunkte gesetzt werden.
In der Abbildung oben, ist die Google Chrome-Entwicklerkonsole dargestellt. Die einzelnen Bereiche werden nachfolgend erläutert:
Im mittleren Konsolenbereich finden Sie den enaio® webclient-Skriptcode zum Debuggen. Durch einen Mausklick auf die Zeilennummern können Sie in der jeweiligen Zeile einen Breakpunkt setzen. Dadurch hält die Skriptausführung in der gewünschten Zeile an und Sie können den aktuellen Zustand der Variablen untersuchen. Sie können den enaio® webclient-Skriptcode hier auch ändern und mithilfe der Tastenkombination STRG+S temporär speichern. Sobald Sie Ihre Änderung gespeichert haben, springt der Debugger auf den Anfang des Skriptes zurück und Sie können Ihre Änderung testen.
Bitte beachten Sie, dass Ihre Änderungen nur temporär gespeichert sind. Sobald Sie den Browser schließen oder den enaio webclient neu laden, sind Ihre Änderungen verloren und der Ursprungszustand aus dem enaio® client oder enaio® editor-for-workflow wird wieder hergestellt.Im unteren Konsolenbereich können Sie Javaskriptausdrücke ausführen und testen. Hier können Sie alle Variablen namentlich eingeben - Ihnen wird dann deren Inhalt angezeigt. Alle Änderungen, die Sie hier vornehmen, werden fest für die Ausführung übernommen.
Im rechten Konsolenbereich können Sie den Stacktrace einsehen, der Ihnen zeigt, welche Stelle Ihres Skripts gerade ausgeführt wird. Darüber hinaus werden hier die gerade vorhandenen Variablen zur Einsicht und Manipulation aufgelistet sowie weitere Informationen zur aktuellen Ausführungssituation angezeigt.
Alternativ können Sie auch im enaio® client oder enaio® editor-for-workflow im Skriptcode den Befehl debugger einfügen. Der Browser hält dann an dieser Stelle in der Skriptausführung an und öffnet Ihnen, falls sie noch nicht geöffnet ist, die Entwicklerkonsole .
Testen von enaio® appconnector-Anfragen
Aus Ihren enaio® webclient-Skripten können Sie den enaio® appconnector oder andere Webservices ansprechen, um Informationen nachzuladen, die für Ihre Skripte zum Ablauf notwendig sind. Beachten sie dabei die URL immer von window.location.baseUrl auszulesen. Zum Testen von Netzwerkanfragen bietet sich hier das Tool Postman an.
Über das Tool Postman können REST-Anfragen abgesetzt und deren Ergebnis analysiert werden. Weiterhin ist es möglich, Anfragen aus der Google Chrome-Entwicklerkonsole nach Postman zu übernehmen. Innerhalb von Postman lassen sich die Anfragen dann abändern und erneut gegen den definierten Endpunkt, wie dem enaio® appconnector, absetzen.