...
OpenSpecimen allows specimens to be collected as per a specific event calendar for clinical trial-based protocols. This allows will enable you to pre-define specimens in CP and collect planned specimens as shown below:
...
However, this page does not have all fields that might be required for a specific protocol. Using CP workflows configuration, you can configure additional fields to be captured after this step.
...
Refer to the 'Collection Protocol Level Configuration' section to add workflow at the CP level.
The below table explains different sections of the nth step:
Section | Details |
---|---|
visitFields | If visit fields need to be displayed on the nth step, this section must be added. There will be only one section of this displaying one row for a visit being collected. |
fields | Within visitFields section, include all fields to be displayed in a table format within the 'fields' section of JSON. |
title | Title of each section/table in the nth step. |
fieldGroups | If fields need to be displayed in separate sections or tables, multiple sections can be within fieldGroups. For example: 'Primary Specimen details', 'Aliquot details' etc. Each section can have a title, criteria, and set of fields. |
criteria | This defines conditions for displaying fields in each section. For example 'Centrifuge event details' section can be displayed only for 'Whole Blood' & 'Primary' specimens. |
Example 1: Display Anatomic Site, Laterality, and Spun Event for Whole Blood Specimens
Expand | ||||
---|---|---|---|---|
Example JSON to configure the setup that is shown in the above screenshot:
|
Example 2: Display ‘Processed By' and ‘Processed Time’ fields only for 'PBMC’ and 'Plasma' samples
Expand |
---|
Example JSON to configure the setup that is shown in the above screenshot |
...
: |
...
|
NOTE
The subform field is not supported in the nth step. This is because the sub-form is a 1:many relation with the main form, and it is not possible to display the 1:many field in the nth step.
A radio button is not supported on the nth step.
Once the workflow is uploaded, refresh your browser page once and then collect samples.
The nth step page will appear after the default specimen collection page.
Example: Show ‘Processed By' and ‘Processed Time’ fields only for 'PBMC’ and 'Plasma' samples.
...
Configure Visit Fields on the nth Step
The visit fields - 'Clinical Diagnoses', 'Clinical Status', 'Surgical Pathology Number' etc. are not displayed on the specimen collection page when collecting planned samples. The specimen collection page is currently not configurable to add visit level fields. These fields can be configured on the nth step (page after specimen collection).
Info |
---|
'visitFields' section is used to add visit fields on the specimen collection pagenth step. |
Expand | |||||
---|---|---|---|---|---|
| |||||
The below table explains different sections of the nth step: | |||||
Section | Details | ||||
visitFields | If visit fields need to be displayed on the nth step, this section needs to be added. There will be only one section of this displaying one row for a visit being collected. | ||||
fields | Within visitFields section, include all fields to be displayed in a table format within the 'fields' section of JSON. | ||||
title | Title of each section/table in the nth step. | ||||
fieldGroups | If fields need to be displayed in separate sections or tables, multiple sections can be within fieldGroups. For example: 'Primary Specimen details', 'Aliquot details' etc. Each section can have a title, criteria and set of fields. | ||||
criteria | This defines conditions for displaying fields in each section. For example 'Centrifuge event details' section can be displayed only for 'Whole Blood' & 'Primary' specimens. |
Hide Fields/Table on Specimen Collection Page (v7.1)
...
Expand | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
Hide table code snippet
Hide column code snippet
|
Example:
...
Processing event information for child specimens needs to be derived from its parent specimen automatically
...
Previously, to achieve that, you would have to show that fields/table in the step. As a resolution, now you will be able to hide the fields and tables on the step.See the below example screenshot:
Expand |
---|
Before hiding the 'Aliquot: Processing Details' section |
...
on the |
...
specimen collection page |
...
: |
...
After hiding the 'Aliquot: Processing Details' |
...
: |
...
Example JSON |
...
to configure the setup that is shown in the above screenshot:
|
Show/Hide Visit, Collection, and Received Event Fields (v7.1)
Use-Cases
Sometimes specimens are collected in the clinic but not yet received by the biobank when the clinic staff enters the details. So the received event is not needed on the specimen collection page.
Collection times are different for each primary specimen. So instead of collecting one time for all, you will collect different times in the nth step.
Expand |
---|
The options are to be added in the |
...
“specimenCollection” section of the workflows JSON as illustrated below:
The above configuration hides visit fields, collection event fields, and displays the received event fields. When the above configuration is not present, all the fields are displayed by default. From v8.1, the collection and receive dates would be blank by default. You can set the collection and receive dates as below:
Screenshot before configuration: |
...
Screenshot after configuration: |
...
Example JSON
...
Example JSON to configure the setup that is shown in the above screenshot:
|
Display Specimen Events at the nth Step
You can display specimen events at the nth step like frozen event, fixed event, spun event, etc at the nth step.
Example: Display Frozen Event for Whole Blood Specimens
Expand | ||||
---|---|---|---|---|
Example JSON to configure the setup that is shown in the above screenshot:
|