21R3 Safety Template Revisions

Vault Safety template revisions include changes to Vault configuration for general usability improvements. Template revisions are not automatically rolled out to existing customers.

New Vaults created in 21R3 or later will have the following settings by default. Vaults created in an earlier release can optionally be updated to match these changes. The sections on this page provide the instructions to enable these changes.

This page does not cover how to update your template to support new features. The What’s New in 21R3 page outlines which features require configuration upgrades, and provides links to enablement instructions for each feature.

Apply Relationship Security to Case and Transmission Document Fields

In the 21R3 template, the Case and Transmission document fields are secured to the referenced object record. The following steps outline how to configure this change in your Vault:

  1. Go to Configuration > Document Fields > Shared Fields.
  2. Select the Secure based on the states and roles of the referenced object records checkbox in the settings for the following fields:
    • Case
    • Transmission
  3. Go to Configuration > Object Lifecycles.
  4. In the Case Lifecycle (case_processing_lifecycle__v), add relationship atomic security for following states:

    • Closed
      Atomic Security on the Case > Closed State

    • Superseded
      Atomic Security on the Case > Superseded State

  5. In the Transmission Lifecycle (transmission_lifecycle__v), add relationship atomic security for the Completed state:
    Atomic Security on the Transmission > Completed State

Remove the AER Field from the Case Page Layout

In the 21R3 template, the AER field has been removed from the Case Page Layout.

Edit this layout from Configuration > Objects > Case > Case Page Layout.

Permission Set Updates for Case Drug History Substance

Grant permissions to the Case Drug History Substance object for the following standard Vault Safety Permission Sets:

Permission Set Object Permissions Object Field Permissions
Case Distribution Manager Read Read on all fields
Case Entry Action
  • Read
  • Create
  • Edit
  • Delete
  • Read on all fields
  • Edit on all standard fields except Case
Case Intake Actions Read Read on all fields
Case Review Actions Read Read on all fields
Case Translation Actions Read Read on all fields
Safety Operations Actions Read Read on all fields
Safety Writer Read Read on all fields
Submission Actions Read Read on all fields

Ensure Permission Sets Do Not Have Delete Permissions for Inbound Transmissions

We recommend that you ensure the following Permission Sets do not have delete permissions for the Inbound Transmission object type:

  • Case Distribution Actions
  • Case Entry Actions
  • Case Intake Actions
  • Case Review Actions
  • Case Translation Actions

Manage Permission Sets in the Admin area from Users & Groups > Permission Sets.

Allow Promote to Case from New Inbox Item

The 21R3 Vault Safety template is updated to allow users to promote Inbox Items to Case directly from the new state. Previously, these actions were only available in the Verification state.

This configuration is documented on the following enablement instructions article:

Do Not Copy Source MedDRA Version Field

Ensure the Do not copy this field in Copy Record checkbox is selected for the Case > Source MedDRA Version (source_meddra_version__v) field. This configuration fixes an issue where manually created follow-ups to E2B Imported Cases skip the Data Entry workflow stage.

  1. Go to Configuration > Objects > Case.
  2. From the Fields tab, open the Source MedDRA Version field for editing.
  3. Select the Do not copy this field in Copy Record checkbox.

Source MedDRA Version Field

Add User Actions to Withdraw Submissions and Distributions

In the 21R3 template, user actions are added to allow users to move Submissions and Distributions to a Withdrawn state. Transmissions that are in the Withdrawn state will be excluded from PADER reports.

Add a User Action to Withdraw a Record

  1. In the Admin area, go to Configuration > Object Lifecycles.
  2. Open the Transmission Lifecycle.
  3. Under States, open the Pending and Active states for editing.
  4. In each state, beside User Actions, select Edit.
  5. Select Add Action, and then add an action to Change State to Withdrawn.
  6. Select Save.

Add a User Action to Reactivate a Record

  1. In the Admin area, go to Configuration > Object Lifecycles.
  2. Open the Transmission Lifecycle.
  3. Under States, open the Withdrawn state.
  4. On the Withdrawn page, beside User Actions, select Edit.
  5. Select Add Action, and then add an action to Change State to Active.
  6. Select Save.

Localized Case Permissions

The 21R3 template has been updated with additional permissions for objects related to Localized Case processing.

  1. Go to Users & Groups > Permission Sets.
  2. Open the Objects tab.
  3. Ensure permissions are granted to object types and fields according to the following table:
Permission Set Field or Object Type Permission
Case Distribution Actions Case Product Registration > Japan (Object Type) Read
Case Distribution Actions Case Product Registration > All Fields Read
Case Distribution Actions Case Product Registration > Base Case Product Registration (Object Type) Read
Case Entry Actions Case Product Registration > Japan (Object Type) Create
Case Entry Actions Case Product Registration > All Fields
  • Edit
  • Read
Case Entry Actions Case Product Registration > Base Case Product Registration (Object Type) Read
Case Distribution Actions Transmission > Localized Case (Field) Edit
Case Distribution Actions Transmission > Case (Field) Edit

Blind Protection on Localized Case

The following sections describe configuration added to the 21R3 template for blind protection on Localized Cases. Implement this configuration if your organization uses Localized Cases to process or translate Study Cases that require blinding.

Localized Case

  1. Go to Configuration > Objects > Localized Case.
  2. Add the Case Blinded field:
    1. Open the Fields tab.
    2. Select Create.
    3. Specify the following details for the field:
      • Field type: Lookup
      • Label: Case Blinded
      • Name: case_blinded__c
      • Lookup Relationship: Case (case__vr)
      • Lookup Source Field: Case Blinded
  3. Add the Case Blinded field to the Details section of the Localized Case Page Layout:
    Localized Case Page Layout

Localized Case Assessment

  1. Go to Configuration > Objects > Localized Case Assessment.
  2. Add the Blind Protection field:
    1. Open the Fields tab.
    2. Select Create.
    3. Specify the following details for the field:
      • Field type: Lookup
      • Label: Blind Protection
      • Name: blind_protection__c
      • Lookup Relationship: Case (case__vr)
      • Lookup Source Field: Blind Protection
  3. Remove the Blind Protection field from the Localized Case Assessment Page Layout.
  4. Update sharing rules for the following roles to match on Organization and Blind Protection:
    • Distribution Manager
    • Data Entry
    • Translator
    • QC
    • Intake
    • Medical Coder
      Localized Case Assessment Matching Sharing Rules

Localized Case Assessment Result

  1. Go to Configuration > Objects > Localized Case Assessment Result.
  2. Add the Blind Protection field:
    1. Open the Fields tab.
    2. Select Create.
    3. Specify the following details for the field:
      • Field type: Lookup
      • Label: Blind Protection
      • Name: blind_protection__c
      • Lookup Relationship: Case (case__vr)
      • Lookup Source Field: Blind Protection
  3. Remove the Blind Protection field from the Localized Case Assessment Result Page Layout.
  4. Update sharing rules for the following roles to match on Organization and Blind Protection:
    • Distribution Manager
    • Data Entry
    • Translator
    • QC
    • Intake
    • Medical Coder
      Localized Case Assessment Result Matching Sharing Rules

Localized Case Product

  1. Go to Configuration > Objects > Localized Case Product.
  2. Add the Blind Protection field:
    1. Open the Fields tab.
    2. Select Create.
    3. Specify the following details for the field:
      • Field type: Lookup
      • Label: Blind Protection
      • Name: blind_protection__c
      • Lookup Relationship: Case (case__vr)
      • Lookup Source Field: Blind Protection
  3. Remove the Blind Protection field from the Localized Case Product Page Layout.
  4. Update sharing rules for the following roles to match on Organization and Blind Protection:
    • Distribution Manager
    • Data Entry
    • Translator
    • QC
    • Intake
      Localized Case Product Matching Sharing Rules

Localized Case Product Dosage

  1. Go to Configuration > Objects > Localized Case Product Dosage.
  2. Add the Blind Protection field:
    1. Open the Fields tab.
    2. Select Create.
    3. Specify the following details for the field:
      • Field type: Lookup
      • Label: Blind Protection
      • Name: blind_protection__c
      • Lookup Relationship: Case (case__vr)
      • Lookup Source Field: Blind Protection
  3. Remove the Blind Protection field from the Localized Case Product Dosage Page Layout.
  4. Update sharing rules for the following roles to match on Organization and Blind Protection:
    • Distribution Manager
    • Data Entry
    • Translator
    • QC
    • Medical Coder
      Localized Case Product Dosage Matching Sharing Rules

Localized Case Product Substance

  1. Go to Configuration > Objects > Localized Case Product Substance.
  2. Add the Blind Protection field:
    1. Open the Fields tab.
    2. Select Create.
    3. Specify the following details for the field:
      • Field type: Lookup
      • Label: Blind Protection
      • Name: blind_protection__c
      • Lookup Relationship: Case (case__vr)
      • Lookup Source Field: Blind Protection
  3. Remove the Blind Protection field from the Localized Case Product Substance Page Layout.
  4. Update sharing rules for the following roles to match on Organization and Blind Protection:
    • Distribution Manager
    • Data Entry
    • Translator
    • QC
    • Medical Coder
      Localized Case Product Substance Matching Sharing Rules

See All Open Action Items Report

The Vault Safety 21R3 template adds a multi-pass report and web action to allow users to see all Action Items across Case versions. The following sections outline the nine steps to add this configuration to your vault.

Step 1: Add Case With Case Number Report Type

  1. Go to Configuration > Report Types.
  2. Create a report type with the following settings:
Setting Value
Label Case with Case Number
Primary Reporting Object Case
Related Object Case Number

Case With Case Number Report Type

Step 2: Add Case With Case Number Report View

  1. Go to Configuration > Report Views.
  2. Create a report view with the following settings:
Setting Value
Label Case with Case Number
Report Type Case with Case Number
Columns
  • Name
  • Case Number > Name

Case With Case Number Report View

Step 3: Add Case Versions With Case Number Report View

  1. Go to Configuration > Report Views.
  2. Create a report view with the following settings:
Setting Value
Label Case Versions with Case Number
Report Type Case
Columns
  • Name
  • Case Number

Case Versions with Case Number Report View

Step 4: Add User Task Report Type

  1. Go to Configuration > Report Types.
  2. Create a report type with the following settings:
Setting Value
Label User Task
Primary Reporting Object User Task

User Task Report Type

Step 5: Add Action Item Report View

  1. Go to Configuration > Report Views.
  2. Create a report view with the following settings:
Setting Value
Label Action Item
Report Type User Task
Filters User Task > User Task Type in Case Task

Action Item Report View

Step 6: Add Action Item Across Case Versions Multi-Pass Report

  1. Go to Configuration > Report Types.
  2. Create a report type with the following settings:
Setting Value
Label Action Item Across Case Versions
Class Multi-Pass
Report View Case with Case Number
Left Join Case Versions with Case Number
Inner Join Action Item

Action Item Across Case Versions Multi-Pass Report

Step 7: Add Open Action Items Across Case Versions Report

  1. From Vault, go to the Reports tab.
  2. Add a report with the following settings:
Setting Value
Label Open Action Items Across Case Versions
Report Type Action Item Across Case Versions
Filters
  • Case > ID (Prompt)
  • User Task > Lifecycle State not equal to Complete
Columns
  • Case Name
  • Task Name
  • Assigned To
  • Priority
  • Due Date
  • Task Type
  • Description

Open Action Items Across Case Versions Report

Step 8: Add Web Action to Pull Report

  1. Go to Configuration > Web Actions.
  2. Create a web action to pull the Action Items Across Case Versions report and populate the current Case ID.

Action Items Across Versions Web Action

Step 9: Add User Action to Case Lifecycle

  1. Go to Configuration > Object Lifecycles > Case Lifecycle.
  2. Add a user action to execute the Action Items Across Case Versions web action to the following states:
    • Approved
    • Closed
    • Data Entry
    • Medical Review
    • QC
    • Revision
      Action Items Across Versions User Action