Administrators can define custom fields to store additional information on each user’s details page. Custom fields can be mandatory or optional, and can also be used when searching for a user in the system.
Custom field names cannot be identical to the names of xMatters objects such as device types and groups.
You can manage custom fields on the Custom Fields page in the xMatters web user interface.
View and manage custom fields
- From the Admin menu, under Company, click Custom Fields.
- If there is more than one company in the system, select the company in which you want to manage the custom fields, and then click Continue.
- xMatters displays a list of the custom fields for the company.
- In the Custom Fields list, do any of the following:
- To modify an existing item, click its name to view its details. For more information about editing items in the Custom Fields table, see Define custom field details.
- To remove an item from the list, select the check box next to the custom fields or dividers you want to remove, and then click Remove Selected.
- To create a new custom field, click the Add Field link, and specify the details for the new custom field. Click Save to create the custom field.
- To add a new divider between custom fields, click the Add Divider link. On the Add Divider page, specify the Divider Name, and then click Save to create the divider. You can use dividers to organize your custom fields on this page. However, they will not appear on a user's detail page.
- To reorder items in the list, click and drag the parallel bars icon (to the left of the item name) for the item you want to move to its new position. You can also use the Move to Top, Move Up, Move Down, and Move to Bottom buttons in the Order column. When you are satisfied with the position of the items in the list, click Save Order.
You can define custom fields on the Custom Fields Details page.
To define custom field details:
- On the Custom Fields page, in the Custom Fields list, click the name of the field you want to modify.
- On the Custom Fields Details page, enter the following information into the form:
When selected, indicates that each user must supply the information required by the field. Clear this check box if you want the custom field to be optional.
Name for the custom field, which is displayed on each user’s details page as the label for the field.
Type of custom field:
Note: You cannot change the Type of a custom field after creating it.
- To save the custom field details, click Save.
Password fields are intended only to obscure passwords from casual inspection. This means that they will:
- Be masked on user details pages.
- Remain encrypted while in transit to and from the integration agent.
- Not be logged in plaintext log files.
However, through configuration it is possible to:
- Send passwords out as plaintext.
- Manually log the contents of a password field.
xMatters users' passwords are stored in the xMatters database and encrypted using a one-way hash. By contrast, password custom field values must be stored using a symmetric cipher so xMatters can submit plaintext passwords to third-party systems and include plaintext passwords in notifications. As a result, a determined attacker could potentially retrieve password values from custom fields.