Service Manager powered by HEAT

GetNextCounter

Instructs the system to increment the specified counter and then returns the incremented value of a counter. For information on counters, see Using Counters.

Syntax

GetNextCounter(counterName)

Enabled For

For a description of the business object categories, see Notes on "Enabled For".

Business Object Category	Yes/No
Business Rules: Before-Save Rules	Yes
Business Rules: Calculation Rules (After Save, with or without Also Recalculate on Load)	Yes
Business Rules: Calculation Rules (Before Save or Always, without Also Recalculate On Load)	Yes
Business Rules: Calculation Rules (Before Save or Always, with Recalculate On Load)	Yes
Business Rules: Editing Rules	Yes1
Business Rules: Initialization Rules	Yes
Business Rules: Read Only Rules	No
Business Rules: Required Rules	Yes1
Business Rules: Validation Rules	Yes
Client Expressions	No
Object Permissions	No
Services	Yes
LDAP	Yes
Mobile	Yes
Quick Actions (except UI Quick Actions)	Yes
UI Quick Actions	No
Reports	Yes
Search/Dashboard without field references	Yes
Search/Dashboard with field references	No
1. Except when this field appears on a form or is triggered by such a field.

Parameter

counterName

The name of the counter to increment.

Return Value

Text value.

Example

$(GetNextCounter("AccountNumberCounter"))

In the above example, if the value of the AccountNumberCounter counter is 1003 and the increment is 1, then the system updates the counter and returns 1004.