...
You will only be able to see those custom form levels for which you can create associations.
...
The CP-specific forms such as registration, specimen, and visit level forms can be attached to one or multiple collection protocols. Also, the User related forms such as user form and user profile form can be attached to one or multiple institutes.
...
Expand |
---|
title | Click to view the steps to attach the form at different levels |
---|
|
Select 'Forms' from the navigation menu or the home screen. Navigate to the form overview page and click on 'Associations'
![Attach1.png](https://openspecimen.atlassian.net/wiki/download/thumbnails/1767473311/Attach1.png?version=6&modificationDate=1723859458362&cacheVersion=1&api=v2&width=1171)
Click on 'Add'
![Attach2.png](https://openspecimen.atlassian.net/wiki/download/thumbnails/1767473311/Attach2.png?version=6&modificationDate=1723859477363&cacheVersion=1&api=v2&width=1171)
Select the level from the dropdown and click on 'Add'
![Attach3.png](https://openspecimen.atlassian.net/wiki/download/thumbnails/1767473311/Attach3.png?version=3&modificationDate=1723858839732&cacheVersion=1&api=v2&width=1171) Select the CP-specific level, e.g., registration, specimen, or visit form and select a specific CP
![attach first after4.png](https://openspecimen.atlassian.net/wiki/download/thumbnails/1767473311/attach%20first%20after4.png?version=2&modificationDate=1723632913116&cacheVersion=1&api=v2&width=953)
Check the 'All Current and Future Collection Protocols' checkbox to link the form with all protocols in the system.
![Attach second after 4.png](https://openspecimen.atlassian.net/wiki/download/thumbnails/1767473311/Attach%20second%20after%204.png?version=2&modificationDate=1723632057354&cacheVersion=1&api=v2&width=1171) If you want to link it to more than one Collection Protocol, click in the collection protocol box and select one or more collection protocols to which the form has to be linked.
In the case of custom fields (for example, forms attached at Distribution Protocol Custom Fields, Container Custom Fields, etc.), it will get attached to all distribution protocols or containers across the system.
![Attachafter4.png](https://openspecimen.atlassian.net/wiki/download/thumbnails/1767473311/Attachafter4.png?version=1&modificationDate=1722822254305&cacheVersion=1&api=v2&width=1195) CP custom field | Container custom filed | DP requirement custom field | DP custom field | Participant form | Project custom field | Registration custom field | Service request custom form | Site custom field | Specimen array event | Specimen slide event | User profile form |
|
...
The forms attached at levels such as participant, visit, or specimen level will appear as a separate form
Expand |
---|
Level | Description |
---|
Participant Forms | Forms linked at the participant level will be available under all the CPs. Data entered at the 'Participant' level will be available under all CPs the participant is registered to. E.g., If P1 is registered under CP1 and CP2, 'Participant Contact Details' entered for P1 under CP1 will also be available under CP2. Forms added at this level will be available under the forms tab for that participant.
| Registration Forms | For CP-specific participant forms. E.g., 'Smoking history', which might only be required under Lung Cancer Protocol. Forms added at this level will be available under the forms tab on the participant form page. | Specimen Array Event | To add custom fields to the 'add event page' of the array. Multiple forms can be attached at this level. While adding an event, click the dropdown button in the event field to select the form. | Specimen Event | Add ‘custom events’ to describe different stages of a specimen life cycle, e.g., Nano-drop event. Refer to the wiki page for more details. | Specimen Forms | Forms linked to this level will be available under the forms tab of any collected specimens of the attached CP. | Specimen Slide Event | To add custom fields on the add event page for the slide. Multiple forms can be attached at this level. While adding an event, click the dropdown button in the event field to select the form. | User Forms (New in v8.0) | To add forms at the ‘User’ level. The forms can be added to capture training records, and so on. Refer to the wiki page for more details. | Visit Forms | Forms linked to this level will be available under the forms tab of any occurred visit of the attached CP. |
|
...
Attachment of Forms as Custom Fields
...
The forms attached at custom field level, e.g., specimen custom fields or container custom fields, would appear on the main data entry screen.
Expand |
---|
Level | Description |
---|
Collection Protocol Custom fields | To add custom fields on the ‘create collection protocol"’page. E.g., 'IRB document', 'CTRI number.' | Container Custom Fields | To add custom fields on the ‘create container page’. E.g., 'Vendor name.' | DP Requirements Custom Fields | To add custom fields on the ‘create DP requirements page’. E.g., 'Specimen quality.' | Distribution Protocol Custom Fields | To add custom fields on the create distribution protocol page. E.g. 'Grant Number' | Order Custom Fields | The forms can not be attached using 'Association' option from the form page. It can be attached either at the system level or the Distribution Protocol level. Refer to Adding custom fields to Order level for more details. | Project Custom Fields | To add custom fields on the ‘create new project page’. E.g., Instructions | Registration Custom Fields | To add custom fields on the ‘participant registration page’. E.g.'Marital Status', 'Age' etc. | Service Request Custom Fields | To add custom fields to the ‘create request page’ of a project. E.g., Requestor Notes | Site Custom Fields | To add custom fields to ‘create site page’. E.g., 'Site phone number'. | Specimen Array Event | To add custom fields to the ‘add event page’ of the array. Multiple forms can be attached at this level. While adding an event, click the dropdown button in the event field to select the form. | Specimen Custom Fields | To add custom fields to the ‘main collect specimen page’. E.g., 'Processing Site', 'Tube Type' etc. | Visit Custom Fields | To add custom fields to the main visit page, e.g.,' Primary Diagnosis.' |
|
Enabling Multiple
...
Records for Forms
Some data for the forms like test results, surveys, etc., might have to be collected multiple times. To do this, check the ‘Multiple records allowed’ checkbox while attaching a form at a particular level.
...
Editing attachment Level for the
...
form
For forms attached at Participant Forms, Visit Forms, Specimen Forms, Registration Forms levels, you can edit the form. For example, the form can have a single record or multiple records.
Expand |
---|
title | Click to view the steps |
---|
|
|
Delete the form field
...
Deleting Form Attachments When No Data Exists
You can directly delete the attachment from different levels when there is no data present related to that form
Expand |
---|
title | Click to view the steps |
---|
|
Follow these steps ONLY when there is no data present in the forms or in a case where the data need not be preserved. Otherwise, deleting the attachment level leads to the deletion of related data. |
Deleting an attachment level leads to the deletion of the data related to those forms. In this case, the data needs to be preserved, and then the form can be reattached to another level. You can follow the below steps:
...