Galaga Development Highlights & Support Notes

The information in this article is the intellectual property of xMatters and is intended only for use with xMatters products by xMatters customers and their employees. Further, this intellectual property is proprietary and must not be reused or resold.

We're hard at work on our next quarterly release, Galaga, which will be rolling out in the Oct/Nov 2019 time frame. Please follow this article and its comments to receive updates throughout the quarter about new features and functionality that we're working on for the Galaga release.

Customers interested in previewing new features before they're released can opt into our Early Access Program (EAP), which delivers new features into non-production environments as they're rolled off the assembly line.

We'll also use this document to capture highlights of additions and updates to our mobile platforms and the xMatters REST API.

Deployment Details

For more information on how a feature in this article works, click the online help links embedded in each topic. As with any of our Community articles, you can click any image or animated GIF to see a larger version.

Support Notes

For a list of additional changes made in each deployment that are not covered in the Development Highlights, see the On-Demand support notes included below each highlight. While most features will be added to production environments as part of our quarterly releases, the support notes typically describe fixes, which can sometimes affect product behavior.

October 7-11, 2019

Flow Designer: New Events steps

Availability: Now in On-Demand

Last week we released two new Flow Designer Events steps called Get Events & Terminate Events that you can use to perform bulk operations on up to 50 events at a time:


Get Events

The Get Events step allows you to get the event IDs of the 50 most recent events in xMatters that match search criteria such as status, priority, or the value of an event property. You can combine search criteria to narrow your results or add multiple status or priority values to broaden the search.

For example, if you wanted to return up to 50 of the most recent high or medium priority events related to a help desk ticket so that you could then terminate them using the Terminate Events step, you could configure the Get Events step as shown in the following screenshot:


The event IDs are returned as an output of the Get Events step, along with the number of matching event IDs that were returned, and the total number of events found that match the search criteria (i.e., while the 50 most recent event IDs are returned, more than 50 events might match the criteria).

Terminate Events

You can use the Terminate Events step to terminate up to 50 events using their event IDs. When you terminate events in xMatters, processing for the events is stopped and cannot be resumed, all active notifications are canceled, and responses to existing notifications are rejected.

Get & Terminate 

You can combine the Terminate Events step with Get Events step described above to retrieve and then terminate events. Start by connecting the Terminate Events step to a flow that includes the Get Events step:


Then use the Event IDs output from the Get Events step as the input value for the IDs of the events that you want to terminate:


Support notes (week of Oct 7-11)

xMatters Internal Reference No. Summary
Groups - temporary absences: Fixed an issue that was causing some groups not to appear in the list when setting a temporary absence.
COR-19554 Integration Builder - outbound integrations: Fixed an issue where attempting to create a new outbound integration would occasionally display a blank page.

September 30 - October 4, 2019

On-Demand: All Events report updates

Availability: Now in On-Demand

We've made a couple of updates to the All Events report that we think you'll find useful. These include information about the source and form used to create the event, and the ability to export delivery details:

Event source & form
Need more context about your past events? The Overview tab of the All Events report now includes the source (the communication plan or built-in configuration) and form used to create the event:


User Delivery export
You now have the option to export user delivery details to a .csv file. This is useful if you'd like to perform additional analysis of your users' notification delivery information, such as when they were notified, what their response was, and from which device they responded. Just click the Export button at the top right corner of the report and select a download location:


Any filters that you apply to the report in the web user interface - such as sorting or rearranging columns - are preserved in the exported file.


xMatters On-Demand: Required replacements

Availability: Now in On-Demand

For some companies, it's simply not an option to have nobody on call because everyone in a group is away, and no replacements have been set. The good news for these companies is that it's now possible to require users to set a replacement when they're going to be absent. We've added a new Replacements Required setting to the Company Details screen so that administrators can enable this rule:


When enabled, instead of having the option to select a replacement, users must select their replacement before they can save their temporary absence (you'll notice that the Save button below is greyed-out because no replacement has been set):


Note: Temporary absences without a replacement scheduled prior to this setting being enabled will continue to function without a replacement.

Flow Designer: Email & HTTP trigger access permission updates

Availability: Now in On-Demand

Want to allow someone to initiate a flow, but don't really want to give them the keys to your comm plan? Not a problem! We've updated email trigger and HTTP trigger permissions so that users can still initiate flows even if they don't have access permissions to the communication plan.

Mobile: iOS 3.27

Availability: Now from the App Store

A new version of the xMatters iOS app is now available. Head on over to the app store to take advantage of the following updates:

  • Support for iOS 13. Keep things running smoothly on Apple's latest mobile update!
  • Improved phone number validation. The app now accepts the newest phone number formats.
  • Get more out of My Schedule. Tap any shift in your schedule to see who’s on call, if anyone is absent, and who’s covering as a replacement.
  • Get all your push notifications. The app now continues to display your push notifications - even after an event has been resolved.

Support notes (week of Sept 30-Oct 4)

xMatters Internal Reference No. Summary
Messaging - re-sending scheduled messages: Corrected an issue that prevented scheduled messages (which were already sent) from being resent.
xMatters REST API - temporary absences: Corrected an issue that returned incorrect shift information if a group contained a temporary absence.
Reports - All Events report: Corrected an issue that caused the number of notified users in the Overview tab to differ from the User Delivery tab.
COR-12093 Groups - Create Shift: Added an error message to the "On Days" selector to let users know at least one day must be selected.
COR-19095 iOS Mobile App - Usability: Improved the usability of the Recipients list by removing extraneous options from groups.

September 23-27, 2019

xMatters On-Demand: Introducing Workflows

Availability: Galaga Quarterly Release & Early Access Program

In case you missed our 'cheesy' announcement, we're releasing our new Workflows UI as part of our coming Galaga Quarterly Release. Changes include new naming conventions to clearly describe application components (goodbye "communication plans", hello "workflows"!) and an improved user interface for managing your processes in a unified view:


If you're enrolled in our Early Access Program, you'll be able to try out this new UI in your non-production environment on Tuesday, October 1

xMatters REST API: More specific user search

Availability: Now in the xMatters REST API

Interested in searching for users based on the value they're assigned for custom field or attribute AND their site location? The GET /people endpoint now narrows your search when you specify a propertyName / propertyValue pair and the  site query parameter.

For example, GET people?propertyName=First%20Aid&propertyValue=CPR&site=Seattle returns users that have a custom field or attribute named "First Aid" with the value "CPR" who are located in Seattle. (Previously, this query would return a larger selection of users who had first aid CPR certification OR were at the Seattle site.)

xMatters REST API: GET /groups supervisors

Availability: Now in the xMatters REST API

It's now possible to embed group supervisor information when you query for multiple groups at a time. The next time you're using GET /groups, just embed supervisors to return a paginated list of each group's supervisors (for example: GET /groups?embed=supervisors)

xMatters REST API: Get dynamic team members

Availability: Now in the xMatters REST API

You can now use the xMatters REST API to programmatically look up the members of dynamic teams using the following new endpoint:

xMatters Agent: Support for Windows Server 2016

Availability: Now in On-Demand

The xMatters Agent is a service you can install on a local system to process workflow logic behind your company firewall. This allows systems behind your firewall to trigger and enrich events in xMatters and enables integrations to communicate with systems that cannot be accessed externally.

If your local system runs on Windows Server, then you'll be happy to hear that we've updated the xMatters Agent to support Windows Server 2016:


Still on Windows Server 2012?
Don't worry - any xMatters Agents you installed using our previous Windows Server 2012 download will continue to function as usual after this update.

For more information about installing the xMatters Agent on Windows Server 2016 systems, see Download and Install the xMatters Agent.

Support notes (week of Sept 23-27)

xMatters Internal Reference No. Summary
Messaging - re-sending scheduled messages: Corrected an issue that prevented scheduled messages (which were already sent) from being resent.
xMatters REST API - temporary absences: Corrected an issue that returned incorrect shift information if a group contained a temporary absence.
Reports - All Events report: Corrected an issue that caused the number of notified users in the Overview tab to differ from the User Delivery tab.
COR-12093 Groups - Create Shift: Improved the error messages to be more helpful when creating a shift.
COR-19095 iOS Mobile App (usability fix): Removed some extraneous and  non-functional user interface controls from groups when choosing recipients.

September 16-20, 2019

Flow Designer: BMC Remedy ITSM Add Note

Availability: Now in On-Demand

We've added an Add Note BMC Remedy step to Flow Designer that you can use to automatically add a note to an incident, either as an internal comment or as a public comment visible to the customer, adding information from the trigger and previous steps in the flow.


On-Demand: JavaScript changes and upgrades

Availability: Now in On-Demand

On Tuesday, September 17 we upgraded the Integration Builder to use JDK Version 11, which means integration designers now have access to a better, faster, and stronger scripting engine!

Since JDK 11 requires scripts be ECMAScript 6+ compliant, we've added handling for some invalid Java methods previously accepted by JDK 8 so that any integrations using them won't break. And, we've provided helpful error messages in the Integration Builder's Activity Stream to point out where these deprecated methods occur.

We know our dedicated integrators have been itching to get their hands on some more modern JavaScript features (such as arrow functions and default parameters) and we're excited to see what they can do with them! For all the details on why we made this change and what you need to do (if anything), see our notice on these recent JavaScript changes and upgrades.

Support notes (week of Sept 16-20)

xMatters Internal Reference No. Summary
COR-18733 xMatters REST API - people: Improved the message returned when incomplete information is provided in a propertyName&propertyValue search.
COR-18243 xMatters REST API - people: Added a link to the person's site in the response.
COR-18014 xMatters REST API - dynamic teams: Updated the response to remove a parameter not applicable to dynamic teams.
COR-18293 xMatters REST API - people: Updated the response when using the at parameter to search historical data to properly reflect the state of the system at the time.
COR-17968 Flow Designer - versions (usabilty): Updated step management so steps with the run location set to xMatters Agent maintain that setting when a new version is created.

September 9-13, 2019

Flow Designer: Step sharing updates

Availability: Now in On-Demand

In the Frogger release, we introduced new step sharing capabilities that allow you to specify which users or groups can use or edit a custom step or HTTP trigger. We've expanded step sharing to include roles, and we've improved the usability of configuring usage permissions.

Let's see it in action

As shown in the animated GIF below, when you create a new step or HTTP trigger, it's available only to the step owner (it's not shared). To make the step accessible to all, you can assign permissions to a new "All Users" recipient type. This is useful if you'd like a step to be available for all users to use, while adding a limited number of other users, groups, or roles that can edit the step's settings. Later, you may decide to remove the All Users option and assign use permissions to specific users, groups, or roles.


Recipients are organized by their level of usage permissions, so you'll see all the recipients who have the higher-level edit permission at the top of the list, followed by those with lower-level use permissions.

If you decide to revoke usage permissions for a recipient (by clicking the 'x' next to their name and removing them from the list), they'll be prevented from adding or editing the step further. While this won't break or remove the step from any of their flows, they'll be unable to change the step's settings from the canvas.

Flow Designer: Deprecate & withdraw steps

Availability: Now in On-Demand

Our step versioning system now allows you to phase out and remove older steps as newer ones become available, using the following additional lifecycle stages:

  • Deprecated - still available for sharing, but scheduled for withdrawal. The planned withdrawal date is displayed as a warning to users on the step configuration screen.
  • Withdrawn - no longer available for use in flows and will cause errors when the step executes.

What happens when I deprecate a step?

When you deprecate a version of a step, flows can continue to use that version, but it will no longer available from the palette. The configuration screen for a deprecated version displays a recommendation to update to a newer version, and you can optionally set a withdrawal date. Setting a planned withdrawal date lets users know how long they have to update to a newer version before the version they're currently using stops working and their flow breaks:


But you're not done yet!

Versions are not automatically withdrawn on the planned withdrawal date. To withdraw a version, you must manually change its current state in the step configuration to "Withdrawn":


Flow Designer: HTTP trigger versioning

Availability: Now in On-Demand

Our versioning system now also extends to HTTP trigger steps! This is great because it means you can adapt your HTTP triggers to meet the constantly changing needs of the real world without disrupting your flows. Like custom steps, you can have multiple versions of an HTTP trigger deployed while others are still in development or have been deprecated and scheduled for withdrawal. For more information about versioning, see Manage step versions.

Mobile: iOS 3.25

Availability: Now from the App Store

We recently released a new version of the iOS xMatters app, which includes the following updates:

  • More accurate group search. The app now returns groups that match all of your search criteria. In other words, it's been updated to use AND instead of OR when multiple search terms are provided (for example: searching for "Database Admin" returns the Database Admins group, but not the Administrators group).
  • Mobile-only users. The app now supports custom roles for mobile-only users that you can use to restrict users from editing or adding other device types to their account.

Support notes (week of Sept 9-13)

xMatters Internal Reference No. Summary
Android mobile app: Fixed an issue causing users to be repeatedly logged out of the app.
Trials: Updated the logic when an inactive trial instance is converted to an xMatters Free instance.
COR-17234 xMatters REST API - devices: Updated the permissions to view and act on devices to align with those in the web user interface.
ACTO-2642 xMatters Agent (usability fix): Updated the web user interface to display a message when a user without the necessary permissions tries to edit the list of registered users for an agent.
Flow Designer (usability fix): Fixed an issue where the scroll bar was not appearing on the custom step tab of the palette in Flow Designer, preventing users from seeing the full list in systems with a large number of custom steps.
COR-18002 Recent Events report (usability fix): Fixed an issue causing multiple scroll bars to appear in the results list when searching the Recent Events report.
COR-18249 Communication Plans - editing properties (usability fix): Improved the message displayed when a user tries to edit a hierarchy property that is used by a subscription form.
COR-18013 Flow Designer (cosmetic fix): Fixed the placement of the close icon.
COR-17367 Who's On Call report - export (usability fix): Improved the reporting of temporary absences without a replacement in the exported Who's On Call report.
COR-17438 iOS app (performance enhancement): Updated the app to improve the experience of moving from an old device to a new one.
COR-17674 iOS app (usability fix): Updated the display of system messages in the inbox to clarify which system communication plan sent the message.
COR-17405 iOS app (cosmetic fix): Updated the app to fix some misalignment on the My Schedule screen.
COR-18239 Web User Interface: Updated a subset of pages to fix an issue where Internet Explorer 11 users could no longer click items after selecting some check boxes in a list.

September 2-6, 2019

Flow Designer: Jira Server Add Comment

Availability: Now in On-Demand

We just added another Jira Server step to Flow Designer! Use the new Add Comment step to automatically add a comment to an issue record, either as an internal comment or as a published comment visible to the customer, adding information from the signal source or previous steps in the flow.


Integration Directory: ServiceNow 5.4

The latest version of the xMatters application for ServiceNow - certified with Kingston, London, Madrid, and now New York - is available from the ServiceNow Store. This latest release includes the following updates:

  • The data sync now properly removes synced groups from xMatters when the group is removed in ServiceNow.
  • We updated the Engage with xMatters behavior so corresponding events in xMatters are terminated when closing an Engage with xMatters record, and to address an issue that was causing some requests involving Mid-Server to run for a long time.

For upgrade or installation instructions, feature and update descriptions, and a list of issues addressed in recent releases, see the integration guide here.

Support notes (week of Sept 2-6)

xMatters Internal Reference No. Summary
All Events report - User Delivery: Updated the User Delivery section of the All Events report to properly display user names that contain special characters.
SMS messaging - responses: Fixed an issue where some users in China would encounter "Invalid Response" messages when sending a response choice that required two digits. 

August 26-30, 2019

New in-country SMS numbers

We've identified two additional 'hot spots' and have added in-country SMS codes for Argentina and Italy... Hola! Ciao! This brings our grand total to 38 countries. See the complete list of countries that we currently support.

xMatters REST API: Get dynamic teams

Availability: Now in the xMatters REST API

We've enhanced the xMatters REST API with new endpoints that you can use to programmatically look up dynamic teams:

You also have the option to embed a dynamic team's supervisors and observers with the response; for example: GET /dynamic-teams?embed=supervisors,observers.

xMatters REST API: Response option translations

Availability: Now in the xMatters REST API

Do you have messages and responses configured in more than one language? If you're interested in retrieving response options based on a user's preferred language, you can now include translations when you embed responseOptions with your request to GET /events or GET /plans:

This returns the configured translations for each response option, including a two-letter code that indicates the language of each response.

xMatters REST API: Events or audits after and before

Availability: Now in the xMatters REST API

You can now use the at parameter for GET /events and GET /audits to search for historical data after and before specific points in time. For example, the following query would return events that occurred after 8 am on Jan 27, 2018, but before 8 am on June 30, 2018:

GET /events?at=2018-11-02T08:00:00.000Z&after=2018-01-27T08:00:00.000Z&before=2018-06-30T08:00:00.000Z 

How is this different than 'from' and 'to'?

If you'd like your query to return objects inclusive of the start and end times, you can use the at parameter with 'from' and 'to' instead (for example, from=2018-01-27T08:00:00.000Z&to=2018-06-30T08:00:00.000Z brings back any events initiated at or past 8 am on Jan 27, 2018 up to and including 8 am on June 30, 2018.)

xMatters REST API: Sort audits

Availability: Now in the xMatters REST API

We've added the ability to sort audit records by their creation timestamp, which makes it easier to look up the most recent record. You can use the sortOrder parameter to sort audits in either 'ASCENDING' or 'DESCENDING' order - if you don't specify which, they'll be sorted in ascending order.

Support notes (week of Aug 26-30)

xMatters Internal Reference No. Summary
COR-16431 iOS xMatters App: Fixed an issue where users who had responded to a notification on their Apple watch were not receiving subsequent notifications on the watch.
COR-16833 Built-in integrations - flows: Fixed an issue that caused certain flow steps to return errors when building flows on the Flows tab in a configuration.
COR-16983 xMatters REST API - on-call: Fixed an issue that resulted in incomplete member information being returned when using the GET /on-call endpoint.
Web user interface: Fixed an intermittent issue causing the web user interface to not load properly when slower network speeds resulted in components loading in the incorrect order.
Event report - Properties: Fixed an issue where the Properties report would occasionally return a blank recipient UUID.
Flow Designer - authentication: Fixed an issue that was preventing users from setting the authentication type of a custom step to "Allow Any".
Flow Designer - Create Event step: Updated the logic for numeric properties with no minimum or maximum defined to address an issue caused when the Create Event step initiated an event but the value for the numeric property was not specified.
xMatters REST API - people: Updated the POST /people to allow the timezone parameter to accept a time zone name as a value to fix an issue causing errors when updating a person.
Devices: Fixed an issue where some devices were being disabled because they weren't being recognized as valid.
Communication plans - export: Updated the import / export of communication plans so the necessary flow components are all exported.

August 19-23, 2019

xMatters REST API: Add and modify communication plan properties

Availability: Now in the xMatters REST API

The xMatters REST API previously gave you the ability to get information about the properties in your communication plans. The following new endpoints now let you add and modify properties as well:

Flow Designer: BMC Remedy ITSM & Jira Server

Availability: Now in On-Demand

We've just added four new built-in steps to Flow Designer! These built-in steps for BMC Remedy ITSM and Jira Server are the first that you can configure to run behind the firewall on the xMatters Agent:

bmc-remedy-create-incident.png BMC Remedy ITSM Create Incident - automatically create a new incident in BMC Remedy.
bmc-remedy-update-incident.png BMC Remedy ITSM Update Incident - automatically update an existing incident record and information changes.
jira-server-create-issue.png Jira Server Create Issue - automatically create a new issue in Jira Server.
jira-server-update-issue.png Jira Server Update Issue - automatically update an existing issue record as information changes.

Support notes (week of Aug 19-23)

xMatters Internal Reference No. Summary
Flow Designer - email initiation (usability): Updated the Email trigger in Flow Designer to accept valid sender addresses regardless of whether uppercase or lowercase is used when sending the email.
COR-17593 User Upload (usability): Updated the User Upload page to support sorting of User Upload jobs of the columns.
Android xMatters app: Fixed an issue that was causing the app to shut down unexpectedly and not process a push notification if the user upgraded to the latest version of the app and received the push notification before opening the updated app for the first time.
Messaging - scheduled messages: Fixed an issue that resulted in changes to a scheduled message not being saved if it was changed multiple times.
COR-16980 Flow Designer - HTTP trigger (usability): Updated the HTTP trigger setup dialog to provide confirmation when the URL is copied.
COR-17325 Admin - company details (usability): Improved validation for the URLs entered into the Single Sign On URL field.
Communication Center - dashboards (usability): Updated the Communication Center so users without permission to manage dashboards are not presented with those menu options.
Profile - Devices (usability): Fixed an issue where locked devices did not drop into the expected position when reordering them via drag-and-drop.
All Events report - filtering: Fixed an issue resulting in users not being able to filter the report by the available search options.
COR-17347 Setup Guide (usability): Updated the Setup Guide to take users to the applicable area in the application when clicking on a step.
 COR-17404 Trial - Admin tab: Fixed an issue that caused an error to display when navigating to the Admin tab in a new trial company.

About the early access delivery process

Customers can choose to opt their non-production environments into an Early Access Program (EAP) to see new functionality before it's released. If you're considering signing up for the early access program, there are a couple of important things to know:

  • Enrollment in EAP can be turned on any time through a support request.
  • Exiting EAP can only be done on quarterly boundaries (you cannot opt in and out between quarterly releases).

For full details, refer to the official On-Demand Deployment Process & Early Access article.

Have more questions? Submit a request


  • 0
    Karla Poplawski

    Highlights and support notes added for week of August 26-30, 2019:

    Updates include:

    • New in-country SMS numbers for Argentina and Italy
    • xMatters REST API: Get dynamic teams, response option translations, events or audits after or before, sort audits
  • 0
    Karla Poplawski

    Highlights and support notes added for week of September 2-6, 2019:

    Updates include:

    • New step for Flow Designer: Jira Server - Add Comment
    • Integration Directory: ServiceNow 5.4
  • 0
    Karla Poplawski

    Highlights and support notes added for week of September 9-13, 2019:

    Updates include:

    • Flow Designer: step sharing updates, withdraw and deprecate steps, HTTP trigger versioning
    • iOS mobile app version 3.25 (more accurate group search, support for mobile-only user role)
  • 0
    Christine Astle

    Highlights and support notes added for week of September 16-20, 2019:

    Updates include:

    • New step for Flow Designer: BMC Remedy ITSM - Add Note
    • JavaScript changes and upgrades
  • 0
    Karla Poplawski

    Highlights and support notes added for week of September 23-27, 2019:

    Updates include:

    • New 'Workflows' UI (coming to EAP on October 1)
    • xMatters REST API: More specific user search, GET /groups supervisors, Get dynamic team members
    • xMatters Agent: Windows Server 2016 support
  • 0
    Karla Poplawski

    Highlights and support notes added for week of September 30 - October 4, 2019:

    Updates include:

    • All Events Report updates: event source & form, export user delivery details
    • Required replacements for temporary absences
    • Flow Designer: email & HTTP trigger access permission updates
    • iOS 3.27: support for iOS 13, improved phone number validation, My Schedule shift info, display all push notifications
  • 0
    Karla Poplawski

    Highlights and support notes added for week of October 7-11, 2019:

    Updates include:

    • New Flow Designer Events steps: Get Events & Terminate Events
Article is closed for comments.
Powered by Zendesk