Jira 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

1 {{object.(attribute name)}}

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:

1 2 3 4 5 6 7 Hi {{object.Name}}, Welcome to your first week! We're really excited to have you as our newest {{object.Job title}. Cheers, The Team

 

Would return the following:

1 2 3 4 5 6 7 Hi Jessie, Welcome to your first week! We're really excited to have you as our newest Frontend developer. Cheers, The Team

Object reference

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

Syntax

1 {{object.(reference name).(attribute name)}}

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:

1 2 3 4 5 6 7 Hi {{object.Name}}, Welcome to your first week! Your primary contact for your first day will be {{object.Manager.Name}}. Please contact them if you have any questions. Cheers, The Team

 

Would return the following:

1 2 3 4 5 6 Hi James, Welcome to your first week! Your primary contact for your first day will be Jessie. Please contact them if you have any questions. Cheers, The Team

Lookup objects

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

Syntax

1 2 3 4 5 {{lookupObjects}} {{lookupObjects.(attribute name)}} {{lookupObjects.(reference name).(attribute name)}}

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 Jira 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:

1 2 3 4 5 6 Hey team, We have {{lookupObjects.size}} new people joining the team today. Please welcome: {{#lookupObjects}} * {{Name}} {{/}}

Would return:

1 2 3 4 5 6 Hey team, We have 3 new people joining the team today. Please welcome: • Omar Darboe • Fran Perez • Jie Yan Song

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.

Additional Help