Documentation Improvement Request - Improve Automation documentation about how to use custom fields with smart values

XMLWordPrintable

    • 0

      Issue Description

      We currently have multiple documentations describing various ways to access a custom field using smart values:
      https://support.atlassian.com/jira-software-cloud/docs/find-the-smart-value-for-a-field/
      https://support.atlassian.com/jira-software-cloud/docs/use-smart-values-to-access-listed-values/
      https://support.atlassian.com/jira-software-cloud/docs/what-are-smart-values/

      However, the methods provided in these documentations don't match, and also do not include all the ways custom fields can be accessed, which can lead to confusion to our customers, and which make it difficult for them to figure out the best ways to access a custom field.

      For example:

      • one documentation says that the following smart value can be used:
        {{issue.My custom field name}}
        
      • another documentation says that the following smart value can be used (assuming that the custom field ID is 11000)
        {{customfield_11000.value}}
        

      In fact, there are many ways to access the same custom field:

      {{issue.fields.customfield_11000}}
      {{customfield_11000}}
      {{issue.customfield_11000}}
      {{issue.My Custom Field Name}}
      

      Suggestion

      Consolidate all the different ways a custom field can be accessed into one single documentation, in order to avoid any confusion.

            Assignee:
            Unassigned
            Reporter:
            Julien Rey (Inactive)
            Votes:
            2 Vote for this issue
            Watchers:
            3 Start watching this issue

              Created:
              Updated: