Learn how to intake data from unstructured and semi-structured source documents such as emails and CIOMs forms, highlight words and phrases within a document to populate fields in the Document Intake Highlighter panel, generate an Inbox Item mapped to those source document field values, and promote it to a Case.

About the Document Intake Highlighter

You can use the Document Intake Highlighter on the Document Intake Highlighter panel, which is available on the Doc Info page of Adverse Event Report classified documents. To generate an Inbox Item from the source document, the document’s Organization field value must reference a Sponsor type.

The panel includes sections and fields that map to Inbox Item sections and fields. As you review data in the document, you can populate fields with content in the source document manually or using the highlighting and extracting content from the document, which adds sticky comment annotations so you can easily trace how field values map to the data in the document. If configured by your Admin, you can extract Company Product details from the document based on matches in your Product library.

When you access the panel on a document not yet associated with an Inbox Item, you can immediately begin populating field values. For documents already associated with an Inbox Item, you will see the summary view. After populating values in the panel, Vault generates an Inbox Item mapped to the values you sourced from the document. Any time you save changes to the values on a document or Inbox Item, Vault updates the corresponding record or document with the new values. If the generated Inbox Item meets all criteria to promote it to a Case, you can do so directly from the panel’s summary view. You can access the associated Inbox Item and Case from the Case section of the Document Information panel.

Document Intake Highlighter panel

Supported File Formats

You can use the Document Intake Highlighter on the following supported file formats:

  • Electronic Mail File
  • HyperText Markup Language
  • Hangul Word Processor
  • JPEG
  • Microsoft Word Documents
  • Microsoft Powerpoint Presentations
  • Microsoft Outlook Mail Messages
  • Portable Document Format
  • Portable Network Graphics
  • Microsoft Powerpoint Presentations
  • Rich Text Files
  • Tagged Image File Format
  • Text

Prerequisites

To utilize the Document Intake Highlighter, your Admin must enable the feature, and you must have an Editor or Owner document role for the Adverse Event Report document type.

Populate Inbox Item Fields

Use the panel to populate fields to generate a new Inbox Item or update an existing Inbox Item based on data in the document viewer. You can populate values manually or highlight and extract content to populate fields from content in the document. The fields available to populate in the panel required to generate an Inbox Item and promote it to a Case. These fields are maintained by Veeva and cannot be modified by your Admin. We recommend entering the minimum information required for triage, validation and duplicate search, and then entering the remaining details on the Case during data entry. To create an Inbox Item without populating all required fields in the panel, you can manually create the record.

To populate Inbox Item fields in the panel:

  1. Navigate to the Adverse Event Report classified document in your Library. If you’re updating an existing Inbox Item, you can navigate here from the Source Document field in its Case Validity and Source section.
  2. On the Doc Info page, select the Document Intake Highlighter () icon.
  3. If you’re updating fields for an existing Inbox Item, select the edit (edit icon) icon.
  4. Populate fields in the following panel sections as applicable. You can do this manually or by highlighting and extracting content to map values directly to content in the document.
    • Details: Specify report details. To generate an Inbox Item, you must specify New Info Date and Report Type, which you cannot populate by extracting content.
    • Country: Specify country details. To generate the Inbox Item, you must specify Reporter Country or Event Country.
    • Event: Add events. To promote the generated Inbox Item to a Case, you must add a primary Adverse Event.
    • Product: Add products. To promote the generated Inbox Item to a Case, you must add a primary Product.
    • Patient: Specify patient details.To promote the generated Inbox Item to a Case, you must populate at least one (1) of these fields.
    • Reporter: Specify reporter details. To promote the generated Inbox Item to a Case, you must populate at least one (1) of these fields.
  5. When you’re done making changes, select Save.

After saving changes, review your entries on the summary view. If all required fields contain values and Vault finds no validation errors for the populated fields, it generates or updates the applicable Inbox Item based on the values you populated in the panel. You can access the Inbox Item from the Case section of the Document Information panel to review and update fields, as needed. If you make any changes to fields on the Inbox Item, Vault syncs them to the fields displayed in the panel. You can navigate back to the panel from the Source Document field on the Inbox Item.

Specify Country Details

If country details are known, we recommend populating these fields before adding events and products so that Vault applies the specified countries to those items. When you populate Reporter Country, Vault applies the same value for the Event Country and Product Country fields. To specify a different country for either of these fields, clear the applicable Same as Reporter checkbox and then populate a different value for that field. If you leave the checkbox selected for either field, Vault applies the same value you populate for Reporter Country.

Country section of the Document Intake Highlighter panel

If you add country details after adding event and product items and do not clear the corresponding Same as Reporter checkboxes, Vault populates the Event Country of generated Events and the Country Obtained of generated Products with the same value as the Reporter Country.

Add Events

Manually add events to the panel based on details in the source document. By default, events you add in the panel are of the Adverse Event type. To view and add different types, select the applicable button:

  • Event: Adds an Adverse Event
  • History: Adds a Medical History & Concurrent Condition
  • Complaint: Adds a Product Quality Complaint

Events section of the Document Intake Highlighter panel

When you add an event, Vault attempts to auto-code terms terms with exact matches to a MedDRA dictionary term or synonym. If Vault finds a match, the item is underlined in the panel. Hover over the underlined item to view details in a hovercard.

MedDRA Hovercard

Manage Events

Hover over any listed item to access the following options:

  • Mark as primary (Mark as primary icon): Select this to specify an item as the primary adverse event for the report. The primary event is denoted with a primary (Primary icon) icon.
  • Auto-code (Auto-code icon): If you update a previously entered term, select this to match and code the MedDRA term. Select the icon again to Clear Auto-code (Clear Auto-code icon).
  • Assign Seriousness Criteria (Assign Seriousness Critreia icon): For Events and Complaints, select this to reveal checkboxes you can select to assign seriousness. Vault displays the selected criteria below the item.
  • Delete Record (): Select this to remove the item before saving changes.
  • Mark for Deletion (): If the record already exists, select this so Vault does not add the associated record to the Case when you promote to Case. Vault displays an alert (Alert Icon) icon to indicate the pending deletion. Once deleted, Vault removes any associated annotations.
    • Undo (Undo Icon): Select this to unmark a record for deletion before promoting.

To view all events without filtering by type, unselect all buttons. Select the caret icons to expand () or minimize () a section. If an expanded section includes more than ten (10) items, use the Next Page (>) and Previous Page (<) icons to move through the pages. You can drag an item to a type section button to change its type. If you move an item to a different type, it sorts at the bottom of the list for that type.

Add Products

To add products to the panel, you can extract them from the document or manually add and update them in the panel.

Products section of the Document Intake Highlighter panel

When you add a product item, Vault attempts to auto-code the item to relevant matches in your Product library. If Vault finds a match, the item is underlined in the panel. Hover the underlined Company Product or Registration to view details in a hovercard.

Product Hovercard:

Product hovercard

Registration Hovercard:

Registration hovercard

Extract Company Products

Select the Extract Company Products (Extract Company Products icon) icon in the Products section header to extract up to 500 unique Company Products from the document based on matches to your Product library. When this action finishes running, Vault adds matches to the Products section as Suspect items, highlights the associated terms in the document, and adds a sticky comment annotation so you can trace the source of each item. All generated annotations for extracted products display as created by “System”. The highlighted terms are the Product Reported of each item. After Vault adds these items to the panel, you can manually update or remove them as needed.

How Vault Extracts Company Products

Vault adds product items to the panel based on values matching the following field values in your Product library:

  • Products
    • Product Name
    • Abbreviation
    • Generic Name
  • Product Families
    • Name
    • Product Family Abbreviation
  • Substances
    • Name
    • Substance Name
  • Substance Aliases
    • Alias
  • Studies
    • Study Name

If Vault finds duplicate matches, it adds separate annotations for each, but adds only one (1) item and creates only one (1) Product Reported record. Vault sorts the items in the panel using the following logic:

  1. Product Type
    1. Suspect
    2. Interacting
    3. Drug Not Administered
    4. Concomitant
    5. Treatment
    6. Drug History
  2. Inbox Item ranked as 1
  3. Inbox Item ranked from 2 onward in alphabetical order

Manually Add & Update Products

You can manually add and update listed product items in the panel. By default, products you add in the panel are Case Products with a Drug Role of Suspect. To view and add different types, select the applicable button:

  • Suspect: Adds a Case Product with a Drug Role of Suspect
  • Interacting: Adds a Case Product with a Drug Role of Interacting
  • DNA: Adds a Case Product with a Drug Role of Drug Not Administered
  • Conmed: Adds a Case Product with a Drug Role of Concomitant
  • Treatment: Adds a Case Product with a Drug Role of Treatment
  • Similar Device: Adds a Device type of Case Product with a Drug Role of Similar Device
  • History: Adds a Drug History
  • Unknown: Adds a Case Product with a blank Drug Role
Manage Products

After you add items to the panel, you can drag and drop them to rearrange the order and move them into different product sections to change their type. You can drag an item to a type section or button to change its type. If you move an item to a different type, it sorts at the bottom of the list for that type. Hover over a listed item to access the following options:

  • Mark as primary (Mark as primary icon): Select this to specify an item as the primary product for the report. The primary event is denoted with a primary (Primary icon) icon. You cannot mark Unknown items as primary.
  • Auto-code: If you update a previously entered term, select this to match and code the MedDRA term. If you edit the item’s name after it’s coded, Vault strikes out the details and displays a message that the reported term is modified.
    • Select the binoculars (Binoculars Icon) icon to open the Product Browser.
    • Select Clear Selection to remove the code.
  • Delete Record (): Select this to remove the item before saving changes.
  • Mark for Deletion (): If the record already exists, select this so Vault does not add the associated record to the Case when you promote to Case. Vault displays an alert (Alert Icon) icon to indicate the pending deletion. Once deleted, Vault removes any associated annotations.
    • Undo (Undo Icon): Select this to unmark a record for deletion before promoting.

To view all products without filtering by type, unselect all buttons. Select the caret icons to expand () or minimize () a section. If an expanded section includes more than ten (10) items, use the Next Page (>) and Previous Page (<) icons to move through the pages.

Highlight Annotations

You can highlight and extract content within a document to populate certain fields in the panel, which is similar to annotating documents. When you highlight content in the document, Vault creates a sticky comment annotation with details about the sourced data and maps it to the selected section in the panel. Use Annotate mode to view all sticky comment annotations, including any added using the highlighter. Vault uses different highlight colors for each section in the panel so you can visualize the different areas from which you’ve pulled source data:

  • Details: Light purple (light purple) annotations
  • Country: Dark green (dark green) annotations
  • Event: Light orange (light orange) annotations
  • Product: Dark pink (dark pink) annotations
  • Patient: Light yellow (light yellow) annotations
  • Reporter: Light green (light green) annotations

For text fields, Vault populates the field with the exact text you highlighted. For fields that support certain values based on existing records or controlled vocabulary, Vault populates the field only if you’ve highlighted an exact valid text match to the available values for that field. For example, if you’re trying to populate the Gender field, which supports Female and Male values, and you highlight “Woman” within the document, Vault adds a comment and maps it to the field without populating it, since there is no exact matching value. When this happens, Vault displays the highlighted term below the field in the panel for reference. You can manually add the applicable field value in the panel.

How to Highlight & Extract

To highlight and extract content in the document and populate fields:

  1. Select the highlighter () icon next to the field or section you want to populate.
    • For events, each item defaults to Suspect type unless you select a different button before highlighting.
    • For products, each item defaults to Event type unless you select a different button before highlighting.
  2. Highlight the word or phrase in the source document to map to the field.
  3. If you highlight valid text, Vault adds a comment and populates the selected field or adds the item.
  4. If you highlight invalid text, Vault adds a comment but does not populate the selected field or add the item.
  5. Optional: Modify the populated value as appropriate.

If you populated a field with a valid value, Vault unselects the highlighter and you can populate a different field or section. If you populated the Event or Product section, the highlighter remains selected until you unselect the highlighter for that section or select the highlighter for a different section or field.

Summary View

The panel displays a summary of the Inbox Item values after saving changes and when viewing the panel for a document already associated with an Inbox Item. The Events and Products section headers include the number of items in each section in parenthesis next to the section name. When all required details are complete, you can promote to Case from the panel.

In the summary view, you can review the details for the generated Inbox Item:

  • Hover over any event or product item to view details in a hovercard.
  • Review the status of each section.
    • If all sections have green checkmarks (green checkmark icon), you can select the Promote to Case (Promote to Case icon) icon to generate a Case.
    • If any sections have grey checkmarks (grey checkmark icon), you must add required details to that section before you can promote the Inbox Item to a Case.
    • Hover over a checkmark icon to view the identifiable criteria for that section.
    • Select a header to collapse () or expand () that section.
    • If an expanded section includes more than ten (10) items, use the Next Page (>) and Previous Page (<) icons to move through the pages.
  • For any mapped highlighted term, select the value to jump to the associated sticky comment annotation in the document viewer.
  • For any extracted Company Products with multiple annotations, hover over the item and select the Apply Filter () icon to view only annotations associated with that item. Select the icon again to remove the filter.
  • Select the edit (edit icon) icon to populate fields.

Document Intake Highlighter panel summary view

Promote to Case

If you’ve added all details required to promote the Inbox Item to a Case, all sections have green complete checkmarks, and you can select the Promote to Case (Promote to Case icon) icon at the top of the panel summary view to promote the Inbox Item. You can access the generated record from the Case section of the Document Information panel to review and update fields, as needed. You can navigate back to the panel from the Source Document field on the generated Case.