Hinweis: Diese Funktion ist im DEBUG Modus inaktiv.
Die Funktion NextCounterValue() nimmt den Counter-Name und optional die ValueReferenz-Bezeichnung als Parameter entgegen und erhöht den Zählerwert der als Ergebnis zurückgeliefert wird.
Ist kein CounterRefKey angegeben, wird ein Default-Key angelegt (s.u. im Bild, Referenz Name 'Default'). Jeder CounterRefKey beschreibt einen eigenständigen Zähler.
Siehe auch: CurrentCounterValue
NextCounterValue('CounterName')
NextCounterValue('CounterName', 'CounterRefKey' )
NextCounterValue('e-Reference-Counter', 'InterchangeRef')
Dieses Beispiel stellt einen eBiss-Zähler dar, der eine Zahl für die Referenz eines Nachrichten-Umschlags erzeugen soll. Wird eine neue Nachricht erzeugt, so wird die Zahl im Zähler um 1 erhöht. Die Funktion NextCounterValue() ermöglicht es, den aktuellen Zählerstand (in dem Beispiel 99) um 1 zu erhöhen und liefert den neuen Zählerstand (100) zurück.