To import Training Assignments using Vault Loader, use the normal object record import procedure, with the following additional guidelines:
- Imported records must include the Creation Source, Training Requirement, Learner, Document fields, and may include the Assigned Date and Due Date fields. Except for Due Date, these fields are not editable once you create the record in Vault.
- Ensure you select the Record Migration Mode checkbox prior to import.
- After import, run the Update Training Assignments job to start automation functions.
About Imported Training Assignment Sharing Settings
When importing a Training Assignment, Vault sets the the Owner role in the record’s Sharing Settings to the user who imported the record.
Upon import, Vault may or may not update a Training Assignment’s Sharing Settings, depending on whether the assignment’s associated Person record references a User record:
- If so, Vault Training adds the User and their Manager Group to the assignment’s Sharing Settings, and adds the User to the document’s Sharing Settings.
- If not, Vault Training does not update sharing settings, even if a User reference is later added to the Person. In this case, we recommend using the API or Vault Loader to update Sharing Settings.
Training Assignment Field Details
The following list shows field details for imported Training Assignment object records:
|The name of the Training Assignment record.
|The value of this field during import must be
Vault manages the
|Sets the object type using the object field name as the column header and the ID value of the record; if left blank, the object record will use the "base" type. For example, Base Product.
|Assignee of the Training Assignment.
|This field doesn't need to match the document version in the parent Training Requirement. The Do Not Re-Train field in the parent object should be set to No if you don't want Vault to re-issue assignments.
|The lifecycle state the record is imported into. At this time, Vault only supports the following states:
|Estimated Time (Minutes)
|The minutes a Learner is expected to spend to read and understand the content.
|This field is optional during import.
|This field is required during import.
You can edit this field when Creation Source is set to
This is the date that Vault assigns the Learner the Training Assignment record.
Recurring training assignments use this field for calculation of Next Training Date (Recurrence).
Best Practices: Importing Training Assignment Records
Ensure the Update Training Assignments job is inactive before the import process begins. If the job runs before you import any records, Vault may assign Learners new Training Assignment records, even if you import completed training assignment records later. To avoid this, inactivate the job, complete the import process, then activate and start the job.
To avoid erroneously issuing Training Assignments, Vault references the Assigned Date rather than the Created Date on migrated Training Assignment records when determining the most recent training completion record. Ensure that recently-completed training records have a more recent Assigned Date than previous completed training records for the same document.
Import or create records for the following before importing the associated Training Assignments:
- Learner Role records
- Curriculum records
- Training Requirement records
When importing or creating records in the Training Requirement object, you can set the Do Not Re-Train field to Yes, No, or blank. If set to Yes, and the user does not have a Training Assignment for the Document or Document Version configured for the Training Requirement, Vault does not assign new Training Assignment records.
For example, a Training Assignment record references Document A v1.0, but the Training Requirement references Document A v2.0. If you do not want the user to get a new Training Assignment for Document A v2.0, set the Do Not Re-Train field to Yes in the Training Requirement. The Update Training Assignments job will not assign a new Training Assignment record.
Importing Assignment Details Records
You can import Assignment Details records along with Training Assignments. Vault prevents importing duplicate Assignment Details records.
However, since the Update Training Assignments job always creates an Assignment Details record for the most-recently-imported Training Assignment, we do not recommend doing so for the most recently-assigned Training Assignment (according to its Assigned Date) for a given Learner/Training Requirement combination.
Updating Learner Application Role on Training Objects
To facilitate easier importing of Training Assignments, you can edit the Learner application role in the Sharing Settings of the following Vault Training objects:
- Training Assignment
- Assignment Details
- TA Checklist
- TA Response
- Class Schedule
- Class Roster
- Session Roster
- Training Completion Criteria
- Training Completion Criteria Detail
- E-Learning Status Detail
- Training Content Status
Learner application role editing should only be used for importing Training Assignments. Editing the Learner application role on these objects in an active training matrix can lead to unexpected behavior, and is not recommended.