Making Changes to Labs Post Go Live

Most updates and/or changes to Analytes or Units in the Labs module can be made after a Study has gone live. You can find instructions for specific actions below.

Updating Analytes

To add a new analyte to an existing Lab panel:

1. If the analyte is new to the Analyte Library, remember to perform a Vault deployment before adding it.
2. Navigate to your Study in Studio.

3. From the Actions menu, select Create New Version.

4. Provide the reason for creating a new Casebook Version in the Change Reason field. In this case, for example, your change reason might be “Adding an analyte to a Lab panel.”
5. Click Create.
6. Once the new Casebook Version is created, navigate to the Lab Panels tab in Studio.
7. Click the name of the Lab Panel that you’d like to add to. Add your new analyte in the Edit Lab Panel dialog and click Save.
8. Deploy.
9. Amend.

To add a new analyte to a new Lab panel:

1. If the analyte is new to the Analyte Library, perform a Vault deployment before adding it.
2. Navigate to Studio and create a new Casebook Version as detailed in the instructions above.
3. Navigate to the Lab Panels tab in Studio and click + New Lab Panel.
4. Add analytes and click Save.
5. Navigate to Schedule > Drag & Drop Editor and add your new Lab panel to a form.
6. Deploy.
7. Amend.

To remove an analyte from an existing Lab panel:

1. Navigate to Studio and create a new Casebook Version.
2. Navigate to the Lab Panels tab and click on the name of the Lab panel you want to remove from.
3. Move the analyte from the Selected Analytes column to the Available Analytes column in the Edit Lab Panel dialog to remove. Click Save.
4. Deploy.
5. Amend.

To update an analyte label:

1. Navigate to Labs > Analyte Library.
2. Click Edit Analytes and update the analyte Label.
3. Perform a Vault deployment.
4. Navigate to Studio and create a new Casebook Version.
5. Navigate to your schedule and update the Label field in the properties panel of the updated analyte.
6. Deploy.
7. Amend.

Note that you can’t decrease Precision. You can, however, increase Precision in Studio after creating a new Casebook Version if using Study-level Labs. If using Global Labs, you can increase Precision after deploying via vault-level analyte deployments.

To add Lab Modifiers (Global Labs):

1. Navigate to Labs > Analyte Library.
2. Follow the steps here to configure Lab Modifiers if not configured.
3. Perform a Vault deployment.

To add Lab Modifiers (Global Labs):

1. Navigate to Labs > Analyte Library.
2. Follow the steps here to configure Lab Modifiers if not configured.
3. Perform a Vault deployment.

Deploying the Analyte Library

To deploy the Analyte Library:

1. Navigate to Tools > System Tools > Deployment.
2. Select a Source Environment and Target Environment.

3. In the Deploy Data section, select Analyte Library.

4. Click Deploy. When finished, Vault sends you an email notification.

The analyte name and analyte Data Type can’t be updated if the analyte is In Use. An analyte is considered In Use when it’s associated with a Lab Panel or Lab Location.

Updating Units (Study Level)

If your study was created before the 22R2 release and uses study-level Lab Codelists and Lab Units, use this method.

To add a new unit to an existing unit codelist:

1. Navigate to the Labs module and update or add the new unit in the System General Settings tab.
2. Perform a Vault deployment.
3. Navigate to Studio and create a new Casebook Version.
4. Navigate to the Lab Panels tab.
5. Click on the Lab Panel that is related to the new or updated unit. Click Save. Saving will copy all units and codelists for the selected analyte from the Labs module.
6. Deploy.
7. Amend.

To remove a unit from an existing unit codelist:

1. Navigate to the Labs module and hide the unit in the System General Settings tab.
2. Perform a Vault deployment.
3. Navigate to Studio and create a new Casebook Version.

4. Navigate to the Units tab and click the name of the unit you’d like to remove. Click the Hide checkbox and Save.

5. Deploy.
6. Amend.

To update a unit label:

1. Navigate to the Labs module and update the unit label via the System General Settings tab.
2. Perform a Vault deployment.
3. Navigate to Studio and create a new Casebook Version.
4. Navigate to Units and select the unit that you’ll be updating.
5. Update the Label field and click OK.
6. Deploy.
7. Amend.

Updating Units (Global Labs)

If your Study was created after 22R2, or you have migrated to Versionless (Global) Labs, use this method. With this feature, you no longer need to deploy each time you update a unit.

To update a Unit or its Unit Items:

1. Navigate to Labs > System General Settings > Units in your DEV environment.
2. Locate the Unit that you want to update in the list.
3. Click the unit’s Name to open it.
4. Make your changes in the Edit Unit dialog.
5. Click Save.
6. Follow your organization’s workflow for deploying and testing changes in your TEST (TST) environment.
7. Deploy to your PRD environment.

An amendment isn’t required, because with Global Labs, Lab Units aren’t versioned.

Updating Codelists (Global Labs)

If your Study was created after 22R2, or you have migrated to Versionless (Global) Labs, use this method. With this feature, you no longer need to deploy each time you update a Codelist.

To update a Codelist or its Codelist Items:

1. Navigate to Labs > System General Settings > Codelists in your DEV environment.
2. Locate the Codelist that you want to update in the list.
3. Click the codelist’s Name to open it.
4. Make your changes in the Edit Codelist dialog.
5. Click Save.
6. Follow your organization’s workflow for deploying and testing changes in your TEST (TST) environment.
7. Deploy to your PRD environment.

An amendment isn’t required, because with Global Labs, Lab Units aren’t versioned.

Study Update Restrictions

After you publish the initial version of your Casebook Definition, Vault prevents you from making certain changes in any later versions you may create. If you were to make these changes, it could cause errors during the casebook amendment process.

See Study Update Restrictions for a list of disallowed changes and available workarounds.