Uploaded image for project: 'Jira Service Management Data Center'
  1. Jira Service Management Data Center
  2. JSDSERVER-16016

Improve the Assets AQL documentation by explaining the Syntax of placehoders

    • 1
    • 1
    • We collect Jira Service Desk feedback from various sources, and we evaluate what we've collected when planning our product roadmap. To understand how this piece of feedback will be reviewed, see our Implementation of New Features Policy.

      The following AQL documentation page: Advanced searching: AQL - Assets Query Language has some AQL queries in it.

      It will benefit users if we can add a short explanation of the syntax used in complex queries, for example:

      object HAVING inboundReferences(Label IN (${Portfolios.label${0}}))
      
      • Label is a function to represent the object's text attribute, set as its Label, regardless of the Attribute's name (by default it is Name, but it may be customized!)
      • ${Portfolios.label${0}} - is a placeholder to represent the value in the Portfolio customfield.
      • The ".label" refers to the text string seen on this customfield in the issue view (while ".id" will refer to the value's ID).
      • The ${0} indicates the Portfolio field may carry multiple values, and this"index 0" indicates to refer to the values as an array of values, and not a single string (...${2} will refer to the 2nd value in the array).
      • Since we use the ALL index (${0}) we cannot use the '=' operator, hence we must use IN (<value1,value2,....>)

      Adding explanation to syntax will help users in understanding and compiling their complex AQLs

       

       

          Form Name

            [JSDSERVER-16016] Improve the Assets AQL documentation by explaining the Syntax of placehoders

            There are no comments yet on this issue.

              94e733e73fd4 Robert Klimkiewicz
              8cdc82c96fd5 Yinon Negev
              Votes:
              0 Vote for this issue
              Watchers:
              1 Start watching this issue

                Created:
                Updated: