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.

Indy Quarterly Release Details Indy was released on July 14, 2020. The Indy release supports the continuous improvement of your on-call management processes, with new peformance metrics, historical on-call data, and usability enhancements for managing users, groups, and dynamic teams. For all the details, see the Indy (June/July) 2020 Release Overview. Next Release: Joust (Oct/Nov 2020) We've already started working on our next quarterly release, which we've named Joust. Follow the Joust Development Highlights & Support Notes page so that you receive updates throughout the quarter on all of the fun and functionality we're working on.

Introduction

We're hard at work on our next quarterly release, Indy, which will be rolling out in the June/July 2020 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 Indy 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.

July 6-10, 2020

Flow Designer: Slack 'Invite to Channel' step

Availability: Now in xMatters

The new Invite to Channel step for Slack from our Indy Release is now available in production environments. You'll find this step on the Apps tab of the Flow Designer palette:

You can use this step to invite users to a public channel using their display name (with or without the @) or user ID. For more information about configuring and using this step, see our online documentation for Slack steps.

Workflows: Improved import process

Availability: Now in xMatters

The next time you import a packaged workflow into xMatters, you'll see the updated Import Workflow dialog we implemented as part of the Indy Release:

We now more clearly indicate that you successfully imported the workflow and give you guidance about next steps. And, instead of hitting you with a wall of log messages and warnings about the import, we've moved them to a separate Import Logs tab for your reference.

Support notes (week of July 6-10)

xMatters Internal Reference No.	Summary
COR-28266 (SUP-21910)	Workflows - scenario recipients: Fixed an issue preventing scenario recipients from getting saved with the workflow.
COR-28230	xMatters REST API - GET /people/{personID}/devices: Corrected an issue to ensure information is displayed to users with the appropriate permissions.
COR-27982 (SUP-21887)	Integrations - event termination: Fixed an issue where some older integrations were not formatting event requests properly, which could lead to them terminating the wrong events.
COR-28276 (SUP-21927)	All Events report: Corrected an issue that caused the exported All Events report to display incorrect response devices.
COR-28011	Flow Designer - Endpoints: Fixed an issue that prevented users from successfully switching endpoints in the Create Channel step by displaying an error message.
COR-27997 (SUP-21647)	Flow Designer - Activity stream (usability fix): All trigger outputs, whether they are set or not, are now included in the Activity stream.
COR-27735 (SUP-21673)	Flow Designer - Switch steps (usability fix): The Switch step now displays a warning message when it isn't properly configured.
COR-27652	Flow Designer - Activity stream (cosmetic fix): Fixed an issue that caused icons in the Type column to be distorted for users in some browsers on older operating systems.
COR-27198	Flow Designer - Custom step creation: Corrected an issue that allowed multiple steps to have the same name, then displayed an error message when users attempted to save the step.
COR-25452	Flow Designer - Custom step libraries: Fixed an issue that prevented  Flow Designer from properly saving a new library on a custom step if the "Save" button was selected.

June 29 - July 3, 2020

Indy Release Overview

The Indy Release overview is now available! It's your comprehensive guide to all the great new features and enhancements we've packed into this quarterly release. For a quick run-down on the release, be sure to check out the Indy Quarterly Release video:

The Indy release is now live in non-production environments and we'll be toggling the features 'on' in production environments on Tuesday, July 14.

Support notes (week of June 29-July 3)

xMatters Internal Reference No.	Summary
COR-27857	xMatters REST API - POST /scenarios: Fixed an issue with the POST /scenarios endpoint that returned errors when the handling section was removed from the form.
COR-27854	xMatters REST API - GET /people: Corrected an issue where GET /people?embed=roles displayed incorrect role names if the name contained a pipe "|" character.
COR-27824	Workflows - Notification Flood Control (cosmetic fix): Improved the layout for some elements to ensure proper spacing between items.
COR-27750	All Events report: Corrected an issue causing users targeted by multiple suppressed events to appear in the Targeted Recipients column for each suppressed event.
COR-27724	Flow Designer - Endpoints in Slack steps: Fixed an issue that prevented Flow Designer from saving a successful connection with Slack across Slack steps.
COR-27713	User Profile - API Keys (usability fix): Improved the error messaging when creating API Keys.
COR-27588	Workflows - Email trigger: Fixed an issue that caused truncation and scrolling errors on the Authenticating User list.
COR-26605	Flow Designer - Remedy Endpoint: Fixed an issue where the "Preemptive" checkbox appeared after saving endpoint information.
COR-25581	Groups - Calendar tab (usability fix): Improved the layout of the Calendar tab so all days of the week are equally accessible.

June 22-26, 2020

xMatters Agent: Graceful shutdown on Windows

Availability: Now in the xMatters Agent

xMatters Agents running on Linux systems have had an advantage over their Windows-based brethren: when stopping a running agent, Linux systems would allow a brief period of additional processing for in-flight requests to finish processing. 

We've now added that capability to Windows systems! With the 1.5.6 version of the xMatters Agent (available now from the Agents page in the web user interface), using the stop service option or command allows the agent to handle the shutdown gracefully. The agent will stop accepting new requests but allow up to 90 seconds for in-progress jobs to complete and existing requests to be forwarded. The process also logs any outstanding requests that couldn't be handled within the 90-second drain period.

Help Resources: Get started with the xMatters mobile app

Availability: Now from xMatters Resources

The xMatters mobile app is one of the easiest and best ways to stay connected when you're on the go. If you still need convincing, or if you're looking for resources to help roll out the app in your organization, then check out these two new mobile app help resource kits:

• Ready, set, xMatters mobile app - Whether you're a seasoned xPert, or you've never seen the xMatters app in your life, this guide will take you through how to get the app set up on your devices, all the features it offers, and how to customize the settings, so everything is just how you like them.
• Getting your team set up with the xMatters mobile app - This guide takes you through some of the powerful features and benefits of using the mobile app, as well as the best way to get your team ready to start using it, including a handy one-page guide that you can download and send out to your users.

Support notes (week of June 22-26)

xMatters Internal Reference No.	Summary
COR-26648 (SUP-21700)	xMatters Agent: Improved error messaging and agent response when submitting a request without any body content.
COR-27050	xMatters REST API - GET /conferences: Fixed an issue where the GET /conferences endpoint would return a 500 error when calling the endpoint as a notified user.
COR-27214	xMatters Agent: Removed a misleading reference to a user manual from within the agent source files.
COR-27487	Workflows - webhook template: Fixed an issue where attempting to save changes to a webhook workflow template canvas would fail.
COR-27702 (SUP-21850)	All Events report(performance enhancement): Fixed an issue that was causing some events to be unavailable in the All Events report, and take a long time to load in the Recent Events report.
COR-27187	Flow Designer - custom steps (usability fix): Updated the two "panes" in the custom step configuration screen to scroll independently, making it much easier to drag and drop values into the fields on steps a high number of inputs.
COR-27709	Intelligent Event Management - event flood control: Fixed an issue that was preventing users from being able to search for a specific rule.
COR-27770 (SUP-21862)	All Events report (usability fix): Updated the All Events report so it will automatically refresh after changing, adding, or removing search criteria.

June 15-19, 2020

Reporting: Historical On Call report filters

Availability: Now in xMatters

We've added new filters to the Historical On Call report to let administrators narrow down the subset of data they export to use for their compensation and planning processes:

• Group Selector. Include data from just the groups you supervise, or all of the groups that you have access to in xMatters.
• Escalations. Choose a subset of data based on escalation criteria:
  • Include all escalations. Include data from all escalations in your report.
  • Filter by escalation level. Limit the report to a maximum number of on-call positions (for example, '2' positions includes primary and secondary on-call members).
  • Filter by escalation time. Limit the report to a maximum escalation delay in minutes (for example, '30' includes on-call information for the first 30 minutes of escalation delay).
• Temporary absences and replacements. Select to exclude data from your report about temporary absences and replacements that don't have any on-call time, so that you only pay the people who were actually on call.

All Events report: View comments in Overview

Availability: Now in xMatters

A couple of weeks ago, we added comments to the User Delivery export of the All Events report. As follow-up to that work, we've now added a Comments section to the Overview tab for an event:

This means as you're scanning the event Overview at the start of a post-mortem, you'll be able to see what was said during the event without yet having to dig into the detailed spreadsheet. As shown in the screenshot above, there's even a handy option to view 'Newest First' or 'Oldest First' (depending whether you want to start with the spoilers, or read the comments in chronological order).

Support notes (week of June 15-19)

xMatters Internal Reference No.	Summary
COR-27209	xMatters REST API - integrations: Improved system performance for some operations involving the /integrations endpoint.
COR-27338 (SUP-21568)	xMatters REST API - creating shifts: Fixed an issue that caused users to receive an error if they tried to add a shift with a null shift rotation.
COR-27515 (SUP-21817)	Web user interface (cosmetic fixes): Corrected an issue that caused browser timeouts and fixed some layout issues for users of Internet Explorer 11.
COR-27516	Workflows - xMatters Agents (cosmetic fixes): Improved the layout of some screen elements when working with xMatters Agents in the web user interface.
COR-27533 (SUP-21831)	All Events report - Initiator column: Corrected an issue that caused the All Events report to populate the Initiator column with "undefined" instead of the actual initiator's name.
COR-27672	Workflows - Agents (usability fix): Updated the Available Agents page so the Software Licence Agreement opens in a new tab or window.

June 8-12, 2020

Flow Designer: Improved flow management

Availability: Now in xMatters

You may have noticed the Flows tab recently got a facelift and some new functionality!

Here's a run-down of what's new:

• Rename canvases and add descriptions. You can now change the default form names assigned to your canvases and add descriptions to help identify them. To do this, select 'Edit Name' from the new settings menu (the gear icon), as shown in the screenshot above.
• Improved styling. It's easier to scan the list of canvases and identify which triggers they use and the forms they're associated with (which is super helpful after you've edited your canvas names).
• Clear the clutter. Canvases that aren't associated with a form include a 'Delete' option in their settings menu. This lets you clean up any old canvases you've got lying around from legacy inbound integrations built using the Integration Builder.

Flow Designer: New DevOps steps for Splunk and Jenkins

Availability: Now in xMatters

DevOps folks in the crowd will be happy to hear that we've added a flow trigger for Splunk, as well as a step to initiate a pipeline or new project execution in Jenkins:

Splunk Alerts App Trigger

Available on the Triggers tab of the palette, the built-in Splunk Alerts trigger initiates flows when it receives a request from Splunk, either from the xMatters Actionable Alerts app or from a generic alert webhook.

Not sure if you should use the app or a generic webhook?
No worries, we've got you covered - check out our helpful tips about which method is right for your workflow.

Jenkins Build Project

The Jenkins Build Project step lets you automatically start a new project or pipeline in Jenkins in response to previous steps in your flow. You can map outputs from previous steps to the inputs of the Jenkins step to dynamically set the values at runtime.

You can find this step on the Apps tab of the palette:

Support notes (week of June 8-12)

xMatters Internal Reference No.	Summary
COR-26288	Flow Designer (usability fix): Updated the step configuration process while editing a step to prevent users from accidentally closing the window when a required field is blank and losing any changes.
COR-26980	User Upload (cosmetic fix): Fixed the positioning and layout of some column entries on the User Upload report.
COR-27055	Flow Designer - French translations: Updated or added some missing and incorrect French translations for part of the Flow Designer interface.
COR-27260 (SUP-21783)	xMatters REST API - GET /user-deliveries: Fixed an issue where some REST API requests involving a large number of recipients were returning incomplete results.
COR-27350	Communication Center - Event Traffic widget: Fixed an issue where the Event Traffic widget would use the incorrect color when displaying only low priority events.
COR-27091	xMatters REST API - get people by site: Fixed an issue where retrieving users for a site from historical data would only accept the site's UUID and not its name.
COR-27318	xMatters REST API - create or modify forms: Updated the error message returned by the REST API when attempting to update a form that does not exist (the provided id was not found).
COR-27382 (SUP-21769)	All Events report: Fixed an issue that was causing inconsistencies between the All Events and Recent Events reports when a user who was an event initiator had been removed from the system.
COR-24120	Flow Designer - step usage: Fixed an issue where the Usage tab would display multiple entries for some flows.

June 1-5, 2020

Indy Quarterly Release

Our next quarterly release is coming up fast! Here are the dates you'll want to mark on your calendar:

• Non-production environment access: Tuesday, June 30
• Production environment access: Tuesday, July 14 (enabled between 10:00-10:30 am Pacific)

Keep an eye out for the complete Indy feature overview, coming on Tuesday, June 30!

All Events Report: Export comments

Availability: Now in xMatters

The ability to add comments to an event (either with your response or directly to the event's Tracking report in the web UI or mobile app) is a great way to provide additional details or context to an event as it progresses. It's also beneficial to have access to those comments when you're performing root cause analyses or investigations into past events.

To support this, we've added a new Comments tab to the User Delivery .csv file export of the All Events report. Here you can view a record of all the comments added to an event, including the time each comment was added, and the user who added it:

Flow Designer: Auto-layout optimization

Availability: Now in xMatters

The Auto Layout button in Flow Designer is a handy tool you can use to quickly tidy up your steps on the canvas and align them to a grid. Over time, as the functionality and tools in Flow Designer have evolved, we've seen our customers build some seriously impressive and complex flows - and we've had to update the auto layout feature to keep up! 

The next time you use this feature, you'll notice your flows are a lot easier to read and follow, with merged flows grouped together, and no overlapping steps and lines, or unpredictable directions in flow paths:

And, if you want to easily change the order of your flows from top-to-bottom on the canvas, just drag the first step of a flow to a new position, then hit auto-layout to bring the rest of the steps along:

FFFun fact!
Here at xMatters, the auto-layout button is fondly - yet unofficially - known as the "F-bomb" because it looks like the letter 'F' and a bomber aircraft. So with these improvements, we guess you could say there's never been a better time to drop the F-bomb!

Support notes (week of June 1-5)

xMatters Internal Reference No.	Summary
COR-27343 (SUP-21794)	xMatters mobile app (Android): Fixed an issue that prevented users from receiving a device validation message.
COR-27216	Messaging - scheduled messages: Fixed an issue where some scheduled messages were not being sent and some notifications were targeting the incorrect primary on-call responder.
COR-27004	Subscription forms - deleting: Corrected an issue where deleting a subscription form that had active notifications resulted in users seeing an incorrect error message.
COR-26986 (SUP-24734)	Admin - custom properties: Fixed an issue that prevented users from changing the order of custom fields.
COR-26939 (SUP-21731)	Flow Designer: Corrected an issue that caused some Flow Designer requests to return 409 errors.
COR-26903	Flow Designer (usability fix): Adjusted the layout to ensure palette drop-down menus don't get cut off on the edge of the screen.
COR-26745 COR-26735	Flow Designer (cosmetic fixes): Fixed layout issues in Flow Designer so multiple lines of information are not displayed as a single line.
COR-25942 (SUP-21619)	Groups - Shifts: Corrected an issue that caused discrepancies in shifts if the calendar was changed from a time zone that observes Daylight Saving Time to one that doesn't.

May 25-29, 2020

Integrations: Microsoft Teams bot updates

Availability: Now in xMatters

We've released a new version of our Microsoft Teams bot, which includes the following handy updates:

• The on-call command now displays the first five recipients that are on call across all active shifts in a group, and also takes into account absent users and their temporary replacements.
• Invitations to join a channel now give you more context by providing the name of the Team you're being invited to join.
• We've added new aliases for some of the primary bot commands. For example, you can now use "oncall" for on-call, "lookup" for find, and "page" or "engage" for invite.
• We updated the bot's help examples so it's easier to understand how to use the commands with a keyword or a group name.

Flow Designer: Create Event step updates

Availability: Now in xMatters

The xMatters Create Event step includes two new tabs: Devices and Handling & Overrides. You can use the settings on these tabs to fine-tune the events created by your flows - without having to build custom steps!

Devices

The Devices tab lets you specify which devices xMatters contacts people on. You can do this in one of two ways:

• With a comma-separated list of target names, defined using the values of outputs from previous steps or constants, or by typing into the field:

• By picking devices from a list of all the available device types (this is the same as the Devices section from the form associated with the Create Event step):

Handling & Overrides

This tab lets you control how the event behaves and how recipients interact with voice notifications, as well as allowing you to override sender information.

For each setting, you can either select or specify a value. When you select the option to 'Use Output or Constant Value', you'll be able to drag an output or constant from the sidebar as the value for that setting, or type in the value that you'd like to use:

What about my existing form settings?

The settings on these tabs reflect the device and handling settings that you've already set up for the form that's associated with your Create Event step. You can leave them as they are, or customize them for your flow - any changes you make in Flow Designer will override the settings in your form layout.

Mobile: Android 2.24

Availability: Now from the Google Play store

Android users, you'll want to head over to the the Google Play store to get the latest version of the xMatters app, which includes an overflowing basket of new goodies:

• See who's on call - Tap any shift in My Schedule to see who's on call, who's absent, and who's covering as a replacement.
• Log in with biometrics - You can now log into the app using your fingerprint for facial ID. (You'll also need to set up a screen lock for your device, if you haven't already.)
• Manage events on the go - Terminate, resume, or suspend events from within the app.
• See what people are saying about an event - We've added the ability to view comments for an event (and in our next release, you'll also be able to add your own comments).

xMatters REST API: Find dynamic teams

Availability: Now in the xMatters REST API

Want to be able to search for dynamic teams or find the dynamic teams that someone supervises? We've added new search and supervisors query parameters to GET /dynamic-teams that let you programmatically do this with the xMatters REST API:

• GET /dynamic-teams?search={term1}+{term2} - returns a list of dynamic teams with any of the search terms in their name or description.
  • You can narrow your search to teams that include all the terms by using the operand query parameter. For example: GET /dynamic-teams?search=term1+term2&operand=AND
  • You can also search just the name or description field by setting the fields query parameter. For example: GET /dynamic-teams?search=term1&fields=DESCRIPTION
• Get /dynamic-teams?supervisors={targetName or ID} - returns a list of dynamic teams supervised by a particular person, or people, identified by their target name or user ID. For example: GET /dynamic-teams?supervisors=asharma,6f347364-8dc7-4871-819b-e3e7dbfda2de
  
  • When two or more supervisors are included in the request, the response includes dynamic teams for which either user is a supervisor.

Support notes (week of May 25-29)

xMatters Internal Reference No.	Summary
COR-26370 (SUP-21638)	Integration Builder: Fixed an issue that caused some Integration Builder requests to return 429 errors.
COR-26818	xMatters REST API - GET /people: Corrected an issue that prevented the xMatters REST API from returning data when certain parameters were used with the "at" parameter.
COR-25093	xMatters Mobile App (Android) - temporary absences: Fixed an issue so users can select starred users as replacements for temporary absences.
COR-26114	Workflows - Event Flood Control: Fixed an issue that prevented users from deleting rules or viewing the status of rules in the table.
COR-26119	Workflows - Subscription Forms: Fixed an issue that prevented users from seeing all scope options in the drop-down menu.
COR-25659	All Events report: Corrected an issue that prevented users from copying text from the All Events report page.

May 18-22, 2020

Support notes (week of May 18-22)

xMatters Internal Reference No.	Summary
COR-26776 (SUP-21716)	Flow Designer - editing workflows: Corrected an error that prevented some users from opening the Configuration page for a workflow.
COR-26547	Messaging forms - recipient selector: Fixed an issue where the Apply/Close buttons were missing from the Recipient selector window in certain browsers.
COR-26040	xMatters Mobile App (iOS) - Who's On Call: Fixed an issue that showed an incorrect error message if a user attempted to view groups that they don't have permission to view.
COR-26039	Groups - Add Group members (usability fix): Corrected an issue where the drop-down menu of users did not properly display scroll bars or information on the number of available users.
COR-26392	xMatters mobile app (iOS) - viewing shifts: Fixed an issue that caused users to receive an error when attempting to view shifts already in progress.
COR-26333	xMatters mobile app (iOS) - Reports: Corrected an issue that prevented the Reports pages from displaying the full name of an event.
COR-26287	xMatters mobile app (iOS) - Temporary Absences: Corrected an issue that caused temporary absences to appear as though they applied to All Groups, rather than a specifically selected group.
COR-26106 (SUP-21646)	Messaging Forms - scheduled messages: Fixed an issue where scheduled messages were not saving dynamic team details if the dynamic team had a space at the end of its name.
COR-26589 (SUP-21681)	Reporting: Fixed an issue to correct inconsistencies in initiator information between the All Events and Recent Events reports.

May 11-15, 2020

Integrations: Slack bot updates

Availability: Now in xMatters

If you've integrated xMatters with Slack, then you're probably using our handy xMatters bot to look up who's on call in your groups and invite them to collaborate in a Slack channel.

We think you'll be happy to hear that the on-call command for the xMatters bot now displays the first five recipients that are on call across all the active shifts in a group, and also takes into account absent users and their temporary replacements. Happy Slack-ing!

Support notes (week of May 11-15)

xMatters Internal Reference No.	Summary
COR-26687 (SUP-21701)	xMatters mobile app (iOS) - push notifications: Fixed an issue that was preventing some users from properly registering and enabling push notifications for the xMatters mobile app.
COR-26504 (SUP-21692)	Groups and Users pages - searching: Increased the maximum number of characters allowed when using the Search field on the Groups and Users pages.
COR-26421	Flow Designer (cosmetic fix): Improved the layout of the elements displayed when viewing a flow canvas to prevent the overlapping of various user interface controls and components.
COR-26348	Flow Designer - shared libraries: Fixed an issue that could cause the permissions dialog to close abruptly when modifying access for a shared library.
COR-26194	Subscriptions - adding subscription (cosmetic fix): Updated the layout of the user interface elements when adding a subscription to prevent some of the controls from being cut off.
COR-26158 (SUP-21475)	Subscriptions (usability fix): Improved the error message displayed when adding a subscription with a name that is already in use.
COR-26152	User profile - Roles page (cosmetic fix): Improved the layout and presentation of the roles lists on the Roles page when viewing a user's profile.
COR-25609 (SUP-21593)	Flow Designer - switch steps: Fixed an issue that was preventing some switch steps from opening the menu to select a property during configuration.
COR-24081	Flow Designer - custom steps: Updated the custom steps list to ensure that it is properly sorted in the menu; i.e., alphabetically by name.
COR-25900 (SUP-21319)	Slack integration: Fixed an issue where the xMatters Slack bot would not allow anyone to overwrite an existing configuration if the user who installed it was no longer an xMatters user.
COR-26382 (SUP-21680)	Web user interface (usability enhancement): Improved the behavior of some controls, such as drop-down lists, to expand the interactive area and make them easier to use.
COR-26159	Web user interface (usability enhancement): Updated some missing French translations in the Invite Your Team dialog box.
COR-26035	Groups - Shifts: Corrected an issue that prevented users from editing holiday shifts.

May 4-8, 2020

Reporting: Event Traffic widget

Availability:  Now in xMatters

The Communication Center now includes an Event Traffic widget that you can add to your dashboards to monitor the volume of events coming into your system from different sources or with different priority levels.

The Event Traffic widget bundles together our previous Events by Source widget with a new 'Events by Priority' graph option, and provides additional timeframes for displaying your data:

View what's important to you

By adding Event Traffic widgets to your dashboard, you can create custom snapshots of the events taking place in your system over different time periods. For example, in the dashboard below we're using two Event Traffic widgets - one for monitoring events by priority over the past 24 hours, and another for monitoring events by source over the past 7 days:

Show me the data!

Like before, you can move your cursor over a graph to get a summary of event data at a specific point in time. You now also have the option to drill through to the All Events report to explore a graph's underlying data in more detail. You can do this either by:

• Clicking the timeframe link below the graph's title ("Past 30 Days" in the example below) to view event data for the entire timeframe displayed on your graph.
• Clicking and dragging your cursor over a specific region of the graph and selecting 'View Report' to view event data for just the selected time period:

For more information about configuring and using the Event Traffic widget, see our online help.

xMatters REST API: Find users by custom fields and attributes

Availability: Now in the xMatters REST API

Do you ever use GET /people with the propertyName,propertyValue parameter to programmatically find users based on the value they're assigned for a custom field or attribute - like the users with a custom field or attribute named 'FirstAid' with the value 'CPR'?

If so, you'll want to start using the updated propertyNames,propertyValues version of this parameter instead, which allows you to specify one or more property name and value pairs. When you specify two or more pairs, the results include only people that match all the criteria. For example:

GET /people?propertyNames=FirstAid,Campus&propertyValues=CPR,West

This request returns all the users with a custom field or attribute named 'FirstAid' with a value of 'CPR' AND a custom field or attribute named 'Campus' with a value of 'West' (in other words, all the people at the West campus that have first aid certification for CPR).

Support notes (week of May 4-8)

xMatters Internal Reference No.	Summary
COR-26232 (SUP-21658)	User Profile - API Keys: Corrected an error where users with periods in their user names were unable to create API Keys.
COR-26167	User Upload page: Fixed an issue that prevented the page from properly applying filters and displaying expected results.
COR-26115	User Profile - Devices: Corrected an issue that prevented users from marking some valid email addresses as tested.
COR-26074	Flow Designer - Form layout: Fixed an issue that prevented a custom  hierarchy property from displaying a new saved name.
COR-23029	Flow Designer - Libraries: Corrected an issue where making a copy of a library with unsaved title changes did not properly name the new library.
COR-26064 (SUP-21636)	xMatters REST API - GET /audits: Fixed a permission issue so users can properly see event timelines.
COR-25978	xMatters REST API - ?embed=recipients for GET /forms and GET /plans/{planId}/forms: Fixed an issue so the embed command returns all recipients for these two endpoints.

April 27 - May 1, 2020

xMatters REST API: On-Call Summary

Availability:  Now in the xMatters REST API

If you use the xMatters REST API to get on-call information, then you'll probably be interested in our new On-Call Summary endpoint. This endpoint makes it easier to see which recipients in a group will be targeted, the order they'll be targeted in, and how long before each of them is targeted.

To look up the on-call summary for a group (or groups), identify the group by its ID or target name. You can optionally use the escalationOrder query parameter to narrow your results to a specific escalation level (like 'Primary' or 'Primary and Secondary'). For example:

GET /on-call-summary?groups=DBA,2b6cf1a8-2186-41bb-951e-f79e9e776c95&escalationOrder=PRIMARY

This request returns the on-call summary of the primary on-call recipients in the DBA group and the Security group (identified by its ID).

Support notes (week of Apr 27-May 1)

xMatters Internal Reference No.	Summary
COR-25700 (SUP-21599)	Recent Events Tracking report - responses: Fixed an issue where the Tracking report was not including responses from some users when the response was in a language other than English.
COR-25566	User Upload: Fixed an issue where the User Upload feature wouldn't properly process an upload file if it included a custom role with special characters in its name.
COR-25474	Flow Designer - custom steps (usability fix): Updated Flow Designer to prevent accidental deletion of the base version of a custom step.
COR-25428	Flow Designer - deprecated triggers: Fixed an issue where adding a new "Send a Webhook" outbound integration to a workflow could break existing flows.
COR-25891 (SUP-21642)	All Events report - exporting: Fixed an issue where the exported version of the All Events report would include different values for "Did Not Respond" than the version displayed in the web user interface.
COR-24838 (SUP-20690)	EPIC Data Sync (usability fix): Updated the EPIC Data Sync feature to prevent it from creating shifts with the same name.
COR-25902	xMatters Agent - installing: Updated the install instructions for the xMatters Agent on Debian systems to reference the correct Java version requirement.
COR-25881 (SUP-21519)	Flow Designer - Jira Cloud Update Issue step: Fixed an issue with the Jira Cloud Update Issue step that was causing it set the linked issue to " "Unassigned".
COR-25813	xMatters REST API - GET /plans: Updated the GET /plans endpoint to ensure that the plan name is returned, and not just the plan ID.
COR-25806 (SUP-21516)	xMatters REST API - GET /events: Fixed an issue with the GET /events endpoint where event data retrieved using the at parameter would not include recipients.

April 20-24, 2020

xMatters REST API: Find groups by members

Availability:  Now in the xMatters REST API

Ever wished there was an easy way to look up groups based on their membership? Well, your wish is our command! We've added a new members query parameter to Get /groups that lets you find groups that contain particular users, devices, or dynamic teams. You can identify members by their target name or ID. For example:

GET /groups?members=asharma,6f347364-8dc7-4871-819b-e3e7dbfda2de,DBA

This request returns all the groups that contain any of the queried members: Ananya Sharma, Mary McBride's work phone (identified by its ID), and the DBA dynamic team.

Support notes (week of Apr 20-24)

xMatters Internal Reference No.	Summary
COR-25824 (SUP-21608)	xMatters REST API - GET /on-call: Corrected an issue where the on-call endpoint returned incorrect shift members.
COR-25811	xMatters Agent: Updated the xMatters Agents page to prevent the use of spaces in agent names.
COR-25801 (SUP-21610)	Workflows page: Corrected in issue that prevented users from reordering their workflows on the page.
COR-25675	xMatters REST API - POST /subscriptions: Fixed an issue that displayed incorrect error messages for users attempting to create or update subscriptions.
COR-25572 (SUP-21580)	Recent Events report - Messaging tab: Fixed an issue that prevented message text from appearing properly in the window.
COR-25557 (SUP-21581)	User profile - Subscriptions: Corrected an issue that prevented users with valid permissions from editing subscriptions.
COR-25473 (SUP-21036)	Flow Designer - HTTP Trigger Usage Permissions: Updated the behavior in Flow Designer to properly log information when usage permissions change.
COR-25443	Flow Designer (usability fix): Corrected an issue that allowed users to interact with and modify disabled fields.
COR-25645	xMatters REST API: Improved the error messages displayed to users when they attempt to create dynamic teams or groups.
COR-25638 (SUP-21043)	xMatters REST API - GET /forms/{formId}/sections: Improved performance when searching for form sections.
COR-25567 (SUP-21540)	Flow Designer (usability fix): Corrected an issue that caused errors for some users.
COR-25469	User profiles - API keys: Updated French translations for some text on the API Keys tab.
COR-25453	Flow Designer - built-in workflow: Fixed an issue that caused an error to display in the web user interface when editing a custom step after opening a flow for a built-in workflow.
COR-25393 (SUP-21548)	Users - Advanced Search (usability enhancement): Increased the width of the selection boxes when searching by custom attribute to make it easier to see long attribute names.
COR-25358 (SUP-21523)	Voice notifications: Fixed an issue that was preventing voice notifications from reaching some customer devices.
COR-25280 (SUP-21540)	Flow Designer - Activity panel: Fixed an issue that resulted in an error displaying in the web user interface when opening the activity log for a flow with no steps.
COR-25272 (SUP-21540)	Flow Designer - step validation: Updated step validation to properly display misconfigured step icons when Flow Designer detects an issue with a step's settings.
COR-25153	Flow Designer (cosmetic fix): Updated the palette to ensure  it resizes properly when multiple step versions are expanded.
COR-25138	Flow Designer - Activity (usability enhancement): Updated the Activity panel to display event properties in the Event tab even if no value for the property was provided when the event was created.
COR-25037	Notifications - recipient handling: Fixed an issue where some recipients with special characters in their name were not receiving notifications.
COR-22935 (SUP-21372)	Flow Designer (usability enhancement): Updated the validation for required inputs when configuring steps to remove the 'required field' message once the field has a value.

April 13-17, 2020

xMatters REST API: Create and manage subscription forms

Availability: Now in the xMatters REST API

In xMatters, users can subscribe to be notified about events that they're interested in, even if they're not scheduled to receive a notification for those events. Subscription forms are what allow you to determine who can subscribe to events from your workflow, which properties they can subscribe to, and whether they can respond to notifications.

Previously, the xMatters REST API gave you the ability to get information about the subscription forms in your workflows. Now, the new POST endpoint lets you create or modify subscription forms as well:

• POST /plans/{planId}/subscription-forms - Create or modify a subscription form for a workflow.

Support notes (week of Apr 13-17)

xMatters Internal Reference No.	Summary
COR-25446	xMatters REST API - GET /people: Fixed an issue where embedded searches did not include empty device and supervisor objects in search results. (This fix applies to GET /people?embed=devices,  GET /people/{personID}?embed=devices, and GET /people/{personID}?embed=supervisors.)

April 6-10, 2020

Reporting: Events by Source widget

Availability: Now in xMatters

The Events by Source widget announced in the Hogan's Alley release is now available! Adding this widget to your Communication Center dashboard allows you to monitor the volume of events that came into your system from different workflows - and to identify noisy sources without needing to export and analyze event data in a third-party tool.

Tell Show me more!

The widget displays event counts over the past seven days for six sources with the most event traffic. (If you've got more than six workflows, the remainder are grouped together in the "Other" category.) By moving your cursor over the graph, you can get a detailed summary of hourly event count data from each source:

You can also tailor your graph to specific workflows: just select or clear the check boxes below the graph to change which sources are displayed. The scale along the left axis of the graph automatically adjusts to give you the best view of the selected sources: 

Integrations: ServiceNow version 5.5

The latest version of the xMatters application for ServiceNow - certified with London, Madrid, New York and now Orlando - is available from the ServiceNow Store. This release includes a lot of great updates, including these highlights:

• Ability to set the Resolution Code and Resolution Notes required by the Incident Management Best Practices plug-in, introduced in the Kingston release.
• Setting the state of an incident to 'Canceled' now terminates the associated xMatters event. (If you want to use the previous behavior, see Set what happens when an incident is canceled.)

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

Support notes (week of Apr 6-10)

xMatters Internal Reference No.	Summary
COR-25237 (SUP-21531)	User Upload (usability fix): Fixed an issue where the User Upload would fail if certain languages were enabled in the company details.
COR-25283 (SUP-21073)	Device management (performance enhancement): Fixed an issue that was causing slight delays when deleting devices.
COR-25338 (SUP-21549)	xMatters REST API - POST /plans: Fixed an issue that was causing some 500 errors when attempting to access the POST /plans endpoint.

March 30-April 3, 2020

Help Resources: 'Let's get integrating' guide

You don't need to be a developer to integrate other tools with xMatters and build automated toolchains. xMatters makes building and managing incident management workflows accessible to everyone - whether you think ‘code’ is a four-letter word, or you dream in functions and methods.

Our new Let's get integrating guide is a great starting point for integrating with xMatters, regardless of your skill level. It's loaded with great tips & tricks and additional resources to help you progress along your integration journey. Be sure to bookmark this go-to reference today!

xMatters REST API: New GET /people query parameters

Want to be more selective when you're searching for users? We've enhanced the GET /people endpoint with two new query parameters that you can use along with the search parameter to create more specific searches:

• GET /people?search={term}&operand=AND - If you're using multiple search terms, you can include the operand parameter with 'AND' to narrow your search to users that contain all of the terms across any of their search fields (first name, last name, target name, web login, email, and phone number).
  
  • For example, GET /people?search=in dy&operand=AND would return the users that contain both 'in' and 'dy', like Inidya Sharma, Andy Plain, and Betty Smith (whose email address is 'betty@dynamicinc.com').

• GET /people?search={term}&fields={term} - If it's only specific fields you're interested in searching (like first name or last name), you can use the fields parameter.
  • For example, GET people?search=don jack&fields=FIRST_NAME,LAST_NAME returns users whose first or last name contains the terms don or jack (like Tom Donalds, or Jack Gardner).
  • FYI, if you added operand=AND to this request, xMatters would return users that contain both 'don' and 'jack' across the specified fields (like Don Jackson and Jackson Donald).

Support notes (week of Mar 30-Apr 3)

xMatters Internal Reference No.	Summary
COR-24926 (SUP-21477)	Messaging - adding recipients (usability fix): Adjusted the sensitivity on the Available Recipients drop-down menu so clicking anywhere in the menu opens it properly.
COR-24832	Messaging tab (cosmetic fix): Corrected an issue where an error message was not appearing with its associated field on the screen.
COR-23293	All Events Report (cosmetic fix): Adjusted the Message Subject field to truncate when the subject is longer than the size of the available row.
COR-25071 (SUP-21502)	Jira Cloud integration: Fixed an issue where the "Engage with xMatters" window did not load properly.
COR-24963	Flow Designer - Responses trigger (cosmetic fix): Fixed an issue that caused response options to be misaligned.
COR-24958 (SUP-21476)	xMatters REST API - POST /plans/{planId}/integrations: Corrected an issue that prevented users from including a script in their integration.
COR-24948	Event Flood Control - Create a rule (usability fix): Corrected an issue that displayed previously entered, unsaved data in the name field.
COR-24947	Event Flood Control (cosmetic fixes): Tweaked a couple of minor layout and positioning items on the Event Flood Control page.
COR-24925	Invite Users window (usability fix): Corrected an issue that caused the Invite Users window to appear incorrectly in some browsers at a specific screen resolution.
COR-24897 (SUP-21467)	xMatters REST API - GET /on-call: Fixed an issue where shift members were displayed in an incorrect rotation order.
COR-24891	Company Details (cosmetic fix): Corrected an issue where an error message was not appearing with its associated field on the screen.
COR-24872 (SUP-21448)	All Events report - Notification Statistics: Fixed an issue where the Notification Statistics and User Delivery pages displayed different user counts for the "Failed" delivery status.
COR-24856 (SUP-21461)	All Events report - User Delivery: Corrected an issue that prevented the All Events report from properly displaying results for one of the search filters.
COR-24424	User Upload report (cosmetic fix): Fixed an issue where an incorrect message was displayed when users set the "from" date to be after the "to" date.

March 23-27, 2020

Workflows: Datadog configuration improvements

It's now even easier to integrate with Datadog! We've updated the configuration screen of our Datadog built-in workflow with a new section that includes a JSON payload. You can copy and paste this payload into Datadog's "Custom Payload" field to simplify the integration's configuration, and to make more Datadog information available in xMatters notifications:

If you have an existing Datadog built-in workflow, you'll see that we've also updated your configuration screen with this new section. You can paste the payload into any of your existing Datadog webhooks for xMatters.

Support notes (week of Mar 23-27)

xMatters Internal Reference No.	Summary
COR-24876 (SUP-21471)	Historical On Call report (performance enhancement): Improved responsiveness when generating reports involving large groups.
COR-24836 (SUP-21444)	Communication Center - sharing dashboards: Updated the permissions for shared dashboards so only the owner of a shared dashboard can make changes or delete the dashboard.
COR-23916 (SUP-21110)	xMatters REST API - dynamic team: Fixed an issue that prevented the removal of observers from dynamic teams
COR-22656	xMatters REST API - Shift member escalation type: Corrected an issue where the incorrect escalation type was assigned to members of a shift.
COR-24837 (SUP-21456)	EventStatus callback user: Fixed an issue where the EventStatus callback user provided information on the event initiator rather than the user who terminated the event.
COR-24827 (SUP-21285)	xMatters REST API - GET /event/{eventID}/recipients: Fixed an issue where the return did not include deleted recipients.
COR-24682 (SUP-21401)	All Events report: Corrected an issue that prevented some data from displaying properly to users.
COR-24651 (SUP-21371)	Flow Designer - email trigger: Corrected an issue where the sender's email address wasn't used properly used in the email.sender step output.
COR-24199	Flow Designer - custom steps (cosmetic fix): Fixed an issue that truncated the drop down menus for custom steps in the palette.
COR-24165	Groups - Who's On Call: Fixed an issue that prevented the user from seeing all group members in a shift.
COR-24745 (SUP-21439)	xMatters REST API - GET /forms: Updated the GET /forms endpoint to prevent it from incorrectly returning forms for system workflow plans.
COR-24662 (SUP-21415)	All Events report - Notifications: Updated the All Events report so users without devices are properly reported in the notification metrics as "failed".
COR-24642 (SUP-21424)	All Events report - User Delivery: Fixed an issue where the User Delivery tab and exported report displayed incorrect information in the First Delivery column.
COR-24534 (SUP-21380)	iOS mobile app - scenarios: Corrected an issue that prevented valid users from opening a scenario if they didn't have permission to access to the form.
COR-24327 (SUP-21334)	Android mobile app - My Schedule: Improved application performance for users with complex schedules.
COR-23950 (SUP-21240)	Android mobile app: Fixed an issue that was preventing users from being able to properly modify order and delays for externally owned devices.
COR-24408 (SUP-20842)	xMatters Agent - proxy configuration: Corrected an issue that caused the xMatters Agent to make an extra request when routed through a proxy server.
COR-23778 (SUP-21441)	Messaging - Scenarios: Fixed an issue that was redirecting users to the Workflows tab when attempting to send a message.

March 16-20, 2020

xMatters REST API: Find groups by supervisor

Want to look up all the groups that someone supervises? Well, you can now do this programmatically using the xMatters REST API! We've added a new supervisors query parameter to GET /groups that you can use to return the groups that a person supervises by specifying their target name or ID. For example:

• GET /groups?supervisors=asamara - returns all the groups Ali Samara supervises.
• GET /groups?supervisors=6f347364-8dc7-4871-819b-e3e7dbfda2de - returns all the groups Mary McBride supervises (using her UUID).
  

When two or more supervisors are sent in the request, the response includes groups for which any of the specified users is a supervisor:

• GET /groups?supervisors=asamara,6f347364-8dc7-4871-819b-e3e7dbfda2de - returns all the groups that either Ali Samara or Mary McBride supervise.

xMatters REST API: Search past events by priority

• Get /events?at={timestamp}&priority=HIGH - returns any high priority events in your system at the specified point in time.
• Get /events?at={timestamp}&priority=HIGH,MEDIUM - returns all the high and low priority events in your system at the specified point in time.

Support notes (week of Mar 16-20)

xMatters Internal Reference No.	Summary
COR-24446 (SUP-21381)	User profile - Subscriptions page: Fixed an issue where the Subscriptions page would display the subscription details only for subscription owners and not subscribers.
COR-24460 (SUP-21343)	Workflows - editing scenarios: Fixed an issue where attempting to edit a scenario on the Workflows page would cause an error.
COR-21835	Responses - redirects: Fixed an issue where configured URL redirects would not work properly for responses submitted after an "Escalate" response.
COR-24262	iOS mobile app - My Schedule: Fixed an issue where the mobile app would intermittently not load more dates when scrolling down to the bottom of the My Schedule page.
COR-24344	iOS mobile app - comments (cosmetic fix): Adjusted the placement of the submit button when adding comments to a response so it won't overlap the text field.
COR-24437 (SUP-21350)	Historical On Call report: Fixed an issue where the Historical On Call report would sometimes return multiple instances of the same shift.
COR-24643 (SUP-21378)	Workflows - custom properties: Fixed an issue where recipients would fail to populate correctly if the workflow included a custom property named "recipients".
COR-23757	Flow Designer (usability fix): Fixed an issue where Flow Designer would display an error when attempting to reload or refresh a new canvas that had not been saved yet.
COR-24291	All Events report - Message tab: Updated the Message tab on the All Events report to display the correct web login value for recipients.
COR-24379 (SUP-21364)	Integration Builder - inbound authentication: Fixed an issue where the Trigger URL for some inbound integrations was not updating automatically when selecting a different authenticating user.
COR-24436	Event Flood Control - suppressed events: Fixed an issue where certain property types were not displayed as property matches when viewing details for a suppressed event.
COR-24442 (SUP-21385)	Groups - DST warnings: Fixed an issue where warnings about upcoming shift gaps or overlaps due to Daylight Saving Time changes were not being displayed for applicable groups.
COR-24615	Subscriptions - permissions: Fixed an issue where some permissions to act on a subscription were not enforced after the subscription was shared with other users.

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.