Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

‘Specimen Type’ is the most important and specialized dropdown. Each specimen type falls under a ‘Specimen class’ e.g., Fluid, Molecular, Tissue, Cell, etc.

Define Specimen Class (v10.3 onwards)

...

Expand
titleClick to expand

You can now add new specimen classes from v10.3 onwards

  • Go to 'Dropdown Manager'. Select 'Specimen Type'

  • Click on 'Add'

  • Enter the Class name in ‘Dropdown value', leaving 'Parent Dropdown’ blank.

  • Add the mandatory properties: ‘quantity_unit', ‘concentration_unit’, and ’container_color_coding’:

    Once new class is added, this can be used as ‘Parent Dropdown' for new specimen types.

Below are the specimen-type properties

Attribute

Property Name

Property Value

Description

Specimen Type

quantity_unit

Quantity units for the specific specimen type

Used to display the units on the specimen pages. Value can only be plain text. If special characters like symbols need to be used, it needs to be specified under quantity_display_unit. For e.g., μg/m3

By default, the units are set at classes level which will apply to all types under it:

  • Tissue: gm

  • Fluid: ml

  • Molecular: µg

  • Cell: count

Specimen Type

concentration_unit

Concentration unit for the specific specimen type

For example - microgram/ml

Specimen Type

container_color_coding

The color representing the specimen class in the container location view

For example - background=red,opacity=0.5

 

Specimen Units (Dropdown)

From v11.x, you can define a list of Units which you want to use in the system. You can use the units defined in this dropdown to define specimen quantity/ concentration units for specimen class/ type on system/CP level.

Specimen Units (Define specimen class/ CP specific units)

From v11.x, OpenSpecimen supports specimen units per CP. A common issue for clients with multiple groups was to make units uniform across the collection protocols. E.g., some groups wanted to use ul vs ml as units for fluids like serum/ plasma. With this feature, users will be able to keep the units specific per specimen type within one collection protocol.

Expand
titleClick here to expand

Configure specimen quantity/ concentration units using the UI

System level

  1. Navigate to Home → Extras → Specimen Units

    Screen Shot 2024-04-17 at 4.48.57 pm-20240417-111920.pngImage Added

  2. Add

    Screen Shot 2024-04-17 at 4.51.30 pm-20240417-112203.pngImage Added

  3. Add all relevant values and add quantity and concentration units for any specimen class/ type for selected CP.

    Screen Shot 2024-04-17 at 4.54.10 pm-20240417-112415.pngImage Added

CP level

  1. Navigate to Home → Collection Protocols → View CP details → Settings → Specimen units

    Screen Shot 2024-04-17 at 5.00.32 pm-20240417-113101.pngImage Added


    Follow steps #2 and #3 similar to system level