Leave a comment at the end of this page or email contact@krishagni.com
Configure derivative and aliquot page
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:
Set default and hide the field in the derived/aliquots creation page.
In the below example, the field is defaulted to its parent value and hidden from the data entry screen.
Add the Specimen Barcode field in 'Create Aliquot' page
To configure the'Create Aliquot' page with the Barcode field, use the below code in the aliquotsCollection under the common section.
Example Barcode field in aliquots page.json
Difference between the specimen. barcode field in dictionary and specimen.barcodes in common section:
The ‘specimen.barcodes’ field in the aliquot section is a textarea field similar to the labels field for aliquots, where you can scan the comma/newline/tab-delimited barcodes. Each barcode corresponds to one aliquot. This field will basically create the aliquots.
The ‘specimen.barcode’ field in the dictionary section is the text field which will specify only one barcode corresponding to one specimen. Thus, the barcode entered on the create aliquot page will be stored and displayed on the overview page.
Leave a comment at the end of this page or email contact@krishagni.com