IsNew
Identify whether the current record is being created and has not been saved yet. Use this when creating a new record to set default values or trigger actions.
Syntax
IsNew()
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 | Yes |
Business Rules: Initialization Rules | Yes |
Business Rules: Read Only Rules | No |
Business Rules: Required Rules | Yes |
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 | Yes |
Parameters
None.
Return Value
Boolean
- True if the record is new (being created and not yet saved).
- False if the record already exists in the system.
Example
The following example shows how to use the IsNew() to set a default priority when creating a new Incident.
$(If(IsNew(), "Priority = 'Medium'", ""))
If the application returns True when a new Incident is being created, so the Priority is set to Medium.
If the application returns False the Incident already exists and the field value remains unchanged.