# About the PromoMats-Medical Connection

Organizations using both a PromoMats Vault and a Medical Vault on the same domain can use a standard Vault to Vault connection. The PromoMats-Medical Connection automates the creation, versioning, and updating of CrossLink documents, document fields, and anchors across Vaults. For example, Medical literature references or labeling documents from RIM via the <a href="/en/gr/72311/">RIM-PromoMats Connection</a>. Streamlining document creation reduces duplicate data and allows Vault documents to have a single source of truth within an organization.

<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>: The PromoMats-Medical Connection is only available for organizations with both a PromoMats Vault and Medical Vault.</p>
    </div>
  </div>
</div>

 

## How the PromoMats-Medical Connection Works

The PromoMats-Medical Connection creates CrossLink documents across Vaults in the following situations:

  * When a document enters its steady state in the source Vault, Vault creates or versions a CrossLink document in the target Vault and populates fields. Any previous steady state versions are also  created in the target Vault.
  * When a user updates fields on documents in the source Vault, Vault updates the crosslinked document in the target Vault.
  * Vault matches the _Product_ and _Country_ fields on documents from the source Vault to the corresponding fields in the target Vault based on _Product Name_ (`name__v`) and _Country Code_ (`code__sys`).

## About Document Creation & Update

Vault creates new CrossLink documents in the steady state defined in the target Vault's document lifecycle of a given document type. If the document's type has multiple lifecycles, Vault applies the first lifecycle available. The connection creates CrossLink documents using the _Specific Document Version_ binding rule and sets the bound source version to match the steady state version of the source document. See details about [_Source Binding Rules_][1] below. If the source document is upversioned from v1.0 to v2.0, the connection creates a new CrossLink and sets the bound source version to v2.0 to match the upversioned steady state source document.

The PromoMats-Medical Connection creates, upversions and syncs metadata for documents in the target Vault that are configured to transfer between Vault Applications:

  * When a source document enters its steady state, the connection creates a CrossLink in the target Vault in the steady state of the target's _Document Type_ defined on the Document Lifecycle. Vault also applies any entry actions configured on that lifecycle state, such as setting the version number to a major version.
  * If a connection-created crosslink exists on the target Vault and a new version of the source document is created and moved to a steady state, the connection upversions the Target CrossLink and creates a new CrossLink version.
  * When the fields on a steady state source document are modified in the source Vault, Vault updates those fields on the CrossLink document in the target Vault.
  * Vault transfers the latest and any previous steady state versions of a document since the connection last ran. However, Vault transfers anchors for only the latest steady state version.
  * Document versions created in the target Vault are set by the target Vault and bound to the versions from which they were created in the source Vault.

### Document Fields

By default, Vault matches the _Product_ field on source Vault documents to the corresponding field in the target Vault based on the _Product Name_ (`name__v`) and matches the _Country_ field based on the _Country Code_ (`code__sys`).

###  About Source Binding Rules {#source-binding}

If a CrossLink document does not already exist in the target Vault, Vault creates the CrossLink document and binds it to the current document version in the source Vault. Vault will then update the CrossLink document only if a user in the source Vault specifically edits the version of the source document that is bound.

All CrossLink documents created via the PromoMats-Medical Connection have the _Source Binding Rule_ set to <a href="/en/gr/23145/#crosslinksourcebinding">_Specific Document Version_</a>.

### About Document Anchors

Anchors created by the connection in the target Vault have persistent IDs that match the source Vault's anchor persistent ID for traceability. Users can differentiate between anchors created manually in the target Vault and connection created anchors from the source Vault by the Vault ID prefix. By <a href="/en/gr/63315/#auto-bring-forward-annotations">configuring the _Bring Forward Annotations on Version Create_ setting</a>, you can enable Vault to automatically bring forward anchors created manually on new Crosslink versions in the target Vault. This functionality does not bring forward duplicate anchors created by the connection. 



<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>: Anchors must have a <a href="/en/gr/15303/#Persistent_ID">persistent ID</a> in the source Vault before you can run the connection. If they do not have a persistent ID in the source Vault, anchors may have different persistent IDs in the source and target Vaults.</p>

<p>Additionally, the <em>Update Claims Reference Anchors</em> action in Veeva PromoMats does not apply to anchors upversioned via the connection if Vault does not <a href="/en/gr/63315/#auto-bring-forward-annotations">automatically bring forward annotations</a> on a document.</p>

    </div>
  </div>
</div>




[1]: #source-binding