Versions Compared

Key

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

...

The $jemhDirectiveSetLinkManager.createDirectiveSetLink parameters to this are as follows:

Example Variable

Example Value

Description

Code Block
$groupId

8f5f485b-7496-4f4b-a0fc-3e37269704bc

This is an id that is used to relate a set of links, such that when one link is used, the others are inherently expired/voided. An email may have several groups of links.

Code Block
$directiveSetId

10

This integer value must refer a known ID value shown in the DirectiveSet section of the JEMH Cloud Notification page. It refers to the set of Directives that will be applied.

Code Block
$profileId

20

This integer value must refer a known profile ID value shown in the JEMH Cloud Profiles page. It will be the profile that will be used for processing the DirectiveSet defined in $directiveSetId, as the $recipient on the $issue.

Code Block
$issueKey

ABC-123

The issue key of the issue where the action will be performed. Value is generally $context.issue.key.textValue().

Code Block
$catchEmailAddress

myprofile@company.com

An email address that matches one of the profile's catch email address. 

Code Block
$recipient

myuser@mail.com

The email address of user that will perform the action, generally the current recipient $jemhUtils.getRecipient().

Terminology

Directive Sets

...

  1. Create the Directive Set in Notifications > Directive Set > Create

  2. Remember the id of the Directive Set (first column on table)

  3. Image RemovedImage Added

    Go to Notifications > Custom Macros and Edit. Add the macro below (replace parameters $directiveSetId, $profileId, $catchEmailAddress) and save.

  4. Create an Issue and inspect the generated email. The email should have the Assign to Ryan link

  5. If you click the link, the directive will be executed and the issue's assignee changed. The response is generated based on the Directive Set's template.

    Image Removed

    image-20240920-130747.pngImage Added

    In the result of an error, the directive set result will be shown. The response will contain the related Message Audit ID, which will allow a Jira Admin to view the related report to diagnose warning and error messages from the directive set execution.

    image-20240920-130336.pngImage Added

JIRA - GENERIC - Assign to Ryan Custom Macro

...

  1. Create Select List (single choice) custom field in Cog > Issue > Custom Fields > Create

  2. Add field to project's screen

  3. Create 3 Directive Sets in JEMH Cloud >Notifications > Directive Sets


  4. Directive Sets page should looks like this:

    Image RemovedImage Added
  5. For JIRA and GENERIC themes, insert #jemhIncludeDirectiveSetLinks macro below in Notifications > Custom Macros. For Service Desk theme, insert #renderDirectiveSetLinks macro below in Notification >Custom Macros. Update $profileId, $directiveSetIdHAPPY, $directiveSetIdOK, $directiveSetIdUNHAPPY and $catchEmailAddress  to match your values.  Custom Macros in Notification should looks like this:

  6. Then, an email sent to your customer will include the 3 icons + links. 

  7. When the user clicks in one of them, the Directive Set will be executed invalidating the other links.

    Image RemovedImage Added


JIRA - GENERIC - Custom Satisfaction Custom Macros

...

Filter by label (Content by label)
page
showLabelsfalse
max5
spacesJEMHC
showSpacefalse
sortmodified
showSpacetypefalsepage
reversetruetype
labelskb-how-to-article
cqllabel in ( "directives" , "template" , "notifcations" ) and type = "page" and space = "JEMHC"labelskb-how-to-article