Skip to main content

Aktion: InstallMessageHandler

Funktion: Die Aktion bewirkt zusammen mit der Aktion UnsinstallAndCheckMessageHandler das automatische Beantworten und Prüfen von Meldungsfenstern, die während eines automatischen Testskriptablaufs blockieren würden.

Aufruf: Testreiber System

Die beiden Aktionen InstallMessageHandler und UninstallAndCheckMessageHandler müssen immer zusammen genutzt werden. InstallMessageHandler markiert dabei den Beginn und UninstallAndCheckMessageHandler das Ende der Sequenz, innerhalb derer die konfigurierte Behandlung der Meldungsfenster anzuwenden ist. Eine geschachtelte Definition mehrerer Message Handler ist zulässig.

Registerkarte: Konfiguration

Bezeichner

Schlüssel, der beim abschließenden UninstallAndCheckMessageHandler zur Identifikation des zugehörigen Message Handlers dient

Beispiel: Message_Handler_App1

Erwartete Meldungen

Tabelle zur Filterung und Konfiguration der Handhabung der Meldungen

Jede Zeile beinhaltet die Konfiguration einer Nachricht.

Typ

. Meldungstyp

  • <alle>: Alle Meldungstypen

  • Information: Einfaches Meldungsfenster mit einer einzigen OK-Schaltfläche

  • Warnung: Einfaches Meldungsfenster mit einer einzigen OK-Schaltfläche

  • Fehler: Einfaches Meldungsfenster mit einer einzigen OK-Schaltfläche

  • Eingabeaufforderung: Einfache Abfragen (Prompts) mit standardisierten Antwortmöglichkeiten für den Benutzer. Derzeit bietet CODESYS folgende Typen an: OK, OK/Abbrechen, Ja/Nein, Ja/Nein/Abbrechen, Wiederholen/Abbrechen und Abbrechen/Wiederholen/Ignorieren

  • Eingabeaufforderung mit Mehrfachauswahl: Abfragen mit einem vom Programmierer festgelegten Satz an Antworten

  • Eingabeaufforderung mit zusätzlichen Eingabefeldern: In einem Fenster können zusätzliche Eingabefelder beliebigen Typs eingetragen werden.

Schlüssel

Schlüssel zur Identifizierung der Meldung

Beispiel: Warning_Var

Zur Festlegung dieses Werts müssen Sie wissen, mit welchem Schlüssel die Meldung in der Implementierung aufgerufen wird (IMessageService3).

Meldung

Meldungstext zur Identifizierung der Meldung

Die Wildcards der Form ? und * sind erlaubt.

Eingabeaufforderung Ergebnis

Wenn die Option Weiter nicht aktiviert ist, legt diese Spalte bei Fenstern vom Typ Eingabeaufforderung fest, auf welche Weise die Nachricht beantwortet wird. Folgende Möglichkeiten stehen zur Verfügung:

  • Abbrechen(Abort)

  • Abbrechen(Cancel)

  • Ignorieren

  • Nein

  • OK

  • Wiederholen

  • Ja

Optional

standard icon: Wenn es für diesen Filter keine passende Meldung gibt, führt dies nicht zum Fehlschlagen einer der Aktionen InstallMessagehandler oder UninstallAndCheckMessageHandler.

_cds_icon_option_deactivated.png: Wenn es für diesen Filter keine passende Meldung gibt, führt dies zum Fehlschlagen der Aktion UninstallAndCheckMessageHandler.

Weiter

standard icon: Die entsprechende Meldung wird dem Anwender zur Auswahl angezeigt, oder im Falle einer Schachtelung an den nächsten Handler weitergereicht.

Mehrfach

standard icon: Die Meldung kann mehrmals erscheinen.

_cds_icon_option_deactivated.png: Wenn die Meldung mehrmals erscheint, schlägt die Aktion UninstallAndCheckMessageHandler fehl.

Ergebnis Mehrfach-Auswahl

Legt den Rückgabewert bei Mehrfachauswahl-Abfragen fest

Die Optionen werden von 0 an fortlaufend nummeriert.

Zusätzliche Eingabefelder

Hinzufügen: Durch einen Doppelklick öffnet sich ein Fenster zur Konfiguration zusätzlicher Eingabefelder.

  • Bezeichner: Bezeichner des Eingabefelds

  • Wert: Wert, der dem Eingabefeld zugewiesen wird, das über den Bezeichner adressiert wird

  • Entfernen: Löscht die selektierte Zuordnung von Bezeichner und Wert

  • Leeren: Löscht alle Zuordnungen

Alle anderen Meldungen

Handhabung der Meldungen, die von keinem der definierten Filter erfasst wurden

  • Als Fehler anzeigen: Führt zum Fehlschlagen der Aktion

  • Quittieren: Beendet diese Dialoge mit der Standardauswahl

  • Weiterleiten (Meldungsbox anzeigen): Zeigt den Dialog blockierend auf dem Bildschirm an oder reicht ihn im Falle einer Schachtelung an den nächsten Handler weiter

Registerkarte: Parameter

Die in der Registerkarte Parameter definierten Parameter werden verwendet, um Werte zwischen Testskriptvariablen und Parametern von Testaktionen auszutauschen. Parameter können in der Registerkarte Konfiguration als Platzhalter verwendet werden. Dabei wird der Name des Parameters im Konfigurationsdialog in geschweifte Klammern gesetzt. Beispielsweise {name}.

Tipp

Global im Skript definierte Variablen (mit Präfix $GLOBALS.) können Sie direkt in der Testaktion verwenden. Eine Übergabe durch Eingangsparameter ist dabei nicht notwendig. Für das Schreiben von globalen Variablen ist die Verwendung von Ausgangsparametern notwendig.

Eingangsparameter: Bei der Ausführung der Testaktion werden die Werte der Testskriptvariablen den Eingangsparametern der Testaktion übergeben und können in der Konfiguration der Testaktion verwendet werden.

Ausgangsparameter: Bei der Ausführung der Testaktion werden die Werte der Ausgangsparameter der Testaktion den Testskriptvariablen übergeben und können so beispielsweise in anderen Testaktionen verwendet werden.

Name

Name des Eingangs- / Ausgangsparameters

Dieser Name wird zusätzlich zum Variablennamen definiert, um die Herkunft des Parameters erkenntlich machen zu können, wenn er an ein anderes Skript übergeben wird. Beim Testlauf wird dieser Name als Name außerhalb Im Fenster Testfortschritt in der Registerkarte Variablen (Gültigkeitsbereich #<n>) mit angezeigt.

Hintergrund: Wenn ein Skript A ein anderes Skript B aufruft, und seine Variable x dem Skript B als Parameter y übergibt, so ist aus Sicht des Skripts B der Parameter y die Variable y.

Um zu sehen, dass diese Variable „außerhalb“ des Skripts B als Variable x bekannt ist, gibt es die Spalte Name („Name außerhalb“): Im Gültigkeitsbereich des Skripts B hat die Variable y den Namen x, weil sie im Gültigkeitsbereich des aufrufenden Skripts A als Variable x an den Parameter y übergeben wurde.

Variable

Name der Testskriptvariablen

Beispiel: TS_CaseA_Result

Nach oben

Verschiebt die selektierte Variable um 1 Zeile nach oben

Nach unten

Verschiebt die selektierte Variable um 1 Zeile nach unten

Entfernen

Entfernt die selektierte Variable aus der Liste

In diesem Abschnitt: