Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Directives allow emails to direct JEMH on what issue attributes should be used during issue creation or update. Along with Project Mappings, they are one of the main ways to ensure that Jira is given all the information it requires to perform issue creation or modification.

...

Directive key

Example using At Prefix Field Processor (in email body)

Example using Subject Field Processor (in subject)

Name or ID of field e.g. My Custom Field

@My Custom Field = value for my field

#customfield_10105=value for my field

Using Directives with different Custom Field Types

...

Field Type

...

Description

...

Example using At Prefix Field Processor (in email body)

...

Checkbox

...

The value that is being set must already exist as an option within the Custom Field Configuration. If the value is not found it will result in the Custom Field not being updated.

...

When using different field types you must follow the supported format as if a different format is used it will mean that JEMH will not be able to set the value within the Custom Field.

Below are some examples using the At(@) Prefix Field Processor. For more info the At(@) Prefix Field Processor see: JEMH Mail Field Processors

Field Type

Additional information

Example using At Prefix Field Processor (in email body)

Checkboxes

Value must already exist as an option within the Custom Field Configuration.

@Custom Field = value

Date Picker

Dates must follow the dd/MMM/yy format.

@Custom Field = 24/nov/22

Date Time Picker

Date Time values must follow the dd/MMM/yy h:mm AM/PM format.

@Custom Field = 28/nov/22 9:30 AM

Labels

Value does not have to already exist as JEMH can create new labels.

@Custom Field = value

Number Field

Largest value is 100000000000000

@Custom Field = number value

Radio Buttons

Value must already exist as an option with the Custom Field Configuration.

@Custom Field = value

Select List (cascading)

Value must already exist as an option with the Custom Field Configuration.

@Custom Field = First value, Second value

Select List (Multiple Choice)

Value must already exist as an option

@Custom Field = First value, Second value

Text Field (multi-line)

Multiple line values can be used with this Custom Field.

@Custom Field = value

Text Field (single line)

@Custom Field = value

URL Field

@Custom Field = value

User Picker (single user)

@Custom Field = Username

Note

Note that from JEMH 2.5.1 date values supplied by email directives are locale sensitive. This means that for example, a Jira user who's profile is set to Spanish should send date values such as 3/ene/19 instead of 3/jan/19.

Prior to 2.5.1, date values should be sent using the system default locale.

...