IncPermanentResponse
Gruppe |
|
Funktion |
Die Klasse ermöglicht das Hochzählen eines permanenten Wertes bei Erfolg eines vorhergehenden Antwortweges. |
Konfigurationsdatei |
Keine. Konfiguration erfolgt durch einen String im Feld Zusätzliche Parameter. |
Beschreibung
Die Klasse IncRermanentResponse kann einen oder mehrere permanente Werte verändern. Sie ermöglicht es, permanente Werte (z. B. Übertragungsnummern) nur dann hochzuzählen, wenn ein (vorheriger) Antwortweg erfolgreich war. Durch entsprechende Abhängigkeiten der Antwortwege kann erreicht werden, dass die Klasse nur nach erfolgreicher Übertragung der Zieldaten ausgeführt wird.
Dazu wird im Feld Zusätzliche Parameter eine Liste von Kommandos, z. B. aus einer Variablen, getrennt durch das Pipe-Zeichen |, erwartet. Leere Kommandos werden ohne Fehler ignoriert. Ein Fehler kann auftreten, wenn der vorherige Wert des permanenten Wertes keine Ganzzahl war. War der permanente Wert vorher nicht vorhanden, wird er mit dem vorherigen Wert 0 angenommen und nach dem Inkrementieren erzeugt. Falls das Logging in Phase 6 für Custom aktiviert ist, wird der neue Wert für jeden permanent value im Message-Log angezeigt.
Hinweis: Profile, die diese Klasse nutzen, sollten die Checkbox Profil darf nur in einer Instanz laufen gesetzt haben.
Parameterbeschreibung
Jedes Kommando besteht aus 1 bis 4 Token, die durch ein Semikolon getrennt werden. Der Aufbau ist folgendermaßen.
<permanentName>;<global>;<stepSize>;<ignoreError> |
Parametername |
Beschreibung |
permanentName |
Name des permanenten Wertes, der inkrementiert werden soll. Default: default. |
global |
(true oder false) Zugriff durch andere Profile (also profilweiter oder systemweiter permanenter Wert). Default: false. |
stepSize |
Ganzzahlwert (positiv oder negativ), der addiert werden soll. Default: 1. |
ignoreError |
Wenn das Schlüsselwort ignore angegeben wird, wird ein Fehler ignoriert. Der Fehler wird dann ins Message-Log eingetragen, der Antwortweg endet aber nicht mit Fehler. Weitere Kommandos werden ausgeführt. Default: Das Flag ist nicht gesetzt. |
Beispiel
DOCNUM und DOCNUM;false;1 sind gleichwertig. Beide Kommandos zählen den permanenten Wert DOCNUM (nur für dieses Profil) um 1 höher.