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.

Hogan's Alley Quarterly Release Details Hogan's Alley was released on March 3, 2020. The Hogan's Alley release includes improvements for service teams, Flow Designer integration enhancements, new reporting features, and more. For all the details, see the Hogan's Alley (Feb/March) 2020 Release Overview. Next Release: Indy (June/July 2020) We've already started working on our next quarterly release, which we've named Indy. Follow the Indy 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, Hogan's Alley, which will be rolling out in the Jan/Feb 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 Hogan's Alley 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.

March 9-13, 2020

While there are no feature highlights to tell you about this week, we did feel it was important to let you know about a new workshop we're offering:

Communicating during a viral outbreak

March 2-6, 2020

Hogan's Alley Release

The Hogan's Alley Release is now available in production environments. For an overview of all the features and enhancements included in the release (and their availability), see our Hogan's Alley Release Overview.

Hogan's Alley Training Webinars

For a guided tour of Hogan's Alley (so to speak!), including tips and tricks, sign up for one of our webinars. 

Support notes (week of Mar 2-6)

xMatters Internal Reference No.	Summary
COR-22997	Flow Designer - Activity panel (usability fix): Corrected an issue where an expanded drop-down menu did not close after another action was selected.
COR-23030	Flow Designer - step versions: Corrected an issue where deleting a newly created step version resulted in a some browsers displaying a gray screen, but not completing the action.
COR-23569	Flow Designer - Activity panel: Fixed an issue where the Activity panel displayed HTTP trigger information instead of the correct step information.
COR-23960	xMatters REST API - POST /scenarios: Corrected an issue where users received an incorrect error message after adding scenarios containing information not available on the form.
COR-24224	xMatters REST API - GET /people?roles: Fixed an issue where the returned results contained only a single role even if the user has multiple roles.

February 24-29, 2020

Integration Agent 5.3.0

The latest release of the Integration Agent (version 5.3.0) now includes support for AdoptOpenJDK. When you're ready to upgrade, be sure to see the Integration Agent documentation, where we've added instructions on how you can download the version of AdoptOpenJDK 8 that's suitable for your operating system.

Support notes (week of Feb 24-29)

xMatters Internal Reference No.	Summary
COR-23991 (SUP-21294)	Flow Designer - Activity panel: Corrected an issue that caused the Activity stream to timeout when attempting to display authenticated users.
COR-23987 (SUP-21276)	xMatters REST API - GET /audits: Fixed an issue that caused audit requests to timeout instead of promptly providing the requested data.
COR-23986 (SUP-21272)	xMatters REST API - GET /audits: Corrected an issue that resulted in an error instead of providing users with accurate historical data.
COR-23754 (SUP-21205)	Login page (usability fix): Fixed an issue where using a shared group URL displays an error to users and requires them to log in twice.
COR-23977 (SUP-21279)	iOS Mobile App: Corrected an issue that prevented the iOS Mobile app from recognizing a valid QR code.
COR-23735	All Events report - flood control messages: Fixed an issue where the All Events report did not display the specific message subject during an event flood.
COR-23563	xMatters REST API - integrations: Corrected an issue in POST /plans/{planId}/integrations that resulted in properly created integrations returning an error.
COR-23536	Subscriptions - sharing permissions: Corrected an issue where permission levels prevented users from accessing subscriptions that were properly shared with them.
COR-23919	iOS Mobile app - fingerprint log in: Fixed an issue that caused the xMatters mobile app to stop working when users attempted to log in using their fingerprints.
COR-23872 (SUP-21217)	Jira Cloud integration: Corrected an issue that caused search slowdown  for Jira Cloud integration searches.
COR-23906	Subscription forms - properties: Fixed an issue where users received an error if the subscription properties were created containing numbers.

February 17-21, 2020

Hogan's Alley Release Overview

The Hogan's Alley 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 Hogan's Alley Quarterly Release video:

The Hogan's Alley release is now live in non-production environments and we'll be toggling the features 'on' in production environments on Tuesday, March 3.

Support notes (week of Feb 17-21)

xMatters Internal Reference No.	Summary
COR-28372 (SUP-21217)	Jira Cloud integration: Improved search performance for the Jira Cloud integration.
COR-23779 (SUP-21238)	Flow Designer - Create xMatters Event step: Inserted missing input labels in the Create xMatters Event step Settings page.
COR-23612 (SUP-20888)	Shared dashboards - sound notifications: Corrected an issue where new events did not play a sound for any users.
COR-23736 (SUP-21208)	Notification Flood Control: Fixed an issue that allowed users to save settings without a valid device type selected.
COR-23679	Flow Designer - switch steps: Corrected an issue that prevented users from assigning a value to the switch step.
COR-23616	Flow Designer - Flows tab: Corrected an issue where users were unable to access their legacy outbound integrations in the Flows tab.
COR-23485	Temporary Absences (usability fix): Fixed an issue where some web browsers distorted part of the Add Temporary Absences window.
COR-23447 (SUP-21131)	xMatters REST API - scenarios: Fixed an issue where users received an incorrect response code after submitting a query for scenarios.
COR-22055 (SUP-21087)	Jira Cloud integration: Corrected an issue where large descriptions or environment names (within parameter limits) resulted in payload error messages.
COR-23544 (SUP-21051)	xMatters REST API - shifts: Fixed an issue where users received an incorrect response code after submitting an empty or null "position" parameter.
COR-23543 (SUP-21046)	Slack integration - help command: Corrected an issue where the wrong information could be displayed when requesting xMatters help in Slack.
COR-23376 (SUP-21101)	xMatters REST API - shifts: Fixed an issue that prevented users from renaming a shift and creating a new shift with the previously used name.

February 10-14, 2020

Longer group descriptions

Availability: Now in xMatters

We've upped the length of the group description field from 200 to 1024 characters. This gives you more room to add descriptive keywords for your groups, like the service name or key responsibilities: 

Having more keywords makes it easier to find the right resources when you're searching for recipients on message forms, using the xMatters REST API, or with our integration chatbots in products like MS Teams and Slack.

Support notes (week of Feb 10-14)

xMatters Internal Reference No.	Summary
COR-23545 (SUP-21193)	All Events report: Updated the process to retrieve events to allow a greater number of events to be retrieved and exported at a time.
COR-23484 (SUP-21135)	Workflows - activity updates: Updated the logic when processing activity updates for a form to ensure users who are also recipients receive both notifications.
COR-23179 (SUP-21060)	User upload (usability enhancement): Updated the user upload to handle adding multiple custom attributes for a user.
COR-23101 (SUP-21210)	Historical On Call report (usability enhancement): Updated the processing to improve handling of large data sets.
COR-22911	Flow Designer (usability enhancement): Updated the Create Event step configuration dialog box to be consistent with other steps.
COR-22593	xMatters REST API - GET /people (usability enhancement): Improved the error message displayed when an incomplete query parameter is included in the request.
COR-23510	Integration Builder (usability enhancement): Fixed the position of the confirmation dialog box that appears when deleting an inbound or outbound integration.

February 3-7, 2020

Flow Designer: Zendesk trigger & workflow

Availability: Now in xMatters

We've added a built-in Zendesk trigger to Flow Designer. Available from a new App Triggers section on the Triggers tab of the palette, you can drag this trigger onto the canvas and use it to initiate flows when Flow Designer receives requests from Zendesk:

Go with the workflow!

This trigger is also used in our new packaged 'Zendesk Alerts' workflow, which includes flows with pre-configured steps to update and add comments to Zendesk tickets with information from the xMatters event. Our workflow instructions also include information on automatically determining notification recipients based on their user or group assignment in Zendesk. If you're using Zendesk in your incident management processes, you'll want to check out this new workflow!

xMatters REST API: GET /roles

Availability: Now in the xMatters REST API

Roles control how users can interact with xMatters, including which features they can access, whether they can send notifications, manage other users, create workflows, configure xMatters, and more. You can now use the xMatters REST API to look up the roles which are visible to you in xMatters. You can request a list of all roles, or narrow the results by searching for a role name:

• GET /roles - returns a list of all roles that are visible to the authenticating user.
• GET /roles?name={term} - returns a role with a name that is an exact match to the term provided.
  • To search based on a partial match, you can use the allowWildcards query parameter (for examples, see the documentation)

xMatters REST API: GET /people by supervisor

Availability: Now in the xMatters REST API

Need to look up all the users that a specific person supervises? You can now do this programmatically using the xMatters REST API. We've added a new supervisors query parameter to GET /people that you can use to return users that one or more people supervise. For example:

• GET /people?supervisors=mmcbride - returns all users Mary McBride supervises.
• GET /people?supervisors=mmcbride,asamara - returns all users who have either Mary McBride OR Ali Samara as their supervisor.

Support notes (week of Feb 3-7)

xMatters Internal Reference No.	Summary
COR-23359	Reports - Recent Events (usability enhancement): Updated the web user interface for the Log to make sure the search box isn't cut off by other elements.
COR-23357 (SUP-21115)	Groups: Fixed an issue that resulted in some users getting an error when trying to view a group they had permission to see.
COR-22680 (and others)	Flow Designer (usability enhancements): Fixed a few minor issues to make working with flows in Internet Explorer 11 easier, and updated how the expand / collapse of the palette works to be consistent with other areas of Flow Designer.
COR-23403 (SUP-21034)	Conference Bridge: Fixed an issue causing requests to extend a conference call to not complete under a certain circumstances.
COR-23406 (SUP-21124)	iOS mobile app - user search: Updated the search logic to fix an issue where searching for users wouldn't return any results.
COR-23205 (SUP-21069)	Flow Designer - xMatters Agent: Updated the processing of steps set to run on an xMatters Agent to add a message to the Activity log if no agents are found for the step.
COR-23368 (SUP-21121)	Android mobile app - send message: Fixed an issue that resulted in errors when attempting to send a message for a form that included certain property types.
COR-22643 (and others)	Web user interface (usability enhancements and cosmetic fixes): Updated various components of the web user interface to address some layout and alignment issues, as well as improve usability.
COR-23455 (SUP-21136)	Android mobile app - send message: Fixed an issue that resulted in errors when trying to send a send a message from the app.
COR-23220 (SUP-21078)	iOS mobile app: Fixed an issue where images with certain characters in their names did not display in the app.
COR-23214 (SUP-21081)	User profile: Fixed an issue that was causing errors to appear when trying to view a user's supervisors.
COR-23367	Flow Designer: Improved the step validation process to better account for merged flows.
COR-23085	Workflows - message layout: Fixed an issue where the alert context variable wasn't resolved when used in the message subject.
COR-23232	Subscriptions (usability enhancement): Added a validation message to inform users if they have no devices selected.
COR-21973	Trials: Updated the trial sign-up to address an issue causing some users to see errors when logging into their new trial instance.
COR-22302	Flow Designer - Activity panel: Improved the display order of steps in the Activity panel.

January 27-31, 2020

xMatters REST API: GET /people updates

Availability: Now in the xMatters REST API

We've just equipped the GET /people endpoint with the following new query parameters that you can use to find users who meet particular criteria:

• status - users that are inactive or active. For example, GET /people?status=ACTIVE
• supervisors.exists - users that have a supervisor, or those that don't. For example, GET /people?supervisors.exists=TRUE
• devices.exists - users that have devices in their profile, or not. For example: GET /people?devices.exists=TRUE
• devices.testStatus - users with devices in a particular test status, such as those with untested devices. For example: GET /people?devices.testStatus={UNTESTED}

xMatters REST API: New GET /audits records

Availability: Now in the xMatters REST API

The GET /audits endpoint allows you to access audit records for actions that occur in your system, such as how recipients responded to an event and the comments they made. We've been building out this endpoint over time, and you can now use it to retrieve the following auditType records for your events:

• EVENT_CREATED - when an event was created
• EVENT_SUSPENDED - when an event was suspended
• EVENT_RESUMED - when an event was resumed
• EVENT_COMPLETED - when an event was completed
• EVENT_TERMINATED - when an event was terminated

Support notes (week of Jan 27-31)

xMatters Internal Reference No.	Summary
COR-21829	Subscriptions - notification delay: Fixed an issue where the option to set a notification delay was still displayed when creating a subscription, even if it was hidden on the subscription form.
COR-23115	Flow Designer - Activity stream (cosmetic fix): Corrected an issue where flow trigger icons were missing from the activity stream.
COR-23116	Flow Designer - custom steps: Fixed an issue that could prevent users from accessing the usage permissions for some custom steps.
COR-23166	xMatters REST API - POST /subscriptions: Corrected an issue that prevented xMatters from saving subscriptions with a large number of subscribers.
COR-32328 (SUP-21113)	Messaging - scheduled messages: Fixed an issue that was preventing the delivery of some scheduled messages.

January 20-24, 2020

xMatters REST API: Get all temporary absences

Availability: Now in the xMatters REST API

You can now use GET /temporary-absences to return the scheduled absences for all users you have access to in xMatters (instead of just a single user). We've also added two new search parameters that you can use to narrow down your results:

• absenceType - search for absences that have a replacement user, or for those that don't.
• groups - search for temporary absences for a particular group, or groups.

xMatters: An enhanced navigation experience

Availability: Early Access Program

In case you missed our recent announcement, as part of the upcoming Hogan's Alley Quarterly Release we're introducing an enhanced navigation experience:

The main benefit of the new navigation design, with its collapsible side menu, is that it frees up a lot of extra screen real estate for you to work with your data in xMatters. With all the new data columns we're adding to the All Events report, we think you're really going to appreciate the extra elbow room!

For the full details, see our announcement of the enhanced navigation experience. Or better yet, if you're enrolled in our Early Access Program, you can experience it first-hand in your non-production environment right now!

Messaging: New recipient selector

Availability: Early Access Program

Another feature from the Hogan's Alley Quarterly Release that's now available in the Early Access Program is a new and improved recipient selector for message and subscription forms. Our new design makes it waaay easier to search for and select multiple recipients at the same time:

Lions, and tigers, and devices - oh my!

Just like our previous recipient selector, you can filter by the type of recipient you want to search for, including All, Users, Groups, and Dynamic Teams:

You'll notice that when you select 'Users' from the available recipients drop-down, you now have a separate option to search for Devices:

Separating users and devices prevents you from unintentionally selecting a user's device - like their home phone - as a recipient, instead of their username (which is what you'd want to do the majority of the time so that xMatters contacts them according to their configured device settings and timeframes).

Improved response counts

As part of our work on the recipient selector, we also improved the usability of specifying response counts. In case you're not aware, you can use response counts to specify the number of recipients that must respond to a message before xMatters stops attempting to notify a group.

With a little rearranging, more descriptive labels, and helpful tooltips, we think you'll now find this feature more straightforward and intuitive to use:

Help Resources: Getting started guide for new users

Are you new to xMatters? Do you wish someone could give you a quick run-through of how to get started so that you're ready to receive and respond to notifications?

Well, you're in luck! We've just released a no-nonsense, easy-to-follow getting started guide for new xMatters users. It'll walk you through the basics of logging into the web application and mobile app, lead you through setting up your devices and checking your on-call schedule, and show you what to expect when getting a notification.

It also includes additional recommendations for more in-depth documentation and resources that are available to help launch you from a newbie to an 'xPert' in no time!

Support notes (week of Jan 20-24)

xMatters Internal Reference No.	Summary
COR-23113 (SUP-21059)	Flow Designer - Webhook step: Fixed an issue that resulted in the step not using the optional endpoint suffix provided in the step configuration.
COR-22975 (SUP-21037)	xMatters REST API - GET /audits: Updated the processing of the GET /audits endpoint to address an issue with requests timing out.
COR-22945 (SUP-21039)	Historical On Call report: Fixed an issue causing an error when trying to export the report.
COR-22918 (SUP-20997)	Events - message subject: Updated the code to properly display URL-encoded special characters in the message subject.
COR-22769 (SUP-20998)	Flow Designer: Fixed an issue where using the browser's back button when in a canvas then clicking a empty flow would cause the steps from the first flow to display.
COR-22760 (SUP-20976)	Workflows - editor permissions: Updated the code for retrieving editor permissions to address a discrepancy between the permissions set and those displayed in the dialog.
COR-22609 COR-22608 COR-22554	Web user interface (cosmetic fixes): Made a number of minor updates to the web user interface to improve usability and readability of text.
COR-22597	xMatters REST API - POST /devices: Improved the handling of the request when it provides a UUID for the new device but that UUID is not valid.
COR-22551	xMatters REST API - plans: Updated the /plans/{planId}/endpoints endpoint to use the same permissions as the root /plans endpoint.
COR-22809 COR-22227 COR-22119	iOS mobile app (cosmetic and usability enhancements): Made a number of minor changes to the mobile app interface to improve usability and consistency.
COR-22056 (SUP-20791)	Integrations - Remedy: Updated the deduplication settings to fix an issue where unsuccessful requests to create events were not being re-sent.

January 13-17, 2020

Hogan's Alley 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, February 18
• Production environment access: Tuesday, March 3 (enabled between 10:00-10:30 am Pacific)

Keep an eye out for the complete Hogan's Alley feature overview, coming on Tuesday, February 18!

Reporting: Historical on-call report

Availability: Now in xMatters

The Historical On Call report announced in the Galaga Release is now available! Located on the Groups tab, the report makes it easy for supervisors to download information for on-call users in their organization and use it for compensation and planning purposes.

Use the 'From' and 'To' fields to export up to 100 days of historical data to a spreadsheet (.xls) file. The date selectors allow you to go as far back as data availability and your pricing plan allow (we started populating the report with data on January 1, 2020).

Helpful resources:

• Interpret the Historical On Call report - An overview of the data included in the report and how to interpret it.
• Making the most of your Historical On Call report data - How to use pivot tables to analyze and extract the on-call data that's most important to you.

Mobile: Android 2.22

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 all of these new goodies:

• See in the dark - The app now supports Night mode when it's enabled on your device.
• Give your thumbs a break - You don't have to type .xmatters.com when you log into the app.
• More accurate group search - The app now returns groups that match all of your search criteria. 
• Android 10 Support - Get this version of the app to keep things running smoothly on Android’s latest OS.

Reporting: Export All Events report

Availability: Now in xMatters

The All Events report now includes an Export option that you can use to export either 'All Columns', or just the 'Current Columns' you've selected to include in the on-screen report:

Export like a pro

To save yourself extra time formatting the exported spreadsheet, you can first filter, sort, and arrange the report in the web user interface. Then, when you're ready to export, xMatters preserves your formatting in the exported file!

If you selected the option to export all columns in the report, xMatters exports the current results as you've arranged them in the web user interface, and then appends any additional columns in alphabetical heading order to the right of the last column of current results.

You'll notice two tabs on the exported file:

• Export Details - a summary of the report, including the date range, initiator of the export, and search filters applied to the report.
• Events - the list of events for the specified timeframe.

Integrations: xMatters Actionable Alerts for Splunk updates

Availability: Now from splunkbase

A new version of xMatters Actionable Alerts for Splunk is now available for Cloud and Enterprise Splunk customers. If you're updating to the latest and greatest version of Splunk (v7.2-8.0), then you'll want this update because it's compatible with Python 3.

Support notes (week of Jan 13-17)

xMatters Internal Reference No.	Summary
COR-22690 COR-22749	Workflows tab - xMatters Agents (cosmetic fix): Updated the styling and layout of the xMatters Agents page in the web user interface.
COR-222595	Flow Designer canvas (usability fix): Fixed an issue where creating a webhook integration did not properly display the mini-map in the Flow Designer canvas.
COR-22752 (SUP-20989)	Communication Center - Recent Events widget: Corrected an issue where special character encoding in email subject lines was not being converted to proper punctuation on the dashboard.
COR-22426 (SUP-20603)	xMatters Agent: Corrected an issue where the xMatters Agent would sporadically process the same job twice.
COR-22638 (SUP-21005)	Admin tab: Fixed an issue where attempting to access the Admin tab would cause an error.
COR-22406	Workflows - scenarios: Corrected an issue that allowed scenarios to be saved without a required name.
COR-22396	Communication Center - saving dashboards: Fixed an issue that prevented users from saving changes to the dashboard name and description.
COR-22653 (SUP-20961)	All Events report: Fixed an issue that was causing the All Events report to display different results than the Recent Events report.
COR-20349	Android mobile app (cosmetic fix): Corrected an issue that caused the hamburger menu icons to distort when viewed on Google Pixel 2 and 3 devices.
COR-22165 COR-22164	iOS mobile app - My Schedule (usability fix): Fixed an issue that displayed a blank schedule screen when reloading data.

January 6-10, 2020

Messaging: 'Alert Context' property

Availability: Now in xMatters

As a message recipient, it's often useful to have more context about why you're receiving a notification. By knowing if you were targeted directly, because of your membership in a group, or from one of your subscriptions, you'll have better insight into your role and responsibilities in the incident resolution process.

To help with this, we've added a new "Alert Context" property to our message editors that you can include in your messages to show recipients how they were notified for an event:

Can I get more context, please?

When the message is sent, xMatters replaces the Alert Context property with the path used to notify you, as shown in the the examples below:

• Directly targeted: "Direct Notification"
• As part of a group: "DBAs > P.M. Shift"
• As part of sub-group: "Campus D > Default > DBAs > P.M. Shift" etc.
• Subscription notifications: "Product Recalls Subscription"
• Group subscription notifications: "Product Recalls Subscription > DBAs > P.M. Shift"

As shown below, even though Mary McBride is a member of several different groups in her organization (like IT, First Responders, and Party Planning) she knows she's been invited to the conference bridge for her IT expertise in developing mobile apps - not to help with this year's Holiday party:

All Events report: 'Source' column

Availability: Now in xMatters

Need more context about your past events? The All Events report now includes a Source column that displays the name of the built-in or custom workflow used to create the event:

xMatters REST API: Get people by role

Availability: Now in the xMatters REST API

Ever wished you could programmatically look up the users in your system with a particular role (or set of roles) in xMatters? Like the Incident Managers? Or users that are Incident Managers and also have the Developer role?

Well, the great news is that you can now use GET /people to do just that! When you query this endpoint, specify which role or roles you're interested in by their name or ID. For example:

• GET /people?roles={Incident Manager}
• GET /people?roles={Incident Manager,Developer}

xMatters REST API: Details for read-only access forms

Availability: Now in the xMatters REST API

Like we implemented last week for plans (AKA workflows), now when you use the xMatters REST API to request information about a form that you don't have access to, instead of getting a 403 Forbidden error you'll receive basic details about the form including its UUID, name, description, as well as the ID and name of the plan (AKA workflow) it belongs to.

 

Support notes (week of Jan 6-10)

xMatters Internal Reference No.	Summary
COR-22424 (SUP-20932)	Trials/Free - expiry warnings: Fixed an issue where Free customers were receiving incorrect email warnings about their instance expiring, and some Trial users were seeing a banner at the top of the page indicating that their trial had expired.
COR-20193	xMatters REST API - GET /people: Fixed an issue where attempting to embed devices when using the GET /people endpoint to retrieve a large number of records would result in a 504 error.
COR-22100	xMatters iOS app - Reports tab: Updated the app to prevent the Reports tab from being incorrectly relabeled when navigating in the interface.
COR-22125	xMatters iOS app - My Devices: Fixed an issue where navigating to a device timeline while the My Devices screen was still loading would cause the app to show a "No Devices" message.
COR-22169	xMatters iOS app - Tracking Report: Updated the behavior when terminating an event on the Tracking Report to immediately update the progress bar to show the termination.
COR-22556	Groups - unscheduled shifts: Fixed an issue where attempting to edit a recently unscheduled shift would cause an error.
COR-22103	Communication Center (cosmetic fix): Updated the layout and appearance for some of the items and widgets displayed in Communication Center dashboards.
COR-22284 (SUP-20788)	xMatters REST API - POST /subscriptions: Updated the POST /subscriptions endpoint to prevent users from inadvertently creating subscriptions with empty property values.
COR-21477	Flow Designer - email initiation: Fixed an issue where some users were encountering a 404 error when attempting to initiate an email trigger.

December 30, 2019 - January 3, 2020

xMatters REST API: Get targeted recipients

Availability: Now in the xMatters REST API

If you're using the GET /events endpoint to return a list of events, you now have the option to embed targeted recipients. For example: GET /events?embed=targetedRecipients

To retrieve events that targeted a specific user, you can explicitly search for just the events targeting that user by identifying them by target name or UUID. For example:

• GET /events?targetedRecipients=mmcbride
• GET /events?targetedRecipients=c56730a9-1435-4ae2-8c7e-b2539e635ac6

xMatters REST API: Embed text property translations

Availability: Now in the xMatters REST API

Do you have text properties configured in more than one language? If you're interested in looking up the values assigned to text properties for different languages as you're working with scenarios, you now have the option to embed translations:

• GET /scenarios/{scenarioId}?embed=properties,plan,form,properties.translations
• GET /plans/{planId}/forms/{formId}/scenarios?embed=properties.translations

When you include these optional embeds in your request to GET /scenarios or GET /plans/{planId}/forms/{formId}/scenarios, the xMatters REST API returns the translated text for each property with a two-letter code for the corresponding language:

    "myTextProperty": {
           "propertyType": "TEXT",
           "value": "This is urgent. Please respond.",
           "translations": {
               "en": "This is urgent. Please respond.",
               "fr": "C'est urgent. S'il vous plaît, répondez."
            }
    },

xMatters REST API: Details for read-only access plans

Availability: Now in the xMatters REST API

Even if you don't have edit permissions to all the plans (AKA workflows) in your xMatters instance, it's still useful to know that they exist and to be able to see basic information about them. Now when you use GET /plans or GET /plans/{planId} for plans that you don't have edit permissions for, instead of getting a 403 Forbidden error you'll instead receive details about each plan including its UUID, name, description, and whether it's enabled.

Support notes (week of Dec 30-Jan 3)

xMatters Internal Reference No.	Summary
COR-22054	Users - profile: Updated what's displayed the web user interface when a user without permission to see user profiles clicks on a user in the UI.
COR-22252	xMatters REST API: Updated a subset of endpoints that were not using the complete targetName when referencing a device.
COR-22071	Messaging - preview: Fixed an issue where certain characters in a message subject prevented the subject from displaying in the preview.
COR-21977 (SUP-20727)	EPIC upload - custom properties: Fixed an issue where the EPIC upload process was not properly handling updates to users custom field and custom attribute properties.
COR-22331 (SUP-20909)	Workflows - integrated properties: Fixed an issue where some integrated properties were not appearing in event reports.
COR-22141 (SUP-20886)	Groups - shifts: Fixed an issue where the proper time zone was not applied when changing a one-time shift into a recurring shift.
COR-22245	Groups - shifts (cosmetic fix): Improved the styles on the web user interface to prevent the shift name field from overlapping the description.
COR-22151	Groups - shifts: Updated the message displayed when trying to create a shift with the same name as an existing one.
COR-22174 (SUP-20861)	xMatters Android app: Updated the app to fix an issue where some umlaut (ö) characters were not being presented correctly.
COR-21963	Free/Trial - Invite Users (usability enhancement): Updated the phone number validation to allow users to continue after only changing the country code.
COR-22102	Users - devices (cosmetic fix): Updated the Devices screen to prevent a specific tooltip from staying open when you move the mouse away.
COR-22250 (SUP-20904)	xMatters Free: Fixed an issue that caused users to see an error after logging in.
COR-22247	All Events report: Updated the response highlights section to display the 'time to first response' information correctly.

December 23-27, 2019

xMatters REST API: Updated Python code samples

Availability: Now in the xMatters REST API

We're pleased to announce that we've just finished updating all the Python code samples in our xMatters REST API docs to be compliant with Python 3.6! Just in time, too, because they'll be sunsetting Python 2 on January 1, 2020.

Support notes (week of Dec 23-27)

xMatters Internal Reference No.	Summary
COR-22207 (SUP-20908)	User Upload: Corrected an issue where an intentionally blank field caused the uploaded file to fail.
COR-21874	Temporary Absences (usability fix): Fixed an issue where clearing the "All Groups" check box did not remove the check marks from the listed groups.

December 16-20, 2019

Flow Designer: Merge flow paths

Availability: Now in xMatters

It's now possible to connect multiple paths of a flow to the input port of a single step. This is useful when different segments of your flow follow the same series of steps. By merging them into a common path, you reduce duplicated configuration and simplify the layout of your canvas:

In the example above, the flow uses a switch step to split the flow based on a customer_impacting event property. A value of "Yes" creates a Statuspage incident and then posts to a NOC dashboard, while any other value just posts straight to the dashboard. Joining both flow paths directly to the same 'Post to NOC' step removes a duplicate step from the canvas and saves configuration time!

Workflows: Send Alerts

Availability: Now in xMatters

A new Send Alerts workflow is now available from our collection of Workflow Templates. We've designed this pre-built workflow template to help you start notifying users and groups with minimal setup. It lets you create an event and send notifications by simply sending an email or HTTP request to xMatters.

You can use this workflow to quickly send test messages, learn how workflows work, and as a starting point for creating your own workflows. To get up to speed quickly, see our Send Alerts workflow guide.

Mobile: iOS 3.31

We've just released a new version of the xMatters iOS app, which includes a TON of great new updates! Here's an overview:

• Duplicate events - When you manage events from the app, you can now copy an existing event, modify some of its properties, and resend it as a new event.
• Reply to push messages - Long press or pull down on a push message from your lock screen or the notification center to reply or to join a conference bridge.
• Edit shifts when you’re on the go - Tap on a shift in My Schedule to change that shift occurrence’s duration or its members.
• On-call schedule at-a-glance - A fresh new look for the on-call widget makes it even easier to tell when you’re next on call for a shift.
• Star or Send with ease - We’ve improved the placement of the Star and Send controls so fingers of all sizes can reliably select one without tapping the other.

Support notes (week of Dec 16-20)

xMatters Internal Reference No.	Summary
COR-21778	Workflows (usability fix): Fixed an issue where attempting to delete a workflow or flood control rule in Internet Explorer 11 would cause the page to stop responding.
COR-21836	Flow Designer - custom steps: Fixed an issue where new custom steps would be incorrectly flagged as in use on a canvas.
COR-18532 (SUP-20066)	Web user interface (usability fix): Updated the web user interface to improve messaging, response times, and prompts when a back-end change requires the user to refresh the page.
COR-21838 (SUP-20285)	Admin tab - Company Details: Fixed an issue where the Admin tab would show two Company Details menu options for some permission and role combinations.
COR-21033	Flow Designer - HTTP Triggers (usability fix): Fixed an issue where the hover-over tooltip for HTTP triggers in the Flow Designer palette would sometime appear in a way that caused them to be truncated by the edge of the screen.
COR-21850 COR-21777	xMatters REST API - /groups: Updated the xMatters REST API to prevent groups from being accidentally created without any supervisors, and to prevent false naming collisions when creating groups with similar but non-identical names.
COR-19384	xMatters iOS app (usability fix): Improved the layout and spacing of the Send and Favorite (Star) buttons to prevent inadvertent tapping of the wrong one.
COR-21362	xMatters iOS app - sending messages: Fixed an issue where the app would prompt to confirm changes to a messaging form before sending when no changes had been made.
COR-21571	xMatters iOS app - terminating events: Fixed an issue where the app would display the option to suspend or terminate already terminated events.
COR-21555	xMatters iOS app (usability fix): Fixed an issue where users were not being directed to the correct event when tapping on a push message.
COR-21831 (SUP-20847)	User Upload - updating users: Updated user target names to be case-insensitive.
COR-21827	All Event - Response Statistics (cosmetic fix): Updated the layout of the Response Statistics section on the All Events report so that long response options won't overlap the next item in the list.
COR-21931 (SUP-20837)	Flow Designer (performance enhancement): Improved the responsiveness and performance of Flow Designer when a workflow contains a very large number of forms.
COR-21794 (SUP-20834)	User profiles - Roles tab: Updated the styling for the Roles tab to address a minor cosmetic issue when adding or editing roles for a user.
COR-20971	Flow Designer - custom steps: Fixed an issue where the Endpoints section would still appear on the Script tab of a custom step even when an endpoint was not defined for that step.
COR-21768	Workflows - importing: Fixed an issue where importing an exported workflow that included a "Send a webhook" outbound integration would cause an error.
COR-21764 (SUP-20836)	Messaging tab: Fixed an issue where the Messaging tab would not display any content.
COR-21699 (SUP-20822)	Flow Designer - email initiation: Fixed an issue where the canvas would not load in Flow Designer if the workflow included email form initiation.
COR-21849 (SUP-20840)	xMatters mobile apps: Fixed an issue that was preventing the xMatters mobile apps from retrieving and displaying data from some instances.
COR-20582	xMatters REST API - POST /groups: Updated the POST /groups endpoint to automatically delete any holiday shifts from a group if the site associated with the group is removed. (This mimics the behavior in the web user interface.)

December 9-13, 2019

All Events report: New columns

Availability: Now in xMatters

We've just added two new columns to the All Events report. You can use Targeted Recipients and Form to get more context about the users, devices, groups, or dynamic teams targeted to receive notifications for each of your events, and the form that was used to initiate them:

We've also included these new columns in the handy Columns selector that lets you choose which data to display in the report:

Help Resources: Be the best group supervisor ever!

Have you just been assigned the Group Supervisor role in xMatters? Are you wondering what that means and what kinds of things you'll be able to do?

Well, we've got great news: we just released an awesome new resource to help you out! Our guide on How to be the best group supervisor ever gives you the run-down on the Group Supervisor role’s capabilities, as well as links to handy resources that will help introduce you to working with groups, shifts, escalations, rosters, and everything else you need to know.

It also includes some first-hand tips and tricks contributed from our advisors and consultants in the field that you won't find anywhere else - so be sure to check it out!

Support notes (week of Dec 9-13)

xMatters Internal Reference No.	Summary
COR-21311 COR-21312	Flow Designer canvas - switch step: Implemented usability fixes that make moving switch steps on the canvas easier, and that place the cursor in the proper position when editing text fields.
COR-21365	Users - Schedule (usability fix): Corrected an issue where the "Filter by" drop down menu is still visible after navigating away from a user's schedule.
COR-21729	Shifts - copying a shift: Fixed an issue where focus did not switch to the copied shift as expected.
COR-20965	xMatters Online Documentation: Corrected the documentation so all links point to appropriate help pages.

December 2-6, 2019

Flow Designer: Palette styling improvements

Availability: Now in xMatters

You'll notice that we've made some styling updates to the Flow Designer palette to tighten things up and make it easier on the eyes. The changes are subtle, but we think you'll enjoy working with this more refined version:

Support notes (week of Dec 2-6)

xMatters Internal Reference No.	Summary
COR-21231 COR-21263	User Upload - error messages  (usability fix): Improved some of the error messages displayed in the User Upload report to be more helpful when a column header is missing, or when all rows in a file are invalid.
COR-21478 (SUP-20690)	xMatters REST API - GET /groups/{groupId}/shifts:  Corrected an issue that prevented users from editing a shift when multiple shifts have the same name.
COR-21193	All Events report (usability fix): Corrected an issue that displayed incorrect search result counts.
COR-21190 (SUP-20693)	Integrations - Activity Stream logging: Corrected an issue where the Activity Stream was not properly logging outbound integrations.
COR-21502 (SUP-20788)	xMatters REST API - POST /subscriptions: Corrected an issue where empty values prevented the subscription from operating properly.
COR-20743	xMatters Agent - permissions: Fixed an issue so users without the proper permissions could no longer make changes to the list of Status Alert Recipients. The changes these users made prior to the fix were not saved.
COR-21274 (SUP-20723)	Groups - incorrect shift members displayed: Fixed an issue where a past shift incorrectly shows the current shift's members.
COR-21356 (SUP-20766)	Web user interface (usability fix): Corrected an issue where users saw a blank screen when xMatters was upgrading the web user interface.
COR-21425	Reporting - access and permissions: Fixed an issue where users with appropriate permissions were prevented from viewing events in the Recent Events report.
COR-21525 (SUP-20825)	Groups - shifts: Fixed an issue where the proper timezone is not applied when changing a one-time shift into a recurring shift.
COR-21333 (SUP-20774)	Workflows - deleting a workflow: Corrected an issue where a subscription form was still available after the workflow was deleted.
COR-21305 (SUP-20676)	xMatters REST API (usability fix): Fixed an issue that caused requests to timeout.

November 25-29, 2019

xMatters REST API: Get user delivery data

Availability: Now in the xMatters REST API

We've added a new endpoint to the xMatters REST API that lets you look up information about who was notified for an event. Some of our customers like to use this data to create reports in other systems such as Splunk or Tableau. Here's the new endpoint:

• GET /events/{eventID}/user-deliveries?at={timestamp} - returns detailed information on who was notified for a specific event, the notification delivery status, the date and time of the notification, and which devices were contacted.

Since this endpoint queries historical data, you'll need to include the at parameter in your request. You can also optionally embed the person.properties query parameter to include the values of the custom fields and attributes assigned to each person (for example: GET /events/{eventID}/user-deliveries?at={timestamp}?embed=person.properties). 

All Events report: View events for the groups you supervise

Availability: Now in On-Demand

We've added a new permission that allows you to view events for the groups you supervise. This makes it easier for Group Supervisors to stay informed and take action on any events targeting the groups that they supervise. For more information about this permission, and to add it to your company's Group Supervisor role, contact xMatters Support.

Support notes (week of Nov 25-29)

xMatters Internal Reference No.	Summary
COR-21024 (SUP-20714)	Subscriptions: Fixed an issue where subscription owners were automatically being added to subscriptions without any other recipients.
COR-21253 (SUP-20741)	Integration Builder: Fixed an issue where users with a specific form configuration found that events were not created and flows not executed when a request was sent to an integration associated with the form.
COR-21032	Workflows (usability fix): Updated the validation of workflow names to check for all disallowed characters.
COR-21075 (SUP-20668)	xMatters REST API - GET /groups: Updated embed=supervisors to correctly process the limit parameter (if included in the query).
COR-21205 (SUP-20751)	xMatters Agent - installation: Fixed an issue where the agent installation information was not being displayed if a user selected manual proxy configuration.
COR-21118 (SUP-20730)	Integration Builder: Fixed an issue where initiating a particular integration using the xMatters REST API would not result in any notifications.
COR-21011 (SUP-20679)	All Events report: Fixed an issue where the selected date range did not persist after logging out and logging back in, even though data displayed in the report used the correct range.
COR-21160 (SUP-20745)	Subscriptions - subscribers: Fixed an issue where an incomplete list of subscribers was returned when opening a subscription, and was then saved when the subscription was saved.
COR-21070 (SUP-20623)	Groups - shifts: Fixed an issue where editing a shift would change the shift's time zone to the group's time zone.

November 18-22, 2019

xMatters REST API: Get, create, and modify scenarios

Availability: Now in the xMatters REST API

Scenarios allow you to save multiple versions of a form with predefined values for common or anticipated situations, making it easier to send relevant messages quickly when those situations arise. You can now use the following xMatters REST API endpoints to look up information about scenarios, and to create and modify them:

• GET /scenarios/{scenarioId} - return a specific scenario, based on its unique identifier.
• GET /plans/{planId}/forms/{formId}/scenarios - return a list of scenarios for a form in a workflow.
• POST /forms/{formId}/scenarios - create or modify scenarios for a form.

Flow Designer: Update Jira status

Availability: Now in On-Demand

Flow Designer's built-in steps to update issues in Jira Cloud or Jira Server now include the option to change the status of the issue. This means that as an incident progresses, you can keep its status up-to-date in Jira (for example, you could change its status from "To Do" to "In Progress" to "Resolved").

Flow Designer: ServiceNow endpoint updates

Availability: Now in On-Demand

It's now easier to include ServiceNow in your incident management workflows! You're no longer required to have the xMatters app installed in your ServiceNow instance to connect your steps to the ServiceNow endpoint, which makes it a lot more convenient to get ServiceNow steps up-and-running in Flow Designer.

Support notes (week of Nov 18-22)

xMatters Internal Reference No.	Summary
COR-20898 (SUP-20677)	Messaging tab - creating messages: Corrected an issue that prevented messages from using their multi-select lists of properties.
COR-20922 (SUP-206520)	User uploads - voice devices: Corrected an issue where Slovakian phone numbers were not properly formatted.
COR-20905	Flow Designer - custom step images: Corrected the message when loading an icon that is too large to properly state the maximum image size is 250KB.
COR-20925 (SUP-20636)	SSO access: Corrected an issue where users saw only a blank screen after logging on using Single Sign-On.
COR-20744 (SUP-20626)	Messaging - text missing from subject line: Fixed an issue where text surrounded by angle brackets was removed from the subject line of the outgoing email.
COR-20882 (SUP-20675)	Groups - editing recurring shifts: Corrected an issue where the Edit Shift button would not work when the shift had a slash in its name.
COR-20831 (SUP-20654)	EPIC data sync processing: Corrected an issue where EPIC was blocked by the length of time taken to remove orphan events.
COR-20943 (SUP-20685)	xMatters REST API - POST /subscriptions: Corrected an issue where the timezone id prevents users from creating subscriptions.
COR-19850 (SUP-20429)	Flow Designer - logging: Fixed an issue where comments submitted with user responses were not displayed in the event log.

November 11-15, 2019

Mobile: Android 2.21

A new version of the xMatters Android app is now available! Head on over to the Google Play store to take advantage of the following updates:

My Schedule calendar view

There's a new calendar view for My Schedule that you can use to quickly and easily look up which days you're on call - just click the calendar icon at the top of the My Schedule screen:

The calendar displays a green dot on the days where you're scheduled to be on call, and you can tap on any day to see your on-call shifts. As you scroll your list of shifts, the monthly calendar view collapses to a weekly view to give more screen real-estate to your shift information:

You can use the calendar to view your on-call schedule for up to the next 90 days. A handy "Today" shortcut makes it easy to quickly return to today's on-call schedule. You can also use the shift filter to choose which on-call shifts to display - where you're primary on-call, primary or secondary on-call, or all of your shifts.

Available update notices

Take advantage of the latest app updates as soon as they're released! The xMatters Android app now lets you know when a new version of the app becomes available.

To get the latest and greatest updates, just tap to download and to relaunch the app. If it's not a convenient time, tap 'Remind me later' and we'll notify you again the next time you open the app.

Support notes (week of November 11-15)

xMatters Internal Reference No.	Summary
COR-20556	EPIC data synchronization - Synchronization report: Fixed an issue that could prevent the Synchronization report from loading properly for a company with an ampersand (&) in its name.
COR-20751	All Events report (usability fix): Updated the All Events report to properly display some special characters in the Message Subject column and on the Message tab.
COR-20844	Flow Designer - run locations: Fixed an issue that was preventing the Run Location tab from appearing on some custom steps.
COR-20553 (SUP-20604)	Groups - permissions: Fixed an issue that was preventing some Group Supervisors from being able to view and edit shift details for their groups.
COR-20830 (SUP-20668)	xMatters REST API - GET /group: Fixed an issue where the /groups endpoint would return an error when attempting to retrieve a list of groups with embedded supervisors.
COR-20806 (SUP-20653)	All Events report - responses: Fixed an issue that was preventing some responses from being displayed when viewing event details on the All Events report.
COR-20565 (SUP-20603)	xMatters Agent - duplicate events: Fixed an issue where the xMatters Agent would sometimes create multiple events if the connection was disrupted during initial processing.

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.