Managing Analytes, Units, & Codelists

The System Settings section of the Labs module includes the Analyte Library and General System Settings, where you can add and edit Units, Codelists, and configure general settings.

Analyte Library

The Analyte Library is a collection of Analytes that you can use to map your lab’s Normal Ranges. From the Analyte Library tab, you can add, edit, copy, import, and delete analytes.

To edit the Analyte Library columns, export your library, or view an Audit Trail, select the gear icon to the right of the library table.

Add Analytes

To add Analytes:

  1. Navigate to Labs > System Settings > Analyte Library.
  2. Click Edit Analytes.

  3. Click Add New Analyte.
  4. Enter a Name in the Analyte column.
  5. Enter a Label.
  6. Select the analyte’s Data Type.
  7. Select the Measurement Type.
  8. If applicable, select a Codelist.
  9. Repeat steps 3 through 8 for additional Analytes.
  10. When finished, click Done.

Edit Analytes

To edit Analytes:

  1. Navigate to Labs > System Settings > Analyte Library.
  2. Click Edit Analytes.

  3. Click on the Cell you want to edit in the library table.
  4. Enter or select the updated value.
  5. When finished, click Done.

You must perform a Vault deployment after making any changes before the changes will be visible in UAT and PROD environments. Learn more about making changes Post Go Live here.

Delete an Analyte

You can delete an analyte if it isn’t In Use.

To delete an analyte:

  1. Navigate to Labs > System Settings > Analyte Library.
  2. Locate the Analyte that you want to delete in the list.
  3. Hover over the Analyte to show the Actions menu.
  4. From the Actions menu (), select Delete.
  5. In the Delete Analyte confirmation dialog, click Delete.

Delete an Analyte

You must perform a Vault deployment after making any changes before the changes will be visible in UAT and PROD environments. Learn more about making changes Post Go Live here.

Import Analytes

You can import Analytes using this template:

  Download the Analyte Import Template

Case Sensitivity: The Specimen and Testing Method columns are case-sensitive when importing.

In Use Analytes

Once an Analyte is added to a Lab Panel in Studio, or if a Lab Location is using the Analyte, Vault marks the Analyte as In Use. Edits are restricted for In Use analytes and deletion isn’t allowed.

Once an Analyte is In Use, you can no longer update the following properties:

  • Analyte Name
  • Data Type
  • Measurement Type
  • Length
  • Precision

You can still make changes to the following properties:

  • Labels
  • SDTM Code
  • LOINC Code
  • Testing Method
  • Specimen Type

You must perform a Vault deployment after making any changes before the changes will be visible in UAT and PROD environments. Learn more about making changes Post Go Live here.

Units

In the System General Settings tab, you can add Units and Codelists to use within your Labs configuration.

Changes to Precision: If your Study was created prior to 22R2 and isn’t using Versionless Labs, Vault will lock the Precision property after you save your Unit. To edit this property, you must make your changes in Studio.

To add a Unit:

  1. Navigate to Labs > System General Settings > Units.
  2. Click + New Unit.
  3. Fill the required fields.
  4. Create Unit Items by filling the required fields and clicking + Add Unit Item to add additional rows.
  5. Select the Standard radio button on the Unit Item that you want to use as by default.
  6. Click Save.

To edit a Unit:

  1. Navigate to Labs > System General Settings > Units.
  2. Locate the Unit that you want to edit in the list.
  3. Click the unit’s Name to open it.
  4. In the Edit Unit dialog, make your changes.
  5. When finished, click Save.

To add or remove a Unit Item:

  1. Navigate to Labs > System General Settings > Units.
  2. Locate the Unit that you want to edit in the list.
  3. Click the unit’s Name to open it.
  4. To add a Unit Item:
    1. Click + Add Unit Item.
    2. Fill the required fields.
  5. To remove a Unit Item, click Remove ().
  6. When finished, click Save.

To delete a Unit:

  1. Navigate to Labs > System General Settings > Units.
  2. Locate the Unit that you want to delete in the list.
  3. Hover over the unit to show the Actions menu.
  4. From the Actions menu (), select Delete.

  5. In the Delete Unit confirmation dialog, click Continue.

To export a list of Units as an Excel™ file:

  1. Navigate to Labs > System General Settings > Units.
  2. From the Actions menu (), select Export.

  3. In the Export dialog, click Close.
  4. Vault sends an email notification when your file is ready for download.

Codelists

To add a Codelist:

  1. Navigate to Labs > System General Settings > Codelists.
  2. Click + New Codelist.
  3. Fill the required fields.
  4. Create Codelist Items by filling the required fields and clicking + Add Codelist Item to add additional rows.
  5. Click Save.

To edit a Codelist:

  1. Navigate to Labs > System General Settings > Codelists.
  2. Locate the Codelist that you want to edit in the list.
  3. Click the codelist’s Name to open it.
  4. In the Edit Codelist dialog, make your changes.
  5. When finished, click Save.

To add or remove a Codelist Item:

  1. Navigate to Labs > System General Settings > Codelists.
  2. Locate the Codelist that you want to edit in the list.
  3. Click the codelist’s Name to open it.
  4. To add a Codelist Item:
    1. Click + Add Codelist Item.
    2. Fill the required fields.
  5. To remove a Codelist Item, click Remove ().
  6. When finished, click Save.

To delete a Codelist:

  1. Navigate to Labs > System General Settings > Codelists.
  2. Locate the Codelist that you want to delete in the list.
  3. Hover over the codelist to show the Actions menu.
  4. From the Actions menu (), select Delete.

  5. In the Delete Codelist confirmation dialog, click Continue.

To export a list of Codelists as an Excel™ file:

  1. Navigate to Labs > System General Settings > Codelists.
  2. From the Actions menu (), select Export.

  3. In the Export dialog, click Close.
  4. Vault sends an email notification when your file is ready for download.

General Settings

The General Settings subtab allows you to configure Site Overrides and Approvals for Lab Normals, Query Settings, and the option to create a Clinical Significance codelist. To edit any of these settings, click Edit at the top right of the page.

To add a Codelist Item to your Clinical Significance codelist, click Edit and select Add Codelist Item at the bottom of the page.