The Overview Dashboard displays summary information about the current activity in the lab. It provides lab managers with at-a-glance information about workflow, sample status, and alerts across projects. The dashboard is dynamic and updates automatically as changes occur in the lab.

By default, the system administrator and facility administrator roles have access to the Overview Dashboard. However, access is a configurable role-based permission. For details, see Configured Role-Based Permissions.

Overall Status Bar

The Overall Status bar provides a snapshot of lab activity.

• Projects—The number of open and pending projects currently in Clarity LIMS. This number does not include closed projects.

• Samples—The number of samples in open and pending projects.

• Workflows—The number of workflows in which the samples are currently being worked through in the lab.

• Alerts—The number of unresolved alerts in the system. To trigger alerts, select Request manager review as the next step for a sample (in the Assign Next Steps screen).

Workflows

This section shows information for the lab workflows that currently have samples uploaded to them. Workflows are listed in alphabetical order.

For each workflow, the following information is shown:

• Projects—The total number of projects containing samples that are currently in the workflow. This number includes samples that are in progress in the workflow and samples that have completed the workflow.

• In progress samples—The number of samples that are currently in progress in the workflow.

• Completed samples—The number of samples that have completed the workflow.

• Protocols—The names of the protocols that are included in the workflow.

• Samples—The number of samples in each protocol of that workflow.

Protocol Capacity

If configuring the sample capacity of a protocol (see #configure-protocols), Clarity LIMS uses color coding to indicate the percentage of the protocol capacity that is being used.

The percentage of capacity is calculated according to the total number of samples that are currently assigned to all occurrences of the protocol (ie, across all workflows).

• Blue indicates that the number of samples currently in the protocol is less than or equal to the configured capacity.

• Yellow indicates that the number of samples currently in the protocol is between 100% - 200% of the configured capacity.

• Orange indicates that the number of samples currently in the protocol is greater than 200% of the configured capacity.

While the protocol for a particular workflow may have few, or even zero, samples assigned to it, its capacity might still display in yellow or orange. This display would occur if the number of samples in other occurrences of the protocol exceeds its configured capacity.

Hover over a protocol to view more information about its configured capacity and the total number of samples assigned to it.

Overview Dashboard—Provides summary information about lab activity. Use this dashboard to view workflow status, sample status, and alerts.

Projects Dashboard—Provides a dynamic view of current lab activity. Use this dashboard to help manage projects and the flow of samples through the lab.

This topic provides guidelines and tips to help you compile a sample list, in Microsoft Excel format, for importing into BaseSpace Clarity LIMS.

• Import up 3456 samples from a single sample list file. To import more than 3456 samples, divide the samples into multiple files.

• If an error is detected in the spreadsheet, the import process aborts. No sample imports until the error condition is resolved. See #troubleshooting.

Column headers

Legend

• An asterisk indicates a *mandatory field.

• Regular font, without an asterisk, indicates an optional field. See #optional-fields for details.

• Text enclosed in angle brackets indicates a placeholder custom field name to replace with a value.

• Italicized text indicates a group of fields that depend on each other. All headers in the group must be either all present or all absent.

The following column headers can be used in the sample list:

• *Sample/Name—Specify the name of the sample. If the system has the unique sample name option enabled and there are duplicate sample names in the spreadsheet, expect an error message. The message provides information on this error condition. No sample is imported until duplicate names are resolved.

• Sample/Volume—Specify the volume of the sample.

• Container/Type—Specify the name of the container type to use for this sample. When specifying a value for this column, verify it exists in the system already. For instance, you can specify 100 well MALDI plate as a value, provided this container type is configured in the system.

• Container/Name—Specify the name of the container to place this sample. If the name does not match a container already in the system, a new container by this name (and of the specified type) is created.

• Sample/Well Location—Specify the well location for the sample. Values for this column are formatted like the following examples: A:1, B:12, or 1:10.

  The import process validates this location against the container type specified. If the location is out of range, the process rejects it. If placing a sample into an existing container, the process checks if the well location is already occupied and rejects it if occupied.

• Sample/Reagent Label—Specify the reagent label name to use for this sample. Values for this column are optional. They can exist in the system or, if the reagent label is not found, a new one is created. Only one reagent label is supported per sample via batch sample import.

• Custom Field/<Name of Custom Field>—Add a custom field instance to the sample. The name of the custom field must exist in the system. If the custom field name specified is not in the system, an error message displays.

  You can specify a value for this custom field in the remaining cells of this column. For example, if there is a custom field by the name Clinical Source, you may have a column header Custom Field/Clinical Source and a value of hospital for the sample. See #optional-fields for details.

• Container/Custom Field/<Name of Custom Field>—Add a custom field instance to container. This field functions in a similar way to the sample custom field previously described, except the values must be defined on each row (per container). If not, an error message displays.

Optional fields

Take Custom Field as an example. Its optional nature in the spreadsheet is contingent on whether a particular field is defined as optional or required in Clarity LIMS.

If there is a required custom field for a sample, there must be a column in the spreadsheet for this field. A value must be specified for it, before any sample can be imported.

Custom field values are validated against their type defined in Clarity LIMS, as follows.

• Date type—For example, if there is a custom field type of Date and the name is Completion Date, the best practice method is to have a column header Custom Field/Completion Date. The remaining values for the cells in the file should be formatted using one of the Excel date formats.

• Numeric type with a range defined—The value is first validated as a number. Then, the number is validated against the range defined in Clarity LIMS.

  • If the validation fails, error messages display.

  • No sample is imported until the value is validated.

• Custom field with values defined in a group of defaults—If a custom field is configured to have one or more values defined in a group of defaults and is only allowed to have one of these defined values, Clarity LIMS validates the value entered against the defined values.

  • If the value in the spreadsheet does not match one of the default values, validation fails.

  • If the validation fails, an error message displays. No sample is imported.

Troubleshooting

If Clarity LIMS expects certain information to be provided and this information is not included in the sample list, the samples are not imported.

Consider the following examples:

• If an option or field is mandatory, the sample list must contain a column to capture that information. The sample list must use the appropriate column title.

• If the samples must contain unique names, the sample list must not contain duplicate names or the names of samples already recorded in Clarity LIMS.

• Containers types referenced in the sample list must already be defined in Clarity LIMS. For example, 96-well plate or tube.

• The sample list must not place a sample into a container well that is already populated with another sample.

• Any custom fields referenced in the sample list must be defined in Clarity LIMS.

Clarity LIMS uses projects as the basis for all work performed in the system. All samples must be added to an existing project.

A project stores the following information:

• The client and account associated with the project.

• The priority of the project (Low, Standard, High).

• The samples submitted to the project.

• Project status (Pending, Open, Closed).

• The date the project was opened and closed.

• Files associated with the project.

• Any configured custom fields.

Create Projects

Before adding samples to Clarity LIMS, create a project to store them.

1. On the Projects and Samples tab, select New Project.

2. On the Properties tab, in the Project Details section, complete the following tasks:

   • Type a descriptive name for the project.

   • If creating a new account, type the name directly into the field. Otherwise, select an existing account from the drop-down list.

   • If creating a new client, type the name directly into the field. Otherwise, select an existing client from the drop-down list.

   • By default, the project opened date is set to the current date. To change this date, select the Opened field and select a date from the calendar.

   • If necessary, edit the project priority. The default is Standard.

3. On the Custom Fields tab, complete the additional details for this project. Mandatory fields are indicated with yellow shading.

4. [Optional] To upload a file to the project:

   • Select the Files tab, then select Upload File.

   • Select Choose File, browse for and select the file, and select Upload.

5. Select Save. The new project displays in the Projects list. Samples can now be added.

View and Modify Projects

View, Modify and Delete a Project

To view, modify, or delete a project, complete the following steps:

1. Navigate to the Projects and Samples tab.

2. In the Projects list, select the project. The Project Details screen displays the details for the selected project.

3. To modify project details, select the field and edit as required (see Project Creation).

4. Select Save.

5. To delete the project, select Delete.

Before deleting a project, consider the following details:

• Deleting a project also deletes any samples it contains.

• By default, projects can be deleted provided no work has been recorded (or is in progress) on the samples. However, this role-based permission is configurable.

• If the samples contained in a project have recorded or in-progress protocol steps, the project cannot be deleted without special user permissions.

View and Modify Project Status

To view and update the project status, complete the following steps:

1. Navigate to the Projects and Samples tab.

2. In the Projects list, select a project.

   On the Properties tab in the Project Details area, the Status slider indicates the status of the project.

3. To move the slider and change the project status, select the desired status.

View and Modify Custom Fields

To view and modify custom fields, complete the following steps:

1. Navigate to the Projects and Samples tab.

2. In the Projects list, select a project.

3. In the Project Details area, navigate to the Custom Fields tab.

4. Select a field to modify and edit as required (see #create-projects).

5. Select Save.

Download / Upload Files

To download, view, and upload project files, complete the following steps:

1. Navigate to the Projects and Samples tab.

2. In the Projects list, select a project.

3. In the Project Details area, navigate to the Files tab. Files currently associated with the project are displayed.

4. To download and view a project file, select the file.

5. To upload a file:

   a. Select Upload File.

   b. Select Choose File.

   c. Browse for the file, select it, and select Upload.

Project Automation

See #project-automation on how to configure Project Automation.

When working on a step, you can create multiple aliquots of each sample, move one aliquot to the next step in the workflow, and store the others for later use.

Create Store Aliquots for later use

1. Add samples to the Ice Bucket.

2. In the Ice Bucket, create the required number of sample aliquots.

   • To create the same number of aliquots for all samples, select the number of derivatives to create and select Apply All. (The number adjacent to each sample updates automatically.)

   • To create a different number of aliquots for each individual sample, adjust the number adjacent to each sample.

   • In the Assign Next Steps screen, all the sample aliquots are listed.

3. To store an aliquot for later use, select Store for later from the next step drop-down list.

Resume workflow on stored aliquots

1. In the Search drop-down list, select Sample, type the sample name, and press the Enter key.

   In the search results, all the sample aliquots are listed.

2. Select a sample aliquot to expand the details.

   A prompt appears to confirm this step.

3. Select Confirm.

   After it is confirmed, the search results update and the sample are shown as queued for the next step in the workflow.

   In Lab View, the sample aliquot is now ready to be worked on.

The Projects dashboard helps with managing projects and the day-to-day flow of samples through the lab. This dashboard provides a dynamic, project-centric view of current lab activity. It allows for the management of projects and the day-to-day flow of samples through the lab.

Overall Status Bar

The Overall Status bar provides a snapshot of current lab activity.

• Projects—The number of open and pending projects currently in Clarity LIMS. This number does not include closed projects.

• Samples—The number of samples in open and pending projects.

• Workflows—The number of workflows in which the samples are currently being worked through in the lab.

• Alerts—The number of unresolved alerts in the system. To trigger alerts, select Request manager review as the next step for a sample (in the Assign Next Steps screen).

Project, Sample, Workflow Snapshot

Additional information provides a snapshot summary of projects and samples, including the workflows to which samples are assigned.

No Workflow Assigned

• The number of projects containing samples that do not have a workflow assigned to them.

• The number of samples that do not have a workflow assigned to them.

In Progress

• The number of projects containing samples that are in progress and being worked on in the lab.

• The number of samples that are in progress and being worked on in the lab.

Workflow Complete

• The number of projects in which all samples have completed all workflows assigned to them.

• The number of samples that have completed all workflows assigned to them.

Projects Table

By default, all open projects display in the Projects table and are sorted by creation date (most recent first).

• Select any project in the table to view its details on the right.

• Projects that have unresolved alerts display an icon in the upper-right corner.

The Projects table allows filtering to display projects that meet certain criteria.

The drop-down list provides several filters. Consider filtering for the following use cases:

• Completed projects—Prepare data and invoices to be sent to clients.

• Projects containing samples that do not have a workflow assigned to them—Find the projects containing these samples, assign workflows to the samples, and start working on them in the lab.

• Projects assigned to a particular workflow or to a particular project—View and manage their progress in the lab. In this case, type the workflow/project name into the filter box and press the Enter key.

View Project Summary Information

Select a project to display summary information about the workflows and samples related to that project. The summary includes the following information:

• The number of samples in the project that have not been assigned a workflow.

• The workflows to which samples in the project are assigned. If needed, scroll to see all the workflows.

• The number of samples involved in each workflow.

• Any unresolved alerts in the project. Select the alert to view and resolve it.

• The project completion percentage.

View Project Workflow Details

Below the Projects table and summary, the workflows for the selected project are listed.

• Directly under each workflow name, the number of in-progress and completed samples currently in the workflow.

• Select In-progress samples to view all in-progress samples across all protocols in the Samples table.

• Select the Completed samples count to view those completed samples in the Samples table.

To view workflow details:

1. To the right of the workflow name, select the arrow.

   The expanded workflow details area shows the following information:

   • All protocols included in the workflow, and the number of samples in each of those protocols.

   • The percentage of project samples currently assigned to each protocol (represented by blue shading). Hover over the shading to see this percentage. The percentage is derived from the number of samples in the protocol divided by the total number of samples in the workflow.

2. Select a protocol to see the steps it includes and the samples assigned to those steps.

View Step and Sample Details

Select a protocol to see the following information display in the Samples table:

• The steps included in the protocol, and the submitted and derived samples that are in each of those steps.

• The sample name and the first three sample custom fields.

In the Samples table, the following features are available:

• View Alerts—Select an alert to go to the step in which the manager review was requested.

Run Automations on Derived Samples

Run automations on derived samples directly from the Samples table.

1. Select one or more derived samples (Ctrl + click to select multiple).

2. In the upper-right corner of the Samples table, expand the drop-down list and select an automation.

3. If the automation requires input, a prompt to enter a value displays. Enter a value and select Continue.

   NOTE: If the parameter name is truncated, hover over it to view the full name.

4. As the automation runs, the status is shown in the samples list.

Projects and Samples —Allows for project and sample management. Use this screen to create and manage , , and .

When you add samples to Clarity LIMS, you must add them to a project. Clarity LIMS uses projects as the basis for all work performed in the system.

There are two ways to add samples to projects:

• Add samples individually to one or more projects. See .

• Upload a sample list (Excel spreadsheet) to a project. See .

Sample Management

The Sample Management screen allows for convenient sample accessioning. On this screen, add multiple samples to a single project or to multiple projects, and modify samples already added to the system.

There are two ways to access the Sample Management screen:

• The main menu bar, which allows for adding samples to one project or to multiple projects.

• The Project and Samples tab, which allows for adding samples to a project or modifying samples already added to a project.

Add samples to one project or to multiple projects

1. On the main menu bar, hover over Projects and Samples tab and select Add Samples when the option displays.

2. In the Sample Management screen, select a project from the Project Name drop-down list. This selection auto-populates the fields in the Project Details area.

   • Edit the project details if necessary.

   • To upload files to the project, select Upload File.

3. In the Sample Details area, provide the following information:

   • Enter the name of the sample.

   • Choose a container from the drop-down list.

   • Enter the container name.

   • Complete any other applicable fields (mandatory fields are marked with an asterisk).

   NOTE: LIMS ID (Submitted Sample), Date Submitted, and LIMS ID (Container) fields are automatically populated after the sample is saved.

4. To upload sample files, select Upload File at the bottom of the Sample Details section.

5. To add another sample, select Sample +. Add this sample to the same project or select a different project from the Project Name drop-down list.

6. Repeat steps 3 to 5 as required.

7. When all samples are added, select Submit Samples. Clarity LIMS validates, saves the samples, and returns to the Project and Samples tab.

On the Project and Samples tab, the projects with recently added samples are automatically selected.

While adding samples, note the following details:

• Copy values across to adjacent samples by selecting the arrows to the left of the fields. Clarity LIMS automatically populates the Well field.

• If editing well information, make those changes last (before submitting the samples). Changes to Container, Container Name, LIMS ID (Container), and Sample Name may reorder the well locations.

• Use the paging buttons to scroll pages of samples.

Add Samples to a Selected Project

In this method, only add samples to the project selected. It is not possible to select a different project as described in the previous section of the documentation.

1. On the Project and Samples tab, select a project to add samples.

2. In the Submit Samples section, select Add Samples.

3. On the Sample Management screen, because the project has already been specified, the project details are automatically completed.

4. Follow steps 3 to 7 of the previous section to add the sample details.

Modify Samples

1. On the Project and Samples tab, select a project to add samples.

2. In the samples list, select the submitted samples to modify (derived samples cannot be modified).

3. Select Modify Samples.

4. Modify the sample and project details as required (the Project Name or Container Name fields cannot be modified).

5. To save the changes, select Submit Samples.
6. Clarity LIMS validates the modifications, saves the samples, and returns to the Project and Samples tab. On the Project and Samples tab, the projects containing the modified samples are automatically selected.

Remove Sample from View

On the Sample Management screen, hovering over a sample displays a small Remove from view (X) button in the upper-right corner.

The effects of selecting this button differ depending on the circumstances.

Upload and Modify Samples

If there are many samples to process, add them to the system by uploading a Microsoft Excel spreadsheet file (*.xls or *.xlsx). Use the same method to modify information for multiple samples.

By default, a maximum of 3456 samples can be uploaded from a single sample list file. To upload more than 3456 samples, divide the samples into multiple files.

Upload a Sample List

1. Navigate to the Projects and Samples tab.

2. In the Projects list, select a project to add samples. The Project Details area updates to show the details for the selected project.

3. Select Upload Sample List.
4. In the Upload File dialog, select Choose File and browse to and open the sample list file.

5. Select Upload File.

   As part of the upload process, Clarity LIMS validates the file to make sure the custom field data it contains meet the requirements, presets, and restrictions that apply to submitted samples. If the file contains invalid data, an error message displays.

6. When the upload process completes, the samples display in the Submitted Samples list for the project.

   The Submitted Samples list allows the following actions:

   • Hover over the Information icon for a sample to view the details associated with it.

   • Modify sample details.

   • Add samples to a workflow.

   • If samples have been created in error, delete them from the sample list and the project (provided no work has been done on them). To complete this action, select the samples and select Delete.

After uploading, the submitted samples can be assigned to a workflow. When they are assigned, the samples are available for lab scientists to work on.

Modify sample information

1. Navigate to the Projects and Samples tab.

2. In the Projects list, select the project containing the samples to modify.

3. Select Modify Samples.

   Clarity LIMS generates a sample list containing all samples in the project and downloads it.

4. Open the file in Excel. It contains the Clarity LIMS IDs of all samples and all custom field data.

5. Update the sample information as required.

Rules for modifying sample information

• A sample list can be uploaded/imported in which custom field values have been changed, removed, or added.

• While sample custom fields can only be updated, the sample list can contain other columns of data. The original data from the sample list does not have to be removed.

• If the system does not require the custom field, leave the cell blank or enter NULL.

  • A ‘blank’ value will leave existing data in the system intact.

  • A NULL value will clear any existing data in the system for that field.

• Clarity LIMS uses the information defined in the sample list (sample name, container type, and so on) and looks for matching samples in the project. If a matching sample is found, the system updates the sample with the values specified in the sample list.

Lab View shows the protocols and steps used in the lab, and the number of samples queued for each step. Use this screen to do the following:

• See recent lab activities.

• See in-progress steps and steps that are ready to be worked on.

• Start or continue working on samples.

• View and follow up on .

Ice Bucket

When users run a step in the LIMS, they typically select a destination container type from a preconfigured list in the Ice Bucket screen, and then proceed to the Record Details screen - where they scan the barcode of a new container to add it to the LIMS.

However, users may sometimes want to place samples into an existing container - that is, a container whose barcode has already been entered into the LIMS. This is easily achieved in the Ice Bucket screen.

Add samples to an existing container

1. In Lab View, open the step containing the samples you want to place into an existing container.

2. Select the samples and add them to the Ice Bucket.

3. In the Ice Bucket screen, in the Container Options panel:

   • In the Destination Container drop-down list, select the desired container type.

   • In the Find Existing Container field, type the name or Clarity LIMS ID of the container in which to place the samples. While typing, Clarity LIMS presents a filtered list of containers with matching names or Clarity LIMS IDs. Select the appropriate container from the list.

4. Click Begin Work to proceed to the Record Details screen.

Remove samples from a queue

Occasionally, you must remove samples from a workflow queue in Clarity LIMS. Only administrator users can perform this operation.

1. In Clarity LIMS, open the step containing the samples to remove.

2. Select one or more samples, expand the Options drop-down list and select Remove.

If necessary, complete the following actions:

1. Search for the samples in Clarity LIMS.

2. Requeue them for a previous step.

Manually Moving Samples to the Next Step

Usually, samples move through the system according to the sequence of protocols and steps defined in a workflow.

However, sometimes samples are moved into the next step manually.

Move samples to the next step

1. In Clarity LIMS, open the step containing the samples to move.

2. Select one or more samples, expand the Options drop-down list and select Move.

   The samples move into the subsequent step in the protocol.

Next Step Selection and Sample Routing

The following tables summarize the expected results when choosing next steps for these three output types.

Step output: Derived sample

Step output: Pool

Step output: Derivative

Samples must be assigned to an active workflow before they can be accessed and worked on from .

Assigning samples to workflows

1. On the main menu, navigate to the Projects and Samples tab.

2. In the Projects list, select the project containing the desired samples.

3. In the Samples and Workflow Assignment area, the Submitted Samples and Derived Samples tabs list all the samples included in the project. Select the tab that lists the desired samples. If no work has been performed on the samples, no derived samples are listed.

4. In the chosen samples list, select the samples to be assigned to a workflow. Use the following methods to select or deselect samples:

   • Select a group to select all samples in the group (the button label changes to Deselect Group).

   • Expand the group and select samples to add them individually. Use Shift + select to select multiple adjacent samples or Ctrl + select to select multiple nonadjacent samples.

   • To deselect samples, select them or select Deselect Group to deselect all samples in the group.

5. When finished selecting samples, select Assign To Workflow and select the desired workflow from the drop-down list.

   The list displays all the workflows that are currently active in the system.

6. In the samples list, a label displays showing the samples that are now assigned to a workflow. Select the X inside a label to remove that sample from the workflow.

   In the Workflows area on the right, the number of samples assigned to the workflow displays. Select the X in the upper-right corner to remove all samples from the workflow.

7. Repeat steps 3 to 6 to assign other samples to workflows, as required.

8. Assigned samples now display in Lab View, in the Available Work area, listed under the first protocol step of the selected workflow.

   To locate samples in the queue quickly, filter on the sample name.

As lab scientists work with samples in the lab, they may request a manager to review a sample at a certain step in the workflow. When a request for review occurs, an alert notification displays in Lab View, in the Recent Activities area.

1. In Lab View, in the Recent Activities area, select an alert to go directly to the step containing the sample to be reviewed.

2. Review the sample, add a comment, and select Finish Review.

   NOTE: You can also view and resolve alerts from

To requeue and rework samples, specific role-based permissions are required. For details, see .

Requeueing samples for a Step

Occasionally, a sample must be rerun through a particular step. For example, there may have been a technical error in the lab. More sequencing may be needed at the end of a workflow if there are not enough samples.

To solve this problem, return samples to the queue and repeat the step.

There are several ways to requeue samples:

• Search for the step with samples to requeue, view all samples that have completed this step, and choose the ones to requeue. See

• Search for a specific sample to requeue. See

Reworking samples from a previous step

In addition to requeueing samples for the same step, you can also rework samples from a previous step. For example, an action is needed if there is an insufficient quantity of a particular sample to meet the required target concentration level.

Overview of Steps and Master Steps

In Clarity LIMS, steps and master steps are techniques or procedures that are performed on a sample. They are the building blocks of the lab work.

Think of master steps as starting points to create the individual steps that are run in the lab.

• The master step <--> step relationship is one to many:

  • Each step is derived from a master step.

  • A master step may be used as the foundation for multiple steps.

• All steps are derived from a master step and inherit any properties configured on the master step.

• If you configure properties at the step level, those properties only apply to that particular step.

To understand how properties set on the master step propagate down to the step level, see .

Rules for Propagation of Master Step Properties

In Clarity LIMS, all steps are derived from a master step and inherit any properties configured on the master step.

The rules for how properties set on the master step propagate down to the step level apply to all properties. Those configured on the Master Step Settings configuration form and those configured on the .

• By default, master step properties are not set (values are null). Therefore, by default, the property settings do not propagate down to the derived steps. This means that you can set, or not set, the property freely at the step level.

• If you set a property on the master step, that property is locked (a Locked icon displays) at the step level, and cannot be modified.

In some situations, you can add to or reorder a locked property at the step level, but you can never remove the property. For example, on the Step Settings form:

• You can add and reorder the column headers that display in the Sample table, even if some of those column headers are set on the master step.

• You cannot remove column headers that are set on the master step.

Master Step Property Propagation Rules

When you add a master step property setting, the setting is also added to all steps derived from that master step.

When you update a master step property setting, the setting is also updated on all steps derived from that master step. This overrides any previous values that had been applied at the Protocol Step level.

When you remove a master step property setting, the setting is also removed from all steps derived from that master step. There are a few exceptions to this rule where appropriate defaults must be applied to keep the step in a valid, workable state.

The following table summarizes what happens at the step level when a property setting is removed from the master step.

About Step Types and Outputs

In Clarity LIMS, steps are categorized by type, where each type is based on the requirements and goals of the step, and the outputs generated by the step. Some step types have unique interfaces and properties designed to perform specific tasks, such as adding reagent labels or pooling samples.

The step type is also displayed on the Step Settings configuration form, but as a read-only property.

Step Inputs and Outputs

All step types must have a submitted sample or derived sample input, and may generate either derived sample outputs, measurement outputs, or no outputs.

Keep in mind that only one output type is permitted. A step cannot generate both a derived sample and a measurement output. The type of step you choose determines which output generation options display. For example:

• Selecting the Standard step type only displays settings for derived sample generation.

• Selecting the Standard QC step type only displays settings for measurement generation.

• Selecting the No Outputs step type only displays settings for no output generation.

Downstream Functionality

The type of step you choose also enables or disables certain functionality downstream. For example:

• Selecting the Pooling step type displays the Pooling screen when the step is run, allowing the ability to create pools of samples. Choosing this step type allows you to configure the number of aliquots used to generate the pools.

• Selecting the Add Labels step type displays the Add Labels screen when the step is run, allowing the ability to configure reagent label format options.

Rules and Constraints

• When creating a master step, you must choose a step type.

• When you have saved a master step configuration:

  • Step type cannot be changed.

  • The number of outputs generated can be adjusted, or switch from a fixed number to a variable number (Standard, Standard QC, Add Labels, Pooling, Analysis step types).

Step Types

The following step types are available in Clarity LIMS:

Standard

Standard steps can have a fixed or variable ratio of samples entering the step to derived samples being generated from the step. After saving, you can switch between fixed and variable.

Default step output: By default, this step type generates one derived sample for every sample tracked in the step.

Downstream functionality: Choosing this step type disables the Pooling and Add Labels screens. Derived sample outputs require placement.

Example steps of this type: Library Normalization, Fragment DNA

Standard QC

Standard QC steps may be included in QC protocols, and may also be included as inline QC steps in other protocol types.

Standard QC steps generate sample measurements, which can have a Fixed or Variable ratio of samples entering the step to measurements being generated.

Default step output: By default, this step type generates one measurement for every sample tracked in the step.

Downstream functionality: Choosing this step type disables the Pooling and Add Labels screens. You may configure a QC step to display or not display the Placement screen.

Example steps of this type: Bioanalyzer QC, NanoDrop QC, Qubit QC

No Outputs

The No Outputs step type does not generate any outputs. You can use this step type for sorting steps or for aggregate QC steps.

Default step output: This step type does not generate any outputs. (This is not configurable.)

QC aggregation is the final step in a QC protocol. This step aggregates the data from the previous Standard QC steps to determine the overall quality of the samples. At the end of the step, samples either pass QC and proceed to the next protocol, or fail QC and are rerun or removed from the workflow.

• At least one aggregate QC step is required in QC protocols.

• At a minimum, one Standard QC step must be run before QC aggregation can occur.

Downstream functionality: Choosing this step type disables the Pooling, Placement, and Add Labels screens.

Example steps of this type: Aggregate QC (DNA), Aggregate QC (RNA), Aggregate QC (Library Validation)

Add Labels

This step type is used to apply a reagent label (or molecular barcode) to each sample entering the step. It may be run on multiple tubes and on multiple plates. Running an Add Labels step allows for a permanent reagent label to be added to each sample. The label data appears while running the step, in a new column in the Sample Data table on the Record Details screen.

Add Labels steps generate derived samples, which can have a Fixed or Variable ratio of samples entering the step to derived samples being generated.

Default step output: By default, this step type generates one labeled derived sample for every sample that enters the step.

Downstream functionality: Choosing this step type disables the Pooling screen and enables the Add Labels screen.

Example steps of this type: Add Multiple Reagents, Adenylate Ends and Ligate Adapters, PCR Amplification.

Pooling

This step type allows for multiple samples to be pooled into a single sample/container for sequencing efficiency. The number of pools is determined while running the step. Samples typically have a label, which is used to differentiate each sample at the demultiplexing stage.

Pooling steps generate pools that are created from a Fixed or Variable number of aliquots.

Default step output: By default, for every sample that enters the step, one aliquot is used to generate pools.

Downstream functionality: Choosing this step type disables the Add Labels screen and enables the Pooling screen.

• The number of pools is determined on the Pooling screen.

• By default, users are prevented from pooling samples without labels or with identical labels. You can modify this on the Pooling Settings configuration screen.

Example steps of this type: Pool Samples

Analysis

Analysis steps allow data to be manipulated by scripts, for example, they may be used to trigger secondary analysis or import data post analysis.

Analysis steps behave similarly to Standard QC steps and generate sample measurements. They can have a Fixed or Variable ratio of samples entering the step to measurements being generated.

Default step output: By default, this step type generates one measurement for every sample that enters the step.

Downstream functionality: Choosing this step type disables the Pooling, Placement, and Add Labels screens.

Example steps of this type: Sample History Report, Process Summary Report

Demultiplexing

This is essentially an Analysis step that deals specifically with labeled samples. It separates pools of samples based on the label assigned to those samples.

Demultiplexing steps have a Fixed ratio of samples entering the step to measurements being generated.

Default step output: By default, this step type generates one measurement for every sample that enters the step.

Downstream functionality: Because samples are placed automatically by a script configured on the step, choosing this step type disables the Placement screen. Choosing this step type also disables the Pooling and Add Labels screens.

Example steps of this type: BCL Conversion and Demultiplexing.

Add and Configure Master Steps and Steps

Clarity LIMS includes preconfigured steps and master steps designed to support established lab processes. You can create additional steps and master steps to represent the procedures that are specific to your lab. There are two approaches:

• Create steps based on the preconfigured master steps. The steps you create inherit the properties of the configured master steps, and you can then set additional properties on the steps themselves.

• Create master steps, and then use them as the foundations on which to create your steps.

You can add the steps to protocols and workflows so that lab scientists can work with them in Lab View.

View Master Steps and Steps

The Lab Work screen provides an at-a-glance view of all steps and master steps configured in the LIMS, along with the protocols and workflows in which they are included.

1. On the main menu, select Configuration.

2. On the LIMS configuration screen, select the Lab Work tab.

   The Workflow, Protocol, Step, and Master Step navigation panel displays. This lists the workflows, protocols, steps, and master steps configured in the LIMS.

3. In the Master Steps list, select a master step to highlight it:

   • The Steps list updates, highlighting the steps derived from the selected master step.

   If multiple steps are derived from the same master step, the Master Steps list includes duplicate rows, each mapping to a different step, and each representing the same master step. All of these rows are highlighted.

   • The Protocols list updates, highlighting all the protocols that contain the highlighted steps.

   • The Workflows list updates, highlighting all workflows that include the highlighted protocols.

4. In the Steps list, select a step to highlight it: The Master Steps list updates, highlighting the master step on which the selected step is based. If multiple steps are derived from the same master step, the Master Steps list includes duplicate rows, each mapping to a different step, and each representing the same master step. All of these rows are highlighted.

   • The Protocols list updates, highlighting the protocol that contains the selected step.

   • The Workflows list updates, highlighting all of the workflows that include the highlighted protocols.

   Below the main navigation panel, the step and master step configuration forms display.

5. Select these tabs to switch between the forms and see which settings are configured on the step and which are configured on the underlying master step.

Master Step and Step Configuration Settings

Table 1 shows which settings must be configured on the master step and which may be configured on the master step or on the step.

Settings configured on the master step are locked at the step level. On the step configuration form, these settings display with a Locked icon.

Table 1: Master Step and Step Settings

Add a Master Step

1. On the Lab Work configuration screen, in the upper-right corner of the Master Steps list, select Add.

2. Below the main navigation panel, the master step configuration form displays.

3. To begin, type a name for your new master step.

5. Select Save to save your master step configuration.

When adding a master step, keep the following in mind:

• Each step is created from a master step. You can create multiple steps from the same master step.

• Any settings you configure on the master step are inherited by all steps derived from that master step.

Configure a Master Step

The following sections describe the settings available when configuring a master step. Note the following:

• Any settings saved as part of the master step configuration cannot be configured at step level. On the step configuration form, these settings display with a Locked icon.

• Some settings may be configured at the step level, as indicated in Table 1.

• The master step configuration form does not show the default setting values (this includes toggle switches).

Step Type

Step types are configured on master steps.

Steps are categorized by step type, where each type is based on the requirements and goals of the step, and the output generated by the step (derived samples, measurements, or aliquots).

The step type is set on the master step, and all steps inherit the step type of the master step on which they are based. After you have chosen a step type and have saved it as part of a master step configuration, you cannot change it.

The step type you choose determines which step milestones are available for configuration.

Output Generation

Configured on master step.

A step may generate a derived sample output, a measurement output, an aliquot output, or no output.

The type of step you choose determines which output generation options are available. Usually, you may choose to keep the default setting or modify the output generation configuration.

Output Naming Convention

Configured on master step.

By default, the name of the outputs generated by a step follows the naming pattern of the inputs to the step.

You can use tokens to configure the naming convention so that it resolves to other unique attributes of the output. These tokens function as placeholders that are replaced with actual values at run time. For example, for the Standard step type, the default naming convention resolves to the value of the {InputItemName} token.

The following table lists the default naming conventions for each of the step types.

Table 2: Default Naming Conventions for Step Types

To add a token:

1. Copy the token you want to use from the Tokens list and paste it into the Naming Convention field. If using multiple tokens, add a space between each entry.

2. Below the Naming Convention field, you can see a preview of how one or more tokens resolve. Some runtime-specific items, such as dates and times, do not preview exactly as they resolve at run time.

Automation

Automations are enabled on master step. Automation triggers may be set on master step or step.

A master step can be configured to update sample fields, assign QC flags, generate files, and submit files and command-line parameters to third-party programs, using automations and the Rapid Scripting API.

When you have configured an automation, you can enable it on one or more master steps and set its trigger location and style.

You can enable automations on master steps in two configuration areas of the LIMS:

• On the Automations tab, when adding/configuring an automation.

• On the master step configuration form.

After it is enabled on a master step, the automation becomes available for use on all steps derived from that master step.

You can set the trigger location and trigger style for an automation on the master step, or on the steps derived from that master step:

• On the master step—In this case, all steps derived from the master step inherit the automation and the trigger settings.

• On the steps derived from the master step—In this case, all steps inherit the automation from the master step, but you can configure different trigger settings for each step, if necessary.

To enable an automation on a master step:

1. In the Automation section, click the Automation configuration screen link. The Automation configuration screen opens, with the Step Automation tab active.

2. In the Automation Use section, select inside the Enable on the Master Steps field and select the master step on which to enable the automation. (If you make a mistake, select the X button to remove a master step from the field.)

3. Select Save.

4. Return to the master step configuration form. The automations are listed alphanumerically by name.

To set an automation trigger on a master step (or step):

1. In the Trigger Location drop-down list, select the stage of the step at which to enable the automation.

   • The list displays all available stages of the step from which the automation can be triggered.

   • Only valid options for the step are displayed, for example, the Pooling option only displays on Pooling steps, the Step Setup option only displays for steps on which the Step Setup screen is enabled.

   • To ensure sequence of execution, only one automation can be associated with each trigger location.

2. In the Trigger Style drop-down list, select how to initiate the automation. For example, automatically on entry to or exit from the screen or manually when a button is selected on the screen.

   The trigger location and style are saved with the automation configuration.

3. Repeat steps 1 and 2 to configure triggers for each automation added.

4. Save the automation configuration.

Instrument Types

Configured on master step or step.

You can specify the instrument/equipment types that may be used in a step. You can do this on the master step or at the step level. At run time, on the Record Details screen, the lab scientist selects from a list of instruments/equipment of that type.

Note also that instrument type/master step configuration is bidirectional - when adding an instrument type, you can select master steps to associate with that instrument type.

To enable an instrument type on a master step (or step):

1. In the Instrument Types section, select Add.

2. At the right of the screen, a list of instrument/equipment types displays. Select one or more instrument/equipment types and select the checkmark button.

   The instrument/equipment types are added to the master step/step configuration.

   • If necessary, you can remove an instrument type by clicking the X button.

   • Step configuration form only: You can reorder instrument types by dragging and dropping them. The order is reflected on the step Record Details screen, in the Instrument selection drop-down list.

3. Save the master step/step.

Reagent Kits

Configured on master step or step.

You can specify the reagent kits that may be used in a step. You can do this on the master step or at the step level.

Configuring reagent kits on the step/master step enables reagent lot tracking on the Record Details screen at run time.

Note also that reagent kit/master step configuration is bidirectional—when adding a reagent kit, you can select master steps to associate with that kit.

To enable a reagent kit on a master step (or step):

1. In the Reagent Kits section, select Add.

2. The reagent kits are added to the master step/step configuration.

   If necessary, you can remove a reagent kit by clicking the X button.

3. Save the master step/step.

Control Types

Configured on step.

You can specify the control types that may be used in a step. This is done at the step level.

Selected controls are then available to add to the Ice Bucket when running the step.

Note also that control type/step configuration is bidirectional—when adding a control type, you can select the steps to be associated with it.

To enable a control type on a step:

1. In the Control Types section, select Add.

2. At the right of the screen, a list of control types displays. Select one or more control types and select the checkmark. The control types are added to the step configuration.

3. Remove a control type by clicking the X button.

4. Save the step.

Step Milestones

Configured on master step or step.

When running samples through steps in the LIMS, each screen displayed represents a specific stage, or 'milestone' of the step.

Some screens display on all steps, while others only display on certain step types.

Add a Step

When adding steps to the LIMS, first select a protocol to include the new step, and a master step on which to base it. The new step inherits all settings configured on the master step.

To add a new step:

1. On the Lab Work configuration screen, in the Protocols list, select the protocol in which to add the new step.

2. In the upper-right corner of the Steps list, select Add.

   Below the main navigation panel, the step configuration form displays.

3. Type a name for the new step.

4. In the adjacent Master Steps list, select the master step upon which to base the new step.

   If creating a step within a QC protocol, the Master Steps list only displays master steps that are Standard QC and Aggregate QC step types.

5. Select Save (this button is not enabled until a master step is selected).

6. In the Protocols list, select the protocol again.

7. The step added displays at the top of the Steps list.

   • The '1' indicates that this is the first step in the protocol. (QC protocol steps are not numbered as they are typically not sequential.)

   • In the Master Steps list, the master step upon which the step is based is also highlighted.

8. Repeat steps 1–5 to add more steps to the protocol.

   • To delete a step, select it and select Delete.

   • To reorder steps within the protocol, drag and drop them.

9. Select Save.

   To drag and drop on a mobile or touch-screen device, touch and hold the item you wish to drag. After a moment, the item appears to lift off the page and its color changes to white. You can then drag the item and drop it into its new position.

Configure a Step

On the step configuration form:

• Any settings that were configured on the master step are locked. On the step configuration form, these settings display with a Locked icon.

• You can configure settings that were not configured on the master step. These settings only apply to the step.

• Settings not configured on the master step typically use the default value at the step level, unless those settings are configured on the step.

If not locked on the master step, the following settings can be configured at the step level.

• Automation triggers

• Instrument types

• Reagent kits

• Control types

• Step Milestones

Modify Master Steps and Steps

1. In the Master Steps list, select the master step you would like to modify.

2. Make your changes and select Save.

When modifying master steps and steps, keep the following in mind:

• You can change the master step on which a step is based, providing the new master step is of the same step type. The list of master steps is filtered to show valid options.

• If you remove configured settings from a master step, those settings on the derived steps revert to their default values, except if this would leave the step in an unworkable state. For example, you cannot remove the last container from a step. Exceptions to this revert to default rule are noted where applicable.

• If you rename a step, the Recent Activities list in Lab View continues to display the name of the step as it was when the step was run. This is because the step name in this case is derived from the activity record.

Delete Master Steps and Steps

1. In the Master Steps list, select the master step to delete.

2. On the master step configuration form, select Delete.

When deleting master steps and steps, keep the following in mind:

• You cannot delete a step if it is included in an active or archived workflow.

• You cannot delete a master step if it is used to generate a step that is in an active or archived workflow.

• You cannot delete a master step if it has already been used to create one or more steps. First delete the step, and then delete the master step.

To process many samples, add them to Clarity LIMS by importing a Microsoft Excel spreadsheet file (*.xls or *.xlsx). This method also applies to updating sample information.

Requirements

• The sample list must be in *.xls or *.xlsx format.

• The sample list's column header names must match the default fields in the LIMS.

• The following column header names cannot be changed: Sample/Name, Container/Name, and Sample/Well Location.

• The following columns must be populated: Sample/Name and any sample-level custom fields that the system administrator requires.

• By default, import up to a maximum of 3456 samples from a single sample list file. To import more than 3456 samples, divide the samples into multiple files.

Create a sample list

1. Download a sample list template from the Projects and Samples view in Clarity LIMS.

2. Open the sample list template.

   By default, the template contains the following information:

   • <TABLE HEADER> and <SAMPLE ENTRIES> tags (red/purple text).

     These identifying tags are required by the LIMS import process. Do not edit these tags.

   • Column headers (white text on blue background)

     These headers must reference the names of the fields containing the information to capture for a sample. If editing the column headers or creating additional headers, make corresponding changes to the fields in Clarity LIMS. See .

3. Populate the columns with the information associated with the samples. Enter the data into the rows between the <TABLE HEADER> and <SAMPLE ENTRIES> tags. Insert additional rows as needed.

4. Save the file and import it into a project (see ).

   If the sample list specifies a container name that does not exist in Clarity LIMS, the system creates the container.

Tips for data entry

• Enter dates using Excel date cell formatting.

• To preserve currency characters (e.g. $), currency is best entered as a string (rather than using the Excel currency category).

• Numbers can be entered either as numeric or string values.

• If there are drop-down lists of values in Clarity LIMS, enter these exact values in the sample list.

• Container well locations are always Row:Column. The actual dimensions depend on the container type configuration.

• Excel may sometimes automatically alter values, depending on the type of data being entered.

For example, for Boolean fields such as Stored On Site? below, numeric values of zero and false will evaluate to FALSE whereas non-zero numeric values and true will evaluate to TRUE. Other values will result in an error on import.

Configuring sample list spreadsheets for usability and speed

Spreadsheet programs like Microsoft Excel contain features for increasing usability and speed when entering data. For example, the following configurations are available:

• Add drop-down lists of options that correspond to options available in Clarity LIMS. Use the Named Range and Data Validation Excel features.

• Hide header columns required by the system but not required.

The Clarity LIMS support team can create custom, efficient sample list templates.

Consumables are the instruments, reagents, containers, and other equipment used in the lab. Configure these items in Clarity LIMS and associate them with specific master steps. When the steps are run in the LIMS, the consumables used are recorded.

Reagents Configuration Screen

Add the reagent kits and lots used in the lab to Clarity LIMS and enable them for use on specific steps. When lab scientists run samples through a step, they can record the reagent lots used.

All users logged into Clarity LIMS can access the Reagents configuration screen. However, their user permissions determine what they are allowed to do in this screen.

By default, only the Administrator role has the Configuration:update permission. For more on user roles and permissions, see User Roles and Configured Role-Based Permissions.

Add and Configure Reagent Kits and Lots

Enabling kits on steps makes them available for use in the lab. When running those steps, the reagent lots used are recorded

When a new reagent kit is added, it is not a requirement to enable it on a step. It can be enabled at any time.

Reagent kit/step configuration is bidirectional. Enable a reagent kit on a step in the following situations:

• When adding reagents on the Reagents configuration screen (described in this section).

• When configuring a master step or step. For details, see #add-and-configure-master-steps-and-steps.

NOTE: The Configuration:update permission is required to add new reagent kits to Clarity LIMS.

Add a New Reagent Kit

1. On the main menu, select Configuration.

2. On the configuration screen, select the Consumables tab, then select Reagents.

3. On the Reagents configuration screen, select New Reagent Kit.

4. Type a name for the reagent kit. This name displays in queues of steps on which use of the reagent kit is enabled.

5. Enter details for the reagent kit to help with future reordering:

   • Supplier: Enter the commercial vendor name.

   • Cat. #: Enter the catalog number.

   • Website. Enter the website of the commercial vendor. When viewing details for the reagent kit, select the link to open the web page in a new browser window.

   • In the Reagent Kit Use section, the status of the new kit is set to Active. This status means that it is available to be used in the lab (after it is enabled on steps).

6. Select Save to add the new reagent kit.

   The new kit displays in the Reagent Kits list.

Enable a Reagent Kit on a Step

1. On the Reagents configuration screen, in the Reagent Kits list, select the kit to enable on steps.

2. In the Reagent Kit Use area on the right, compete the following actions:

   • Select a protocol from the drop-down list. Type the first few letters of the protocol to filter the list.

   • In the adjacent list, select the step on which to enable the reagent kit.

   • Enable the control on additional steps, if necessary.

3. Select Save. The Reagent Kits list now indicates that the kit has been enabled on the selected steps.

Add a Reagent Lot

1. On the Reagents configuration screen in the Reagent Kits list, select the kit for which you would like to add a new lot.

2. Below the Kit Details in the Lots area, select New Lot.

3. In the Lot Details area, enter the lot name.

4. [Optional] Enter additional details about the lot, such as the lot number and expiry date.

   • Specify a storage location and add notes about the reagent lot. For example, use this field to note why a lot is being archived).

   • Clarity LIMS automatically populates the LIMS ID and Created and Modified dates.

5. Select Save.

   The new lot displays in the Reagent Kits list.

By default, when a new lot is added, the status is Pending. The Status of Reagent Lot slider at the bottom of the Lot Details area controls the lot status.

Reagent Kit and Lot Status

The status of a reagent kit may be Active or Archived. The status of a reagent lot may be Pending, Active, or Archived.

Note the following details about reagent kit status:

• Active reagent kits are in use, or are available for use, in the lab workflows. By default, when a new kit is added, the status is saved as Active.

• Archived reagent kits are kits that are not currently in use, or available for use, in the lab workflows. Configuration details for archived kits are saved, so reactivation is easy.

Archived kits are listed at the bottom of the main Reagent Kits list in the Archived Reagent Kits group.

Note the following details about reagent lot status:

• Active reagent lots are in use, or are available for use, in the lab. Select the active reagent lots as they record work for a step.

• Pending reagent lots have been ordered but not yet received in the lab. They are not available for selection by lab users running steps in Clarity LIMS. By default, when a new lot is added, the status is saved as Pending.

• Archived reagent lots have typically expired or been used up. They are not available for selection by lab users. Note the following information:

  • When the expiry date for a lot has passed, Clarity LIMS automatically archives the lot.

  • Archived lots that have passed their expiry date cannot be reactivated.

  • Archived lots display in an Archived Reagent Lots group within the Reagent Kit details list.

Activate and Archive Reagent Kits and Lots

Activate and Achieve Reagent Kits

1. In the Reagent Kits list, select the kit to be archived or reactivated.

2. In the Reagent Kit Use area on the right, select Archived / Active.

3. Select Save.

Activate and Archive Reagent Lots

1. In the Reagent Kits list, select the kit containing the lot to be activated or archive

2. At the bottom of the Lot Details area on the Status of Reagent Lot slider, select Active / Archived.

3. Select Save.

Delete Reagent Kits and Lots

1. In the Reagent Kits list, select the reagent kit or lot to delete.

2. In the Kit Details/Lot Details area on the right, select Delete.

When deleting reagent kits and lots, keep the following in mind:

• Only reagent kits and lots that have not been used in a step can be deleted.

• If a kit or lot has been recorded in a step, or is being used in a step, it cannot be deleted. The Delete button is not enabled.

The Instruments Configuration Screen

Add the instruments and equipment used in your lab to Local Analysis Software, and associate these items with specific steps. When running steps in the LIMS, lab scientists can record the instruments and equipment used.

All users logged into the LIMS can access the Instruments configuration screen. However, what they are allowed to do in this screen is determined by their user permissions.

By default, only the Administrator role has the Configuration:update permission. For more on user roles and permissions, see User Roles and Configured Role-Based Permissions.

Add and Configure Instruments

When adding instruments to Clarity LIMS, there are two main steps involved:

1. Add a new instrument type (Configuration:update permission required).

2. Select an instrument type and then add a new instrument of that type. You cannot add an instrument without first selecting an instrument type

When initially setting up the system, add all the instrument types used in the lab. For example, HiSeq 3000, 2100 Bioanalyzer, NanoDrop 2000. Any logged in user can then add specific instruments to each type.

Add a New Instrument Type

1. On the main menu, select Configuration.

2. On the configuration screen, select the Consumables tab, then select Instruments.

3. On the Instruments configuration screen, select New Instrument Type.

4. In the Instrument Type Details area, complete the following required information:

   • Enter the name of the type of instrument or equipment you are adding.

   • In the Vendor drop-down list, select an existing vendor from the list, or select Create new and type the new vendor name into the field. After you create a vendor, it is added to the list and can then be selected when creating other instrument types.

   • In the drop-down list that displays, select one or more master steps on which to enable this instrument type.

   • To remove a step from this field, select the X to the left of the step name.

   The instrument type is made available for use on all steps that are created from the selected master steps. When running those steps in the LIMS, the appropriate instrument can be selected from the Record Details screen. This configuration is bidirectional - when configuring a master step, you can select instrument types to associate with that master step.

5. Select Save.

   The new instrument type displays in the Instrument Types area. The ' zero instruments ' label indicates that no instruments of this type have yet been added

Add a New Instrument

1. On the Instruments configuration screen, in the Instrument Types area, select the appropriate instrument type.

2. Select New Instrument.

3. In the Instrument Details area, enter the details for this instrument.

   • Instrument Name: Enter the name of the instrument. (This is the only required field.)

   • Serial number: Enter the serial number of the instrument, or other instrument-specific information.

   • Expires: Select the expiry date (or calibration date) of the instrument or equipment.

   Valid dates are the current date or any date in the future.

   After an instrument has been saved, a label displays next to this field. The label shows the number of days, and then hours, remaining before the instrument expires, or warns that the instrument has expired.

   The LIMS automatically archives the instrument when the expiry date is reached (see #instrument-status).

   • Software Name: Enter the name of the instrument software.

   • Software Version: Enter the instrument software version number.

4. Select Save.

   In the Instrument Types area, the new instrument is nested under its instrument type.

5. To create another instrument of the same type, select Add Another New Instrument.

   When creating instruments, note the following:

   • A LIMS ID is automatically assigned to the instrument.

   • The instrument record Created date is automatically populated.

   • The instrument record Modified date is automatically populated; this field keeps track of any changes made to the instrument details.

   • By default, the instrument status is set to Active. See #reactivate-an-archived-instrument.

Instrument Status

The instrument Status toggles between Active and Archived. By default, when adding a new instrument, its status is Active.

Active instruments:

• These instruments are in use, or available for use, in your lab workflows; they can be selected by lab users as they record work for a protocol step.

• Users may edit the details of Active instruments.

Archived instruments:

• These instruments are not currently in use in lab workflows (for example, they may be expired or under repair), and are not available for selection by lab users working in the LIMS.

• When the expiry date for an instrument has passed, the LIMS automatically archives the instrument.

• The details of Archived instruments are read-only. They may be viewed, but not edited.

• Archived instruments are listed together in a single Archived Instruments group (no subgrouping by type), at the bottom of the Instrument Types area. If an archived instrument is reactivated, it once again displays under its respective instrument type.

Edit in Instrument Types and Instruments

When editing instrument types and instruments, keep the following in mind:

• Only users with the Configuration:update permission type can edit instrument types.

• Changes made to an instrument type, or to any instruments of that type, are reflected on all future steps on which the instrument type is enabled.

• Steps that have already been run are not affected by changes made to instrument types or instruments.

Delete Instrument Types and Instruments

When deleting instrument types and instruments, keep the following details in mind:

• To delete instrument types, the Configuration:update permission is required.

• When deleting an instrument type, all instruments of that type are also deleted and are no longer available for selection on steps.

• You cannot delete an instrument type if any instruments of that type are in use.

• You cannot delete an instrument if that instrument has been used in a step.

Reactivate an Archived instrument

1. In the Instrument Types area, expand the Archived Instruments section and select the instrument to reactivate.

2. If the instrument has not expired, select Activate.

3. If the instrument has expired, reset the expiry date to a date in the future, and then select Activate.

4. Select Save.

   In the Instrument Types area, the reactivated instrument displays under its instrument type. The instrument may now be selected when running steps.

Labels Configuration Screen

Add a label group for each reagent category used in your lab, and then add labels to the groups. Each label represents a reagent type (or molecular barcode) within the group/category.

Select the label groups to be used in the step when configuring the properties of steps generated from an Add Labels master step type.

To access the Labels configuration screen, the Configuration:update permission is required. Users who do not have this permission do not see the Labels option displayed under the Consumables tab.

By default, only the Administrator role has the Configuration:update permission. For more on user roles and permissions, see User Roles and Configured Role-Based Permissions.

Add and Configure Labels and Label Groups

When adding label groups and labels to the LIMS, there are several main steps involved:

1. Add a new label group.

2. Then, to add labels to the group:

   • Download a template label list (Microsoft® Excel® file) from the Labels configuration screen.

   • Add reagent type details to the downloaded template.

   • Upload the completed label list.

Add a New Label Groups

1. On the main menu, select Configuration.

2. On the configuration screen, select the Consumables tab and then select Labels.

3. On the Labels configuration screen, select New Label Group.

4. In the Label Group Details area, enter the name of the label group you are adding.

   • Numeric names are not permitted.

   • Duplicate names are not permitted.

   • You may use the name of a previously deleted label group.

5. Select Save.

   • The new label group is listed in the Label Groups list. Because there are no labels in the group, no count displays.

   • The Upload Label List and Download Label List buttons display in the Label Group Details area.

Add Label to Label Groups

1. On the Labels configuration screen, in the Label Groups list, select the label group to which you want to add labels.

2. In the Label Group Details area, select Download Label List to download the template.

3. Open the template in Excel. It has two example label entries containing the following information:

   • Group Name (column A): Prepopulated with the name of the label group you selected in the LIMS.

   • Label ID (column B): No information is provided in this column as it is populated by the LIMS.

   • Label Name (column C): Provides examples of label name (reagent type) formats.

   • Sequence (column D): Provides examples of sequence properties of theIndex special type of the reagent type. Dual-indexes may be used, separated by a hyphen.

4. To complete your label list, add new rows between the opening and </LABEL ENTRIES> closing tags and enter reagent label information into these rows:

   • Group Name: (Required on upload) Enter the name of the label group (reagent category) into which you are adding labels.

   • Label ID: Leave this column empty. It is populated by the LIMS when you upload your completed label list.

   • Label Name: (Required on upload) Enter the names of the reagent labels (reagent types) you would like to add to the LIMS, using one of the example formats.

   • Sequence: (Optional on upload) Enter the index sequence of the Index special type of the reagent type, for example, "ATCACG." You may enter dual-indexes, separated by a hyphen.

5. Save your label list file.

   • Return to the Labels configuration screen, select Upload Label List and upload your completed labels list. If there are errors in the list, the upload does not complete. Refer to #label-list-upload-error.

   • In the Label Groups list, the label count shows the number of labels in the group.

Edit and Delete Label Groups

When editing/deleting label groups, keep the following in mind:

• The only item you can change directly in the LIMS is the label group name.

• To make changes to the labels within the group, you must upload a modified label list. See #edit-and-delete-label.

• Deleting a label group does not affect historical run data. This information is preserved in the LIMS.

Edit and Delete Label

When editing and deleting labels (reagent types), keep the following in mind:

• Changes you make to a label are reflected on all future steps on which the label is applied.

• Steps that have already been run are not affected by changes you make to labels. The labels are mapped to samples in the run and historical run data are preserved.

Label List Upload Error Conditions

When uploading a label list, the following conditions result in an error:

• One or more of the four headers (Group Name, Label ID, Label Name, Sequence) is missing or misspelled.

• Attempting to rename a label to the same name as an existing label within any label group.

• Attempting to rename a label to the same name as an existing label—even if you are also renaming the other label at the same time.

• Adding a label with the same name as another label within any label group.

• Attempting to edit a label without providing the Label ID.

• Providing labels for the wrong group. That is, the Group Name column does not match the name of the label group into which you are uploading labels.

• Providing a sequence for a reagent that does not have the 'Index' special type.

Controls Configuration Screen

Controls behave like special samples that can be enabled at specific points in your workflows. However, unlike samples, controls do not need to belong to a project and do not have to be assigned to a workflow.

Add the control samples used in the lab to Clarity LIMS, and enable them for use on steps. When running a step on which control samples are enabled, the lab scientist can add those control samples to the Ice Bucket.

All users logged into the LIMS can access the Controls configuration screen. However, their user permissions determine what they are allowed to do in this screen.

By default, only the Administrator role has the Configuration:update permission. For more on user roles and permissions, see User Roles and Configured Role-Based Permissions.

Add and Configure Controls

There is no limit to the number of controls you can create or the number of steps on which you can enable a control. When adding a new control, you are not required to enable it on a step. You can do this action at any time.

Control sample/step configuration is bidirectional. Enable a control sample on a step in the following situations:

• When adding control samples on the Controls configuration screen (described in this section).

• When configuring a step (see #add-and-configure-master-steps-and-steps).

Add a New Controls

1. On the main menu, select Configuration.

2. On the configuration screen, select the Consumables tab, then select Controls.

3. On the Controls configuration screen, select New Control.

4. Type a name for the control sample. This name displays in queues of steps on which controls are enabled. This field is the only required field.

5. [Optional] Enter additional details for the control sample:

   • Supplier—Enter the commercial vendor name. If this control sample was made in the lab, enter in-house.

   • Cat. #—Enter the catalog number.

   • Website—Enter the website of the commercial vendor. If it is an in-house control, enter the URL of the internal web page that contains details of the in-house control. When viewing details for the control sample, lab scientists can select the link to open the web page in a new browser window.

6. In the Control Use section, note the following defaults:

   • The status of the new control is set to Active.

   • The new control is not flagged as a single step only control.

7. Select Save.

   The new control displays in the Control Samples list.

Enable controls on a step

Enabling controls on steps makes them available for use in the lab.

To enable a control sample on a step, complete the following steps:

1. On the Controls configuration screen in the Control Samples list, select the control to enable on steps.

2. In the Control Use area, select the protocol that includes the step on which you want to enable the control. Type the first few letters of the protocol to filter the list.

3. In the adjacent list, select the step on which you want to enable the control.

4. Enable the control on additional steps, if necessary.

5. Select Save.

   The Control Samples list now indicates that the control has been enabled on a step. Hovering over the 'On 1 step' label displays a popup that shows the protocol and step involved.

Control Use Settings

Control Status

The status of a control may be Active or Archived.

• Active controls are controls that are in use or available for use in the lab workflows.

• Archived controls are controls that are not currently available for use in the lab workflows.

  • Lab users do not see archived controls when initiating steps.

  • Configuration details for archived controls are saved, so it is easy to reactivate them.

In the Control Samples list, archived controls are listed in their own group. Select the arrow to expand the list and view control details.

Single Step Only Controls

Single step only controls do not progress in workflows. When completing a step, lab users do not need to select a Next Step for these controls.

Use this option to represent single-use, disposable samples such as QC standards, molecular weight ladders, and blanks.

Archived and Reactivate Controls

Archived Controls

1. In the Control Samples list, select the control to archive.

2. On the Status of Control slider, select Archived.

3. Select Save.

Reactivate and Archived Controls

1. In the Control Samples list, expand the archived control group and select the control to be activated.

2. On the Status of Control slider, select Active.

3. Select Save.

Delete Controls

When deleting controls, keep the following details in mind:

• You can only delete control samples that have not been used in a step.

• If a control sample has been recorded in a step, or is currently being used in a step, you cannot delete it. The Delete button is not enabled.

To delete a control:

1. On the Controls configuration screen in the Control Samples list, select the control to delete.

2. In the Control Sample Details area on the right, select Delete.

This section describes two tasks that Clarity LIMS administrators are often required to perform:

• Temporarily prevent a user from logging in by archiving the user.

• Email a link to a user that allows them to reset their Clarity LIMS password.

Archive a User

1. On the main menu, select Configuration.

2. Select User Management.

3. Select the Users tab to see a list of all current active and archived users in the system, categorized by role.

4. Select the user to archive.

   The details for the selected user display in the User Details area on the right. The Status slider displays the current status of the user.

5. Select Archived to temporarily archive the user.

6. Select Save.

By default, every new user created in Clarity LIMS is an active user and can sign in to Clarity LIMS with their username and password.

Reset a User Password

1. On the main menu, select Configuration.

2. Select User Management.

3. Select the Users tab to see a list of all current active and archived users in the system.

4. Select the user whose password is to be reset.

   The details for the selected user display in the User Details area on the right.

5. Select Login and Password and select Reset password.

   This sends the user a link that allows them to reset their password.

The Send login instructions option sends the user the following information:

• The URL for the login screen.

• Instructions on how to set their login password.

• This email is sent automatically when a new user is created, but you may occasionally need to resend it.

User Management Configuration Screen

• Users are the individuals who have access to the Clarity LIMS interface. Because each step in Clarity LIMS is associated with a user, you can make use of user profiles to track the work moving through your lab. While users are associated with the steps they perform as part of a project, they are not directly associated with that project—unless they are assigned as the project client.

• Clients are directly associated with projects in Clarity LIMS. When you create a project, you must associate it with a client. Clients differ from users in that they are not able to log in and access the Clarity LIMS web interface. They are typically external collaborators or customers who submit samples to the lab.

• Accounts must be directly associated with projects, users, and clients that are created in Clarity LIMS.

  NOTE: Viewing user/client/account details, and adding, modifying, and deleting users/clients/accounts are role-based permissions. For more information, see Configured Role-Based Permissions.

Add and Manage Users and Clients

This section describes how to add and manage users and clients in Clarity LIMS.

When creating users, keep the following in mind:

• The username must be unique among active users in the system. This is validated when you save the user details.

• If the username is already associated with an existing user, an error message displays and you are not be able to save the new user profile.

• All users must provide their email address and reset their password upon upgrading their software to v5.4 (or later).

Add a User

1. From User Management, select the Users tab.

2. Select inside the Role field to display a drop-down list of roles:

   • Select the role to assign to this user.

   • To remove a role from this field, select the X to the left of the role name.

3. [Optional] Enter a title, phone number, and fax number for the user.

4. Select Save.

   An invitation email is automatically sent to the user. This email includes the login screen URL and information on how to set the login password. You may resend the login instructions email at any time (see #modify-user-details).

   The user displays in the Users list.

5. [Optional] By default, the status of a new user is set to Active, which means that they can log in to Clarity LIMS. To temporarily prevent a user from logging in, change this setting by selecting Archived. (See also Manage User Access)

Modify User Details

1. From User Management, select the Users tab.

2. Select the user to modify.

3. In the User Details area, modify the details as required. If you change the username, a password reset email is sent automatically to the user.

4. Select Login and Password to access the following options:

   • Send login instructions—Choose this option to re-send the user the login screen URL and information on how to set their login password.

   • Reset password—Choose this option to send the user a link that allows them to reset their login password (see Manage User Access).

5. Select Save.

Delete a User

1. From User Management, select the Users tab.

2. Select the user to delete.

3. In the User Details area, select Delete.

When deleting users, keep the following in mind:

• You cannot delete a user if that user has logged in to Clarity LIMS.

• You cannot delete a user if that user is associated with a project (eg, the user is the project client).

• Deleting a user removes them from Clarity LIMS. You may instead prefer to archive the user or temporarily remove their access to the system. For details, see Manage User Access.

Add and Modify Clients

When adding new clients, each client must be a unique entry in the LIMS.

To add a client:

1. From User Management, select the Clients tab.

2. Select New Client.

3. In the Client Details area, complete the following required information:

   • Enter the first name and last name of the client.

   • Select inside the Account field and select the client account from the drop-down list.

   • Enter the client email address.

4. [Optional] Enter client title, phone number, and fax number.

5. Select Save.

   The user displays in the Clients list, under their account name.

Delete a Clients

A client cannot be deleted if that client is associated with a project.

1. From User Management, select the Clients tab.

2. Select the client to delete.

3. In the Client Details area, select Delete.

Add and Manage Accounts

Accounts are the organizations with which a facility conducts business. In the Clarity LIMS Projects and Samples screen, select the existing account from the Account drop-down list to associate projects and samples with it.

To create a new account, type directly into the Account field.

For Clarity LIMS v6.2 and later, you can also create a new account through the Accounts section of the User Management tab that is under Configuration.

Add a New Account

1. From Configuration, select the User Management tab.

2. Select the Accounts tab.

3. In the Account Details area, select New Account.

4. Type a name for the account and complete any other applicable fields (eg, Billing Address).

5. Select Save.

Modify Account Details

1. From Configuration, select the User Management tab.

2. Select the Accounts tab.

3. In the Accounts list, select the account that you want to modify.

4. In the Account Details area, update the fields that need to be modified.

5. Select Save.

Delete an Account

1. From Configuration, select the User Management tab.

2. Select the Accounts tab.

3. In the Accounts list, select the account that you want to delete.

4. Select Delete.

   You cannot delete an account that is associated with a user or project.

After signing into Clarity LIMS, you can update some of the details associated with your profile, including your password, email address, and profile photo.

Update User Profile

1. In Clarity LIMS, at the right of the menu bar, select your username and then select Profile.

2. The Profile page opens, displaying the details associated with your user profile.

3. On this page, you can:

   • Change your password.

   • Change your email address.

   • Upload an image to associate with your profile.

Reset a forgotten password

1. On the Sign In screen, click the Forgot your password link.

2. In the Reset Your Password screen, enter your username or email address and click Submit.

Clarity LIMS users are assigned roles. These roles control permissions and the ability to:

• Access certain Clarity LIMS features.

• Perform certain actions.

• Sign in to the Clarity LIMS interfaces.

In a typical LIMS lab environment, there are four primary user roles:

• #system-administrator-and-facility-administrator

• #researcher

• #collaborator

The following sections describe the default permissions of the four primary user roles. Some user role permissions are configurable (see Configured Role-Based Permissions).

System Administrator and Facility Administrator

By default, both the System Administrator and Facility Administrator user roles have access to:

• All configuration areas of the Clarity LIMS web interface, allowing them to:

  • Add and configure workflows, protocols, and steps.

  • Add consumables—reagents, controls, instruments, reagent labels, containers.

  • Add and configure custom fields.

  • Add and configure automations.

• Supervisory and lab management functions in the Clarity LIMS web interface, allowing them to:

  • Review escalations.

  • Remove samples from workflows.

  • Move samples into the next step in a workflow.

  • Access the Overview and Projects dashboards.

• User management, allowing them to:

  • Create, modify, and delete user accounts.

  • Modify user roles and permissions.

  • Approve access requests from external collaborators.

Researcher

The Researcher role is typically assigned to the laboratory scientist. By default, individuals who are assigned this user role are able to:

• Log in to Clarity LIMS.

• Access Lab View.

• Manage and work with samples contained in all projects in the system.

• Edit their own user profiles—ie, they can change their own passwords and other profile information.

• Access three Consumables configuration areas: Reagents, Controls, and Instruments, and do the following.

  • View reagent kits and add new reagent lots to those kits (researchers cannot create reagent kits).

  • View controls.

  • View instrument types and add new instruments to those instrument types (researchers cannot create instrument types).

  • Reactivate expired (archived) instruments by resetting the expiration date.

Collaborator

The Collaborator role is assigned to external collaborators who interact with Clarity LIMS using the LabLink Interface.

The Collaborator role is supported in v5.3 and later. It is not supported in v5.0.x to v5.2.x.

An external person can request a user ID through LabLink. By default, when the request is approved by an administrator, the collaborator is able to:

• Sign in to LabLink.

• Create, view, and delete projects. (Collaborators are automatically given full permissions to projects they create.)

• Submit samples to projects, and delete samples from projects.

By default, collaborators do not have access to the main Clarity LIMS web interface.

Containers Configuration Screen

Clarity LIMS is a container-based system requiring that samples reside in a container at every step of a workflow. Add the types of containers used in your lab to Local Analysis Software and enable them for use on specific steps.

When running a step in the LIMS, the lab scientist scans in the container barcode and proceeds to the Ice Bucket screen. In the Ice Bucket, the output container types that can be used in the step are listed.

To access the Containers configuration screen, the Configuration:update permission is required. Users who do not have this permission do not see the Containers option displayed under the Consumables tab.

By default, only the Administrator role has the Configuration:update permission. For more on user roles and permissions, see User Roles and Configured Role-Based Permissions.

Add and Configure Containers

When adding a new container to the LIMS, you are adding a container type (ie, a tube, a 96 well plate, a flow cell). When the container barcode is scanned, an instance of that container type is added.

Add a Container Type

1. On the main menu, select Configuration.

2. On the configuration screen, select the Consumables tab, then select Containers.

3. On the Containers configuration screen, select New Container.

4. In the Container Details area, enter the name of the container type you are adding. This is the only required field. When you have entered a name, the Save button becomes available.

5. [Optional] Specify the details of the rows and columns in the container:

   • In the Number fields, enter the number of rows and columns in the container.

   • Use the Naming toggle to specify whether the rows and columns have Alphabetic or Numeric labels.

   • For numeric rows and columns, use the Start at field to specify the number at which the row/column labels start.

6. [Optional] If you enter 1 in both row and column Number fields, an additional Yes/No toggle setting displays, asking "Do you want to skip the placement screen?".

   • Yes—The LIMS does not display the placement screen when the step is run. It automatically places the samples into the container.

   • No—The placement screen displays samples that need to be manually placed into the single well.

7. [Optional] List any unavailable wells (ie, wells in which samples must not be placed). Specify these in a comma-separated format, for example, A:1, A:2, A:3, A:4.

   Note the following:

   • If you switch between Numeric and Alphabetic rows/columns, the list of unavailable wells updates to reflect the change.

   • If you change the Start at number for numeric rows/columns, the list of unavailable wells updates to reflect the change.

   • If you specify an invalid unavailable well, or change the dimensions of the container such that one or more of the specified unavailable wells becomes invalid, the List unavailable wells field turns red.

   • The Save button is only available when all specified unavailable wells are valid.

8. Select Save.

Specify Unavailable Wells

To prevent lab users from placing samples in specific wells of a container, list the unavailable wells in a comma-separated list. Each well must be listed individually. You cannot enter a range.

Wells that are marked as unavailable are shown with a dashed line border in the sample placement screen. If a sample is placed into an unavailable well, a Destination is unavailable error message displays.

Edit Container Type Details

1. On the Containers configuration screen, in the Containers list, select a container type.

   The Container Details area displays the details for the selected container type.

2. Edit the details as required.

3. Select Save.

When editing container type details, keep the following in mind.

• To view and edit container types, the Configuration:update permission is required.

• Changes made to a container type are reflected on all future steps on which that container type is enabled.

• Steps that have already been run are not affected by changes made to container type details.

• When a container type has been used, its row, column, and unavailable wells settings are not editable.

Delete Container Types

1. On the Containers configuration screen, in the Containers list, select a container.

   The container details display on the right.

2. Select Delete.

3. Confirm the deletion.The container is no longer be available for selection on steps.

When deleting container types, keep the following in mind:

• To delete container types, the Configuration:update permission is required.

• Container types cannot be deleted if an instance of that container type is in use, or has been used, in a step.

The Clarity LIMS automated QC system is configurable. This allows administrators to determine which QC master steps and steps are required for aggregation, the criteria to apply to each master step/step, and the field values to be copied up to aggregation.

The following features are provided:

• Preconfigured protocols for DNA Initial QC and RNA Initial QC that include master step templates for Bioanalyzer, NanoDrop, Qubit, PicoGreen, CaliperGX, TapeStation, and Aggregate QC.

• Custom field-based storage of key QC results for both automated and spreadsheet-based manual storage.

• Custom field-based criteria (Source Data Field, Operator, and Threshold Value) for QC steps that allow for automatic assignment of QC flags triggered on the storage of a QC result file.

• QC protocol filter configuration that allows you to determine to which QC step samples are queued and which must be completed before aggregation can occur.

• Automated aggregation of QC results and assignment of QC flags, from individual step right up to the sample undergoing QC, with the option of using custom field-based configuration to update Concentration (and other fields) from a particular QC result.

• Easy access to individual sample QC measurements and flags, allowing you to review results, see the criteria evaluated, and the resulting QC flags assigned.

• Excel-based log files, attached to the aggregation step, clearly show the criteria evaluated, the resulting QC flag assigned, and which individual QC test results were used to update the custom field values on the sample undergoing QC.

The Advanced Search function is included in Clarity LIMS v6.1 or later. Advanced Search allows you to search for specific criteria and create relationships that are used to locate information stored in the system. You can use Advanced Search to build detailed search strings (including grouped and nested strings). These search strings provide the search engine with precise instructions on what to look for in the system.

Access Advanced Search

You can use the search toolbar to select Advanced Search from the drop-down list. This selection takes you to the Advanced Search page. You can also access the Advanced Search page directly at /clarity/advanced-search.

Users with Read-Only permissions cannot perform a search using Advanced Search. If a user with Read-Only permissions must use Advanced Search, enable access as follows.

1. Locate the file on the server (/opt/gls/clarity/tomcat/current/lib/activity-management-ui-config.groovy). Create a backup of the file before proceeding.

2. Open the file and add the following code:

   // To grant Advanced-search access to Readonly user

   readonly.allowUrlMap = [

   [post: ['/clarity/api/advanced-search']]

   ]

3. Restart Clarity LIMS.

Create Search Strings

1. From the query builder panel, select a category from the Search drop-down list.

2. Select Add to add one or more search conditions to the selected category.

   If a search condition has other conditions following it, an AND/OR operator is displayed. A search condition contains the following components:

   • Constraining Entity

   • Field

   • Constraint

   • Constraint Value

3. To remove a condition, select Delete (X) to the right of the condition.

Grouping Controls

Use grouping controls to group search conditions by selecting the Show Grouping Controls checkbox. When these controls are enabled, select the checkboxes next to the conditions, and then select Group to group them together. The conditions and groups must be adjacent to each other.

The Query Preview field uses the numbers of each condition to display your search string. To separate the conditions, select the checkbox within the group, then select Ungroup.

Use Undo and Redo Operations

The Undo and Redo operations record the state of a search string when you perform one of the following operations:

• Add

• Delete

• Group

• Ungroup

• Clear all groups

When you select Undo, the string returns to the state before the last operation. When you select Redo, the string reverts to the state after the Undo operation.

Advanced Search Result Table

After you perform a search, a table shows the results. This table displays the first 500 returning results by default. Use the Configuration Property tool to change the default display.

To export the search results, select Export (down arrow) to the right of the table. Filters applied to the table are not preserved in the exported search results.

Save Query

The Save Query operation is enabled after a search is completed using a search string. You can use the Save Query panel to save search strings as follows.

1. Select Save Query.

2. Enter a descriptive name for the search string.

3. Select Save.

The new search query shows in the Save Query panel and can be used in future searches.

View, Modify or Delete a Saved Search Query

• To view a saved query, select the query from the Saved Query panel. The Query Builder panel shows the conditions and details of the selected search query.

• To modify the search query, select the applicable conditions and edit them. When you update a saved query, an EDITED label displays to the left of the query name.

• To delete a saved query, select Delete (trash bin) to the left of the query.

Share or Import a Saved Search Query

• To share a saved query, select Share (right arrow) next to the applicable query in the Saved Query panel.

  A text file is downloaded that contains the selected query details.

• Import a saved search query as follows.

  1. Select Import Query.

  2. Browse for the text file and select Open.

     The query builder panel shows the details of the imported search query.

  3. After performing a search with the imported query, select Save Query.

  4. Enter a descriptive name for the search query.

  5. Select Save.

     The imported search query shows in the Saved Query panel and can be reused in future searches.