Versions Compared

Version Old Version 37 New Version 38
Changes made by

asawari (Unlicensed)

asawari (Unlicensed)

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

The custom forms can be attached at different levels for data entry. Forms attached at the custom form level, such as participant, visit, or specimen level, will appear in the ‘forms’ tab. Meanwhile, forms attached at the custom field level, for example, specimen custom fields or container custom fields, will appear on the overview pages.

Users can attach forms at three different levels:

  1. System level

  2. Collection Protocol level

  3. Collection Protocol Group level

You will only be able to see those custom form levels for which you can create associations.

Attach Form

...

minLevel1
maxLevel6
include
outlinefalse
indent
styledefault
exclude
typelist
class
printabletrue

Attach Form

A user can attach forms at three levels depending on the role assigned to the user. For example: Super admin users have access to attach forms at the system level, whereas admin users can attach forms at the CP level to which they have access.

  1. At system level

  2. At collection protocol level

  3. At collection protocol group level

At System Level

Forms attached at the system level apply to every collection protocol, container, and user across all institutes within the system.

  • Only the Super Admin can attach forms at this level.

  • There are two type types of associations where the form can be attached at the system level 

  1. Direct Attachment at the System Level:
    Certain associations allow forms to be attached directly at the system level, such as collection protocol custom fields. This approach ensures that the form is accessible across all collection protocols within the system.

Expand
titleClick here to view the steps with example

  1. Select 'Forms' from the navigation menu or the home screen.

  2. Navigate to the form overview page and click on 'Associations'

    Attach1.pngImage RemovedAttach1.pngImage Added

  3. Click on 'Add'

    Attach2.pngImage RemovedAttach2.pngImage Added

  4. Select the ‘Collection protocol Custom Field’ level from the dropdown and click on 'Add'

    Attach3.pngImage RemovedAttach3.pngImage Added

  1. At All Present and Future Collection Protocols:
    There is other type of association where users can choose the option ‘All Present and Future Collection Protocols’ when linking the form. This setting ensures the form is automatically applied to both existing and future collection protocols in the system.

Expand
titleClick here to see the steps

  1. Navigate to the form overview page and click on 'Associations'

    Attach1.pngImage RemovedAttach4.pngImage Added

  2. Click on 'Add'

    Attach2.pngImage RemovedAttach5.pngImage Added

  3. Select the ‘Registration Form’ level from the dropdown, select 'All Present and Future Collection Protocols' then click on 'Add'.

    Attach second after 4.pngImage RemovedAttach6.pngImage Added

At Collection Protocol

...

Level

Forms

...

attached to individual collection protocols

...

take precedence over system-level or Collection Protocol Group (CPG)

...

associations.

...

Regular users with form access, in addition to administrators, can attach forms at this specific level.

Expand
titleClick hee to see the stepshere to view details...

  1. Navigate to the form overview page and click on 'Associations'

    Attach1.pngImage RemovedAttach1.pngImage Added

  2. Click on 'Add'

    Attach2.pngImage RemovedAttach2.pngImage Added

  3. Select the ‘Registration Form' and select the name of the 'Collection Protocol’ from the dropdown.

    attach first after4.pngImage Removed

    ‘Collection Protocol’, click on 'Add’

    Attach7.pngImage Added

At Collection Protocol Group

...

Level

Users can

...

attach a

...

form at the CPG level to enter data across all collection protocols

...

in the group, thereby overriding system-level associations.

Expand
titleClick to view the steps

  1. Navigate to the CPG and click on the 'Forms' tab

    Attach17.pngImage RemovedAttach8.pngImage Added

  2. Select the level for attaching the form participant/visit/specimen where you want to attach the form.
    If you wish to attach the

    Attachafter7.pngImage Added

  3. To attach a form at the ‘'Custom Field' level, click on the ‘Add’ button beside 'Add' button next to 'Custom Filids’Fields'.

    Attach18.pngImage RemovedAttach9.pngImage Added

    Attach19.pngImage Removed



    Attach10.pngImage Added

  4. If you wish to attach the form at the ‘CustomForm' level, click on the ‘Add’ button present beside 'Forms’.

    Attach20.pngImage RemovedAttach11.pngImage Added

    Attach21.pngImage Removed



    Attach12.pngImage Added

Attachment level and Description

...

Expand
titleClick to view the levels and description

Level

Description

Participant Forms

  • Forms linked at the participant level will be available under all the CPsare accessible across all Collection Protocols where the participant is registered.

  • 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 level (e.g., 'Participant Contact Details' entered for P1 under CP1 ) will also be available under CP2in all collection protocols participant is associated with.

  • Forms added at this level will be available listed under the participant’s forms tab for that participant.

Registration FormsFor CP

  • Collection Protocol-specific participant forms (e.

E.

  • g., 'Smoking

history', which might only be required under Lung Cancer Protocol.Forms added at this level will be available

  • History' for Lung Cancer Protocol) are available only within the relevant Collection Protocol.

  • These forms will be listed under the forms tab on the

participant

  • participant’s form page.

Specimen Array EventTo add custom fields

  • Custom fields can be added to the '

add event

  • Add Event' page

'

  • of the array.

  • Multiple forms can be attached at this level.

While

  • To select a form while adding an event, click the dropdown button in the event field

to select the form

  • .

Specimen Event

  • Add

‘custom events’

  • ‘Custom Events’ to describe different stages of a

specimen

  • specimen’s life cycle

,

  • (e.g., Nano-drop event

. Refer to the wiki page for more details

Specimen Forms

  • Forms linked

to

  • at this level will

be available

  • appear under the forms tab

of

  • for any collected specimens

of

  • within the attached

CP

  • collection protocol.

Specimen Slide EventTo add custom fields on the add event

  • Custom fields can be added on the 'Add Event' page for the slide.

 Multiple

  • Multiple forms can be attached at this level

.

  • While adding an event, click the dropdown button in the event field to select the desired form.

User Forms To add

  • User forms can be added at the ‘User’ level

. The forms can be added to capture training records, and so on. Refer

  • for capturing training records and other information

  • For more details, refer to the wiki page

for more details

  • .

Visit Forms

  • Forms linked

to

  • at this level will be

available

  • accessible under the forms tab

of

  • for any

occurred

  • visit

of

  • within the attached

CP.

  • collection protocol

Collection Protocol Custom fields

  • To add custom fields on the

‘create collection protocol"’page. E.g., 'IRB document', 'CTRI number.'

  • ‘Create Collection Protocol’ page, such as 'IRB Document' or '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 FieldsThe forms can not

  • Order custom fields cannot be attached using the 'Association' option from the form page.

It

  • Instead, 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

  • main collect specimen

page’.

  • page, E.g., 'Processing Site', 'Tube Type' etc.

Visit Custom Fields

  • To add custom fields to the main visit page, e.g.,' Primary Diagnosis.' 

Edit Attachment

At Forms can be edited at the Participant Forms, Visit Forms, Specimen Forms, and Registration Forms levels. For example, you can edit forms. See the following example where modify a form is modified to contain a single recordto include multiple records, as demonstrated below.

Expand
titleClick to view the steps

  • Click the 'Edit' icon

    Attachbefore5.pngImage RemovedAttach13.pngImage Added

  • Unselect Select the multiple records allowed and click on 'Update'

    Attach5.pngImage RemovedAttach14.pngImage Added

Delete Attachment

...

Expand
titleClick to view the steps

  • Navigate to the associations and click on the 'Delete' icon

    Attach7.pngImage RemovedAttach15.pngImage Added

  • Click on 'Yes'

    Attach8.pngImage RemovedAttach16.pngImage Added

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.

When Data Exists

Deleting When 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 refer to this wiki page for further details, the associated data is also removed. To ensure data preservation, first, save the data before deleting the attachment level. Afterward, you can reattach the form to a different level. For more detailed instructions, please refer to the wiki page.

Enable Multiple Records

Some To collect data for the from forms like such as test results , surveys, etc., might have to be collected or surveys multiple times. To do this, check , ensure you select the ‘Multiple records allowed’ checkbox while when attaching a the form at to a particular specific level. This setting enables the form to be used repeatedly for data collection.

Attach4.pngImage Removed
Expand
titleClick to view the screensho
screenshot

  • Select ‘Multiple records allowed’

    Attach17.pngImage Added

Enable Notifications

The notifications can be sent to the users regarding adding/Users can receive notifications about adding or editing form associations. You can also include Additionally, you can choose to include the form data in the notification these notifications by selecting the check boxcorresponding checkbox.

Expand
titleClick to view the steps

  1. While adding an association, select ‘Send Notification’

    form notification 1.pngImage RemovedAttach18.pngImage Added

  2. Select the user group from the ‘Notification Recipient' dropdown and click on 'Add’

    form notification 2.pngImage RemovedAttach19.pngImage Added

Note: The notifications are only sent to the User Groups and not to the individual users.