# Promote to Case

Veeva Safety allows you to promote an _Inbox Item_ to a _Case_. When you do this, Vault searches for existing _Cases_ and _Inbox Items_ with matching data, which you can review on the [_Potential Matches_ page][5]. From there, you can compare details, mark as duplicate, create a new _Case_, or proceed to the <a href="/en/gr/826980/#complete-the-inbox-item-to-case-compare-page">_Inbox Item to Case Compare_ page</a>.

Depending on your Admin's configuration, you may also be able to promote _Inbox Items_ to _Cases_ in the following ways:

* <a href="/en/gr/01142/">Promote an _Inbox Item_ to multiple _Cases_</a>
* <a href="/en/gr/01131/">Automated _Case_ promotion</a> of _Inbox Items_ generated from certain sources

<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 you promote an <em>Inbox Item</em> and create a <em>Case</em> with a related <em>Case Adverse Event</em>, <em>Case Product</em>, or <em>Case Reporter</em>, you cannot delete the generated <em>Case</em>, nor can you delete the primary <em>Case Adverse Event</em>, <em>Case Product</em>, or <em>Case Reporter</em> records.</p>
    </div>
  </div>
</div>



### Duplicate Detection {#overview-of-duplicate-detection}

During duplicate detection, Vault compares the current record against _Cases_ and _Inbox Items_ that are linked to the same _Organization_ in your Vault and identifies potential matches to prevent the creation of duplicate _Cases_. Vault references many field values when searching for potential matches and identifies existing _Cases_ and _Inbox Items_ with field values matching your current record. In some scenarios, records with sparse information can be considered a match. Vault identifies matches using the following criteria:

* Vault matches across _Report Types_ and filters based on _Study Type_ so clinical trial study _Cases_ match only to other _Cases_ with _Clinical Trial_ as the _Study Type_.
* When the _Study_ of an imported _Inbox Item_ does not match a _Study_ in your Vault, Vault uses the source _Study Type_ to filter potential matches.
* Vault matches the following ID field values, including cross-field matches (for example, matching _WWUID_ and _External UID_ values):
  * _Case Identifier_
  * _Case Vault Global ID_ (for records generated by the <a href="/en/gr/679350/#records">Safety-EDC Connection</a>)
  * _External System UID_
  * _UID_
  * _Worldwide UID_ (WWUID)

Vault does not compare values for the following fields:

* _Study Products_ on blinded _Study Cases_
* _Patient Initials_ with values of _Unknown_ and _Privacy_ 

Vault excludes potential matches that meet following criteria:

* Different _Organization_ values.
* Different _Reporter Country_ values, unless any _Patient_ fields match.
* Different _Study Type_, specifically when one _Study Type_ is _Clinical Trial_ and the other _Study Type_ is not.
* The _New Info Date_ is older than two years from the current date. (This applies only to the _Possible Matches_ section)
* _Cases_ in _Superseded_ state (instead, Vault compares the latest _Case_ version)
* _Inbox Items_ in the following <a href="/en/gr/760903/#states">states</a>:
  * _Promoted_ (instead, Vault compares the promoted _Case_)
  * _Duplicate_
  * _Rejected_
  * _Superseded_

When duplicate detection returns potential matches, Vault generates a <a href="/en/gr/907890/#results-log">results log</a> and attaches it to the _Inbound Transmission_ of the applicable _Inbox Item_ and _Case_.

## Prerequisites

Depending on your business processes, your Admin may need to complete the following:

* Enable the applicable <a href="/en/gr/740208/#duplicate">duplicate search options</a>.
* Enable <a href="/en/gr/01311/">non-E2B Case Identifiers</a>.
* Enable the <a href="/en/gr/740208/#security-other">_Mask PHI and PII on the Potential Matches page_ setting</a>, which [encrypts PHI and PII fields][13] on the _Potential Matches_ page.

## Promote an Inbox Item to a Case {#case-promotion}

Before promoting an <a href="/en/gr/01285/">_Inbox Item_</a> to a _Case_, review the values to ensure it has enough qualifying _Case_ data. Once you've verified it has the data required for a valid ICSR, run the **Promote to Case** action by selecting it from the **All Actions** menu or by selecting the **Promote to Case** (<img class="inline" src="https://platform.veevavault.help/assets/images/saf-create-case-icon.png" alt="Promote to Case icon" style="" />) icon. When the action runs, Vault displays a message that it is searching for potential matches. If any matches exist, Vault displays the [_Potential Matches_ page][5]. If no matches exist, Vault creates a _Case_ and an <a href="/en/gr/907890/">_Inbound Transmission_</a>.

Depending on your Admin's configuration, before you can run the _Promote to Case_ action, the following fields may require values or, in some cases, must have _Yes_ values:

* _Identifiable Patient_
* _Identifiable Reporter_
* _Country_ of the primary _Reporter_ or primary _Adverse Event_
* _Adverse Event_
* _Study_ or _Company Product_

Your Admin may also configure your Vault so you can promote _Inbox Items_ only in specific lifecycle states.

## About the Potential Matches Page {#potential-matches}

If Vault finds matches after running the _Promote to Case_ action, you're directed to the _Potential Matches_ page. The left pane of the page lists all potential matches. The right panes display a comparison table, with the field values of the current record and the selected potential match, allowing you to compare the data of the two records side-by-side. You can select the header of the potential match to open the record to review additional details. 

Based on your Admin's configuration, Vault may display or mask [certain field values][13] in the comparison table.

### Page Display Options

The _Potential Matches_ page displayed in your Vault depends on your Admin's configuration. We recommend using the [enhanced page][7], which offers an improved user experience, instead of the [legacy page][8], which will be deprecated in a future release and no longer receives functionality updates such as [_Subject Matches_][2] for clinical trial study _Cases_ and the <a href="/en/gr/907890/#results-log">potential matches results log</a>.

### PHI and PII Masking {#phi-pii-mask}

If your Admin has configured <a href="/en/gr/740208/#security-other">_Mask PHI and PII on the Potential Matches Page_</a> setting, Vault masks protected health information (PHI) and personally identifiable information (PII) on both the enhanced and legacy _Potential Matches_ pages. In Vaults configured for Case Access Group Security, Vault offers more <a href="/en/gr/01182/#phi-pii-pm">refined masking</a> on the enhanced page based on user permissions. 

Vault considers the following fields to contain PHI and PII on the _Potential Matches_ page:
 
* **Patient**: 
    * _Patient First Name_
    * _Patient Last Name_
    * _Patient Initials_
    * _Date of Birth_ 
    * _MRN - GP_
    * _MRN - Specialist_
    * _MRN - Investigation_
    * _Sex_ (This field displays as _Gender_ on the legacy page.) 
* **Reporter**: 
    * _Reporter First Name_
    * _Reporter Last Name_
    * _Reporter Country_ 
* **Event**: 
    * _Event Onset_

#### Enhanced Page {#enhanced}

The left pane groups the results into [_ID Matches_][9], [_Subject Matches_][2], and [_Possible Matches_][10] sections, with section headers displaying the number of matched records within it. The [comparison table][12] in the right pane displays the current record and the selected matched record.

In the left pane of the page, you can use keyboard shortcuts to <a href="/en/gr/01229/#inbox-case">navigate between listed records</a> and your **Enter** key to open a selected record in the comparison table. The page includes the following icons to assist with your review:

* Select caret icons in any section header to expand (<i class="fas fa-caret-right"></i>) or minimize (<i class="fas fa-caret-down"></i>) that section. 
* Select the legend (<img class="inline" src="https://platform.veevavault.help/assets/images/saf-icon-legend.png" alt="Legend Icon" style="" />) icon to display comparison table status icon descriptions. 
* Select an information (<img class="inline" src="https://platform.veevavault.help/assets/images/saf-icon-info.png" alt="Info Icon" style="" />) icon to display relevant details in a tooltip for certain sections.

**Potential Matches for a Postmarketing Inbox Item**:
<a href="https://platform.veevavault.help/assets/images/saf-potential-matches-page.png" data-lightbox="saf-potential-matches-page.png" data-title="Potential Matches Page" data-alt="Potential Matches Page">
  <img class="docimage" src="https://platform.veevavault.help/assets/images/saf-potential-matches-page.png" alt="Potential Matches Page" style=""  />
</a>

**Potential Matches for a Clinical Trial Inbox Item**:
<a href="https://platform.veevavault.help/assets/images/saf-potential-subject-matches.png" data-lightbox="saf-potential-subject-matches.png" data-title="Potential Matches Page for a Clinical Trial Inbox Item" data-alt="Potential Matches Page with Subject Matches">
  <img class="docimage" src="https://platform.veevavault.help/assets/images/saf-potential-subject-matches.png" alt="Potential Matches Page with Subject Matches" style=""  />
</a>

##### ID Matches {#id}

The _ID Matches_ section lists records with matching ID values:

* **WWUID** (<img class="inline" src="https://platform.veevavault.help/assets/images/saf-tag-wwuid.png" alt="WWUID Tag" style=" width: 3rem;" />): Indicates matching _Worldwide UID_ values.
* **ID** (<img class="inline" src="https://platform.veevavault.help/assets/images/saf-tag-id.png" alt="ID Tag" style=" width: 1.5rem;" />): Indicates any of the following values match, including _Worldwide UID_ cross-field matches:
  * _UID_
  * _External System UID_
  * _Case Identifier_
  * _Event Vault Global ID_ (for records generated by the <a href="/en/gr/679350/#records">Safety-EDC Connection</a>)
  * _Case Vault Global ID_ (for records generated by the <a href="/en/gr/679350/#records">Safety-EDC Connection</a>)

If a record has one matching WWUID value and multiple matching ID values, the section displays the **WWUID** badge and not the **ID** badge.

##### Subject Matches {#subject}

The _Subject Matches_ section appears only for _Inbox Items_ and _Cases_ with a _Study Type_ of _Clinical Trial_. The section lists records in the following rank of matching values:

* EDC subject information (for records generated by the <a href="/en/gr/679350/#records">Safety-EDC Connection</a>)
* _Study Number_ and _MRN - Investigation_
* _Study Number_ and _Patient Initials_

##### Possible Matches {#possible}

The _Possible Matches_ section lists records in order of their [ranked matching field values][11]. Depending on your Admin's <a href="/en/gr/740208/#duplicate">configuration</a>, this section may appear for _Inbox Items_ and _Cases_ with a _Study Type_ of _Clinical Trial_.

##### Status Bars

Each listed record in the _Subject Match_ and _Possible Match_ sections includes status bars to indicate the categories in which Vault has identified matched values. For each status bar, green (<img class="inline" src="https://platform.veevavault.help/assets/images/saf-icon-status-green.png" alt="Green Bar" style=" width: 3rem;" />) indicates a match and gray (<img class="inline" src="https://platform.veevavault.help/assets/images/saf-icon-status-gray.png" alt="Gray Bar" style=" width: 3rem;" />) indicates no match. A green status bar indicates a record meets the following conditions: 

* **Patient** (<img class="inline" src="https://platform.veevavault.help/assets/images/saf-icon-patient.png" alt="Patient Icon" style=" width: 1rem;" />): Any of the following patient-related values match:
  * _Patient Initials_
  * _First Name_
  * _Last Name_
  * _MRN_
  * _Date of Birth_
  * EDC subject information (for [_Subject Matches_][2] only)
* **Country** (<img class="inline" src="https://platform.veevavault.help/assets/images/saf-icon-country.png" alt="Country Icon" style="" />): The primary reporter's _Country_ matches
* **Reporter** (<img class="inline" src="https://platform.veevavault.help/assets/images/saf-icon-reporter.png" alt="Reporter Icon" style="" />): Any of the following reporter-related values match:
  * _First Name_
  * _Last Name_
  * _Qualification_ of the primary reporter
* **Products** (<img class="inline" src="https://platform.veevavault.help/assets/images/saf-icon-product.png" alt="Products Icon" style="" />): Any of the following displayed (and not blinded) product-related values match:
  * _Product (Reported)_
  * _Product_
* **Adverse Events** (<img class="inline" src="https://platform.veevavault.help/assets/images/saf-icon-event.png" alt="Adverse Events Icon" style="" />): Any of the following adverse event-related values match:
  * _Event (Reported)_
  * _Event (MedDRA)_

#### Comparison Table {#table}

The comparison table allows you to compare data between two records. Rows highlighted in green indicate exact matching values for fields used to [identify matches][1]. Rows with displayed values include status indicator icons (or harvey balls) to indicate the type of match for fields used to identify matches (green icons) and informational fields (gray icons):

* **Exact Match** (<img class="inline" src="https://platform.veevavault.help/assets/images/saf-icon-exact-green.png" alt="Exact Match Green Icon" style="" /> and <img class="inline" src="https://platform.veevavault.help/assets/images/saf-icon-exact-gray.png" alt="Exact Match Gray Icon" style="" />): Values exactly match, including cross-field [ID matches][9]
* **Partial Match** (<img class="inline" src="https://platform.veevavault.help/assets/images/saf-icon-partial-green.png" alt="Partial Match Green Icon" style="" /> and <img class="inline" src="https://platform.veevavault.help/assets/images/saf-icon-partial-gray.png" alt="PArtial Match Gray Icon" style="" />): For the following fields, values partially match:
  * _Details_ section: _Receipt Date_ and _New Info Date_ values overlap within 30 days
  * _Reporter_ section: _First Name_ and _Last Name_, including cross-field first and last name matches
  * _Products_ section: _Product (Reported)_
  * _Adverse Events_ section: _Onset_ values overlap within 30 days or the month and day values are inverse
* **No Match** (<img class="inline" src="https://platform.veevavault.help/assets/images/saf-icon-no-green.png" alt="No Match Green Icon" style="" />): Values do not match

The comparison table has the following conventions and behavior:

* The header includes the _WWUID_ and _UID_ values of both records for easy reference as well as the matching record's lifecycle status and a link to open the record in a modeless browser window.
* The _Details_ section always displays the _Report Type_.
* The _Identifiers_ section includes up to ten matching records and displays ID type badges to indicate any cross-field [ID matches][9]. This section is collapsed on page load if Vault finds no matches.
* The _Products_ section includes up to three matching records.
* The _Adverse Events_ section includes up to three matching records.
* Certain rows may not display when neither the current or selected match records contain values for that field.
* Hovering over an underlined <a href="/en/gr/01164/">coded MedDRA event</a> displays details in a hovercard.
* For [_Subject Matches_][2] only, when either the source or matched record includes EDC subject information, the _Patient_ section displays the <a href="/en/gr/01287/#edc-subject-information">_EDC Subject Information_</a> from the _Case Patient_.

#### Legacy Page {#legacy}

The legacy page lists [ranked][11] matches from most similar to least similar and displays the following visual indicators to help you to compare data on [matched records][1]:

* **Checkmark** (<img class="inline" src="https://platform.veevavault.help/assets/images/saf-likely-match.png" alt="likely-match-indicator" style="" />): Indicates matching values on the records.
* **Question Mark** (<img class="inline" src="https://platform.veevavault.help/assets/images/saf-potential-match-maybe.png" alt="potential-match-maybe-indicator" style="" />): Indicates similar values on the records. For the _Event Onset_ field value, this indicator appears when the date values differ by up to 30 days.
* **Likely Match** (<img class="inline" src="https://platform.veevavault.help/assets/images/saf-likely-match-tag.png" alt="Likely Match Tag" style=" width: 4rem;" />): Indicates an ID match on the listed matched record.
* **Possible Match** (<img class="inline" src="https://platform.veevavault.help/assets/images/saf-possible-match-tag.png" alt="Possible Match Tag" style=" width: 4rem;" />): Indicates matching field values on the listed record.

<a href="https://platform.veevavault.help/assets/images/saf-potential-matches-page-v3-inbox-item.png" data-lightbox="saf-potential-matches-page-v3-inbox-item.png" data-title="Potential Matches Page" data-alt="Potential Matches Page">
  <img class="docimage" src="https://platform.veevavault.help/assets/images/saf-potential-matches-page-v3-inbox-item.png" alt="Potential Matches Page" style=""  />
</a>

<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 <em>Sex</em> field in the <em>Patient</em> section displays as <em>Gender</em>.</p>
    </div>
  </div>
</div>



### Ranking {#rank}

Vault lists matches according to the following rank of matching field values:

1. _Patient_ 
    * _Initials_
    * _Date of Birth_
    * _MRN_
    * _Sex_
    * _First Name_
    * _Last Name_
2. _Study_
    * _Study Number_
3. Primary _Reporter_<sup id="fnref:1" role="doc-noteref"><a href="#fn:1" class="footnote" rel="footnote">1</a></sup>
    * _First Name_
    * _Last Name_
    * _Qualification_
4. _Case Product_
    * _Product (Reported)_
    * _Product_
5. _Adverse Event_
    * _Event (Reported)_ 
    * _MedDRA Preferred Term (PT)_

<a id="fn:1"></a>1. Primary _Reporter_ matches disregard the order of first and last name between records. For example, Vault matches <code>Jacob Smith</code> and <code>Smith Jacob</code>.<a href="#fnref:1" class="reversefootnote" role="doc-backlink">↩</a>

When multiple records match, Vault lists them according to the rank of the matching field values. For example, if potential match A has the same _Patient_ value and potential match B has the same _Study_, _Primary Reporter_, and _Case Product_ values, Vault ranks potential match A first since _Patient_ ranks higher than the other fields. If multiple records match on the same field values (for example, multiple matches with the same _Patient_ values), Vault ranks the record with the most field value matches higher. 

## Complete the Potential Matches Page {#page}

To complete the _Potential Matches_ page:

1. In the left pane, select a listed _Case_ or _Inbox Item_ to compare with the current record.
2. Review the details of the records.
3. Select one of the following options after reviewing the details:
    * **Cancel**: Select this button to exit the _Potential Matches_ page and return to the current _Inbox Item_.
    * **Compare Details**: This button appears when you are comparing a _Case_ to your current record. When selected, Vault directs you to the <a href="/en/gr/826980/#complete-the-inbox-item-to-case-compare-page">_Inbox Item to Case Compare_ page</a>, where you can mark the current record as duplicate or follow-up, merge to current, or create a new _Case_ with existing patient information.
    * **Mark as Duplicate**: This button appears when you are comparing an _Inbox Item_ to your current record. Select this option if the _Inbox Item_ is an exact match to the current record. When selected, Vault updates the record to _Duplicate_ state and does not create a _Case_. Vault adds a <a href="/en/gr/01285/#cases">link to the duplicate</a> _Case_ or _Inbox Item_ of the current record.
    * **Create New Case**: Select this option if the current record is not a duplicate of any potential matches. When selected, Vault creates an initial <a href="/en/gr/01147/">_Case_</a> and an <a href="/en/gr/907890/">_Inbound Transmission_</a>.

### Combination Products {#combination}

When you promote an _Inbox Item_ with a _Combination Product_, Vault uses the <a href="/en/gr/01214/#combination-product-registrations
">_Product Registration_ data</a> to populate certain fields, calculate expectedness, and generate _Submissions_.

### Blinded Study Cases {#blinded}

On _Inbox Items_ for <a href="/en/gr/01176/">blinded study cases</a> without <a href="/en/gr/840046/">study arms</a>, Vault does the following upon promoting the record to a <a href="/en/gr/01287/#study-section">blinded _Case_</a>:

* If the _Study Product Role_ value is _Standard of Care_, Vault ignores the _Blinded_ field value of the _Inbox Item's_ associated <a href="/en/gr/01285/#products">_Study Product_</a> since these are always considered _Open Label_. For all other _Study Product Role_ values, Vault populates the following field values on the generated <a href="/en/gr/01287/#products-section">_Case Product_</a> based on values on the _Inbox Item's_ associated _Study Product_:
  * Populates the _Blinded Name_ with value of the _Name_ of the _Study Product_
  * Populates the _Masking_ field based on the _Blinded_ value of the _Study Product_
    * _Blinded_ = _Yes_
    * _Unblinded_ = _No_
    * _Open Label_ = _blank_
* Vault populates the _Study Arm_ or _Study Blinded_ value of the _Case_ with the same value of the applicable _Inbox Item_ field. 

### Clinical Trial Cases {#clinical-trial}

If your Admin has configured your Vault to <a href="/en/gr/691317/#promote">isolate blinded _Product_ information on Clinical Trial _Study Cases_</a>, when promoting an _Inbox Item_ for blinded clinical trial study _Cases_, Vault generates blinded and unblinded records based on the _Drug Role_ and _Blinded_ field values of the _Study Product_.

[1]: #overview-of-duplicate-detection
[2]: #subject
[5]: #potential-matches
[7]: #enhanced
[8]: #legacy
[9]: #id
[10]: #possible
[11]: #rank
[12]: #table
[13]: #phi-pii-mask