Configure Narrative Templates

Configure narrative templates to customize how narrative documents are generated when Cases are opened.

Note Beginning with 24R1 in April 2024 and for all subsequent releases, Vault Safety General Release Help content is moving to a new site. Test the new site using Limited Release content.

About Narrative Templates

When a Case is opened, the system generates a narrative document using either a custom or system-provided standard narrative template.

Custom narrative templates are applied based on the Case details. Using custom narrative templates saves case processing time by generating a narrative document with only case-specific details. Admins can configure custom templates for any combination of Organization, Report Type, Study Type, Study, and Localization.

System-provided narrative templates are blank. They are applied when no custom template is found or custom templates are not enabled. See more information on Enable Narrative Templates for Report Types and Studies. Admins can update these custom narrative document templates or add versions for certain organizations, by using controlled document templates.

Vault Online Help provides more information about managing document templates.

Narrative Template Types

When generating narrative documents on a Case, Vault Safety uses the appropriate template for the type of Case. Configure each type of narrative template that your organization requires.

The system includes the following types of narrative templates by default:

  • Default: The default narrative template type is used to generate the narrative document for Cases that were manually entered and promoted from an Adverse Event Report or Inbox Item.
  • Blinded: You can upload a blinded narrative template, which the system uses to generate the narrative document for blinded Study Cases.
    If the blinded narrative template is not available, the system uses the default narrative template to populate the case narrative. Blinded Study Cases imported from an E2B file use the E2B import narrative template.

    Note Do not enter any study product information in your blinded narrative template. If there is any product information in the blinded narrative template, it will not be masked in the blinded Distribution records.

  • E2B Import: The E2B import narrative template is used to generate the narrative document in the following scenarios:
    • Cases created from an E2B file import.
    • Importing narrative text to a Case from the Import Narrative REST API

Update the Default Narrative Template

  1. Go to Business Admin > Templates > Documents & Binders.
  2. Expand Template > Narrative, and then select Default.
  3. Open the Narrative Template - Default template, and then select Edit.
  4. Under More Information, select Upload File, and then open the file that you want to use as a template.
    The template must be a .docx file.
  5. Select Save.

Result

The system uses this template to generate case narratives. By default, all Cases use this template except Cases under organizations with organization-specific narrative templates.

Update the E2B Import Narrative Template

  1. Go to Business Admin > Templates > Documents & Binders.
  2. Expand Template > Narrative, and then select E2B Import.
  3. Open the Narrative Template - E2B Import template, and then select Edit.
  4. Under More Information, select Upload File, and then open the file that you want to use as a template.
    The template must be a .docx file.
  5. Select Save.

Result

The system uses this template to generate case narratives for Cases imported from an E2B file and narratives imported from the REST API.

Manage the Blinded Narrative Template

You can set up a dedicated blinded narrative template to generate narratives on blinded study cases.

Add a Blinded Template

If a blinded template does not already exist in your vault, you can manually add one.

  1. Go to Business Admin > Templates > Documents & Binders.
  2. Expand Template > Narrative, and then select Default.
  3. Select Create > Document Template, and then on the Create Document Template page, enter the following details:
    • Type: Select Basic Document Template.
    • Label: Enter Narrative Template Blinded.
    • Name: Verify the name is narrative_template_blinded__c.
  4. Beside File Details, select Upload File, and then upload the document that you want to use as the blinded narrative template.
    The template must be a .docx file.
  5. Select Save.

Update the Blinded Template

  1. Go to Business Admin > Templates > Documents & Binders.
  2. Expand Template > Narrative, and then select Default.
  3. Select Narrative Template Blinded, and then select Edit.
  4. Under More Information, select Upload File, and then open the file that you want to use as a template.
    The template must be a .docx file.
  5. Select Save.

Add an Organization-Specific Narrative Template

For vaults that contain Cases across multiple organizations, you can create organization-specific narrative templates.

This type of template allows you to create a custom template for one or more sponsors within your vault. The system uses a sponsor’s template to generate the narrative document when a Case is opened for that Organization.

Organization-specific templates use controlled document templates. Controlled document templates point to a Steady-state vault document, referred to as a template document, as the source file for the template.

Activate Narrative Template Document Types

Before you can add organization-specific narrative templates, narrative template document types must be active in your vault.

  1. Go to Admin > Configuration > Document Types.
  2. If Template (template__v) is inactive, expand the Actions (Actions) menu, select Edit Details, and then set the Status to Active.
  3. Expand Template (template__v) > Narrative (narrative__v).
  4. If the narrative template type for which you want to add is inactive, expand the Actions (Actions) menu, select Edit Details, and then set the Status to Active.

Add a Controlled Document Narrative Template

Note Controlled document narrative templates do not support both regular and blinded templates. If your organization handles blinded study data, do not upload a template with tokens for sensitive data that should be blind-protected.

  1. Go to the Library tab.
  2. From the menu bar, select Create and then create the document.
    If you do not see the Create button, you do not have permission to upload documents.
  3. Specify the following document type fields, depending on the template type:
    • To create a default template:
      1. On the Step 1 page, under Choose document type, select Template › Narrative (Template) › Default.
      2. On the Step 2 page, set the Template Document Type to Default.

      Note You can only configure one default organization-specific template. You cannot upload both a standard default template and a blinded template for the same organization.

    • To create an E2B import template:
      1. On the Step 1 page, under Choose document type, select Template › Narrative (Template) › E2B Import.
      2. On the Step 2 page, set the Template Document Type to E2B Import.
  4. On the Step 2 page, complete the following document fields, and any additional fields as required:
    • Name: Enter a name to identify the template.
      We recommend that you include the organization in the name. For example, Narrative Template - Default - Verteo BioPharma.
    • Organization: Select the organization that the template is for.
  5. Save the document.
    If the Save button is inactive, the system has not finished creating the document or the required fields are blank.

Result

The document is added to the Library in the Draft state. To apply the template, approve the template document.

Approve the Template Document

You must approve a document to use it in a controlled document template.

  1. On the document page, expand the All Actions (All Actions) menu , and then select Approve.
  2. In the Change Document Status dialog, select Yes.

Result

The new template should be listed for the appropriate template type, in addition to any existing templates. If you do not see the template, verify that the source document is in the Approved state and the Template Document Type field is completed.

View the Template

  1. Go to Business Admin > Templates > Documents & Binders.
  2. On the Document & Binder Templates page, expand Template > Narrative, and then select the narrative template type.

Result

The new template should be listed for the appropriate template type. If you do not see the template, verify that the source document is in the Approved state and the Template Document Type field is completed.

Add Merge Fields to Templates

To populate a narrative template with values populated in Case fields, use the Vault merge fields for Microsoft Word feature. Merge fields trigger Vault to search within a Microsoft Word (.docx only) source file and replace certain tokens with values from the Case.

Merge fields allow you to create templates that auto-populate with details like product name, organization, and receipt date. Vault Online Help provides information on using merge fields.

Note Because narratives are transmitted as plain text in submissions, we recommend that you use merge fields with caution and keep templates with merge fields very basic. The use of tables and images is not recommended.

Disable and Delete Templates

Disabling a template makes it temporarily unavailable to users creating new documents. Setting the disabled template back to Active makes it available again.

Deleting a template permanently removes it from the vault and deletes the attached file or the association to the template document. Neither action affects case narrative documents previously created from the template.

Disable a Basic or Controlled Template

To disable a basic or controlled template, perform one of the following actions:

  • From the template list panel, select Set to Disabled from the Actions menu.
  • From the template detail page, select Edit, change the status, and then select Save.

Delete a Basic Template

To delete a basic template, perform one of the following actions:

  • From the template list panel, select Delete from the Actions menu.
  • From the template details page, select Delete.

Note You cannot delete controlled document templates directly from the Admin area. Vault Online Help provides details about deleting controlled document templates.

Custom Narrative Templates

When generating narrative documents on a Case, Vault Safety applies custom templates based on Case details, including the following:

  • Case Type (E2B or manual)
  • Organization
  • Report Type
  • Study Type
  • Study
    • Blinded or Unblinded
  • Localization

The system applies the narrative template that shares the most details with the Case.

Narrative Template Applied
Vault Safety Applies the Most Specific Narrative Template

If no custom template details match, a system-provided narrative template is applied.

Custom templates are applied during the Case promotion or E2B import process. If a Domestic Case is created, the system generates a localized Narrative document using a localized template, if available. Otherwise, a global narrative template is applied.

Add a Custom Narrative Template

Custom templates use controlled document templates as the source file for the template.

Note To use custom templates, your administrator must enable Narrative Template Type on the applicable Transmission Profile. See Update the Transmission Profile to Use Custom Narrative Templates for more information.

  1. Go to the Library tab.
  2. From the menu bar, select Create and then create the document.
    If you do not see the Create button, you do not have permission to upload documents.
  3. Specify the following document type fields, depending on the template type:
    • To create a non-E2B template:
      1. On the Step 1 page, under Choose document type, select Template › Narrative (Template) › Default. Upload the file you want to use as a template, and then select Next. The template must be a .docx file.
      2. On the Step 2 page, set the Template Document Type to Narrative.
    • To create an E2B import template:
      1. On the Step 1 page, under Choose document type, select Template › Narrative (Template) › E2B Import.
      2. On the Step 2 page, set the Template Document Type to Narrative.
  4. On the Step 2 page, complete the Name field, and any additional fields as required.
  5. As needed, populate template matching details in the following fields:
    • Organization
    • Localization
    • Study Type
    • Report Type
    • Study
  6. Save the document.
    If the Save button is inactive, the system has not finished creating the document or the required fields are blank.

Result

The document is added to the Library in the Draft state. For the template to be matched to a Case during promotion, the document must be in the Approved state. To enable the template in Document & Binders, approve the document using the steps below.

Approve the Template Document

You must move the template document to a steady-state, such as Approved, to make the template active.

  1. On the document page, select the Workflow State Change Menu (Workflow-State-Button), and then select Approve.
  2. In the Change Document Status dialog, select Yes.

Result

The new template is available for use.

Note If a new version of the template is uploaded, it must be approved to be available for matching to a Case. Vault Safety will not use the last steady state document.

View the Template

  1. Go to Business Admin > Templates > Documents & Binders.
  2. On the Document & Binder Templates page, expand Case > Summary > Narrative.

Result

The new template is listed. If you do not see the template, verify that the source document is in the Approved state and the Template Document Type field is completed.


Configure Company Product Match Verification
Configure Controlled Vocabularies
Feedback?