Versions Compared

Key

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

...

Warning

Velocity Script cannot be validated at configuration time (for example the dynamic phone numbers). You should test the script by re-executing events in Auditing → Events

Issue Updated SMS notifications

SMS messages are limited (in size and pricing) so JEMHC may not notify issue updates out of the box. Also you wouldn't want to spam your SMS users for every change in an issue. You can confirm that an issue updated event has been ignored (no SMS) if you see the line SMS message to phone numbers '+555123456' has not been sent as no useful information was displayed in the events report (Auditing → Events → Cog Icon → Report).

In order to send SMS messages from issue update, you would need to create a custom template containing the logic around which fields and in which conditions the SMS message must be sent. An example:

Send SMS notifications if the issue priority has been changed to Blocker.

In this example, the interested field is Priority and the condition is new value=Blocker. These are the steps to create and set an SMS Issue Updated template:

  1. Create a new Template by going to Notifications → Templates → Create 
  2. Set the name (Priority Update Template), select SMS theme, Issue Updated Template Type and copy from System Default Issue Updated Template
    Image Added
  3. In the edit screen enter the script you can find below
    screenshot-1.pngImage Added

  4. Code Block
    titlePriority Update SMS template
    #renderMessage()#if ($jemhUtils.isCreateOrInChangeLog($context, 'priority') 
    && $context.issue.fields.priority.name.textValue()=='Blocker'). New Priority: $context.issue.fields.priority.name.textValue() $jemhUtils.setFieldRendered() #end


  5. Go to Notifications → Notification Mappings → SMS → Edit → and change the Issue Updated template for the new template (Priority Update SMS template) and save. 
    Image Added
  6. If you change an issue priority of one of your issue to Blocker, the new template will print the priority in the message and notify JEMHC that the message has valid information (via the $jemhUtils.setFieldRendered() command).  JEMHC will now send the SMS to the handler's phone number. 
  7. You can confirm that the SMS has been sent by going to Auditing → Events→ Cog→ View Report
    Image Added

Info

You can add more fields and values by updating the template. For example the script:

Code Block
#renderMessage()#if ($jemhUtils.isCreateOrInChangeLog($context, 'priority') 
&& ($context.issue.fields.priority.name.textValue()=='Blocker' || $context.issue.fields.priority.name.textValue()=='Highest')). New Priority: $context.issue.fields.priority.name.textValue() $jemhUtils.setFieldRendered() #end #if ($jemhUtils.isCreateOrInChangeLog($context, 'status')). New Status: $context.issue.fields.status.name.textValue() $jemhUtils.setFieldRendered() #end

Will send an SMS if the issue priority has been changed to 'Blocker' or 'Highest' or if the issue status has also been changed.

Please note that the new lines are missing in the script so the SMS message doesn't have them.


Related articles

Filter by label (Content by label)
showLabelsfalse
max5
spacesJEMHC
showSpacefalse
sortmodified
reversetrue
typepage
cqllabel in ("events","notifications") and type = "page" and space = "JEMHC"
labelsnotifications events

...