You can import Training Assignment object records from other training systems into Vault using Vault Loader or the API.

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:

Column Header Field Example Value Notes
name__v Name Travel policy The name of the Training Assignment record.
creation_source__v Creation Source import__v The value of this field during import must be import__v.

Vault manages the system__v and direct_assignment__v fields.
training_requirement__v Training Requirement V1C000000000127 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.
learner__v Learner V0I000000000102 Assignee of the Training Assignment.
training_document__v Document 8_2_0 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.
state__v Lifecycle State completed__v The lifecycle state the record is imported into. At this time, Vault only supports the following states:

assigned_state__v

created_state__v

completed_state__v

cancelled_state__v
estimated_time_minutes__v Estimated Time (Minutes) 70 The minutes a Learner is expected to spend to read and understand the content.
due_date__v Due Date 3/22/18 This field is optional during import.
assigned_date__v Assigned Date 2018-11-07T14:50:00.000Z This field is required during import.

You can edit this field when Creation Source is set to import__v.

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:

  • Documents
  • 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
  • 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.