Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
note
Info

NOTE: This article should only be used in order to apply a version update to modify your already active E-Consent survey in Production in order to apply version updates as necessary. . If you are updating your consent version from e-consent 1.0 > 2.0 please follow: E-Consent Transition Guide

If you are looking to create a e-consent survey for the very first time, see: E-Consent Initial Setup

Warning

Never delete (old) consent instruments, this will result in lost data!

Instead, you can ‘deactivate’ the old survey instrument which will keep you data intact, but ensures said survey is no longer accessible to participants. This is completed using ‘survey settings’, view the below process for details.

...

Initial Considerations

Design changes after the Production phase are discouraged but sometimes needed. If When a new version of the consent is needed, it is critical to modify the project in such a way as to not lose existing data nor compromise the audit trail of the REDCap e-Consent.

There are two ways to implement new versions of e-consent:

  1. Creation of new instruments

  2. Branching Logic

Expand the process you wish to review below

The Process

Updating E-Consent using new instrument creation:

Expand

Modifying the e-consent via new instrument:

  1. Since your project is in Production, you’ll need navigate to your online designer and enter Draft Mode

    Image Removed
  2. Copy your existing E-consent form to quickly copy over the bulk of your E-Consent

    Image Removed
  3. Move the E-consent (version 2) instrument under the now expired (version 1) instrument

    Image Removed

     

  4. Apply needed updates to new version (2) such as…

    1. Upload IRB stamp with new expiration date

    2. Apply any consent field/verbiage updates required

    3. All Consent component should be included in your new version

  5. Submit your drafted changes for review to a REDCap Administrator

  6. STOP HERE UNTIL YOUR CHANGE REQUEST HAS BEEN APPROVED

Once the requested changes have been approved…

  1. Enable E-Consent Version 2 as a survey

  2. Open E-Consent Version 2 survey settings to perform the below:

    1. Update the copied Survey Title:

      1. This is what will appear at the top of the participants survey page, edit as needed.

      2. Note, the survey title (red) and the instrument name (blue) can be different.

        Image Removed
    2. Setup the E-consent Framework

      1. Update version number from 1 > 2 (you do not have to use the number 2, but the value listed MUST be different from the first version). Best practice would include version number and IRB expiration date.

        Image Removed

         

    3. CRITICAL STEP: in addition to updating the version number, you also must ensure the framework is pulling data from the new fields in the new consent version (2) for the below inputs:

      1. First name (v2)

      2. Last Name (v2)

      3. DOB (v2)

      4. Signature (v2)

        Image Removed

  3. Next you need to ensure all appopriate user(s) in the project now have access to view the new form. By default when a new form is added, it defaults to ‘NO ACCESS’ to all users as a safeguard, to ensure you are able to update the framework settings as shown above BEFORE collecting new data.

    1. Update user rights to access the new form

    2. Adjust any operational settings you project may use such as survey queues, ASI’s or form display logic to use the new form.

    3. Deactivate the OLD consent:

The survey itself can be switched from active > ‘Survey Offline’ in survey settings, which ensures respondents will not be able to take the survey, even if mistakenly triggered!

Image Removed

Updating E-Consent using Branching Logic:

...

using branching logic:

...

Keep the existing public survey instrument as the first instrument in the project

...

...

Create new fields for each updated section of the consent.

  1. Updated fields should sit directly under the original field

Create a field in the public survey to denote Consent Version.

...

Use Action tags to ensure that only the current version of the e-consent is selected.

Use the @Default to ensure only the most current version is presented and @HIDDEN SURVEY)

...

Image Removed

...

Use of branching logic makes the new fields visible only when the appropriate current version of the e-consent is selected.

...

...

Open survey settings to preform the below updates:

  1. Update version number from 1 > 2 (you do not have to use the number 2, but the value listed MUST be different from the first version). Best practice would include version number and IRB expiration date.

    Image Removed

     

  2. Below is an example of the issue that occurs if you do NOT update your version number:

    1. participant #3 actually filled out Version 2 but because the survey settings were not updated, the accurate version is not shown in the PDF file display. (However if you open the PDF it will be second version signed by the participant)
       

      Image Removed

...

After saving your survey settings, the next participant consented will accurately reflect consent version

...

...

E-consent Survey: consent is signed, reviewed, and submitted within the e-consent framework.

...

When you have multiple, separate, consent survey(s) in your project, each survey instrument will have it’s own unique set-up options as shown below for an ICF & Assent and Parental Permission Surveys.

...

How to version and update e-consent document:

Panel
panelIconIdatlassian-warning
panelIcon:warning:
bgColor#FFEBE6

IMPORTANT NOTICE

  • Upon clicking the "Add new consent form" button (in step 4e) the new consent form will GO LIVE IMMEDIATELY within your project and cannot be un-done.

  • If an error is made, correct by adding a new version with the correct file/settings.

    • For example, let’s say you were at version 2.0 but uploaded the wrong document, you would update to 2.1 or whatever version number you see fit with the correct document.

  1. Navigate to the ‘online designer’ page

  2. Rename your instrument to include the updated expiration date.

    1. To do so enter ‘draft mode' > ‘rename’ instrument > then 'submit changes for review’

    2. If your title doesn’t include an expiration date, we suggest adding it as a visual reminder to upload your new version when the time comes.

    3. Review the new version document against the document currently in your project to identify if any additional questions need added into the survey instrument.

      1. Add new fields if applicable

    4. Click ‘Submit Changes for review’

    5. Screen Shot 2024-10-21 at 2.51.47 PM.pngImage Added

  3. Navigate to e-consent framework feature via the ‘online designer’ page

    1. Click ‘+Add Consent Form’ for the applicable survey

      Screen Shot 2024-10-17 at 9.33.14 AM.pngImage Added

    2. Input new version number

    3. Choose new PDF file

    4. Verify updated inputs are correct

      1. Make sure the file selected is correct before submitting

        Screen Shot 2024-10-17 at 9.34.39 AM.pngImage Added

    5. After verifying the desired version and correct file have been input, click ‘Add new consent form’

  4. Consent version update is now live and complete!

Old versions of consent forms can be viewed by selecting “View all versions”

...