You can configure the derivative/aliquot page based on the different criteria. This helps you eliminate the unwanted fields that are not needed on derivative/aliquot pages.
OpenSpecimen allows you to configure the derivative/aliquot page at the 'Collection Protocol' level and 'System Level'.
Protocol-level configuration
If you want to configure the derivative/aliquot page for a specific collection protocol, use CP level workflow JSON.
Refer to the 'Protocol Level Configuration' page to set the JSON file to the specific CP.
Derivative Page Configuration
To configure the derivative page user needs to add the "derivedSpecimens" section in the "data" block mentioned in the below JSON.
Screenshot: Create a derivative page after JSON configured columns.
Aliquot Page Configuration
To configure the aliquot page user needs to add the "aliquotsCollection" section in the "data" block mentioned in the below JSON.
Screenshot: Create aliquot page after JSON configured columns
System-level configuration
Refer to the 'System-Level Configuration' page to set the System- Level Workflow.
Once you configure the derivative/aliquot at the system level, it affects all the collection protocols present in the OpenSpecimen.
Selecting specimens of multiple CPs from the cart view or any other view and subsequently clicking on "Create Aliquots" or "Create Derivatives" displays configurable derivative/aliquots data table. The configurable table is displayed only if SDE is installed and derivative/aliquot fields are configured at the system level.
Screenshot: Create derivatives and aliquots from the cart page
Screenshot: Cart view page → Create Derivative Page
Screenshot: Cart view page → Create Aliquot Page
Extra features in creating derived and aliquot page
Hide 'Copy first to all' link on derivative and aliquot pages
There is a button 'Copy first to all' on the aliquots and derivatives pages, which will allow creating similar aliquots and derivatives at once. Some users do not need this as a similar type of children are generally created in a single row, and 'Copy first to all' might be confusing.
In v6.0, this button can be hidden. To hide "Copy first to all" a button from derived or aliquot pages, add the following setting in JSON under aliquotsCollection and derivedSpecimens sections
{ ... "aliquotsCollection": [ ... { "title": ..., ..., "hideCopyFirstToAll": true ... }, ... ], "derivedSpecimens": [ ... { "title": ..., ..., "hideCopyFirstToAll": true ... }, ... ], ... }
Before configuring the JSON, the "Copy first to all" button is present on Create derivative page:
After configuring the JSON, "Copy first to all" button is hidden on Create derivative page:
After configuring the JSON, "Copy first to all" button is hidden on Create aliquot page:
Add ability to create aliquots from the 'Create Derivatives' page
Added an option to allow users to create aliquots when creating unplanned derivatives. The default system workflow includes the option to create aliquots.
The customized CP workflows can add the following JSON to the "derivedspecimens" workflow to activate the option:
{ "name": "specimen.createAliquots", "caption": "Create Aliquots?", "icon": "fa fa-share-alt", "type": "toggle-checkbox", "width": "30px" }
Example JSON: