# Configuring the QMS Change Related Object Lifecycle State Job Entry Action (QMS)

The _QMS Change Related Object Lifecycle State Job_ entry action executes a no-limit asynchronous job to move child records forward when the parent record transitions to a specific state. The job is capable of handling large numbers of record changes.

## Supported Objects

The _QMS Change Related Object Lifecycle State Job_ entry action is supported for the following objects:

- _Audit Program_
- _Assessment_
- _Change Control_
- _Complaint_
- _Continuous Improvement_
- _Deviation_
- _Finding_
- _Lab Investigation_
- _Nonconformance_
- _Quality Event_

## How to Set Up the Action

The following section covers details that are specific to this entry action. For general information on configuring entry actions, see <a href="/en/gr/30683/">Configuring Object Lifecycles</a>.

To configure this entry action:

1. From **Admin > Configuration > Object Lifecycles**, open the lifecycle that applies to the parent object.
2. Click into the lifecycle state that you want all parent records to be in when you change the related record state.
3. Add the **QMS Change Related Object Lifecycle State Job** entry action.
4. Select the **Destination State on Error (Initiating Record)**. This is the state that Vault transitions the parent record into if there are any errors while moving child records to a new state.
5. Select a child object from the **Related Object** drop-down.
6. Select the destination state for child records from the **Change State To** drop-down.
7. Optional: Select **Conditions on related records** to execute the validation rule only on related records that meet your specified condition.
8. Optional: Add additional criteria by clicking **Add action**. If the rule is conditional, these criteria will share the same conditions.
9. Optional: In the _Action Completion Notification Recipients_ field, specify which roles should receive a notification when the action completes. You cannot select the _Owner_, _Editor_, or _Viewer_ roles or an inactive role from the drop-down.

Vault sends a notification when the _QMS Change Related Object Lifecycle State Job_ entry action completes. If the action encounters an error, users can click the links in the notification to download the job log file and a CSV containing the records that failed to transition to the destination lifecycle state.

<div class="note-border alert-info">
  <div class="alert alert-info" role="alert">
    <div><i class="far fa-info-circle"></i></div>
    <div class="alert-text">
      <p><strong>Note</strong>: Users must have the <em>Admin: Jobs: Read</em> permission to download the job log file.</p>
    </div>
  </div>
</div>



## Example Configuration

VeePharm configures the _QMS Change Related Object Lifecycle State Job_ entry action for the _Audit Program_ object. This entry action moves _Proposed Audits_ into a specific state when the parent _Audit Program_ transitions to the _In Approval_ state.

### Related Record Condition

VeePharm wants to modify the above configuration so that only _Proposed Audits_ in _Initiated_ state move forward. To configure this, an Admin can select the **Conditions on related records** checkbox, **Include related records in the following lifecycle states** from the _Conditions_ drop-down, and **Initiated** from the _Related Record's State_ drop-down.