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.