Updating Subscription Response Handler Scripts

After modifying the response choices for a Subscription, you must modify the corresponding handler script using the xMatters Developer IDE. For more information about installing and using the Developer IDE, see the xMatters Online Developer's Guide.

The following is an excerpt from the out-of-the-box messaging subscription response script:

IF ($reply == "Acknowledge" || $reply == "1")
	@notification::delink($response.person_target)
ELSE
  IF (EXISTS($event.debug))
      @script::log($event.incident_id & ": Response unrecognized: " & $reply)
  ENDIF
 
# get the recipient that responded and increment the 
# number of invalid responses.
@recipient = @event::getRecipient($response.recipient_target)
@event::report("Received unrecognized response: " & $reply,

$notification.id)
  @externalMessage = @event::createExternalServiceMessage()
  $externalMessage.message = "Received unrecognized response from" & $response.recipient_target & ": " & $reply
  @externalMessage::send()
 
IF (EXISTS($recipient.invalidCount))
  $recipient.invalidCount = $recipient.invalidCount + 1
ELSE
  $recipient.invalidCount = 1
ENDIF
 

To add handling for an additional response, add an ELSE-IF section:

IF ($reply == "Acknowledge" || $reply == "1")
  @notification::delink($response.person_target)
ELSE-IF ($reply == "Clear" || $reply == "2")
# Add handling for the 'Clear' response
ELSE
  IF (EXISTS($event.debug))
    @script::log($event.incident_id & ": Response unrecognized: " & $reply)
  ENDIF
...
ENDIF