Create
cancel
Showing results for 
Search instead for 
Did you mean: 
Sign up Log in

It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

assignee.property field question

Does anyone know what the field assignee.property does / controls?

1 answer

assignee.property is not a valid smart value.

assignee.properties smart values refer to entity properties, discussed in exhaustive detail at https://developer.atlassian.com/cloud/jira/platform/jira-entity-properties/

Entity properties are best set via the REST API as you can do bulk updates and use it to load entity-relevant information from external systems.

In Automation, these are set with the "Set Entity Property" action which lets you set properties for a Issue, Project or User. You've asked about assignee.properties so I will only discuss user properties, which in Automation are documented at https://support.atlassian.com/jira-software-cloud/docs/smart-values-users/

Tip: You can specify user-type custom fields in the "Set Entity Property", just type in {{issue.<custom field name>}}. Automation will protest a bit but it accepts it and it works fine.

Here's it used in a rule:

  1. When: Scheduled
    1. Searches with: Key = AUTOTASK-1
    2. every 0 0 0 1 1 ? 1970
  2. Then: Set entity property:
    1. Type: User
    2. User: {{issue.Manager}}
    3. Property Key: phoneNumber
    4. Property Value: 555-555-5555
  3. And: Add value to the audit log.
    1. {{issue.Manager.properties.phoneNumber}}

Run this rule and the Manager user listed on the AUTOTASK-1 issue now has a permanent entity property of "phoneNumber: 555-555-5555" going forward on that site.

Tip: You can load user entity properties outside a REST API by creating task issues in an AUTOTASK Task Management project:

  1. Create a CSV file with columns: "User", "Property Key", and "Property Value"
    • The User column needs to be the users' Atlassian account IDs.
  2. Import the CSV into the AUTOTASK project with the map:
    • User -> Reporter
    • Property Key -> Summary
    • Property Value -> Description
  3. Change the rule above with:
    1. Searches with: JQL that returns the issues you've loaded
    2. Set entity property:
      1. User: Issue's reporter
      2. Property Key: {{issue.summary}}
      3. Property Value: {{issue.description}}

Then Run the rule. Just make sure you turn off the notification scheme for that project. Going forward, you'll be able to load that property from the user in automations. A nice way to store information on users, like job title, phone number, location, time zone, etc. Make sure to store the Manager's account ID, if you want to store the user's Manager. Eventually the Atlassian User Profile should be accessible via automation, but there are always going to be use cases.

I like entity properties because they offer variables that are accessible everywhere in a rule. The "create variable" action only makes variables available in a local context, ie. within an if/else block or a branch.

Suggest an answer

Log in or Sign up to answer
DEPLOYMENT TYPE
CLOUD
PRODUCT PLAN
STANDARD
PERMISSIONS LEVEL
Site Admin
TAGS
Community showcase
Published in Jira Service Management

Atlympic Event: Jira Service Managemnt

Hello Community!  Quick disclaimer: We are running a contest on Community (The Atlympics!) from July 23rd - August 8th of 2021. If you are interested in participating in this contest (prizes! ...

337 views 5 6
Read article

Community Events

Connect with like-minded Atlassian users at free events near you!

Find an event

Connect with like-minded Atlassian users at free events near you!

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you