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

{{:images:sign_warning.png|}}**Note:** Will not change the value in during debugging the mapping.

Funtion **NextCounterValue()** returns the next value of **CounterRefKey** in the Counter named **Counter-Name**. If **CounterRefKey** is missing the **Default-Key** is used (see picture below, reference name 'Default'). Each CounterRefKey describes an independent counter.

**See also:** [[en:transformation:mappings:funktionen:allgemein:currentcountervalue|]]

==== Syntax: ====

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


==== Example: ====

<code>NextCounterValue('e-Reference-Counter', 'InterchangeRef')</code>
This example represents an eBiss counter that is to generate a number for the reference of a message envelope. If a new message is created, the number in the counter is increased by 1. The function **NextCounterValue()** makes it possible to increase the current counter reading //(in the example 99)// by 1 and returns the new counter reading (100).\\ 
{{images:mappingfkt_currentcoutervalue.jpg}}