Info |
---|
You need to be well-versed with HTML to configure consent forms. The HTML files can be created by hand manually or using online editors like this. In future versions, we plan to give a UI-based editor within OpenSpecimen to create the consent forms. |
Introduction
Consent forms eConsent Forms are configured at a CP System level in HTML and contain it contains the following:
HTML text (Text formatting/Image source etc.)
Consent Statements
Custom fields (Text/Dropdowns/Signatures etc.)
Prerequisites
'Allowed File Types' setting
...
The consent form could have fields like consent witness, consent date, eSignaturese-signatures, etc. These fields are to be added in a custom form attached to the “Consent Document Custom Fields” level. A single form is maintained for consent custom fields across the system to avoid duplicating fields across CPs and making it easy for reporting.
...
The consent form is designed in HTML, since it gives us the flexibility of easy formatting. E.g. use of bullet points, use of text formatting like bold, underline, embed videos/photos, etc.
There are three sections in the consent form:
Formatted text
Header/Footer
Consent statements
Custom fields
...
Consent statement(s) can be added anywhere in the consent form. They can be displayed as a dropdown, radio-button, or checkbox.
For example:
...
Custom Fields
Details such as signature, date of signature, etc. that were defined in the custom form (step 2 in the “Prerequisites”) can be displayed as below in the consent form.
...
Examples of Consent Form
Here’s the HTML for the above consent document: The HTML document has a below example of a consent statement, custom fields, signature, and date.
View file |
---|
name | General Consent Form(English)- v1.10.html |
---|
|
Other Example
Expand |
---|
title | Examples to add the different types of custom fields in the consent document |
---|
|
The ‘Consent Date’ should display the default value as the current date and time. Ensure that the control type in the consent custom fields form is updated to ‘Date and Time’.
In the consent HTML, the code for the ‘Consent Date’ field needs to be updated as below: Code Block |
---|
| <div class="clearfix">
<div style="width: 45%; float: left; clear: left;">
<div class="col-xs-8 os-no-left-padding">
<os-date-picker name="consentDate" date <div user-input field="ectx.customFields.consentDate" default-current-date></os-date-picker>type="date-time">
</div> <div class="col-xs-4 os-no-left-padding"> <timepicker class="os-time-no-wheels" ng-model<os-date-picker name="consentDate" date="ectx.customFields.consentDate" show-meridian="false"></timepicker>
</div>default-current-date ng-disabled="1 != 0"></os-date-picker>
</div>
</div> |
The ‘os-date-picker’ sets the value to the current date and the time picker allows the display of the current timestamp. 2. Add consent statement with the default value set and hidden on the overview page Code Block |
---|
<div
consent-question="C0003">
<input type="hidden <div class="col-xs-4 os-no-left-padding">
<timepicker class="os-time-no-wheels" ng-model="ectx.statementscustomFields.C0003consentDate" ngshow-initmeridian="ectx.statements.C0003 = ectx.statements.C0003 || 'Y'">false" readonly-input="true"></timepicker>
</div> |
3. Add custom field radio button "I Agree/I do not agree" Image Removed Code Block |
---|
<div class="clearfix" style="padding: 8px 8px 8px 0px;">
<label class="radio-inline">
<input type="radio" name="iAgree" value="Yes" ng-model="ectx.customFields.iAgree" required>
<span>
<strong>I agree</strong> that you may contact me if there are results from the genetic research that may be relevant to my health.
</span>
</label>
<p></p>
<label class="radio-inline">
<input type="radio" name="iAgree" value="No" ng-model="ectx.customFields.iAgree" required>
<span>
<strong>I do not agree</strong> that you may contact me if there are results from the genetic research that may be relevant to my health.
</span>
</label>
<div os-field-error field="econsentForm.iAgree"></div>
</div> |
4. Add custom field text-box Image Removed Code Block |
---|
<div class="clearfix">
<div style="width: 70%;">
<label class="control-label">
<span>Print Name of Biobank Participant</span>
</label>
<textarea class="form-control" ng-model="ectx.customFields.participantName" rows="1" required></textarea>
</div>
</div> |
5. Add signature field Code Block |
---|
<div class="clearfix" style="padding: 8px 8px 8px 0px;">
<label class="control-label">
<span><strong>e-signature Biobank Participant(Mandatory)</strong></span>
</label>
<div>
<ec-signature name="signature" image="ectx.customFields.signature" required></ec-signature>
</div>
<div os-field-error field="econsentForm.signature"></div>
</div> |
6. Add date as a custom field with default current date and non-editable Code Block |
---|
<div class="clearfix">
<div style="width: 45%;">
<label class="control-label">
<span>Date</span>
</label>
<div class="clearfix">
<div class="col-xs-8 os-no-left-padding">
<os-date-picker name="consentDate" date="ectx.customFields.consentDate" default-current-date ng-disabled="1 != 0"></os-date-picker>
</div>
<div class="col-xs-4 os-no-left-padding">
<timepicker class="os-time-no-wheels" ng-model="ectx.customFields.consentDate" show-meridian="false" readonly-input="true"></timepicker>
</div>
</div>
<div os-field-error field="econsentForm.consentDate"></div>
</div>
</div> |
7. Add number custom field Code Block |
---|
| <div class="clearfix" style="padding: 8px 8px 8px 0px;">
<div style="width: 10%; float: left">
<label class="control-label">
<span>Patient Age</span>
</label>
<ec-number name="age"
ng-model="ectx.customFields.participantAgeWhenConsented"></ec-number>
</div>
</div> |
8. Add OpenSpecimen PV-dropdown as a custom field biohazard, race Code Block |
---|
| <div style="width: 33%"> </div>
<div os-field-error field="econsentForm.consentDate"></div>
</div>
</div> |
The ‘os-date-picker’ sets the value to the current date and the time picker allows the display of the current timestamp. 2. Add consent statement with the default value set and hidden on the overview page Code Block |
---|
<div consent-question="C0003">
<input type="hidden" ng-model="ectx.statements.C0003" ng-init="ectx.statements.C0003 = ectx.statements.C0003 || 'Y'">
</div> |
3. Add custom field radio button "I Agree/I do not agree" Image Added Code Block |
---|
<div class="clearfix" style="padding: 8px 8px 0px;#if(true)display: none;#end">
<div style="display: block; margin-bottom: 10px;">
<span>
<div user-input field="ectx.customFields.iAgree">
<input type="radio" name="iAgree" value="Yes" ng-model="ectx.customFields.iAgree"
ng-required="(ectx.statements.C0003=='N' || ectx.statements.C0003==null)">
<span>
<strong>I agree</strong> that you may contact me if there are results from the genetic research that may be relevant to my health.
</span>
</div>
</span>
</div>
<div style="display: block;">
<span>
<div user-input field="ectx.customFields.iAgree">
<input type="radio" name="iAgree" value="No" ng-model="ectx.customFields.iAgree"
ng-required="(ectx.statements.C0003=='N' || ectx.statements.C0003==null)">
<span>
<strong>I do not agree</strong> that you may contact me if there are results from the genetic research that may be relevant to my health.
</span>
</div>
</span>
</div>
<div os-field-error field="econsentForm.iAgree"></div>
</div> |
4. Add custom field text-box Image Added Code Block |
---|
<div>
<label class="control-label">
<span>Disease</span> </label><span>Print Name of <ec-select name="biohazard" ng-model="ectx.customFields.biohazard" multiple>Biobank Participant</span>
<custom-field>consentCustomFields.biohazard</custom-field></label>
</ec-select> </div>
<div style="width: 33%70%; float: left">
<div <labeluser-input classfield="control-labelectx.customFields.participantName">
<span>Race</span> </label><div>
<textarea <ec-selectclass="form-control" name="raceparticipantName"
ng-model="ectx.customFields.race">participantName" rows="1" required></textarea>
<pv>race</pv> </ec-select>div>
</div> |
9. Add custom field dropdown value with options Code Block |
---|
| <div style="width: 25%">
<select name="consentedAt" class="form-control" ng-model="ectx.customFields.consentedAt" >
<option value="Home">Home</option>
<option value="Work place">Work place</option>
<option value="Doctor's clinic">Doctor's clinic</option>
</select>
</div> |
10. Add print break in the consent document PDF: <ec-print-page-break></ec-print-page-break> is used to add the print break in the downloaded PDF. In the below example, the 'We may contact you….' line will be printed on the next page. Code Block |
---|
| <ol>
<li>
<u>You will be asked to donate a blood sample (approximately 3 tablespoons) and urine sample.</u> If these samples are not collected today, they may be collected at a future time when you have a blood draw ordered by your doctor or a separate appointment that is convenient for you. In some cases, we may ask you for a saliva (spit) or buccal (cheek swab) sample. We may also use blood, urine, or tissue samples collected as part of your clinical care now or in the future that would otherwise be thrown away.
</li>
<li>
<u>We will request information about you and your health. We will collect your name, address and other contact information.</u> We will use your electronic health records now and, in the future, to update your health information. We will store some of your health information, including your name, contact information, and medical history, in the Columbia Biobank database. Biobank staff will make a note that you are a participant in the biobank in your electronic health record.
</li>
<ec-print-page-break></ec-print-page-break>
<li>
<u>We may contact you in the future.</u> We may ask you to complete additional questionnaires about your health or contact you to get additional information and ask if you are interested in joining other research studies. We may also contact you for another biological sample. We may ask for additional samples in order to study changes in your sample over time, or because we used up the first sample you provided. If we ask you for another sample, you may always say no.
</li>
<li>
<u>Your coded samples, health information, and the research results may be shared with the scientific research community.</u> A science and ethics committee will review each request for data access. We will not give researchers outside of Columbia University Irving Medical Center-NewYork Presbyterian your name or any other information that could directly identify you.
</li>
</ol> |
11. Show/hide field/section based on the other field selection Syntax: Needs to add the 'ng-show' tag to implement the show/hide logic Code Block |
---|
| <div ng-show="ectx.statements.C0003=='N'" >
<p> .... </p>
<label class="radio-inline">
......
</label>
</div> |
Example: When a user clicks on the “I agree to participate" option, the below section highlighted in red is enabled. Image RemovedExample HTML for the above example: View file |
---|
name | Participant English 11 Nov - v1.0 (1).html |
---|
|
12. Mark consent statement non-editable with default selected. Code Block |
---|
| <div class="clearfix" consent-question="M001">
<div os-field-error field="econsentForm.participantName"> </div>
</div> |
5. Add signature field Code Block |
---|
<div style="width: 70%; float: left">
<div>
<label class="control-label">
<span>
<strong>Signature of Biobank Participant</strong>
</span>
</label>
</div>
<div user-input field="ectx.customFields.signature" type="signature">
<ec-signature name="signature" image="ectx.customFields.signature" ng-required="(ectx.customFields.signatureAuthRep==null && (ectx.statements.C0003=='N' || ectx.statements.C0003==null))">
</ec-signature>
</div>
<div os-field-error field="econsentForm.signature"> </div>
</div> |
6. Add date as a custom field with default current date and non-editable Code Block |
---|
<div style="float: left; clear: left;">
<label style="float: left; clear: left;">
<strong>Today's Date</strong>
</label>
</div>
<div class="clearfix">
<div style="width: 45%; float: left; clear: left;">
<div class="col-xs-8 os-no-left-padding">
<div user-input field="ectx.customFields.consentDate" type="date-time">
<os-date-picker name="consentDate" date="ectx.customFields.consentDate" default-current-date ng-disabled="1 != 0"></os-date-picker>
</div>
</div>
<div class="col-xs-4 os-no-left-padding">
<timepicker class="os-time-no-wheels" ng-model="ectx.customFields.consentDate" show-meridian="false" readonly-input="true"></timepicker>
</div>
<div os-field-error field="econsentForm.consentDate"></div>
</div>
</div> |
7. Add number custom field Code Block |
---|
| <div style="margin-bottom: 20px;">
<label style="display: block;">Height (centimetres)</label>
<div style="width: 250px;" user-input field="ectx.customFields.height_centimetres">
<input style="padding: 8px; border: 1px solid #ddd; border-radius: 4px; width: 100%" name="height_centimetres" ng-model="ectx.customFields.height_centimetres" required
<label classng-pattern="control-label/^[1-9][0-9]*$/">
<input name="M001" type="checkbox" ng-true-value="'Y'" ng-false-value="'N'" ng-disabled="1 != 0" ng-model="ectx.statements.M001" ng-init="ectx.statements.M001 = 'Y'"> </label> <div os-field-error field="econsentForm.height_centimetres"> </div>
</div>
<span>I consented for cancer study</span>
</div> |
13. Default custom value with non-editable8. Add OpenSpecimen PV-dropdown as a custom field site dropdown Code Block |
---|
| <input type="radio" name="health_info_described_in" value="both" ng-model <div style="margin-bottom: 20px;">
<label style="display: block;">Collection Center</label>
<div user-input field="ectx.customFields.healthpreferred_infocollection_described_insite"
ng-init="ectx.customFields.health_info_described_in = 'both'" ng-disabled="1 != 0"> |
14. Make field mandatory based on other field value Eg:1 - Make Guardian name custom field mandatory for Male patients. Code Block |
---|
| <div>
<textarea class="form-control" ng-model="ectx.customFields.parentGuardianName" rows="1" ng-required="cpr.participant.gender == 'Male'"> </textarea>
</div>
|
Eg:2 - Make Guardian name custom field mandatory when site='Stanford Hospital ' Code Block |
---|
| <div>
<textarea class="form-controltype="user">
<div style="display: inline-block; margin-right: 20px;">
<os-sites name="preferred_collection_site" ng-model="ectx.customFields.parentGuardianName" rows="1" ng-required="cpr.registrationSite == 'Stanford Hospital''"> </textarea>
</div>
|
Eg:3 - Make Participant Signature(signature ) mandatory if Gurgdian signature(signatureAuthRep ) is not entered Code Block |
---|
| <div>
<ec-signature name="signature" image="ectx.customFields.signature" ng-required="ectx.customFields.signatureAuthRep==null"></ec-signature>preferred_collection_site" ></os-sites>
</div>
<div os-field-error field="econsentForm.preferred_collection_site"> </div>
</div>
</div>
|
159. Add File Type Controlcustom field dropdown value with options width33%float:left;padding-left:16px;">class="control-labelstyle="display: block;">Visit Center</label>
<div user-input field="ectx.customFields.visit_center">
| <span>Signed Form</span> <div style="display: inline-block; margin-right: 20px;">
| </label> <div> file-uploader fileselect ng-model="ectx.customFields. | signedConsentFile"></ec-file-uploader>
</div>
</div>
16. Conditional field mandatory (File Type Field) Eg, The consent form has the participant’s signature, parent’s signature, and paper consent file (File type). Out of three fields, one of them needs to fill. Code Block |
---|
<div style="width: 45%; float: left;">
<label class="control-label">
<span>Upload Paper Consent</span></label>
<div>
<ec-file-uploader file="ectx.customFields.signedConsentFile" name="signedConsentFile" ng-required="(ectx.customFields.signature==null && ectx.customFields.signatureAuthRep ==null)"></ec-file-uploader>
</div>
<div visit_center" required>
<custom-field>consent_custom_fields.visit_center</custom-field>
</ec-select>
</div>
<div os-field-error field="econsentForm.signedConsentFile"></div>
visit_center"> </div>
</div>
</div> |
17. Configure headers and footer for 10. Add print break in the consent document print file: To configure this, you need to set the print template in OpenSpecimen settings as below. You can set the logo, stamp on headers, and footer, including page numbers. Image RemovedExample: PDF Image RemovedExample HTML code for the above document:PDF: <ec-print-page-break></ec-print-page-break> is used to add the print break in the downloaded PDF. In the below example, the 'We may contact you….' line will be printed on the next page. Code Block |
---|
| <div> <ol>
<ec-page-header>
<div class="clearfix" style="border-bottom: 1px solid #ddd; position:relative;height: 70px; background: "#fff"; display: inline-block; width: 100%; padding: 8px 8px;">
<div style="float: left;">
<img style="position: absolute; z-index: 1000; height: 60px; width: 450px;" src="https://test.openspecimen.org/logo/RS2133_RS460_Columbia_CUIMC_H_B_RGB_A.png">
</div>
</div>
</ec-page-header>
<ec-page-footer>
<div class="clearfix" style="border-top: 1px solid #ddd; position:relative;height: 70px; display: inline-block; width: 100%; padding: 8px 8px;">
<div style="float: left;">
<img style="position: absolute; z-index: 1000; height: 60px; width: 300px;" src="https://test.openspecimen.org/logo/cumc_stamp.png">
</div>
<div style="float: right; color: #666;">
<span>- {{currentPage}} of {{totalPages}} - </span>
</div>
</div>
</ec-page-footer>
</div>
|
|
Upload Consent Document in OpenSpecimen
Users can upload consent documents in the Consents tab and can access those in the collection protocol. From v9.0, OpenSpecimen will allow using the same consent form in different CPs. The user who has. the access to the Consent can be uploaded or updated consent document in OpenSpecimen.
Expand |
---|
title | Upload Consent Document in OpenSpecimen |
---|
|
Login to the OpenSpecimen → Click on Consent Card Click on View Documents Image RemovedClick on Add and provide the Title and Revision details and upload the HTML consent form you created Image Removed
|
Adding the Consent Form to a CP
Once the HTML is ready, you can upload it for a CP using the below steps.
Expand |
---|
title | Adding a consent document to the CP |
---|
|
From the navigation menu, go to the Collection Protocols list page > CP Overview > Consents tab
Image RemovedThe user is redirected to the list page of the CP level consents. Click on “Add”.
Image RemovedSelect the Consent Document from the list and click on Add
Image RemovedIt will be visible at the end of the consent statements in the list view.
|
Updating a Consent Form
The title, version, and HTML content can be updated. It can be done by clicking the “Edit” icon from the consents list page.
From v9.1, OpenSpecimen will not allow updating the consent document if that is used with any patient.
Expand |
---|
title | Steps to edit eConsent document |
---|
|
Navigates to the Home page → Click on Consent Card → View Documents Click on the “Update” icon beside the consent document(As highlighted below)
Image RemovedIf you want to update the title and version, just update the fields and click update. No need to re-upload the document. In case an updated document is to be uploaded, leave the other fields unchanged. Upload the document and click “Update”.
|
Consent Revision (Versioning)
A consent document can have multiple versions. When a new version is added, the new version is available for old and new participants. The data collected for older version remains in the database and is available for querying.
Expand |
---|
title | Steps to add a new version of the document |
---|
|
Navigate to the Home → Consents → View Documents → Click on the "+” icon
Image RemovedEnter the version of the consent document. Upload the document and click “Add”.
Image Removed
|
Archiving Consent Form
If a version of a consent form is not needed, it can be archived. Once archived, the consent document is not available anymore for consent response collection. However, if consent is already collected for that version, then it is available for viewing, editing, and reporting.
From v9.0, OpenSpecimen allows archiving the document at the system level and CP level. If the document is archived at the system level, the user won't be able to add that in new collection protocols, but if that document is already used in other CP will work without affecting anything.
Users also allow to Archive the document in the collection protocol, and users won't be able to collect any responses for new patients.
System Level Archive Option:
Navigates to Home → Consent → View Documents
Click on the Archive option
Image Removed
CP Level Archive Option:
Go to the Collection Protocol Overview Page → Consents tab
...
Download Consent
The consent form’s HTML file can be downloaded and used to edit the form or upload it to another instance or another CP. This saves the re-work of designing the document from scratch.
Navigate to Home → Consent Card → View Documents → Click on the Download button below
Image Removed
Sort Consents
The order of consent documents can be changed using the “Sort” option. If no order is specified, the consent documents will appear in the order that they were added.
Expand |
---|
title | Steps to re-order the consent documents |
---|
|
Go to CP Overview > Consents > Sort
Image RemovedEnter the sort order starting from 1. Click “Update”.
Image RemovedWhile choosing to add the consents for a participant, these documents appear in the same order as specified. Image Removed
|
Audit Trails for consent document
You can check the audit trails for the consent document. The audit trails show who updated the consent document and when.
Expand |
---|
title | Click here to see the screenshot |
---|
|
Navigate to Home Page → Consent Card → View Documents –> Click on the Audit Trail button Image RemovedImage Removed |
Consents Digests
You can add multiple users to get the daily digest email about eConsents. The digest email has the information of the patient who consented on that day or who updated the consent document on that day for that patient along with the date. Also, you can configure when to send the digest email, like Hourly, Monthy, Daily, On Demand etc.
Expand |
---|
title | Click here to see screenshots... |
---|
|
Digests Settings: Image RemovedDigests Email Example: Image RemovedDigest email configuration: The user user should have the super admin privilege to change the digest job settings as below. Go to Home--> Jobs Search For “Consent response" as below Image Removed. Click on three dots and edit Setup the job based on your requirement like daily, Hourly, etc Image Removed <li>
<u>You will be asked to donate a blood sample (approximately 3 tablespoons) and urine sample.</u> If these samples are not collected today, they may be collected at a future time when you have a blood draw ordered by your doctor or a separate appointment that is convenient for you. In some cases, we may ask you for a saliva (spit) or buccal (cheek swab) sample. We may also use blood, urine, or tissue samples collected as part of your clinical care now or in the future that would otherwise be thrown away.
</li>
<li>
<u>We will request information about you and your health. We will collect your name, address and other contact information.</u> We will use your electronic health records now and, in the future, to update your health information. We will store some of your health information, including your name, contact information, and medical history, in the Columbia Biobank database. Biobank staff will make a note that you are a participant in the biobank in your electronic health record.
</li>
<ec-print-page-break></ec-print-page-break>
<li>
<u>We may contact you in the future.</u> We may ask you to complete additional questionnaires about your health or contact you to get additional information and ask if you are interested in joining other research studies. We may also contact you for another biological sample. We may ask for additional samples in order to study changes in your sample over time, or because we used up the first sample you provided. If we ask you for another sample, you may always say no.
</li>
<li>
<u>Your coded samples, health information, and the research results may be shared with the scientific research community.</u> A science and ethics committee will review each request for data access. We will not give researchers outside of Columbia University Irving Medical Center-NewYork Presbyterian your name or any other information that could directly identify you.
</li>
</ol> |
11. Show/hide field/section based on the other field selection Syntax: Needs to add the 'ng-show' tag to implement the show/hide logic Code Block |
---|
| <div ng-show="ectx.statements.C0003=='N'" >
<p> .... </p>
<label class="radio-inline">
......
</label>
</div> |
Example: When a user clicks on the “I agree to participate" option, the below section highlighted in red is enabled. Image AddedExample HTML for the above example: View file |
---|
name | Participant English 11 Nov - v1.0 (1).html |
---|
|
12. Mark consent statement non-editable with default selected. Code Block |
---|
| <div class="clearfix" consent-question="M001">
<label class="control-label">
<input name="M001" type="checkbox" ng-true-value="'Y'" ng-false-value="'N'" ng-disabled="1 != 0" ng-model="ectx.statements.M001" ng-init="ectx.statements.M001 = 'Y'"> </label>
<span>I consented for cancer study</span>
</div> |
13. Mark consent statement editable with default selected. Code Block |
---|
| <div class="clearfix" consent-question="M001">
<label class="control-label">
<input name="M001" type="checkbox" ng-true-value="'Y'" ng-false-value="'N'" ng-model="ectx.statements.M001" ng-init="ectx.statements.M001 = ectx.statements.M001 || 'Y'">
<span>I consented for cancer study</span>
</div> |
14. Default custom value with non-editable Code Block |
---|
| <input type="radio" name="health_info_described_in" value="both" ng-model="ectx.customFields.health_info_described_in"
ng-init="ectx.customFields.health_info_described_in = 'both'" ng-disabled="1 != 0"> |
15. Make field mandatory based on other field value Eg:1 - Make Guardian name custom field mandatory for Male patients. Code Block |
---|
| <div>
<textarea class="form-control" ng-model="ectx.customFields.parentGuardianName" rows="1" ng-required="cpr.participant.gender == 'Male'"> </textarea>
</div>
|
Eg:2 - Make Guardian name custom field mandatory when site='Stanford Hospital ' Code Block |
---|
| <div>
<textarea class="form-control" ng-model="ectx.customFields.parentGuardianName" rows="1" ng-required="cpr.registrationSite == 'Stanford Hospital''"> </textarea>
</div>
|
Eg:3 - Make Participant Signature(signature ) mandatory if Guardian signature(signatureAuthRep ) is not entered Code Block |
---|
| <div>
<ec-signature name="signature" image="ectx.customFields.signature" ng-required="ectx.customFields.signatureAuthRep==null"></ec-signature>
</div>
|
16. Add File Type Control Code Block |
---|
| <div style="margin-bottom: 20px;">
<label style="display: block;">Photo Identity</label>
<div user-input field="ectx.customFields.photo_identity" type="file">
<div style="display: inline-block; margin-right: 20px;">
<ec-file-uploader name="photo_identity" file="ectx.customFields.photo_identity" required></ec-file-uploader>
</div>
<div os-field-error field="econsentForm.photo_identity"> </div>
</div>
</div> |
17. Conditional field mandatory (File Type Field) Eg, The consent form has the participant’s signature, parent’s signature, and paper consent file (File type). Out of three fields, one of them needs to fill. Code Block |
---|
<div style="width: 45%; float: left;">
<label class="control-label">
<span>Upload Paper Consent</span></label>
<div user-input field="ectx.customFields.signedConsentFile" type="file">
<div>
<ec-file-uploader file="ectx.customFields.signedConsentFile" name="signedConsentFile" ng-required="(ectx.customFields.signature==null && ectx.customFields.signatureAuthRep ==null)"></ec-file-uploader>
</div>
</div>
<div os-field-error field="econsentForm.signedConsentFile"></div>
</div> |
18. Change the caption for the Next and Previous button Code Block |
---|
<ec-page-nav-buttons>
<next>Siguiente</next>
<previous>Página Anterior</previous>
<save>Guardar</save>
<cancel>Cancelar</cancel>
</ec-page-nav-buttons> | Image Added19. Add Participant’s Information in the Consent document: Below is an example to display/print First Name and Last Name Code Block |
---|
| <div style="position:relative; white-space: nowrap; padding: 20px 0px 0px 0px;">
<!-- #if (1 == 0) --> // This section will display the information in UI
<table style="width: 80%; border: 2px solid black; margin-left: auto;">
<tr>
<td>
<strong>Last Name:</strong> {{cpr.participant.lastName}}
</td>
<td>
<strong>First Name:</strong> {{cpr.participant.firstName}}
</td>
</tr>
</table>
<!-- #else --> // This section will be used to print the information while printing
<table style="width: 80%; border: 2px solid black; margin-left: auto;" ng-if="1 == 0">
<tr>
<td>
<strong>Last Name:</strong> $cpr.participant.lastName
</td>
<td>
<strong>First Name:</strong> $cpr.participant.firstName
</td>
</tr>
</table>
<!-- #end -->
</div> | Image Added20. Configure headers and footer for the consent document print file: To configure this, you need to set the print template in OpenSpecimen settings as below. You can set the logo, stamp on headers, and footer, including page numbers. Image AddedExample: PDF Image AddedExample HTML code for the above document: Code Block |
---|
| <ec-print-template>
<div>
<ec-page-header>
<div class="clearfix" style="border-bottom: 1px solid #ddd; position:relative;height: 70px; background: #fff; display: inline-block; width: 100%; padding: 8px 8px;">
<div style="float: left;">
<img style="position: absolute; z-index: 1000; height: 60px; width: 450px;" src="https://bb.cuimc.columbia.edu/os-test/logo/RS2133_RS460_Columbia_CUIMC_H_B_RGB_A.png">
</div>
</div>
</ec-page-header>
<ec-page-footer>
<table style="border-top: 2px solid #ddd; position:relative;height: 70px; display: inline-block; width: 100%; padding: 8px 8px;">
<tbody>
<tr>
<td style="text-align: left;">
<img style="height: 70px; width: 300px;" src="https://bb.cuimc.columbia.edu/os-test/logo/cumc_stamp_hiccc.png">
</td>
<td style="text-align: right; padding: 10px;">
<div id="osPageCounter" style="position: absolute; bottom: 12px; right: 5px;"> </div>
</td>
</tr>
</tbody>
</table>
</ec-page-footer>
</div>
</ec-print-template>
|
|
Upload Consent Document in OpenSpecimen
Users can upload consent documents in the Consents tab and can access those in the collection protocol. From v9.0, OpenSpecimen will allow using the same consent form in different CPs. The user who has. the access to the Consent can be uploaded or updated consent document in OpenSpecimen.
Expand |
---|
title | Upload Consent Document in OpenSpecimen |
---|
|
Login to the OpenSpecimen → Click on Consent Card Click on View Documents Image AddedClick on Add and provide the Title and Revision details and upload the HTML consent form you created Image Added |
Adding the Consent Document Form to a CP
Once the HTML is ready, you can upload it for a CP using the below steps.
Expand |
---|
title | Adding a consent document to the CP |
---|
|
From the navigation menu, go to the Collection Protocols list page > CP Overview > Consents tab
Image AddedThe user is redirected to the list page of the CP level consents. Click on “Add”.
Image AddedSelect the Consent Document from the list and click on Add
Image AddedIt will be visible at the end of the consent statements in the list view.
|
Updating a Consent Form
The title, version, and HTML content can be updated. It can be done by clicking the “Edit” icon from the consents list page.
From v9.1, OpenSpecimen will not allow updating the consent document if that is used with any patient.
Expand |
---|
title | Steps to edit eConsent document |
---|
|
Navigates to the Home page → Click on Consent Card → View Documents Click on the “Update” icon beside the consent document(As highlighted below)
Image AddedIf you want to update the title and version, just update the fields and click update. No need to re-upload the document. In case an updated document is to be uploaded, leave the other fields unchanged. Upload the document and click “Update”.
|
Consent Revision (Versioning)
A consent document can have multiple versions. When a new version is added, the new version is available for old and new participants. The data collected for older version remains in the database and is available for querying.
Expand |
---|
title | Steps to add a new version of the document |
---|
|
Navigate to the Home → Consents → View Documents → Click on the "+” icon
Image AddedEnter the version of the consent document. Upload the document and click “Add”.
Image Added
|
Archiving Consent Form
If a version of a consent form is not needed, it can be archived. Once archived, the consent document is not available any more for consent response collection. However, if consent is already collected for that version, then it is available for viewing, editing, and reporting.
From v9.0, OpenSpecimen allows archiving the document at the system level and CP level. If the document is archived at the system level, the user won't be able to add that in new collection protocols, but if that document is already used in other CP will work without affecting anything.
Users also allow archiving the document in the collection protocol, and users won't be able to collect any responses for new patients.
System-Level Archive Option:
Navigates to Home → Consent → View Documents
Click on the Archive option
Image Added
CP Level Archive Option:
Go to the Collection Protocol Overview Page → Consents tab
...
Download Consent
The consent form’s HTML file can be downloaded and used to edit the form or upload it to another instance or another CP. This saves the re-work of designing the document from scratch.
Navigate to Home → Consent Card → View Documents → Click on the Download button below
Image Added
Sort Consents
The order of consent documents can be changed using the “Sort” option. If no order is specified, the consent documents will appear in the order that they were added.
Expand |
---|
title | Steps to re-order the consent documents |
---|
|
Go to CP Overview > Consents > Sort
Image AddedEnter the sort order starting from 1. Click “Update”.
Image AddedWhile choosing to add the consents for a participant, these documents appear in the same order as specified. Image Added
|
Audit Trails for consent document
You can check the audit trails for the consent document. The audit trails show who updated the consent document and when.
Expand |
---|
title | Click here to see the screenshot |
---|
|
Navigate to Home Page → Consent Card → View Documents –> Click on the Audit Trail button Image AddedImage Added |
Consents Validation
One or more validation rules can be added to ensure that specimens cannot be collected before the participant has consented. These validation rules are defined at a CP level.
To define validation rules:
Go to the CP Overview > Consents > Validations
...
Click on “Add”.
Field | Description | Options |
---|
Statement | Coded consent statements | All the consent statements defined for the CP |
Match | Condition for the consent response | is is not is one of is not one of
|
Response | Response of the consent statement | Any valid consent response. |
...
The above rule is to allow collection when the response for C0001 is “Yes”. Click on “Add”.
Follow the above steps to add more than one consent.
In the validations list page, there is another match for multiple consents.
...
ALL: It allows the collection of visits/specimens when ALL rules are true. Works like “AND” in the query.
ANY: It allows the collection of visit/specimens when ANY one of the rules is true. Works like “OR” in the query.
ADVANCED: This is used for creating a combination of rules using ‘and’ and ‘or’.
For example,
The below will be true if either (consent 1 is yes AND consent 2 is yes) OR consent 3 is yes.
...
The expression in the box defines the rule which allows collection. It can be edited by clicking on “Edit”.
Consents Digests
OpenSpecimen provides two options to receive the consent digest, which described below. User will get receive the participants and consent document information who consented on that day(within 24hrs).
Site based Recipients? → No, The user has to specify a list of users and those users will get the consent digest email.
Site based Recipients? → Yes, The user has to specify a sites and user groups and those users from groups will receive the digest emails
What information is present in Digest Email?
The digest email has the information on the patient who consented on that day(24hrs) or who updated the consent document on that day for that patient along with the date. Furthermore, you can configure when to send the digest email, like Hourly, Monthly, Daily, On Demand etc.
Expand |
---|
title | Click here to see screenshots... |
---|
|
Digests Settings: Site based Recipients? → Yes Image AddedDigests Settings: Site based Recipients? → No Image AddedDigests Email Example: Image AddedDigest email configuration: The user should have the super admin privilege to change the digest job settings as below. Navigates to Home → Jobs Search For “Consent response” as below Image AddedClick on three dots and edit Set up the job based on your requirements like daily, Hourly, etc Image Added
|
Reuse Participant Consents
At many centers, participant consents are registered or collected only once as per the IRB guidelines and reused in multiple studies.
From v10.3, A new setting has been added to the CP consents tab, this allows consent responses to be shared between multiple collection protocols, streamlining the consent management process.
Expand |
---|
title | Click here to see screenshots... |
---|
|
How to copy consents from another CP. Go to Collection Protocol Overview Page. Click on the Consents Tab. Click on the ⚙️ Set button and choose the CP from which you want to copy consents. Image Added |
Points to remember :
No new consent tiers or documents can be added in the receiver CP.
Consent responses cannot be added/updated via receiver CP registrations.
The participants' consent responses can be seen in the read-only mode in the receiver CPs with the option to print the consent document.
Since the consents for participants is copied to receiver CP, openspecimen users can distribute specimens collected for the receiver CP.