# About the QualityOne to Training Connection (Training)

Organizations using both a QualityOne Vault and a Training Vault can utilize the [Spark messaging framework](/en/lr/57405/) to create a standard connection between Vaults. This connection transfers information across Vaults and automates the creation, versioning, and updating of [CrossLink documents](/en/lr/23143/) and document fields, and E-Learning content used for various training areas. Streamlining document creation reduces duplicate data and allows documents to have a single source of truth within an organization.

The QualityOne to Training Vault Connection supports the different training use cases, in addition to quality training, by leveraging the latest Veeva Training features. You can use this connection to expand, manage, and complete a variety of training material types under a single Vault.

Depending on your [Admin's configuration](/en/lr/549897/), object, field, and section labels may appear differently than the labels mentioned in this article.

 
<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>: This article refers to the configured QualityOne to Training Vault Connection. The QualityOne to Training Vault Connection is only available for organizations with both a QualityOne Vault and a Training Vault. If your organization uses Training Management within QualityOne only, you cannot use this feature. See <a href="/en/lr/549898/">Overview of Training Environments in QualityOne</a> for details on the different training environments and the information applicable to your Vault.</p>
    </div>
  </div>
</div>



## How the Connection Works {#how-connect}

The QualityOne to Training Vault Connection enables Vault to create and update documents in a Training Vault after a user initiates a change event in a QualityOne Vault. The connection integrates data following this general process for a typical Crosslink document (E-Learning content follows a similar process): 

* **QualityOne Vault**: A Training Admin creates a source document (can be classified as any document type) with the _Applicable to Training_ field set to "Yes". When the document reaches a _Ready for Training_ or _Steady_ state in the workflow, this triggers Vault to send a Spark message to the Training Vault. This message indicates that the connected Training Vault needs to start the sync job for documents recently created and updated in the QualityOne Vault to create and update the applicable CrossLink documents matching the source documents.
* **Training Vault**: This Vault receives the Spark message and schedules a sync job. In the sync job, Vault queries and finds no new updated documents and one (1) newly-created document in the QualityOne Vault. Vault then creates a new CrossLink document that sources its content from the matching QualityOne document, sets the document to the latest major version, and binds the document to the current source version. Vault sets the CrossLink document to a _Ready for Training_ or _Steady_ state type configured for the _Training Material_ document type in the Training Vault (the state name varies depending on your Admin's configuration). After the sync job completes, the new CrossLink document can be used as training material in the Training Vault.

If a CrossLink document or E-Learning file moves up a major version in the QualityOne Vault, Vault sends a Spark message to the Training Vault to move the related CrossLink or E-Learning document up a major version and marks the previous version as superseded. If a CrossLink document or E-Learning file moves to an obsolete state type in the QualityOne Vault, Vault sends a Spark message to the Training Vault to move the related CrossLink or E-Learning document to an obsolete state type.

See <a class="external-link " href="https://quality.veevavault.help/en/lr/50953" target="_blank" rel="noopener">Veeva Training Overview<i class="fa fa-external-link" aria-hidden="true"></i></a> for more details regarding the training environment in the Training Vault and its features.

### About Record Creation & Update {#about}

When Vault creates a CrossLink or E-Learning document in the Training Vault, Vault also populates the _Link_ (`link__sys`) field on the document with the source document's _Global ID_ (`global_id__sys`). These fields inform Vault which documents to update in the Training Vault when data is updated in the QualityOne Vault.

<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>: When users delete or archive documents in either Vault, the other connected Vault does not delete or archive the associated documents and the connection between the documents are lost. We recommend you to <a href="#obsolete">obsolete</a> your documents instead.</p>
    </div>
  </div>
</div>



## Syncing Training Materials {#sync}

There are three (3) activities where you can trigger Vault to sync your training materials from QualityOne Vault over to the Training Vault:

* [Creating a new training document][4]
* [Updating an existing training document][5]
* [Obsoleting an existing training document][6]

### Creating Training Materials {#create}

In your QualityOne Vault, ensure you set the _Applicable to Training_ field to "Yes" when creating a new document or uploading an E-Learning ZIP file. Once the document or E-Learning file (which has an _E-Learning Standard_ picklist value set) reaches the _Ready for Training_ or _Steady_ states in the workflow, the state change triggers Vault to sync your training materials over to the Training Vault through a sync job. After the sync completes, your CrossLink or E-Learning document is ready for use.

### Updating Training Materials {#update}

There are a few ways you can update your training materials from your QualityOne Vault:

* You can update the document's Admin-configured mapped fields and manually trigger a sync to update the related CrossLink or E-Learning document on the Training Vault. In the **All Actions** menu, select the **Sync Documents To Training** action to trigger a manual sync. You should see the updated fields reflected in both documents.
* You can update the [document's version](/en/lr/162/) or [E-Learning file's version](/en/lr/162/) and set the new version's lifecycle state to either the _Ready for Training_ or _Steady_ state. This triggers Vault to sync your training materials over with the new versioned document, binding the CrossLink or E-Learning document to the new version number. Vault accomplishes this by sending a Spark message to the Training Vault when an existing document enters a new major version, triggering the sync job. Before the sync completes, you can view the version differences within the document's _Source Document Details_ section. After the sync completes, Vault creates a new CrossLink document with the latest major version, and the _Source Document Details_ section updates to the latest _Bound Source Version_ for CrossLink documents and _Source Document Version_ for E-Learning documents.
* You can create a new [draft version of the document](/en/lr/1560/). This also triggers Vault similarly to versioning documents.

### Obsoleting Training Materials {#obsolete}

To obsolete your training materials in your Training Vault, you must change the CrossLink or E-Learning document's lifecycle state to the _Obsolete_ state from your QualityOne Vault. This state change triggers Vault to sync your training material's lifecycle state over to the Training Vault through a sync job. After the sync completes, both your source content and CrossLink or E-Learning document (including its previous versions) are now set to an obsolete state.

## Previewing E-Learning Content

In your QualityOne Vault, you can preview the E-Learning content synced to your Training Vault, similarly to <a class="external-link " href="https://quality.veevavault.help/en/lr/61957#previewing-e-learning-content" target="_blank" rel="noopener">previewing content uploaded to Veeva Training<i class="fa fa-external-link" aria-hidden="true"></i></a>. After uploading your E-Learning file to QualityOne, Vault detects the E-Learning standard for your content and populates the _E-Learning Standard_ field. You can launch and interact with the E-Learning document from the document's Doc Info page using the _Preview E-Learning Content_ action. 

In QualityOne Vaults, the preview window displays the course response data but does not capture the data in <a class="external-link " href="https://quality.veevavault.help/en/lr/61656#about-training-content-status" target="_blank" rel="noopener">_Training Content Status_<i class="fa fa-external-link" aria-hidden="true"></i></a> records as it would when you run the course in your Training Vault. See <a class="external-link " href="https://quality.veevavault.help/en/lr/61957#previewing-e-learning-content" target="_blank" rel="noopener">Previewing E-Learning Content<i class="fa fa-external-link" aria-hidden="true"></i></a> for more details regarding your Training Vault.

[1]: #how-connect
[2]: #about
[3]: #sync
[4]: #create
[5]: #update
[6]: #obsolete