====== NextCounterValue ======

{{:images:sign_warning.png|}}**Hinweis:** Diese Funktion ist im [[transformation:mappings:debug|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:** [[transformation:mappings:funktionen:allgemein:currentcountervalue|]]

==== Syntax: ====

<code>NextCounterValue('CounterName')</code>
<code>NextCounterValue('CounterName', 'CounterRefKey' )</code>

==== Beispiel: ====

<code>NextCounterValue('e-Reference-Counter', 'InterchangeRef')</code>
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.\\ 
{{images:mappingfkt_currentcoutervalue.jpg}}