GetNextCounter

Instructs the application 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

Parameter Description

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 application updates the counter and returns 1004.