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.
Note: Depending on your Admin’s configuration, object, field, and section labels, lifecycle states, and workflows may differ from the general information on this page. Refer to your organization’s business processes for guidance.
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.
Note: For E2B files with structured data, we recommend running the Create Inbox Item from Document action to generate Inbox Items instead of utilizing the Document Intake Highlighter.
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:
- 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.
- On the Doc Info page, select the Document Intake Highlighter () icon.
- If you’re updating fields for an existing Inbox Item, select the edit (
) icon.
- 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.
- 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.
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
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.
Manage Events
Hover over any listed item to access the following options:
- Mark as primary (
): Select this to specify an item as the primary adverse event for the report. The primary event is denoted with a primary (
) icon.
- Auto-code (
): If you update a previously entered term, select this to match and code the MedDRA term. Select the icon again to Clear Auto-code (
).
- Assign Seriousness Criteria (
): 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 (
) icon to indicate the pending deletion. Once deleted, Vault removes any associated annotations.
- Undo (
): Select this to unmark a record for deletion before promoting.
- Undo (
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.
Note: The panel displays up to 500 event items for an intake document. You can view additional items in the Medical Events section of the generated Inbox Item.
Add Products
To add products to the panel, you can extract them from the document or manually add and update them in the 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:
Registration Hovercard:
Note: The panel displays up to 500 unique Company Products for an intake document. You can view additional items in the Products section of the generated Inbox Item.
Extract Company Products
Select the Extract Company Products () 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.
Note: You cannot extract products until Vault has generated the document’s viewable rendition.
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:
- Product Type
- Suspect
- Interacting
- Drug Not Administered
- Concomitant
- Treatment
- Drug History
- Inbox Item ranked as
1
- 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 (
): Select this to specify an item as the primary product for the report. The primary event is denoted with a primary (
) 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 (
) icon to open the Product Browser.
- Select Clear Selection to remove the code.
- Select the binoculars (
- 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 (
) icon to indicate the pending deletion. Once deleted, Vault removes any associated annotations.
- Undo (
): Select this to unmark a record for deletion before promoting.
- Undo (
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 (
) annotations
- Country: Dark green (
) annotations
- Event: Light orange (
) annotations
- Product: Dark pink (
) annotations
- Patient: Light yellow (
) annotations
- Reporter: Light green (
) annotations
Note: After adding comment annotations, we recommend that you do not change the color, edit the text style, or perform any actions.
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.
Note: Moving or deleting a sticky comment annotation does not update or remove the mapped field value in the panel. You must manually update the field.
How to Highlight & Extract
To highlight and extract content in the document and populate fields:
- Select the highlighter () icon next to the field or section you want to populate.
- Highlight the word or phrase in the source document to map to the field.
- If you highlight valid text, Vault adds a comment and populates the selected field or adds the item.
- If you highlight invalid text, Vault adds a comment but does not populate the selected field or add the item.
- 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.
Note: If you exit the panel after populating fields without saving, Vault saves any sticky comment annotations you added but does not map them to fields in the panel. You can manually manually delete these as needed.
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 (
), you can select the Promote to Case (
) icon to generate a Case.
- If any sections have grey checkmarks (
), 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.
- If all sections have green checkmarks (
- 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 (
) icon to populate fields.
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 () 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.