Configure Narrative Templates

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

Sections in This Article

About Narrative Templates

When a Case is opened, the system generates a narrative document using a Vault Safety-provided standard narrative template.

The default narrative template is blank. Admins can configure custom narrative document templates. To customize document templates for certain organizations, add 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.

Vault Safety 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.
  • 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 > 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 > 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 > 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 Button, 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 > 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. In the Admin area, go to 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 Button 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. In the Admin area, go to Business Admin > 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.


Migrate External Cases
Configure the Inbox Item Follow-Up Case Compare Layout
Feedback?