Health authorities may require your organization to capture a reason for a change when correcting fields on records associated with certain key processes. If configured by an Admin, Vault QMS may prompt you to provide a Reason for Change if you update one or more fields when an object record is in a particular lifecycle state. Additionally, Vault may prompt you to provide a clarifying comment when you select a particular reason.

For example, if an Internal Audit record is in the In Audit lifecycle state and a user needs to update the Starting Date field, Vault may prompt you to provide a reason for the change and comments before saving the record.

This article provides guidance on how to provide Reasons for Change if prompted, any limitations to using this feature, and related permissions.

Supported Objects

The Reason for Change feature supports the any standard or custom object.

Providing a Reason for Change

If you update one or more fields on an object record, Vault may prompt you to provide a Reason for Change upon saving the record. If at least one of the edited fields is configured to require a reason, Vault displays a dialog to capture a single reason to capture all relevant field changes.

To provide a reason:

  1. In the dialog, select a Reason for Change from the drop-down, for example, Input Error.
  2. Provide a Comment if the selected reason requires one. Otherwise, use the Comment field to optionally provide additional justification.
  3. Click Save.

Upon saving, Vault captures the reason for the change, the affected fields, the user who made the change, and when the change was made. If the Reason for Change History section is available on the object record’s details page, and you have the appropriate permissions, you can view the changes and reasons in this section. Reason for Change records are not editable.

You must have a security profile with the following permissions to work with Reasons for Change:

Type Permission Label Controls
Security Profile Object: Reason for Change Ability to view Reason for Change records.
Security Profile Object: [Supported Object]: Object Control Permissions: Reason for Change Ability to view the Reason for Change application control.