Every person in the xMatters system is a "user" defined by a set of details, including ID number, user name, login password, and so on. Each user has a set of permissions that define the features to which he or she has access.
The Users page
The Users page displays a list of all the users in the system that you have permission to view. You can use the filters, search criteria, and other settings on the users page to refine the list. For example, you can locate a single user, find all the users that belong to a specific site, or see a list of just those users you supervise. You can also export the list of currently displayed users to a spreadsheet; for more information, see Export a list of user details.
Users with similar roles and permissions may see different results because the "All Users" option does not display all of the users that exist in your deployment. Instead, it displays all of those users assigned to roles that your role has permission to view, and all of the users you supervise (even if you would not normally be able to see those users based on their roles alone). For example, if two person supervisors supervise a different number of users, and those users include people with roles that would not normally be visible to a person supervisor, then each of the supervisors would see a different number of users when they select the "All Users" option.
- In the xMatters web user interface, click the Users tab.
- If this is the first time you've visited this page, xMatters displays a list of the users in the system that you supervise.
- To refine the list of users, do any of the following:
- Click the All Users button to show the list of all users in the system that you have permission to view, or click the Users I Supervise button to display only the users you supervise.
- Click one of the column headers to sort the list contents in alphabetical or numerical order based on that column's contents. (Click the header again to reverse the sorting order.)
- If the list contains more users than can be displayed on your screen, scroll down the page to view more users in the list. Note that the system will automatically load more users as you scroll; you do not need to navigate to another page.
- Click the Search icon to open the search bar and specify your search criteria. (For more information about using the Search bar on scroll-and-load forms, see Search for users and groups. You can also click the Advanced Search link to specify multiple criteria using the classic xMatters search utility as described in Search for users with the advanced search tool.)
- If you have the correct permissions, you can click the name of a user in the list to view their details .
- To delete a user, select the check box next to the user or users that you want to remove, and then click Delete Users.
- Note that the deleted user will also be removed from any groups to which they belong, and all of their devices will be deleted.
- To add a user, click the Add icon, and enter the details for the new user. (For more information, see Add a user.)
- If you are using a trial version of xMatters, click Invite Users. (For more information, see Invite users.)
You can add users through the web user interface. Before adding users to xMatters, you should be aware of any naming conventions or rules regarding user IDs and numbering systems used by your organization. Users must have unique names within xMatters. You cannot create a user with the same name as any other user, group, or dynamic team.
If you are using a trial version of xMatters, you can add users using the Invite users feature.
To add a new user:
- In the web user interface, click the Users tab.
- On the users page, click the Add icon in the top right corner of the users list.
- xMatters displays the Add a User page.
- Specify the following details for the new user:
and LDAP Server
Select this option to authenticate with an LDAP server instead of a user name and password. The value of the User ID field must match the user's LDAP identifier. Select a server from the LDAP Server drop-down list.
The LDAP Authentication option is displayed only if your administrator has configured LDAP on your deployment. Selecting LDAP authentication will remove the Password, Confirm Password, and Force Password Expiry fields from the Add a User page.
|First Name and Last Name||
The user's name. This value can be used to search for the user in the database, to check their schedule, or to look up the user or their device details. A user's name can later be changed without affecting notifications.
|User ID||A unique identifier that the user will use when logging into xMatters. This is a mandatory alphanumeric field of up to 25 characters. This value can only be changed by a supervisor or an administrator.|
Maximum 30 characters. The password rules defined for your organization will be displayed when you begin typing in the Password field. For more information about password rules, see Password rules. For more information setting the password policy, see Set the password policy.
Re-type the password in this field for confirmation.
|Force Password Reset||Selecting this option requires the user to create a new password after they have logged into xMatters. For more information about forcing a user's password to expire, see Control a user's access|
The user's primary location. The site setting determines company and site holidays, phone class lists, default language, and time zone. If the user is assigned to a site that is not active (or not enabled within xMatters), they will not be able to receive notifications, so verify the site is active before selecting a new site.
Click in the field to see a list of available roles for you organization. For more information about roles, see Default roles.
Customized fields for your xMatters deployment that can be used to sort, organize and locate users. The settings and information required in these custom fields are determined by your xMatters administrator, and are unique for each company.
- Click Add to create this user.
- If you'd like to create another user immediately after you've finished adding the current user, select the Create Another check box before you click Add.
If you have permission to supervise other users, you will automatically become the supervisor of any new user's you create. If you do not have permissions to supervise users, the users you create will have no supervisor.
Company supervisors can upload multiple users at one time by using the User Upload tool. For more information about using the User Upload tool, see Upload users. If you would like to automatically synchronize your xMatters users with an external system such as an LDAP system or your human resources directory, contact your Client Success Manager, who can help you configure the EPIC data synchronization process.
All users in the xMatters database count towards the license limit. This means that users not set as Active (i.e., on the sidebar of their user profile) are still counted for licensing purposes. For further details on xMatters licensing, contact xMatters Sales.
- On the Users page, click the name of a user to modify their details.
- You can only click the names of users for which you have the "View Person" permission.
- Set or edit the user's details as required.
- When you are finished making changes, click Save.
You can permanently remove users and their information from the system by deleting them. When you delete a user, they will be removed from any groups which they are a member, and their devices, details, and login information will also be removed. Any scheduled messages they own, and their temporary replacement assignments will also be deleted from xMatters.
To delete a user:
- In the web user interface, click the Users tab,
- Use the Search tools described in Search for users and groups to locate the user you want to delete.
- Select the check box beside the user’s name, and then click Delete.
You cannot delete a user if they have active notifications, if they are the only supervisor of a group, or if they own subscriptions. In these cases, to delete them you must first terminate or wait for their active notifications to end, assign another supervisor to any groups where they are the only supervisor, and delete or change the owner of their subscriptions.
You may also need to delete the user from an external database, if you synchronize user data from an external system with xMatters. This will prevent the user from being added back into xMatters during a data synchronization process.
You can also deactivate users in xMatters to prevent them from being able to log in or receive notifications. This enables you to quickly disable an account without deleting it. Inactive users count against licensing limitations. For more information about product licensing, contact xMatters sales.
To deactivate a user:
- Click the Users tab.
- Find the user that you want to deactivate, and click on their name.
- On the sidebar of the user's profile, click the toggle to make the user active or inactive.
Inactive users and their devices may appear grayed-out and struck through in the web user interface
You can use the Export Users feature to generate a comma-delimited list of all users in the system (or a specific sub-set of users) to analyze the data in an external tool, or to import the data into another xMatters deployment. This feature generates a CSV file in the format supported by the User Upload feature.
To export user details:
- In the xMatters web user interface, click the Users tab.
- xMatters displays the users list, which defaults to showing all of the users you supervise.
- Use the available filters, options, and search tools to refine the list to show the users you want to export.
- The selection check boxes for individual users do not affect the Export feature; they are used only to select users for deletion.
- To export the currently displayed list of users, click the Options icon, and then click Export.
- xMatters creates a file named User Export <date/time>.csv, where <date/time> is a timestamp of when the file was created.
The following table provides information about the fields included in the user export file. For more information on formatting this file to upload users, see Modify the upload template file.
Used in the upload process to indicate the following operations:
|User||User ID and web login ID|
|First Name||First name of the user|
|Last Name||Last name of the user|
|Site||Company site associated with the user|
This field indicates if users are owned by an external management system and synchronized into xMatters
Values include: TRUE or FALSE
|Password Status||Values include: Current, Unset, or Expired|
The enabled language for the associated company used to contact the user
|Time Zone||Time zone (e.g., US/Pacific)|
|User Supervisor||A list of user IDs of user supervisors for the user, delimited by the pipe ("|") character (e.g., bsmith | mmcbride)|
|Role||Roles assigned to the user, delimited by the pipe ("|") character (i.e., Company Supervisor | Developer | Full Access User)|
|Last Login||The last date and time the user logged into the xMatters user interface. For example: 2015-07-30 14:40:20 PDT.|
|UUID||The Universally Unique Identifier (UUID) of the user|
Device (e.g., Mobile Phone)
|Contact details for the listed device|
Device Status (e.g., Mobile Phone Status)
|Values include: Active or Inactive|
|Device Valid (e.g., Mobile Phone Valid)||Values include: Tested, Untested, or Pending|
Custom field types and values are assigned by administrators to help sort, organize, and locate users.
Examples of custom fields might include: Department (Value = Name), Building (Value= Building number), First Aid (Value = True or False)
To properly display names with special characters, such as accents and umlauts, in an external spreadsheet program, you may need to manually select UTF-8 encoding as the file origin when importing the CSV file.