自動化スマート値 - アセット

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

オブジェクト属性

自動化ルールをトリガーするオブジェクトの属性へのアクセスに使用されます。

構文

attribute name は属性の名前を示します。

例

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.

この場合、次の入力:

は以下を返します。

Attribute changelog

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

構文

ここで:

• 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

例

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

この例では:

• {{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.

オブジェクト参照

オブジェクトの参照属性にアクセスするために使用されます。

構文

ここで:

• reference name は参照を含む属性を示します

• attribute name は参照されるオブジェクトの属性を示します

例

たとえば、社内の従業員を表すために使用される Employee と呼ばれるアセット オブジェクト タイプを持つ、HR オブジェクト スキーマがあるとします。また、各 Employee オブジェクトには Manager 参照があるとします。

The following input in an action such as Send email:

は以下を返します。

オブジェクトのルックアップ

[Lookup objects (オブジェクトのルックアップ)] アクションによって返されるオブジェクトのリストへアクセスする際に使用されます。

構文

ここで:

• attribute name は参照されるオブジェクトの属性を示します

• reference name は参照を含む属性を示します

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

例

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.

次の入力:

は、以下を返します:

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.