Test Management - Cannabis

From LabLynx Wiki
Jump to: navigation, search

This is an Administrative function rather than a standard lab operation. Only users with LIMS Admin or similar profile have this on their menu and may access it.

Central to the setup of the LIMS is the ability to set up tests to be assigned to samples. There really is no point to any LIMS if there are no tests! Your LabLynx Cannabis Testing LIMS comes with a set of standard tests already defined. However, LIMS Administrators are trained on how to make new versions and create new tests, giving your system extended longevity through adaptability.

First, it is important to be clear on just what constitutes a Test: A Test is a collection of analytes (called Parameters in the system) to be measured in some way, with some kind of results expected to be reported. So a Test may consist of one or more Parameters, each with their own normal ranges. It also consists of one or more steps, or Processes, which are collected into a Path and selected for that test. All specimens assigned that test must complete the prescribed steps in order before they can reach "Complete" status.

Once analysis has been done, results are entered - either manually or, if instrument(s) interfacing has been done then automatically - and the associated reports are able to be generated. Reports on which the test should be viewed should have been selected during setup (see "To Create a New Test" below) and those reports will display. Additional Paths are also available for selection, e.g. "Analysis with Review".

Test Groups, Tests and Parameters

It's important to understand that in ELab there are three levels of test components:

  1. Parameters - These are the analytes, the actual things being tested, e.g. calcium etc.
  2. Tests - You might currently call these "Panels". They are a collection of one or more Parameters.
  3. Test Groups - These are collections of tests, grouped for easy assignment to samples. If a Test Group consists of two or more tests that all only have one parameter each (e.g. a test named "Calcium" with a single Parameter in it that is "Calcium"), then that Test Group can function as a Panel or Test. In most cases, Test Groups are unnecessary, since a Test can contain multiple Parameters. It can function as a profile or panel (clinical). Test Groups merely offer an additional level for particular situations.

To View a Test

There are a number tests included in the LabLynx LIMS for Cannabis Testing solution as delivered. Just click on the test you are looking for (or you can use the Filter Filter Button.png button or the Advanced Filter icon Advanced Filter Button.png to search for the one you want and then click on that).

Test List.PNG

Clicking on a test reveals its detail screen.

Test Detail Screen - Canna.png

For any test that is Active, the fields are grayed out and un-editable.

The Parameters of the test may be viewed by clicking the Parameters Parameters Button.png button.

View Parameters Canna 1.png

Click any Parameter to see its details.

View Parameter Canna 2.png

You can see details about the Parameter by clicking on the appropriate button. If the Test is Active, the fields and buttons will be grayed out, except the Formula Formula Button.png and Limits Limits Button.png buttons. If there are any limits/specs defined for the purpose of flagging testing result values, they can be defined here during test creation (before the test is published and active. The same goes for any calculation that should automatically occur for that parameter result.

Formula details (none defined)

Formula Detail Popup.png

Limits details

Limits - Parameter.png

  • Note: Limits may be edited here by clicking the New Limit Revision New Limit Revision Button.png button. For guidance on how to do that, see To Create a New Test below.

To Create a New Test

First of all, most cannabis testing labs should not find it necessary to create additional tests beyond the ones supplied. Second, if you do, it most likely wiould be a similar test to one of the existing ones - in which case, the Copy function would be easier. However, if you need to make a completely new test, here is how:

There are three prerequisites to creating a new test:

1. Parameters - The parameters (analytes) to be measured in the new test must exist in the system. See Test Parameter Management.

2. Processes - Steps, or processes, that are to be included in the test must have been defined in the system. See Process Management

3. Paths - Processes are not directly assigned to tests. They are grouped into Paths, which dictate their sequence and other characteristics, and the appropriate Path is assigned to a test. Any Path may be assigned to as many tests as needed. It is possible for a Path to consist of only one Process. See Path Management

Once you are certain these conditions have been met, proceed as follows:

Navigate to the Test Management menu item.Its default location is in the LIMS folder (again, only accessible for authorized admin security profiles like LIMS Administrator), in the subfolder System (NOTE: there are multiple System subfolders, each is related to its parent module folder).

Test Management Canna 1.png

Click the New New Button.jpg button (this can also be done from within any test's detail screen).

New test - Canna 1.png

Work through all the mandatory fields (in bold) and any of the others that you choose.

These include:

  • Test Name - This must be unique. If a test exists with the same name, it will be de-activated upon activation of the new test with the same name.
  • Version # - This auto-updates each time a new version of a test is created.
  • Report Name - How you would like the name of the test to appear on the report
  • Location/Department - Tests are location/department-specific. They are only available to that area. If you want the same test to be available in more than one place, simply "Copy" it and change the location/department on the second one.
  • Sample Type - This field is how the list of appropriate tests is determined when adding tests to a sample. For example, if a Sample Type of "Edible" is selected here, then this test would be displayed as available for any samples for which the "Edible" Sample Type has been chosen in the Sample detail screen (Sample Receiving) for the assigned location/department.
  • Path Name - Assign the defined Path that must be followed for this test to reach completion (see initial discussion of prerequisites in this section).
  • Test Ref. Methodology - You can enter the method reference number or similar information for the test here.
  • File Name – An SOP or Method file can be associated with the test if it has been uploaded to the LIMS in Document Management and given the type "SOP". Click to select it (you can use the filter to find it).
  • All Users – This should normally be checked to allow all users to access this test. It can be limited later if desired, as a new test version.
  • Subcontract - If the test is always subcontracted, check that box and select the lab (must be defined in Entity Management). The Test Name should reflect this.
  • Lab Name - If Subcontract has been selected, this field activates for you to select which lab (defined in Entity Management) this test is subcontracted to.
  • Sig. Fig./Resolution Default - If the test has a lot of parameters, specify a default significant figures (number of total number places a value displays on the report) and resolution (number of places displayed to the right of the decimal on the report), then any parameters as added will default to that (makes it quicker) - although they can be edited individually.
  • Std Price - You can define a standard price for the test here.
  • Published - A test must be Published to appear in the Test List screen, and Active to be usable.
  • Active - A test must be Published to appear in the Test List screen, and Active to be usable.
  • Test Code - If there is a code associated with the test you may enter it here
  • Report Friendly Name - It is important to select the report where this test is to appear. The default report is "COA (New)". You may have requested a custom report for your lab. NOTE: Always note there are more than one page to select from. The number of pages is displayed at the bottom right of the popup. Click to go to page 2, 3, etc. if the report you need isn't in the displayed list.
  • TEST DETAIL 1, 2, etc. - There are additional generic fields you can utilize if desired. See your LabLynx representative for more information.
  • Description - You can enter any free text you want to be saved with the test here. Clicking the canned comments icon to the left of the field displays preset notes/comments for selection.

Click Save Save Button POL.png button -- Do NOT click Published or Active yet

Upon saving, the test detail screen displays additional buttons for adding Parameters, QC Tests and, if All Users wasn't selected, Test Users.

Test Management 8.png

Add Parameters to Test

No test is functional until items to be measured are added to it. These are the Parameters (analytes), and they are what will display in Data Entry for results to be entered (either manually or, if integrations have been implemented, then automatically).

Once the test has been initially saved as in To Create a New Test above, the Parameters Parameters Button.png button displays at the bottom of the page, which allows the adding and setup of parameters and any associated limits, formula, etc.

Click the Parameters Parameters Button.png button. The Add/Edit Parameters frame displays:

Test Create 2.png

Now click the New New Button POL.png button. Test parameter Details screen displays:

Test Create 3.png

Click the "Select" link next to Parameter Name to browse for the parameter you would like to add to the test. You can use the popup's filter to narrow your search. Note: If the parameter you need is not in the list, go to the Test Parameter Management menu item and add the new parameter there. It will then show as available for selection here.

Test Mgt - Add Parameter 1.png

Fill in the appropriate attributes for the parameter, as they apply specifically to this test. These attributes are test-specific and can vary according to the test in which they are used. Mandatory ones are in Bold.

  • Param. Name - This is filled in automatically if you select it from the list. Otherwise, if it is a new one you are adding to the master list, type the parameter name here. Always use the exact spelling and capitalization that your instrument uses for this analyte, if it is listed on your instrument. It's not crucial, because the parameters are mapped by you manually if the instrument is interfaced. But it makes that easier if you make them the same.
  • Parameter Description - This will be used on report if present, otherwise it defaults to Name.
  • Significant Fig/Resolution - Add the number of digits to be displayed in total for any result for this parameter, and the number of decimal places to extend.
  • Rounding Function - If there is a custom rounding function you have defined in the system, it may be selected here.
  • DL, QL – These are based on instrument (if present). QL leaves a safety margin from DL and may be used like the DL for better confidence. Any values entered here will be the default, but may be edited anytime before saving, publishing and activating the test.
  • Display Order - Select Display Order to specify the order the parameters appear on a sample and during data entry This needn’t be strictly sequential – in fact, it is best to leave gaps in case you later want to add more - although they will display in order from lowest to highest number. Zero is valid. If two have the same number, they are displayed alphabetically. Grouping handled in filtering in data entry
  • Unit Name - Assign units for the result values for this parameter. You can add/edit units in Picklist Management. All Data Entry units are "Analysis" type units. NOTE: It's usually best to make sure the necessary units exist before setting up tests.
  • All Processes – Choose whether the Parameter is to display in all processes. If not, leave unchecked and you will be able to specify in which process(es) it occurs, in the next step.
  • Numeric - Expected result values may be any alphanumeric and/or symbol characters, but checking this box simply shortens the field length, in expectation of a number rather than words.
  • Exclude From Report - Some testing results are not final, reportable results, e.g. values that comprise part of a calculated result. If this parameter should not appear on the report, check this box.
  • Required – Choose whether this Parameter must have a result entered before a sample can go to "Complete" status.
  • Audit - Checking this box activates the audit trail function for this parameter's results. Any results and changes to those results are logged and retrievable in the audit trail module, helping meet many standards and regulatory requirements.
  • Selectable Results – Check this box if you prefer results may not be free text, but rather selected from a specified drop-down picklist (if so, you can specify choices in the next steps below).
  • Allow Multiple Results – If Selectable Results is checked, you can allow more than one value to be selected from the results picklist here.

Once these choices have been made, click Save Save Button POL.png. Additional buttons display, allowing you to define any Formula and/or Limits or Ranges for the parameter in this test. Also, if the All Processes box was not checked, then the Processes Processes Button.png button is active so you can define in which Processes this Parameter displays, and if Selectable Results checkbox was selected, then the Selectable Results Selectable Results Button.png button will display, so that possible result choices may be set to display for the user during manual data entry.

Test Parameter Canna 5.png

To Set Up Parameter Formula

In the Test Parameter Details screen once initial Parameter details have been saved, click the Formula Formula Button.png button. You can either use free text or the provided controls to build your formula for this parameter result calculated value. Results from other Parameters may be used in the formula.

Formula Builder Popup.png

You can use the Validate Validate Button.png button to test that the formula construct is valid, and you can also use the Spell Check Spell Check Button.png to proof for spelling errors, as with all pages.

A simple example may help here. Let’s say we were going to create a formula to take our result and multiply it by the dilution factor for the sample. Using an aluminum parameter is a 200.7 test; our formula would look like this:

~p~SELF~p~ [Current Parameter] *~p~13.-285~p~[200.7 Liquid Metals ICPOES v.1 - Dilution Factor]

Where the ~p~SELF~p~ [Current Parameter] is the parameter we are adding to the test, in this case aluminum. "*" is the multiplication operator. And ~p~13.-285~p~[200.7 Liquid Metals ICPOES v.1 - Dilution Factor] is the Test Parameter we chose after clicking the Other Params Other Params Button.png button. In the expression ~p~13.-285~, 13 is the TestID and -285 is the Master ParameterID. It is not necessary to know the IDs required for a Test or Master Parameter; however, it can be helpful in troubleshooting calculation-related issues.

Click Save Save Button POL.png to save the formula for this Parameter, and return to the Test Parameter Detail screen.

To Set Up Parameter Limits (Range)

ELab will flag any results that fall outside value ranges that you define for any parameter. You can define ranges (Limits), as well as any internal warning limits or specifications, using the Limits function in the Test Parameter Details screen.

In the Test Parameter Details screen once initial Parameter details have been saved, click the Limits Limits Button.png button.

The Limit Set frame displays.

Limit Set Frame.png

Select a Limit Type, Operator and Limit Value. The argument is "Flag the result if it is [Operator - e.g. Greater than, less than, etc.] [Limit Value]".

Limit Set 1.png

Limit Set 2.png

Limit Set 3.png

The Limit Type list is modifiable (see Picklist management). You may have as many types of limits and limit sets as you like. NOTE: Modifying (copy/change) parameters not recommended, especially if any are currently under testing. It is better to create a new test revision. That way any samples with that test assigned will complete as normal, and any new samples will be given the new version.

  • Important NOTE: In order for the Range to appear on the COA Report, it must be entered in the 'Note' column, on any existing Limit row (not on more than one).

Range In Note.png

To Select Processes

If the All Processes box has not been checked and there is more than one process or step so that you would like to specify for which one the parameter is available, click the Processes Processes Button.png button to display the Parameter Processes selection frame.

Parameter Processes Frame.png

Select each process, one-by-one, Saving each as you go. If you require a process or step to be completed (i.e., a result or observation, etc. of some kind entered for that parameter for that process), then check the "R" checkbox.

To Define Selectable Results

If you have checked the Selectable Results checkbox for the Parameter, then you can define the drop-down picklist choices by clicking the Selectable Results Selectable Results Button.png button.

The Selectable Results frame displays.

Selectable Results Frame.png

Type in the results choices you would like the analyst to choose from when entering results manually for this Parameter. If you would like one to be the Default value, check the "D" checkbox.

Selectable Results Frame 2.png

Once all set up, click on Save Save Button POL.png and Done Done Button.png to return to the Test Configuration Details screen.

Set Test Users

If All Users box was not checked, and you would like to specify only certain users as authorized for this Test, in the Test Configuration Details screen click the Test Users Test Users Button.png button.

Here you can assign specific users to the test.

Test Mgt - Assign Users.png

Test Mgt - Assign Users 2.png

There is no need to Save, assignments are complete once made.

Check "Published" and "Active" and then click Save Save Button POL.png to finish and activate the Test. No changes may be made. If changes are required, make a Copy. The Name will not be editable, and the copy will be a new Version. The old test will be made inactive automatically if the new one is made active.

Create QC Tests

A QC Test can be created manually just like a regular Test in the system, but with frequencies defined, and then generated automatically. From the Test Configuration Details screen, click the QC Test QC Tests Button.png button. The system displays the Quality Control Test List area.

QC Tests 1.png

Select a Test Name to edit an existing QC Test, or click New New Button POL.png to create a new one. The QC Tests Add-Edit screen is displayed.

QC Tests 2.png

Complete the fields of the QC Tests tab. Bold fields are required.

Fields and Descriptions

These are largely similar to the fields found in any test detail screen, but with a few exceptions:

  • Test Name - The Test Name is the name of the test that will show up to the users of the system. This is normally a short name or nickname that all of the users will recognize.
  • Report Name - The Report Name is the formal name of the Test as it should be displayed on reports.
  • QC Type - The QC Type indicates the main grouping information for the QC Template for control charting. Select this type from the Quality Control Type picklist.
  • Dependent QC Type - The Dependent QC Type defines for the system another QC Test that this QC Test needs to have in the batch. Select the Dependent QC Type from the drop-down list.
  • Is Sample - This flag defines whether the QC will be a QC Sample, which is a new sample introduced to a Process Group/Batch (CCV, Blank, ICV, etc) or a QC Test assigned to an existing sample (Matrix Spike, Matrix Spike Duplicate, Lab Replicate, etc). Check this flag if this template will be creating a specimen in the system.
  • QC Sample Required - Select the checkbox if this QC Test is required for the regular test you created in order for the specimens to move to "Complete" status.
  • Process Name - The system will display the Processes in the Path assigned to the current regular Test. Select the Process Name from the drop-down list to define which process this QC Test will show up to add to the Process Group/Batch.
  • Sample Type - The Sample Type is the Matrix of the sample on which this test will be performed. It will only display as available to the user for the selected type. Select the type from the drop-down list.
  • Test Ref. Methodology - The Test Reference Methodology is the form Method name for this test. Type the Test Reference Methodology
  • Sig. Fig. Default - The Sig Fig Default field at the Test level designates that all parameters assigned to this test will have the same Significant Figures. Type the number of significant figures that will be applied to the results for test parameters during rounding.
  • Resolution Default - The Resolution Default field at the Test level designates that all parameters assigned to this test will have the system begin the rounding at the same number of decimal places to the right of the decimal point. Type the number of places to the right of the decimal point to start rounding.
  • File Name - The File Name field allows us to associate an SOP or Method Document that has been uploaded into the system in the Document Management module. Click the link to select the File Name from the SOP Document Lookup List.
  • All Users - The All Users flag tells the system to allow anyone user of the system to perform the operations necessary to complete the Test for the samples it is assigned to. Select the checkbox to allow all system users to view and enter data for this Test.
  • Published - Select the checkbox to publish the Test. Do Not Publish the Test until all parameters and associated information have been entered.
  • Active - Select the checkbox to activate the Test. Do Not Activate the Test until all parameters and associated information have been entered.
  • Description - Type a description.

Complete the fields of the Frequency Details area. This area defines how many and how often this QC Sample is added to the Process Group/Batch. The following choices are available for the frequency type. The “?” is filled in from what is entered in the Frequency field. "[" Front Bracketed means at the Beginning of the batch, "[]" bracketed means Front/Middle/End of the batch and "]" Rear Bracketed means at the end of the batch.

? QC Samples Per Batch QC Per Batch

1 QC Per ? Sample [ w/ QC QC Per How Many Samples starting at the beginning of the batch and Count QC samples

1 QC Per ? Sample [ w/o QC QC Per How Many Samples starting at the beginning of the batch and do not Count QC samples

1 QC Per ? Sample [] w/ QC QC Per How Many Samples, with one at the beginning and one at the end and Count QC samples

1 QC Per ? Sample [] w/o QC QC Per How Many Samples, with one at the beginning and one at the end and do not Count QC samples

1 QC Per ? Sample ] w/ QC QC Per How Many Samples with one at the end and Count QC samples

1 QC Per ? Sample ] w/o QC QC Per How Many Samples with one at the end and do not Count QC samples

  • Frequency Type - Select the Frequency Type from the drop-down list.
  • Frequency - Type the frequency for the Test.

QC Tests 3.png

When you are finished, click Save Save ButtonPOL.png. The system displays the Parameters Parameters Button.png button. Click to display the QC Test Parameters frame.

QC Tests 4.png

Click the New New Button POL.png button to create a new QC Parameter and proceed as in any test as described in Add parameters to Test above.

Publish and Activate test

When all QC Parameters have been entered and set up completely, click Done Done Button.png repeatedly until you return to the master Test Configuration Details screen and check Published and Active checkboxes to activate the new test, complete with all Parameters, Ranges, QC Tests and other elements as available for assignment to appropriate samples. Previously editable fields will now become grayed out and uneditable. A new revision must be done to update the test if you need to keep the same name.

Test Management Canna Final.png