How do I set xMatters to suppress Temporary Replacement notifications, or to send them by email only?

When I set a Temporary Replacement in xMatters, the system sends out a notification about the replacement; is there a way to suppress these notifications completely, or to send them only to email devices?

NOTE: Depending on your requirements, you must edit the scripts for the domain you are using; by default, this is the Messaging (Business) script package.

A.  Suppressing All Temporary Replacement Notifications

You can completely suppress all Temporary Replacement notifications by delinking all recipients before the notifications are delivered. The advantage to this approach is that the system will still log the Temporary Replacement assignment as an event, but no one will be notified.

To do this:

1. Open your initial script in the xMatters Developer IDE, and add the bolded portion of the following code below the setup defaults, as shown:

# Setup defaults for use within this script. 
@alert::setHandlerScript("response") 
@alert::setPresentationScript("messaging") 
@alert::setTimeOverride(FALSE) 
@alert::setEmergencyDeviceUsage(FALSE)
 
# check for Temp Replacement User 
$tmpRepl = $event.incident_id::startsWith( "TEMP_REPLACEMENT" )
print($tmpRepl)

2. Locate the following text:

# Do the notification.
@alert::performNotification()

3. Replace the text located in the previous step with the following text:

# Do the notification.
if ($tmpRepl == false)
  @alert::performNotification()
endif

B.  Suppressing All Temporary Replacement Notifications Except Email Messages

You can also edit the same script so that, instead of suppressing all Temporary Notifications completely, xMatters sends the notifications only to recipients' Email Devices.

As above, edit the initial script in the xMatters Developer IDE, and add the bolded portion of the following code below the setup defaults:

# Setup defaults for use within this script.
@alert::setHandlerScript("response")
@alert::setPresentationScript("messaging")
@alert::setTimeOverride(FALSE)
@alert::setEmergencyDeviceUsage(FALSE)

# Send Temp Replacement notifications to Email only
$tmpRepl = $event.incident_id::startsWith( "TEMP_REPLACEMENT" ) 
IF ( $tmpRepl ) 
$event.deviceFilter = "email" 
ENDIF

xMatters reference:

JDN-1123: originally created by Don Clark

Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.
Powered by Zendesk