Editing eConsent Forms

Learn how to edit eConsent forms in the Veeva eConsent editor.

Overview of Editing eConsent Forms

Veeva eConsent editor

The Veeva eConsent editor allows you to transform source documents such as Microsoft Word™ informed consent forms (ICFs) into electronic consent (eConsent) forms that participants can review and complete in MyVeeva for Patients. You can also edit and format eConsent forms that you uploaded to Vault directly as Microsoft Word™ documents.

For sponsors, Veeva eConsent is available if you license and configure it. For sites, Veeva eConsent is available if you’re conducting a study with a sponsor who uses it for a connected study or if you enable it as a paid add-on.

Complete the following steps to edit an eConsent form using the Veeva eConsent editor:

  1. Access the blank ICF that you want to edit in your vault. The blank ICF must be a new ICF that isn’t in a steady state or a new draft version of an ICF. Additionally, the blank ICF can’t be checked out by another user. See the following pages for more information:
  2. Select the action to edit the eConsent form from the Actions menu (Edit eConsent in SiteVault). The blank ICF is checked out, and the Veeva eConsent editor is opened in a new browser tab.
  3. In the new tab, edit the content as necessary. See the Best Practices for eConsent Forms and Using the Veeva eConsent Editor sections for more information.
  4. When you’re ready to save to Vault or check in the document, select Save to Vault or Check In above the table of contents in the editor. We also automatically save your progress in the editor every 30 seconds.

Browser and Device Prerequisites

To have the best experience using the Veeva eConsent editor, ensure that your browser and device meet the following requirements:

  • Browser: We recommend that you use a desktop browser for the editor, and you’ll have the best experience in Google Chrome™, Microsoft Edge®, or Mozilla Firefox®. Using Microsoft Internet Explorer™ 11 is not recommended, and you may encounter cosmetic issues if you do.
  • Pop-Up Blockers: If you use Apple Safari® or Mozilla Firefox® to edit an eConsent form, you must configure your browser to allow pop-ups from the Vault website.
  • Resolution: If your screen is smaller than 960 pixels wide or you zoom in to an equivalent width, you may not be able to use some functionality such as the table of contents and the buttons for saving to Vault or checking in.

Best Practices for eConsent Forms

To simplify the editing process and ensure that the participant has a good user experience in MyVeeva for Patients, we recommend that you consider the following items when editing a document in the Veeva eConsent editor:

Topic Description
Microsoft Word™ Support

We recommend that you use Microsoft Word™ source documents in the eConsent editor in the following ways:

  • If you're using a Microsoft Word™ document to collaboratively author your ICF, you can import it into Vault as an eConsent form and the system will automatically transform it.
  • You must use the Veeva eConsent editor to add and manage eConsent-specific assets like question blocks, signature blocks, images, and videos that aren’t imported when you upload the form into Vault.
  • Use the eConsent editor to review, edit, and check in the version of the document that you intend to approve for use. If you import the version of the Microsoft Word™ document you intend to approve for use to Vault and approve it without reviewing it, editing it, and checking it in from the eConsent editor, errors occur.
Faster Transformation

The following functionality is available to help transform source documents into eConsent forms:

  • Import: If you’re using an eConsent form that someone else created, you can import it using an import code or the eForm rendition. For example, site staff can import an eConsent form from a sponsor or vice versa. See the Importing eConsent Forms section for more information.
  • Copy-and-Paste: You can copy and paste text into content blocks.
  • Split Content: You can also copy and paste an entire document into a text box then select the Split Content icon ( Split Content icon ) to break the content into blocks quickly. See the Editing Text Content section for more information.
Modular Content

We recommend that you make your content modular in the following ways:

  • Multiple Sections and Content Blocks: Break your ICF into multiple sections and content blocks, for example, a section for the study overview and another for possible risks. Doing so ensures that participants view each section, have good user experiences in MyVeeva for Patients, and more easily consume the information.
  • Complex Content in Separate Blocks: If you have longer, more complex content (for example, large tables or specially formatted lists or text), split the content into its own block. This makes it easier to move the content and change its formatting independently of the other content blocks.

See the Adding Sections and Adding Content Blocks sections for more information.

Simplified Tables

We recommend that you keep tables simple on eConsent forms.

A complicated table with many columns or tables within tables may be difficult for the participant to view if they're using a mobile device or small screen, as they’ll need to scroll horizontally to view the content. Additionally, the table may be narrowed in the .PDF file of the eConsent form in Vault and MyVeeva for Patients.

Previewing the Document

We recommend that you view the web preview from the editor and download the .PDF file to verify that the form is displayed as you want in both formats.

See the Previewing and Downloading eConsent Forms section for more information.

Importing eConsent Forms

Copy Import Code dialog

You can import eConsent forms into the Veeva eConsent editor using Microsoft Word™ documents, import codes, or eForm renditions.

For example, you can download a Microsoft Word™ file, review and edit the form with an EC or IRB, then import the new version. For another example, if you’re creating an eConsent form for a site, you can import an eConsent form from a sponsor using an import code then make site-specific edits to the form.

Regardless of which method you use to import your eConsent form or what edits you make in the editor, the original file type of the document in Vault (.PDF or .DOCX) will be maintained throughout the document’s life.

Note Importing an eConsent form replaces the content you currently have in the Veeva eConsent editor. You can select Undo Changes in the editor if you accidentally replace your edits.

Importing With Import Codes

Importing with a code allows you to import an eConsent form into the editor from your vault or someone else’s using a code copied in the participant preview. To share a code, you can send the person importing the document a link to the participant preview or the import code itself.

Complete the following steps to import an eConsent form using an import code:

  1. If you don’t already have the code or haven’t sent it to the person importing the document, complete the following steps:
    1. Open the participant preview. You can access the link given to you, or you can select the preview option from the Actions menu for the eConsent form in Vault (Open Preview Link in SiteVault).
    2. Select the Share icon ( Share icon ) in the upper-right corner of the participant preview.
    3. Select the Copy to Clipboard icon ( Copy to Clipboard icon ) to copy the code. We also include instructions in the dialog for how to use the code if you want to share them.
    4. Continue with Step 2 if you’re importing the document, or send the import code to the person importing the document.
  2. In Vault, create a new blank ICF or a new draft of an existing blank ICF, then select the action to edit the eConsent form from the Actions menu (Edit eConsent in SiteVault).
  3. Select the Import icon ( Import icon ) in the upper-right corner of the editor.
  4. Select Import With Code.
  5. Paste the import code into the box, then select Import Document. All the content in the editor is replaced. You can select Undo Changes in the message at the top of the page if you want to restore the previous content.
  6. Save the document to Vault. We recommend saving a version to Vault before you begin editing, so that you always have a version that represents the original imported content.

Importing Microsoft Word™ Documents

Complete the following steps to import an eConsent form from a .DOCX file:

  1. Ensure that your .DOCX file is formatted per the guidelines below.
  2. Select the Import icon ( Import icon ) in the upper-right corner of the editor.
  3. Select Import Microsoft Word (.DOCX).
  4. Either drag-and-drop the .DOCX file into the box or browse for and select it. The maximum file size is 10 MB.
  5. Select Import Document. All the content in the editor is replaced. You can select Undo Changes in the message at the top of the page if you want to restore the previous content.
  6. Save the document to Vault. We recommend saving a version to Vault before you begin editing so that you always have a version that represents the original imported content.

Note The version of the Microsoft Word™ document you import and intend to approve for use must be reviewed, edited, and checked in to Vault from the eConsent editor prior to approval. If you import a Microsoft Word™ document and approve it without reviewing it, editing it, and checking it in to Vault from the eConsent editor, errors occur.

Import Guidelines

When you import a .DOCX file, format the file per the following guidelines to ensure that the document is imported correctly:

Guideline Description
Headings

Use the standard Microsoft Word™ styles for heading level one and two. Use heading 1 for sections and heading 2 for content blocks.

When you download an eConsent form, the system also makes sections heading 1 and content blocks heading 2 in the downloaded .DOCX file.

Images Don’t use text boxes to alter images, and ensure that the images are in a .JPG, .PNG, or .GIF format. The system will import the images.
Lists Use bullet points or numbered lists in Microsoft Word™. Lists that don’t use that formatting are not imported as lists.
Tables Keep bullet points on tables to a minimum. These lists make table rows expand. Additionally, tables on eConsent forms are in portrait format. If you include landscape tables, the system reformats them.
Tracked Changes Accept or reject tracked changes before importing a file. When you import a .DOCX file with tracked changes, the changes are imported as text.
Videos

If your eConsent form includes videos, add them in the editor after importing the .DOCX file. The first time you import a .DOCX file that includes a video, the system imports the first frame of the video as an image. You can replace the image with the video in the editor.

If you download an eConsent form that includes a video then import it later, the video is imported.

Other Formatting and Content

Formatting or Content Description
Content Blocks

Signature and question blocks need to be created in the Veeva eConsent editor. When you initially import a .DOCX file, use the editor to create signature and question blocks instead of using text blocks for those items. When you download a Microsoft Word™ document, we use special formatting around the signature and question blocks to ensure they can be imported as the correct content block type.

The Veeva eConsent editor should also be used to edit and manage the label fields on signature blocks. If you edit or delete signature labels in an exported .DOCX file and then re-import to the editor, the signature block isn’t retained and connected forms are disconnected from the sponsor.

Fonts

eConsent forms use a sans-serif font. If you import a document that uses a serif font, the system changes it to sans-serif.

Font colors and highlights are imported.

Headers and Footers The system doesn’t import headers, footers, or footnotes. The system will automatically add a header and footer to the .PDF files.
Margins Margins are ignored by the import process.
Orientation Pages on eConsent forms are oriented in portrait mode. The system reformats landscape pages to portrait.
Unsupported Items

The following items can’t be imported:

  • Columns: The content will be imported into a single column, top to bottom.
  • Comments: While documents with Microsoft Word™ comments are supported in Vault, the Veeva eConsent editor doesn’t support them and will permanently remove comments from imported documents.
  • Cross-reference links within the document
  • Embedded objects such as Microsoft Excel™ or Microsoft PowerPoint™ content
  • Fields
  • Images with links
  • Microsoft Word™ art, shapes, and drawings
  • Page breaks
  • Text boxes. Text will be imported, but any style or placement on a page will not.

Importing eForm Renditions

Complete the steps below to import an eForm rendition (the .JSON file of an eConsent form) into the editor. If you’re creating a copy of a document in your own vault, we recommend that you copy the document in Vault instead. Additionally, if you’re a sponsor sharing a form with sites, we recommend that you use the import codes for ease of use and traceability.

  1. If you don’t already have the .JSON file or haven’t sent it to the recipient, select Veeva eForm from the download options in Vault for the document.
  2. In Vault, create a new blank ICF or a new draft of an existing blank ICF, then select the action to edit the eConsent form from the Actions menu (Edit eConsent in SiteVault).
  3. Select the Import icon ( Import icon ) in the upper-right corner of the editor.
  4. Select Import JSON.
  5. Either drag-and-drop the .JSON file into the box or browse for and select it. The maximum file size is 10 MB.
  6. Select Import Document. All the content in the editor is replaced. You can select Undo Changes in the message at the top of the page if you want to restore the previous content.
  7. Save the document to Vault. We recommend saving a version to Vault before you begin editing, so that you always have a version that represents the original imported content.

Using the Veeva eConsent Editor

Titling eConsent Forms

Participant-Friendly Title box

Complete the following steps to specify a participant-friendly title for a document:

  1. Select the Edit Title link at the top of the form.
  2. Enter your title, for example, Main Informed Consent Form. The title can be up to 150 characters. If your title is too long, consider shortening it to be more understandable for the participant and including the full title in the document’s text.
  3. Click outside of the title box or select a content block on the page.

The participant-friendly title is displayed in MyVeeva for Patients and on the viewable rendition in Vault but is not saved to a field in Vault. If you want to view the participant-friendly title when you select an ICF to send to a participant, add the title to the document’s Description field in Vault.

Requiring an Unlock Code to Sign

Requires Unlock Code to Sign toggle

If you want to require participants to have a site-provided unlock code to sign the eConsent form, toggle the Requires Unlock Code to Sign setting to on.

When site staff send an eConsent form that requires an unlock code to a participant, the participant can review the form before an in-person or virtual consenting visit but can’t sign it until the site coordinator gives them the unlock code. This allows the site to ensure that the participant discusses the form and study with site staff before signing. Site staff create the code in the preview opened from SiteVault.

See Unlocking an eConsent Form in SiteVault Help for more information about how to create the code.

Requiring a Hand-Drawn Signature

Requiring a hand drawn signature

If you want to require MyVeeva users to draw their signature instead of clicking or tapping to sign, toggle the Requires Hand-Drawn Signature setting to on.

The following conditions apply to hand-drawn signatures:

  • All Users: If hand-drawn signatures are required, MyVeeva users need to draw their signature to sign the eConsent form and won’t need to verify their identity with a code.
  • Registered Users: When hand-drawn signatures aren’t required, registered MyVeeva users can choose whether they draw their signature or click or tap to sign.
  • Unregistered Users: Hand-drawn signatures are always required if a MyVeeva user is signing a consent form in person without an account registered with a phone number and email address.

Note If a sponsor created a consent form in Clinical Operations that requires a hand-drawn signature and a site is editing the form in SiteVault, the SiteVault user can’t turn off this setting while the form is still connected to the sponsor.

Connecting or Disconnecting a Form

Document connected to sponsor

If you’re editing a consent form in SiteVault that was shared from a sponsor with an import code or Site Connect, a banner is displayed at the top of the editor to notify you that the form is connected to the sponsor. When a MyVeeva user submits a connected consent form, de-identified question and signature response data is sent to the sponsor in Vault Clinical Operations as well as the site in SiteVault.

A green link icon ( Connected Form icon ) is also displayed next to the question and signature blocks that were in the sponsor’s consent form.

  • If you want to disconnect the consent form from the sponsor, select Disconnect This Document in the banner then select Disconnect to confirm. We recommend only disconnecting a form if you plan to use it as a template for another purpose. We also recommend making a copy of the form first in case you need a connected version later.
  • If you want to reconnect the document, select Reconnect This Document in the banner.

See the Viewing eConsent Form Responses topic in SiteVault Help or the Reporting topic in Vault Help for more information about viewing and reporting on signature and question responses in Vault.

Note For a document to be connected, it must be created by the sponsor in Vault Clinical Operations, and for a block in the form to be connected it must also be created by the sponsor. If site staff create a form or add a contact block, data isn’t sent to the sponsor. Additionally, if data is sent to the sponsor then the site disconnects the form, the sent data remains with the sponsor.

Working With Sections and Content Blocks

Table of Contents

The table of contents on the right side of the editor displays the sections and content blocks on your form. You can view, move, remove, and add content blocks on the table of contents.

Viewing Sections and Content Blocks

If you want to navigate to a section or content block, select it on the table of contents.

Moving Sections and Content Blocks

If you want to move a section or content block, drag and drop it on the table of contents. You also can position your pointer over the section or content block on the table of contents and select the applicable Move Up One ( Move Up One icon ) or Move Down One ( Move Down One icon ) icon.

If you drag-and-drop a content block to a different section, the content block is added to the bottom of the section.

Removing Sections and Content Blocks

If you want to delete a section or content block, position your pointer over the section or content block on the table of contents and select the Remove icon ( Remove icon ) .

If the section or block currently includes content, select Yes to confirm that you want to remove it.

Adding Sections

Complete the following steps to add a section:

  1. Select the Add Section icon (+) next to Sections on the table of contents. The section is added to the bottom of the table of contents.
  2. If you want to specify a title for the section, enter it in the title box. Section block titles can be up to 100 characters long.

Note The section title box isn’t displayed if the document has only one section. Additionally, Section [#] is used as a default title in both the editor and MyVeeva for Patients if the document includes multiple sections and you don't specify a title.

Adding Content Blocks

Add Content Block dialog

If you’re currently viewing the section to which you want to add a text content block, select Click to Add Content Block below the last content block.

If you want to add a content block to a different section or add a different type of block, complete the following steps:

  1. Select the section to which you want to add the content block.
  2. Select the Add Content Block icon (+) next to Content Blocks on the table of contents.
  3. Select the type of content block that you want to add. See the Content Block Types section below for more information.
  4. If you want to specify a title for the content block, enter it in the title box. Content block titles can be up to 100 characters long.
  5. Select any additional settings as needed. See the Content Block Types and Content Block Settings sections below for more information.

Content Block Types

The following content block types are available:

Type Description
Text Block If you want to navigate to a section or content block, select it on the table of contents. See the Editing Text Content section for more information.
Signature Block

The signature content block allows you to add places for signatures and optional text content above them. You can add one signature block per role that might need to sign a consent form. The site approver signs in SiteVault after all the included roles sign in MyVeeva for Patients.

See the Content Block Settings section for more information about the roles.

Question Block The question content block allows you to insert a question and its response options. You can also add text content above the response options. See the Content Block Settings section for more information about how to add responses.

Content Block Settings

The following content block settings are available:

Setting Types Description
Role Signature

Select the role for the signature block from the Role list. The options are Participant, Witness, Translator, Guardian / Representative, and Proxy.

You can add only one signature block per role. If you include a guardian signature block and send the form to two guardians, both guardians receive the document and have a place to sign.

When the site coordinator sends the form to the participant, only the roles included on the consent form and associated with the patient or participant in SiteVault receive the form.

Show Title All

Deselect the Show Title checkbox if you want to hide a content block's title. The checkbox is selected by default when you add a content block.

If you hide the title or don't enter one at all, no heading for the block is displayed in MyVeeva for Patients or the .PDF files. Instead, the content block is added to the previous content block or section.

Show Text Content Question, Signature

Deselect the Show Text Content checkbox if you want to hide the block's text content. If you do so, the text content you entered is still saved but is not displayed in MyVeeva for Patients or the .PDF files.

You can reselect the checkbox to display the content. The checkbox is selected by default when you add a question or signature block.

Required Response Question Toggle Required Response to on if you want participants to be required to answer a question before they can sign and submit the eConsent form. Questions with more than one response option are required by default, and you can't make questions with only one response required.
Responses Question

You can modify a question block’s responses in the following ways:

  • Add Response: Select Add Option and enter your response option in the Your Option box. You can add up to 12 response options.
  • Move Responses: You can drag and drop response options to move them on the list or select the Move Up One ( Move Up One icon ) or Move Down One ( Move Down One icon ) icon.
  • Remove Responses: You can position your pointer over the response option and select the Remove icon ( Remove icon ) to remove it.
Sponsor Connection Status Question, Signature

If you’re editing a consent form in SiteVault that was shared from a sponsor using an import code or Site Connect and is still connected to the sponsor, a green link icon ( Connected Block icon ) is displayed next to question and signature blocks that were in the sponsor’s form.

If the link icon is red ( Disconnected Block icon ) , the consent form came from a sponsor originally but is now disconnected.

See the Connecting or Disconnecting a Form section for more information about connected documents.

Signature Name, Question Name, and Answer Name Question, Signature

The signature, question, and answer names are displayed in the response records for participants and used in Vault reporting. You can either enter a name of up to 128 characters or use the default. The system uses the first 40 characters of the body text as the default name if text is present. If a consent form is not connected to a sponsor and no text content is present or you remove the name, the system uses a default name such as question_1.

For consent forms connected to the sponsor, question, answer, and signature names for connected blocks are filled in automatically with the names that the sponsor defined. You can enter your own name for these blocks, and it won’t interfere with the ability to send responses to the connected site.

The names are displayed in Vault. You can use the names to aggregate response data across separate documents and studies when you create reports. We recommend that you use unique names in a data set for easy organization and reporting, and we recommend not changing the sponsor-defined names when they are present to facilitate communication with the sponsor.

See the Viewing eConsent Form Responses topic in SiteVault Help or the Reporting topic in Vault Help for more information about viewing and reporting on signature and question responses in Vault.

Signature, Printed Name, and Date Labels Signature

You can edit the signature, printed name, and date labels on signature blocks to add custom labels or translations to them. Each label has a maximum character limit of 50. By default, the signature, printed name, and date labels are in English.

Editing Text Content

Text block

The text formatting toolbar is displayed when you click into or select text in a text content box. The following functionality is available on the toolbar:

Notes Similar to other text editors, browsers undo your edits to the current field then continue to the most recent fields you edited when you press CTRL+Z (⌘+Z) in the editor. If you undo edits to one section or content block, make sure you don't undo changes elsewhere on the page also.

When you inclue carriage returns in the text editor, we recommend that you press Shift + Enter to minimize white space in longer documents. Pressing only the Enter key will add more space for clearer paragraph separation.

Action Icon Shortcut Description
Split Content Split Content icon N/A

Select the Split Content icon to split the text into a new text content block. This enables you to paste an entire document or a large portion of a document into the editor then select where you want to split it into a new content block, which can be quicker than copying and pasting each section from a source document.

The content is split after the cursor. If you want part of the text to be the title of the new text content block, select the text then the Split Content icon. The selected text is made the heading of the new content block, and the content after the selected text is the text content.

Format Format icon Multiple

You can format text in the following ways:

  • Normal text (CTRL+ALT+0 or ⌘+ALT+0)
  • Quote
  • Code
  • Subheadings 1, 2, and 3 (CTRL+ALT+1,2, or 3 or ⌘+ALT+1, 2, or 3)

Occasionally, subheading styles may shift to nearby sections of text while you are copying, pasting, or deleting formatted text. If this happens, you can select the Format icon to reapply the correct style to any effected text.

Bold Bold icon CTRL +B (⌘+B) Select the Bold icon to bold your text.
Italic Italic icon CTRL+I (⌘+I) Select the Italic icon to bold your text.
Underline Underline icon CTRL+U (⌘+U) Select the Underline icon to bold your text.
Strikethrough Strikethrough icon N/A Select the Strikethrough icon to strike through your text.
Bullets Bullets icon CTRL+SHIFT+8 (⌘+SHIFT+8) Select the Bullets icon to add a bulleted list.
Numbers Numbers icon CTRL+SHIFT+7 (⌘+SHIFT+7) Select the Numbers icon to add a numbered list.
Table Table icon N/A

Select the Table icon then Insert Table to add a table. If you want to add or remove rows or columns or add a heading row, select the Table icon then the applicable option.

You can also remove tables by selecting the Table icon then Delete Table.

Link Link icon CTRL+K (⌘+K)

Complete the following steps to add a link:

  1. Select the Link icon.
  2. Select Insert Link.
  3. Enter the web address in the URL box.
  4. Enter the link text in the Text box.
  5. Select Insert.

Note When adding links to a document, use https:// links instead of http:// links. Participants may not be able to access http:// links from the Android and iOS apps.

Media Image icon N/A Select the Media icon to add an image or video. See the Working With Media section for more information.
Align Align icon N/A Select the Align icon then an alignment option to change the alignment of your text.
Clear Formatting Clear Formatting icon CTRL+SHIFT+M (⌘+SHIFT+M)

Select the Clear Formatting icon to clear the formatting from the text. If you select text first, the selected text’s formatting is removed. If you select the icon without text selected, all the text content formatting in the block is removed.

Note If you’re having issues with formatting, you can press CTRL+SHIFT+V (⌘+SHIFT+V) to paste text without formatting then apply the formatting you want manually.

Working With Media

Add Image dialog

You can use images and videos to include helpful visuals on eConsent forms such as device diagrams, visit schedules, and instructions. Videos can be used to further explain study-specific or general medical topics to the participant, for example, the phases of a clinical trial, a summary of informed consent, or an overview of what an MRI entails.

Adding Images and Videos

Complete the following steps to add an image or video:

  1. Select the Media icon ( Media icon ) on the text editor’s toolbar.
  2. Either drag-and-drop an image or video in a supported format into the box, or select Browse and select a file. The maximum file size is 2 MB for .JPG, .PNG, and .GIF files and 500 MB for .MP4 files.
  3. If you’re adding an image, enter a description in the Description box. This description is used as alternative text for screen readers and accessibility for users in MyVeeva for Patients. See Alternative Text on the WebAIM℠ website for more information about writing high-quality alternative text.
  4. If you’re adding an image and want to align it a specific way, select an option in the Alignment section.
  5. Select Add Media.

Editing Images

Complete the following steps to change, realign, or edit the description of an image:

  1. Select the image, then select Edit in the upper-right corner of the image.
  2. Make any updates as necessary.
  3. Select Update.

Note You can’t edit videos. If you want to change an included video, remove it and add a new one.

Removing Images and Videos

Complete one of the following steps to remove an image or video:

  • To remove an image, select it and press BACKSPACE (DELETE).
  • To remove a video, click to the right of it and press BACKSPACE (DELETE).

Previewing and Downloading eConsent Forms

Editor Preview mode

Previewing eConsent Forms

Select the Web Preview icon ( Web Preview icon ) in the upper-right corner of the eConsent editor to preview how the eConsent form will be displayed to participants in MyVeeva for Patients. We recommend previewing the document to ensure that the form is displayed as you want.

This preview is viewable to only you as the logged-in user. If you want to create and share a preview of the form with external readers, select the option from the Actions menu in Vault (Open Preview Link in SiteVault). See the following pages for more information:

Note The web preview accessed from the editor includes your current content in the editor at the time you open it. It doesn't include more recent edits if you refresh it. If you want to open a new preview, reselect the Web Preview icon.

Downloading eConsent Forms

Complete one of the following steps to download an eConsent form:

  • eConsent Editor: In the editor, select the Download PDF ( Download PDF file button ) or Download Word Document icon ( Download Word file button ) in the upper-right corner.
  • eConsent Preview: In the preview opened from Vault, select the ellipsis () in the upper-right corner then select Download PDF or Download Word Document.

When you download a Microsoft Word™ document, we use special formatting around the signature and question blocks to ensure they can be imported as the correct content block type. Only edit the content in the blocks and don’t delete and replace them to ensure they remain the correct type.

The participant can download the .PDF file from MyVeeva for Patients, and the file is stored as a viewable rendition in Vault. You can also download the .PDF document in Vault after you save the document or check it in.

Note If you notice that a section or page is separated from its content by a page break in the .PDF document, you can add lines at the end of an earlier block to force a page break in the .PDF document.

Saving and Checking In eConsent Forms

Saving to Vault dialog

Autosave

Autosave indicator

We save your changes automatically in the Veeva eConsent editor every 30 seconds. This occurs after you add text to a content block and click outside of it or after you otherwise edit, add, move, or remove items. You need to save to Vault only if you want to create a new version or share your draft in Vault.

If you leave or close the editor, you can return to it by reselecting the action to edit the eConsent form from the Actions menu (Edit eConsent in SiteVault).

Saving to Vault

If you want to save your changes and create a new version in Vault without ending your editing session, complete the steps below. Saving to Vault allows other staff to view the progress you’ve made. If another user needs to edit the form, you’ll need to check in the document from the editor instead.

  1. Select Save to Vault.
  2. If you want to include version comments, enter them in the Version Comments box.
  3. Select Save to Vault. A message is displayed over the Save to Vault and Check In buttons that indicates that your changes are being saved.

When the changes are successfully saved, the message is updated. You can select the linked version number to return to Vault, or you can select the X to close the notification.

Checking In to Vault

When you’re ready to check in your document, complete the steps below. When you check in the document, a new version is created, your editing session is ended, and the document is unlocked in Vault so others can edit it or it can be sent for review. Only one user can edit a document in the editor at a time.

  1. Select Check In.
  2. If you want to include version comments, enter them in the Version Comments box.
  3. Select Check In. When the check-in is complete, we redirect you to the new document version in Vault.

Troubleshooting the Veeva eConsent Editor

You may encounter the following issues while using the Veeva eConsent Editor:

Issue Resolution
HTML was removed from my content.

If you copied and pasted content into the editor and a message was displayed that HTML was removed, your content contained HTML that the editor doesn’t support. Extra characters from the removed HTML may still be present, so check the content you pasted to verify that it’s still correct.

The editor does not support the following items, and any HTML that contains them is removed:

  • Alerts
  • Cross-site scripting
  • External resources
  • Inline frames
  • Pasted media
  • Scripts

The following anchor tags may still be included in your content after the unsupported HTML was removed:

  • href
  • id
  • target
  • title

If you can see HTML tags in the editor, the participant will see them as well. For this reason, we recommend pasting in only rendered HTML and not raw HTML, as the raw HTML will still include the tags in the editor.

My document checkout was canceled.

If you were editing, saving, or checking in the document and a message was displayed that your checkout was canceled, you or an administrative user canceled your checkout in Vault.

Return to Vault to view the current version of the document and, if necessary, reenter the editor.

My editor login expired.

Your access to the editor is determined by whether you’re logged in to Vault. You remain logged in as long as you’re interacting with either Vault or the editor.

If you’re inactive in both Vault and the editor, we log you out of the editor. However, we autosave your content in the editor every 30 seconds. If you’re logged out, simply log in to Vault and reselect the action to edit the eConsent form from the Actions menu (Edit eConsent in SiteVault).

I can’t save to Vault or check in the document.

Follow the instructions in the error message displayed in the application. You won’t be able to save or check in the document if you’re logged out or if either Vault or the Veeva eConsent editor is experiencing issues. Try again later and contact Veeva support if the issue continues.