Automation smart values - Assets

The smart values on this page are for Assets in Jira Service Management only. Learn more about Assets in Jira Service Management.

Object attribute

Used for accessing attributes for an object that triggers an automation rule.

Syntax

Where attribute name refers to the name of the attribute.

Example

Let's say you have a HR object schema with an Assets object type called Employee, used to represent employees at your company. Let's also say you want to send a welcome email to all new employees when they join the company. You could create an automation rule that is triggered whenever a new Employee is created, and with the Send email action, create an email for that person.

In this case, the following input:

Would return the following:

Attribute changelog

Used for accessing the original and new values of an object attribute when it changes.

Syntax

Where:

• attribute name is the name of the attribute on the object

• .from returns what the attribute value changed from

• .to returns what the attribute value changed to

• .changeTypereturns the type of change in the attribute value: added/updated/deleted

• containerObject return any attribute of the object triggering the rule

Example

Let’s say you have an Employee object type with an Employee Status attribute. You want to run a rule only when the status changes from Onboarding to Active.

You can use conditional logic to run automation when this condition is met:

• First {{Smart Value}} Condition:

  • First Value {{attributeChangelog.Employee Status.from}}

  • Condition: equals

  • Second value: Onboarding

• Second {{Smart Value}} Condition:

  • First Value {{attributeChangelog.Employee Status.to}}

  • Condition: equals

  • Second value: Active

In this example:

• {{attributeChangelog.Employee Status.from}} returns Onboarding

• {{attributeChangelog.Employee Status.to}} returns Active

The rule only runs when both conditions are true – that is, when the status changes specifically from Onboarding → Active.

Object reference

Used for accessing the attributes of an object's reference.

Syntax

Where:

• reference name refers to the attribute that contains the reference

• attribute name refers to the referenced object's attribute

Example

Let's say you have a HR object schema with an Assets object type called Employee, used to represent employees at your company. Let's also say that each Employee object has Manager references.

The following input in an action such as Send email:

Would return the following:

Lookup objects

Used for accessing the list of objects returned by the Lookup objects action.

Syntax

Where:

• attribute name refers to the referenced object's attribute

• reference name refers to the attribute that contains the reference

This can also be combined with the smart values found in Automation smart values - lists. 

Example

Let's say you have a HR object schema with an Assets object type called Employee, used to represent employees at your company. Let's also say you what to send an email, welcoming all new employees who started in the last week. You could use the Lookup objects action to obtain a list of all Employee objects that were created in the last week, and then use the Send email action to send out a list of all new employees.

The following input:

Would return:

Note that in this example, .size isn’t an attribute name; instead, it’s a list smart value. Learn more about using list smart values.