Versions Compared

Key

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

Status
colourYellow
titleDRAFT

During notification, JEMHCloud renders templates differently depending on the recipient users, for example due to security.  Private/restricted comments should only be sent to users that are allowed to see it, so if the recipient is an email only user, a restricted comment shouldn't rendered/sent.   Similarly, if the recipient is a JIRA user without the required role or doesn't belong to the required group.  Notifications are sent or not according to the information displayed. Some emails could be empty if no comment (e.g restricted) or change is displayed. In this case, the notification is not sent.

This guide will show you how to verify the content of an email depending on the issue's event and the recipient. 

Step-by-step guide

  1. Create a private comment in an issue.  Note that project must have an issue notification mapping associated (Notifications->Notification Mappings->Issue)

...

  1. Image Added
  2. Create a Preview Context from the Web-Hook event JIRA generates

...

  1. Image Added


    Image Added


    The comment on the event is

...

  1. internal as it includes something like:

    Code Block

...

  1.        

...

  1.  

...

  1.     "

...

  1. body": "

...

  1. This comment can only 

...

  1. be seen by admins",
                "

...

  1. jsdPublic": 

...

  1. false,
         

...

  1.        "

...

  1. created": "

...

  1. 2023-04-

...

  1. 06T16:

...

  1. 48:

...

  1. 49.

...

  1. 812+0100",
       

...

  1.  

...

  1.         "

...

  1. updated": "

...

  1. 2023-04-06T16:48:49.812+0100"
  2. Go to Notifications

...

  1. > Preview.  Select the used Issue Updated Template and the preview context you've just created

...

  1. Image Added
  2. Leave Recipient blank to test how the email looks like if it is sent to an email only user. Hit Preview.

...

  1. Image Added
  2. The error identifies that the comment has been excluded and that the generated email is empty

...

  1. so the notification wouldn't be sent.  The Email is empty as the event contains one comment that email-only users are not allowed to read.  If you repeat the test changing the recipient to an administrator, Email content should be displayed:

...

  1. Image Added

 

Info

This same strategy (create/update/comment issue, create preview context and preview templates) can be used to troubleshooting multiple email notification problems.

Filter by label (Content by label)
showLabelsfalse
max5
spacesJEMHC
sortmodified
showSpacefalse

...

reversetrue
typepage
cqllabel in ( "jemhc" , "template" ) and type = "page" and space = "JEMHC"
labelsjemhc template
Page Properties
hiddentrue

Related issues