...

OpenSpecimen allows specimens to be collected as per a specific event calendar for clinical trial based protocols. This allows you to pre-define specimens in CP and collects as collect planned specimens using the below screen:

...

But However, this page does not have all fields that might be required for a specific protocol. Using CP workflows configuration, the administrator can configure additional fields to be captured after this step.

...

Once the workflow is uploaded, refresh your browser page once and then collect samples. After the specimen collection page, the below page appears.

...

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 1:many field in the nth step.
A radio button is not supported on the nth step.

...

Configuration: Show 'Viability' field ‘Processed By' and ‘Processed Time’ fields only for derived 'Plasma' PBMC’ and 'SerumPlasma' samples.

...

Configure visit fields on collection page (nth Step)

...

Expand

title	Click here to see the JSON code..

Code Block

language	json

{
    "name": "specimenCollection",
    "data": {
      "visitFields": {
        "title": "Visit Details",
        "fields": [
          [
            {
              "name": "visit.name",
              "baseField": "visit.name",
              "type": "span",
              "width": "150px"
            },
            {
              "name": "visit.clinicalDiagnoses",
              "baseField": "visit.clinicalDiagnoses",
              "width": "200px"
            },
            {
              "name": "visit.comments",
              "baseField": "visit.comments",
              "width": "200px"
            }
          ]
        ]
      },
      "fieldGroups": [
        {
          "title": "Frozen Event",
          "criteria": {
            "op": "AND",
            "rules": [
              {
                "field": "specimen.specimenClass",
                "op": "==",
                "value": "'Tissue'"
              }
            ]
          },
          "fields": [
            {
              "name": "specimen.label",
              "baseField": "specimen.label",
              "type": "span"
            },
            {
              "name": "specimen.type",
              "baseField": "specimen.type",
              "type": "span"
            },
            {
              "name": "events.SpecimenFrozenEvent.time",
              "baseField": "specimen.events.SpecimenFrozenEvent.time"
            },
            {
              "name": "events.SpecimenFrozenEvent.user",
              "baseField": "specimen.events.SpecimenFrozenEvent.user"
            },
            {
              "name": "events.SpecimenFrozenEvent.frozenMethod",
              "baseField": "specimen.events.SpecimenFrozenEvent.frozenMethod"
            }
          ]
        }
      ]
    }
  }

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, there can be multiple sections 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.

Screenshot after specimen collection page configuration:

...

Before hiding the 'Aliquot: Processing Details' section in the speciemenCollection page.
Image RemovedImage Added
After hiding the 'Aliquot: Processing Details'.
Image RemovedImage Added
Download example JSON to see the above configuration.