Checking the value of a multi-valued field

Abstract

This code snippet checks the value of a standard or custom multi-valued type field (typically a multi-select field). The multi-valued fields can either be an array of objects or an array of values.

Logic

Iterate over the array of objects or values and check a specific field for the required value.

Snippet

For multi-select fields:

{# Checks if a specific option is selected #}
{{ issue.fields["<Name of the field>"] | find({"value":"<Value of the desired option>"}) != null }}

Placeholders

For multi-versions/users/components/groups fields (e.g. Fix Version/s):

{# Checks if a specific version is selected #}
{{ issue.fields["<Name of the field>"] | find({"name":"<Name of the desired version>"}) != null }}

Placeholders

For Labels field:

{# Checks if a specific label is present #}
{{ issue.fields["<Name of the field>"] | find("<Desired label>") != null }}

Placeholders

Examples

The output of this snippet is a boolean value (true or false) which you could use to conditionally execute a Post-function or Unlink issues:

• Check the issue has been flagged

  {{ issue.fields["Flagged"] | find({"value":"Impediment"}) != null }}

• Check the issue has a label Server

  {{ issue.fields["Labels"] | find("Server") != null }}

• The issue has 5.0.0 as an Affects Version/s

  {{ issue.fields.versions | find({"name":"5.0.0"}) != null }}

References

• How to insert information using Nunjucks annotations
• Accessing the standard fields
• find filter

Related articles

• Page:
  Add a certain number of days to a date excluding the weekends
• Page:
  Fetch a subset of values of a multi-valued field based on a condition
• Page:
  Add certain number of minutes/hours/days/weeks/months to a date
• Page:
  Uncheck/Unselect an option
• Page:
  Getting the current user