Documentation
Tutorials
Workflows
Kebab actions
Daily Work
Dashboard & Reports
Quality Control
ISO 17025
Logs
Contacts
Billing
Analysis Setup
Settings
Initial Setup
Help & Reference
Architecture decisions
Workflows
0:000:00

Quality Control Sample Management

This guide describes the step-by-step process for creating, logging measurements and evaluating quality control (QC) samples. Control samples, per ISO 17025 §7.7.1, are used to ensure the reliability of analytical results.


Prerequisites

Before you begin, make sure the following data exists:

#PrerequisiteWhy it's neededPage
1Analytical InstrumentsEach control sample must be linked to the instrument on which the measurement was performed. Without an instrument, a record cannot be created.Instruments
2Lab MethodsThe analysis method is required — it determines which acceptance criteria apply.Lab Methods
3Analysis ElementsNeeded when logging measurements (results) on the control sample.Elements
4Acceptance CriteriaDefine expected value and acceptable limits for each method–element combination. Without these, limits are not auto-populated and the "Pass/Fail" evaluation is unreliable.Acceptance Criteria
Tip: The creation order should be: Elements → Lab Methods → Instruments → Acceptance Criteria → Control Samples.

Step 1 — Navigation

Go to the Control Samples page from the QC menu. A table of existing control samples is displayed.

The visible table columns are:

ColumnDescription
Document No.Unique code (for example QC-YYYY-0001)
Control TypeBlank, Duplicate or CRM (Certified)
DateDate the test was performed
InstrumentThe analytical instrument
Lab MethodThe laboratory method
Batch No.Reference material batch number
StatusPending, Pass or Fail

Step 2 — Creating a Control Sample

Click the "+" button on the toolbar to open the creation form.

Fill in the fields:

  1. Document No. — Leave blank for auto-numbering (for example QC-YYYY-0001) or enter your own code
  2. Control Type — Select a category: Blank, Duplicate or CRM (required)
  3. Date — Date the control test was performed
  4. Instrument — The analytical instrument used
  5. Lab Method — The analysis method
  6. Status — Initially "Pending", changes after evaluation
  7. Batch No. — Reference material batch number (if applicable)
  8. Expiry Date — Reference material expiry date
  9. Operator — The analyst who performed the test
  10. Notes — Additional remarks

Step 3 — Recording Measurements

After saving, open the control sample in edit mode. Below the basic fields, the "Measurement Results" section appears.

Click "New Measurement" and fill in:

FieldDescription
ElementThe chemical element or parameter
Measured ValueThe value measured
Expected ValueThe reference value (auto-populated if an acceptance criterion exists)
Lower LimitMinimum acceptable (auto-populated)
Upper LimitMaximum acceptable (auto-populated)

The Pass/Fail status is calculated automatically: if the measured value is within the limits, ✔ (green) is shown; otherwise ✖ (red).

You can add multiple measurements for different elements on the same control sample.

Step 4 — Control Chart (Levey-Jennings)

In the edit form, below the results, click "Control Chart" and select an element.

The Levey-Jennings chart displays:

  • The mean value (centre line)
  • The control limits (±2σ and ±3σ)
  • The measurements in chronological order

Use it to detect trends, biases or out-of-control points according to Westgard rules.


Step 5 — Search & Filtering

Type in the search field for quick text filtering.

Filter Panel

Click the filter icon to open the filter panel:

FilterTypeDescription
StatusSelectFilter by status (Pending, Pass, Fail)
Control TypeSelectFilter by category (Blank, Duplicate, CRM)
Lab MethodSelectShow samples for a single method only
InstrumentSelectShow samples for a single instrument only
Date FromDateRange start date
Date ToDateRange end date
Max RecordsNumberRecord limit for print/export (default: 200)

Step 6 — Print & Export

PDF Print

Click the print icon. A PDF list is generated with:

  • Title "Control Samples Report (ISO 17025 §7.7)"
  • Active filters shown below the title
  • Portrait/landscape toggle

Individual Sample Print

From the row actions (⋮), select Preview or Download PDF to print an individual control sample with its results and chart.

CSV Export

Click the export icon to download a CSV file.

Printing and export respect active filters and the max records limit.

FAQ

What is the difference between Blank, Duplicate and CRM?

  • Blank: A sample without the analyte — checks for contamination
  • Duplicate: A repeated analysis — checks repeatability
  • CRM (Certified Reference Material): A sample with a certified value — checks accuracy

How are limits auto-populated in measurements?

When selecting an element for a new measurement, the application looks up the corresponding acceptance criterion for the method–element combination and auto-fills the expected value, lower and upper limit fields.

How does auto-numbering work?

If you leave the "Document No." field blank during creation, the application assigns the next available code (format QC-YYYY-NNNN).

When should I change the status to Pass or Fail?

After logging all measurements, check the results (✔/✖) and update the status accordingly. The status does not change automatically — it is a deliberate decision by the analyst.

What should I do if a measurement is out of limits?

Per ISO 17025, you must document the non-conformity, investigate the causes and take corrective action. Record your findings in the "Notes" field and change the status to "Fail"