Got feedback or spotted a mistake?

Leave a comment at the end of this page or email contact@krishagni.com

Customize Screens (JSON)

Introduction

In OpenSpecimen, there are standard fields for participant, visit, and specimen pages. However, these fields must not be relevant for your study, or you would want to create new fields based on the CP requirements. Using this feature, super administrators can configure the user interface.

This is possible using JSON configuration at a CP level or system level.

Which pages can be configured?

Data Entry

This includes the overview, add, and edit pages.

  • Participant

  • Visit

  • All specimen pages like add new fields during collection, aliquot, derive, etc.

List View

The list view page is the table displayed when you click on any object.

  • Participant

  • Specimen

  • Specimen cart

  • Reserved specimen

  • Order specimens

What can be configured?

  1. Fields to be displayed, i.e., remove unwanted fields or add additional fields.

  2. Making fields mandatory/optional.

  3. Default values for fields.

  4. Populate values in a field based on a value in another field.

  5. Subsetting dropdown values based on the value of another field.

  6. Adding skip logic (i.e., hide/unhide fields based on the value of another field).

  7. Display calculated fields in overview pages or tables.

  8. Reorder fields.

  9. Group fields in the same line under headers.

  10. Validation rules (Refer to Data Validations(Edit Checks)).

Workflow Configuration

This configuration can be done at three levels:

  1. System-wide - applies to all protocols

  2. Collection Protocol Group level - applies to all protocols in the group and overrides system setting for them.

  3. Collection Protocol level - overrides the system and/or CP group setting for that protocol

Collection Protocol Level

To import/export workflows:

  1. Go to the collection protocols overview page.

  2. Click on the 'More' button.

  3. Select Export Workflows or Import Workflows.

Collection Group Protocol Level

To import/export workflows:

  1. Go to the collection protocol group overview page.

  2. Click on the 'Workflows'.

  3. Select ‘Export' or 'Import’.

System Level

JSON can be set for all CPs at the system level. When OpenSpecimen is installed, there is already a default system-level JSON set in the Settings. This contains the list view and aliquot/derivative creation screen configurations. Refer to the steps to edit system JSON:

  1. Navigate to 'Settings'.

  2. Under 'Biospecimen', set the 'System Workflows' property with the new JSON.

  3. Refresh the browser to take effect of the settings.

 

You can configure different pages of OpenSpecimen through System JSON. The different sections of JSON are mentioned below:

Remove Workflow Configuration

Custom Fields Configuration

Custom Fields Display

If you define custom fields in system or CP level JSON, any changes to the form needs changes in respective JSONs too.

The feature where custom fields automatically appear without JSON configuration was implemented in v9.0.

Default JSON Files

 

Got feedback or spotted a mistake?

Leave a comment at the end of this page or email contact@krishagni.com