Vault provides standard fields for tagging documents required for positive and negative lists, allowing users to maintain compliance with health authority regulations in France. When integrated with Veeva CRM, Representatives can view positive and negative list documents via MyInsights, indicating which documents must, can or cannot be shown to Healthcare Professionals (HCPs). As print materials expire, Representatives are notified via MyInsights to destroy the materials and confirm the destruction, ensuring traceability.
Important: Integration with Veeva CRM MyInsights requires service engagements for both MyInsights and Vault Data Hub. Contact Veeva Services to enable this integration.
Configuration Overview
You must complete the following configuration steps to use positive and negative lists in Vault:
- Configure document fields and field layouts.
- Configure the Positive/Negative List object.
- Configure the Material document lifecycle.
- If necessary, adjust your workflows.
- Configure field dependencies.
- Configure the Positive List and Negative List reports.
Configuring Document Fields & Field Layouts
Before using positive and negative lists, you must first configure the document fields and field layout:
- Navigate to Admin > Configuration > Document Fields > Material.
- Click Add and select Existing Shared Field.
- Add the following fields: Add to Positive/Negative List, Positive/Negative List Name, and Delivery to HCPs.
- Navigate to Configuration > Document Fields > Shared Fields.
- Click Add to Positive/Negative List, then click Edit.
- Under Display Section, select Submission Details.
- Click Save.
- Repeat steps 4 – 7 with the following fields: Positive/Negative List Name and Delivery to HCPs.
- Navigate to Configuration > Field Layout > Submission Details.
- Click Edit.
- Reorder the fields to group the following fields together: Add to Positive/Negative List, Positive/Negative List Name, and Delivery to HCPs.
- Click Save.
Configuring the Positive/Negative List Object
Next, you’ll need to configure the page layout and fields for the Positive/Negative List object:
- Navigate to Configuration > Objects > Positive/Negative List.
- Click the Fields tab, then click Create.
- Configure the new field as follows:
- Field Type: Object
- Label: Country
- Object: Country
- Select the Display in default lists and hovercards checkbox
- Click Save.
- Click the Page Layouts tab, then click Positive/Negative List Detail Page Layout.
- Click Add Section and select Related Documents.
- Add the following information:
- Referencing Document Field: Positive/Negative List Name
- Section Label: Documents
- Criteria VQL:
country__v = AND add_to_positive_negative_list__v = 'true' AND status__v = 'Approved for Distribution'
.
- Click Done.
- In the Documents section, click Edit Columns.
- Move the following fields from Available Columns to Displayed Columns: Add to Positive/Negative List, Delivery to HCPs, Expiration Date, Country, and Product.
- Click Done.
Configuring the Material Document Lifecycle
Updating the Material document lifecycle allows Vault to add expired documents to the Negative List report. If the Veeva CRM integration is enabled, MyInsights flags expired documents on the negative list and notifies representatives to destroy the material.
Note that the Material document lifecycle is the default lifecycle for promotional materials, and may have a different name in your organization’s vault.
To update the Material document lifecycle:
- Navigate to Configuration > Document Lifecycles > Material > States > Expired.
- Click the Entry Actions tab and click Edit.
- Click Create Entry Action.
- Select Perform with conditions.
- Select Add to Positive/Negative List > equals > Yes.
- Under perform actions, select Set field using formula.
- Select the Delivery to HCPs field and enter formula
'not_authorized_negative_list__v'
.
Configuring Workflow Considerations
While configuring positive and negative lists, you may want to update your workflows to include a task to complete the new document fields for any relevant countries.
Configuring Field Dependencies
You can configure field dependency to ensure that Vault correctly displays fields on Material type documents:
- Navigate to Configuration > Field Dependencies and click Create.
- Select Controlled by document field.
- Under Type, select Material.
- Under Field, select Add to Positive or Negative List.
- Click OK to open the details page.
- Under If field, select No.
- Add the following dependency rules: Positive List Name is hidden and Delivery to HCPs is hidden.
- Click Save.
- Repeat steps 1 – 5.
- Under If field, select Yes.
- Add the following dependency rules: Positive List Name is required and Delivery to HCPs is required.
- Click Save.
- Repeat steps 1 – 3.
- Under Field, select Country.
- Click OK to open the details page.
- Under If field, select France.
- Add the dependency rule Add to Positive or Negative List is visible.
- Click Save.
Note that you can add other countries as desired by repeating the process above. For example, if you want to monitor expired printed materials for the United Kingdom, you can add field dependencies on the Material document type while selecting the United Kingdom under If field.
Configuring the Reports
The Positive List and Negative List reports are automatically added to your vault when the Veeva CRM and Vault Data Hub integration is enabled. If you choose not to enable the Veeva CRM and Vault Data Hub integration, we recommend that you deploy the reports using a configuration migration package. Click here to download the VPKs, then deploy the workflow configuration. Deploying the packages adds the reports to your vault.
Once the reports are added to your vault, you’ll need to add filters to each report and configure them to best fit your business requirements:
- Navigate to the Reports tab.
- On the Positive List report, click the Actions menu next to the report name and select Edit.
- Add report filters as desired. For example, Expiration Date is after today()-1 and Document States equals Approved for Distribution.
- Click Save.
- On the Negative List report, click the Actions menu next to the report name and select Edit.
- Add report filters as desired. For example, Expiration Date is before today().
- Click Save.
Related Permissions
You can complete all steps in this article with the standard Business Admin, System Admin, or Vault Owner profile. If your vault uses custom security profiles, your profile must grant the following permission:
Type | Permission Label | Controls |
---|---|---|
Security Profile | Objects: Positive/Negative List: Read, Create, Edit, Delete | Grants ability to view, edit, and manage Positive/Negative List object records. |