What is the structure of emails with Directives?

Scenario

As a user you want to provide directives in an email that affect how JIRA issues are created, to do this, JEMH Directives may be injected. Several formats are supported through Field Processors such as:

  • Colon suffix (key: value)

  • At prefix (@key=value)

  • Subject (#key=value / #key="some value")

  • XML...

  • CSV...

  • Nagios...

  • Wufoo...

All field processors expect Directives at the start of an email, in a block, such as:

At Prefix Simple Case

Note1, Directive block is at the start of the email and contains no empty lines between Directives
Note2, The 'body' content is separated from the Directive block by an empty line

@priority=Major @Company=xxx @CISMID=567 @Component=xxx @Summary=1Meldung mit Melder test1 import 2Meldung mit Melder 3Meldung mit Melder 4Meldung mit Melder

Muli-line value Case

This example shows how a mulit-line value can be injected through directives. A limitation of this approach is that content included must not start with something matching '@key=' which would be taken as the next Directive.

@priority=Major @CISMID=1234 @Environment=This is a long environment String @Component=xxx @Summary=1Meldung mit Melder test1 import 2Meldung mit Melder 3Meldung mit Melder 4Meldung mit Melder

Colon Suffix Simple Case

Note1, Directive block is at the start of the email and contains no empty lines between Directives
Note2, The 'body' content is separated from the Directive block by an empty line

priority: Major Company: xxx CISMID: 567 Component: xxx Summary: 1Meldung mit Melder test1 import 2Meldung mit Melder 3Meldung mit Melder 4Meldung mit Melder

Muli-line value Case

This example shows how a mulit-line value can be injected through directives. A limitation of this approach is that content included must not start with something matching '@key=' which would be taken as the next Directive.

Subject based Simple Case

The subject based field processor allows a sub-set of fields to be set:

For further examples see the JEMH Profile Configuration screen, each field processor entry shows an example at the bottom of the screen when enabled.