Placeholders

<< Click to Display Table of Contents >>

Navigation:  NITRO™ Workflows > Configuring Workflows > Conditions, Placeholders & Functions >

Placeholders

PlaceHolders

 

Note: The following placeholders should not be used in column names, as they will conflict with workflows:

Parentheses “()”

Number sign “#”

Percent “%”

Double Colon "::"

Dollar sign “$”

At sign “@”

Brackets “[]”

Braces “{}”

Vertical bar “|”

 

-afterchange: used in conditions to check if the value of a column has been changed as part of the current update process.

Syntax: afterchange:value

Possible values:

1. afterchange:Fixed value

2. afterchange:[Column Display Name|Column Internal Name]

3. afterchange:[[Any]]

4. afterchange:[[None]]

Example: afterchange:Email

Afterchange

 

-beforechange: used in conditions to check the value of a column before it was updated to another value by the current update process.

Syntax: beforechange:value

Possible Values:

1. beforechange:Fixed value

2. beforechange:[Column Display Name|Column Internal Name]

3. beforechange:[[Any]]

4. beforechange:[[None]]

Example: beforechange:Calendar

Beforechange

Note:

These placeholders should only be applied on workflows that run-on Item modified event.

Use afterchange:[[Any]] for any change in a column value.

Use afterchange:[[None]] for no change in column value.

 

-Me: Used to check a Person/Group column value against the current logged in user.

-Note: This option is available only in on-premises only.

In Conditions:

Me placeholder

 

In Field Mappings:

WF Placeholder 4

 

 

-Today: Used to check Date Time column value with today’s date

In Conditions:

Today in condition

 

In Field Mappings:

Today in field mapping

In Field Mapping with expression builder:

Today in expression Builder

 

 Now: Gives current date time. Used to Update Date Time value with current time.

In Conditions:

Now contextual in condition

In Field Mappings:

Now in field mapping

            UtcNow: Gives current date time in UTC format. Used to update Date Time value with current UTC time.

In Conditions:

UTCNow in condition

In Field Mappings:

 UTCNow in field mapping

Column Placeholder: in condition, it is used to compare value between two columns with different type of operators. In field mapping, it is used to update the column value with another column value.

Syntax: [Column Display Name|Column Internal Name]

Ex: [Status|RequestStatus]  

In Conditions:

Column placeholder in condition

In Field Mappings:

 Column placeholder in field mapping

Query list item placeholder: it is used to update the column value with query list item column value. Note: this can not be used in workflow condition, because query list action will be executed after workflow condition evaluation. you can use this in Gateway condition and field mapping.

Syntax: Query list action name##[Column Display Name|Column Internal Name]

Ex: GetConfiguration##[Approver|Approver]

 

In Field Mappings:

Query list in field mapping

Variable: The variable value can be updated at run time using query list actions and create item actions and this updated variable values can be used in conditions, column mappings in further actions. Note: this can not be used in workflow condition, because variable value will be evaluated after workflow condition evaluation. you can use this in Gateway condition and field mapping.

Syntax: Variable##Value

Ex: VarStatus##Value

 

In Field Mappings:

Variable in field mapping

 

Refer this article for more detail on placeholder with expression builder: Syntax For Expressions In NITRO Workflows