The Assign to Learner action, available on Curriculum object records, allows you to directly assign Curricula to integrate into a Learner’s training matrix, respecting all training rules and automation. Training assigned via this method will be issued via the standard Vault Training automation job.
Enabling the Assign to Learner Action
To enable the Assign to Learner action, an Admin must first add it to the Curriculum object in Admin > Objects > Curriculum > Actions. Then they must add it to the Curriculum object lifecycle states where they want it to appear.
Additionally, to facilitate use of the action:
- Activate the Individual Learner Role object type on the Learner Role object.
- Activate the Person field on the Individual Learner Role object type.
- Create a new object page layout for Individual Learner Role that includes the Person (required) field.
- Add an event action on the Individual Assignment Request object lifecycle: Start Workflow > VT: Individual Assignment Request
- Add the Training Administrator role to the Individual Assignment Request object lifecycle and select the VT: Training Admins permission set for the role. This permission set should include the following permissions:
- Read, Create, Edit, and Delete for the Learner Role: Individual Learner Role object type.
- Read for the Individual Assignment Request object.
- Read for the Individual Assignment Request-Person object.
Individual Learner Roles
Vault uses a special Learner Role to seamlessly insert the Curriculum into a Learner’s training matrix. When you perform the Assign to Learner action, Vault creates a Learner Role record of the Individual Learner Role object type and assigns it to the Persons chosen in the action dialog. Vault then adds the Curriculum to that Individual Learner Role. Each Person can only have one Individual Learner Role, but each of these can include up to the standard limit of Curricula.
Curricula Assignment Approval
If you want to ensure that assignment of a Curriculum is approved by the appropriate parties, an Admin can configure a conditional entry action on the Individual Assignment Request Lifecycle to check the value of the Requires Approval field on the Curriculum record and, if necessary, start a review and approval workflow.
Direct assignments allow you to issue training assignments to learners as-needed, separately from the system-managed job process. This is useful for situations that require learners to train on documents that may not be part of their normal training matrix or when you need to manually assign re-training. You can also use a direct assignment action to assign Learners a Curriculum, which can contain multiple training requirements.
In contrast to Assign to Learner, creating direct assignments does not affect the automation process. Training assignments created with the direct assignment action are ad-hoc and are not tracked in training matrices. This means it is truly a one-off assignment. The Learner will not receive recurrence training or retraining based on document updates. If instead you want a Curriculum outside of a Learner Role to integrate into a Learner’s training matrix and respect training rules like prerequisites and substitutes, you should use the Curriculum to Learner feature.
Direct Assignment User Input houses data entered when you create a direct assignment. For example, due dates, learners, and the reason for the assignment. Modify the page layout of this object to add or remove fields in the dialog box. As this object is intended only to collect data, we recommend that any reporting, searching, or other related functions be performed against the Direct Assignment Request object.
Direct Assignment Request copies data from the Direct Assignment User Input object. When this object moves into the Issued state, Vault creates a training assignment and issues it to relevant learners. Note that Vault does not copy over custom fields added to the Direct Assignment User Input object. The Training Assignment record contains a reference to the Direct Assignment Request record, and the Direct Assignment Request record contains a reference to the Direct Assignment User Input object
- Configure the Direct Assignment user action for the Training Requirement object.
- Select the appropriate object type checkbox under Objects > Training Requirement > Object Types. Select Edit Object Type Fields in the action menu to make this checkbox available.
- Ensure appropriate users have Execute permission for the Direct Assignment user action.
- Configure Atomic Security on the Direct Assignment lifecycle for the Direct Assignment user action.
Creating Direct Assignments
To create a direct assignment for a single Training Requirement:
- Navigate to a Training Requirement in the Available lifecycle state.
- Select Direct Assignment from the Actions menu. This action will not appear unless all the documents in the Training Requirement are in a Steady State or Ready for Training lifecycle state.
- Enter required fields and click Continue. Note that you can select multiple Persons in the Learners field.
To create a direct assignment for a Curriculum:
- Navigate to a Curriculum in the Available lifecycle state.
- Select Direct Assignment from the Actions menu.
- Enter required fields. Note that you can select multiple Persons in the Learners field. Select a value for the Apply to Training Requirements in field to indicate whether Vault Training should create Direct Assignment Request records for Training Requirements in Available States Only or All States Except Retired.
- Click Continue.
When using the Direct Assignment action on a Curriculum, Vault will not issue Training Assignments for Training Requirements that contain documents not in a Steady State or Ready for Training lifecycle state.
Vault creates a Direct Assignment User Input record and a Direct Assignment Request object record. The Direct Assignment User Input record contains a list of comma separated Person ID values in the Learners (
learners__v) text field. This record collects data only, and we recommend users use the Direct Assignment Request object for reporting and searching.
The Direct Assignment Request record contains:
- The Requested By field that is set to the person’s name who executed the user action.
- Other field values (Learner, Due Date, Reason, and Training Requirement). Vault copies these values from the Direct Assignment User Input record.
Vault immediately moves Direct Assignment Request records into the Issued state, which creates and issues a training assignment with the following properties:
- The Training Assignment record has a reference to the Direct Assignment Request record.
- The field Created Via Direct Assignment is set to
Yeson the Training Assignment record.
If Vault encounters problems when creating Direct Assignment Request or Training Assignment records, an email is sent to the user who initiated with the Direct Assignment action.
Note: Adding or editing entry criteria on the Direct Assignment Request lifecycle may prevent Vault from changing the state of a Direct Assignment Request from Created to Issued. This would mean Vault would not automatically create a training assignment after you use the Direct Assignment action.
Cancelling Direct Assignments
You can cancel direct assignments in two ways:
- Move the related Training Requirement or Curriculum to the Retired state. This cancels any direct assignments immediately.
- Move documents in the Training Requirement to a document lifecycle state which has the Cancel Open Training Assignments entry action configured.
- Set the Person record Status to
Inactive, or set its Training Eligibility to
- Select Change State to Cancelled from the Actions menu. This action is only available for a training assignment created via a direct assignment (Created Via Direct Assignment field is set to
Creating direct assignments does not affect the automation process. Training assignments created with the direct assignment action are ad-hoc and are not tracked in training matrices.
Integrating Vault Training with Vault QMS
You can also issue a training assignment from a QMS process. For example, a CAPA action could require that certain users be trained on a training requirement.
To set this up:
- On the Direct Assignment Request object, create an object reference field to the target quality process. For example, CAPA Action.
- Create an object type for the quality process you want to integrate with.
- Associate the Requested By field and the object reference field to that object type.
- On the page layout for the target quality process, add a related object for Direct Assignment Request.
To issue an assignment:
- From your quality process, create a Direct Assignment Request record. If Requested By is not set, Vault populates that field with the user’s name who created the record.
- Change the state of the related Direct Assignment Request record to Issued.
- Once in Issued, Vault creates a Training Assignment record.
You will need the following permissions to work with direct assignments:
|Objects: Training Requirement: Object Action Permissions: Execute
|Ability to view and execute the Direct Assignment user action.
|Objects: Direct Assignment User Input: Create
|Ability to view and create Direct Assignment User Input records.