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

Sample Workflow

This guide describes the step-by-step lifecycle of a sample — from reception and preparation, through linking to an analysis, result approval and report generation. The workflow follows ISO 17025 requirements for traceability, sample identification and chain of custody.


Prerequisites

Before creating a new sample, make sure the following data exists:

#PrerequisiteWhy it's neededPage
1ContactsEvery sample is linked to the customer who submitted it.Contacts
Recommended setup order: Contacts → Samples

Optional but useful:

  • Laboratory Methods — to log the analysis method
  • Instruments — to log the analytical instrument
  • Users — to assign the sample to an analyst

Step 1 — Navigation

Go to the Samples page from the main menu. A table with existing samples is displayed.

The table columns are:

ColumnDescription
Sample CodeUnique identification code (e.g. SAM-YYYY-0001)
Receipt DateDate the sample was received at the laboratory
Delivery DateResults delivery deadline — shown in red if overdue
CustomerThe customer who submitted the sample
StatusCurrent status in the workflow
MethodLaboratory method (optional)
InstrumentAnalytical instrument (optional)
PreparationPreparation status — drying / grinding / sieving (stars indicator)

Step 2 — Sample Reception

Click the "+" button in the toolbar to open the reception form.

Fill in the fields:

  1. Sample Code — Leave blank for auto-numbering (SAM-YYYY-NNNN) or enter manually
  2. Receipt Date — Date the sample was received at the laboratory (required)
  3. Customer — Select the customer from the list (required)
  4. Status — Select initial status (default: Received)
  5. Lab Method — Analysis method (optional)
  6. Instrument — Analytical instrument (optional)
  7. Assigned To — The analyst who will handle the sample (optional)
  8. Due Date — Results delivery deadline (optional)
  9. Notes — Additional remarks
  10. Photo — Sample photograph
After saving, the sample is created in Received status and you can print a barcode label.

Barcode Label Printing

After creating the sample, you can print a barcode label (Code128 or QR) for physical identification. The label includes the sample code and can be scanned later for quick lookup.


Step 3 — Sample Preparation

Preparation is tracked through three steps, each with a checkbox and date:

StepFieldDateDescription
1DryingDrying DateDrying the sample in an oven
2GrindingGrinding DateGrinding/pulverizing the dried sample
3SievingSieving DateSieving to the desired particle size

Preparation status is shown in the table with star indicators (e.g. stars for 2 out of 3 steps completed).

Once all three steps are complete, change the status from In Preparation to In Analysis to begin measurement.

Step 4 — Linking to an Analysis

Once the sample is ready for analysis, create an analysis record:

  1. Go to the Analyses page (Analyses)
  2. Create a new analysis, selecting the sample (via the Sample field)
  3. The analysis is linked to the sample via FK — each analysis record corresponds to one sample
  4. Update the sample status to In Analysis
For the analysis workflow (entering measurements, review, approval), see the Analysis Workflow Guide.

Step 5 — Status Workflow

The sample follows a workflow with six statuses:

StatusDescription
ReceivedInitial state — the sample has been received at the laboratory
In PreparationDrying, grinding or sieving is in progress
In AnalysisLinked to an analysis, measurements are being entered
AnalysedResults have been entered, pending review
ApprovedFinal approval — report can be generated
RejectedSample rejected (final state)

Transitions

Received → In Preparation → In Analysis → Analysed → Approved

↘ Rejected

ActionFromToNote
Start PreparationReceivedIn PreparationPhysical sample preparation begins
Start AnalysisIn PreparationIn AnalysisAnalytical process begins
CompleteIn AnalysisAnalysedMeasurements completed
ApproveAnalysedApprovedFinal result approval
RejectAnyRejectedSample does not meet requirements

Step 6 — Search & Filtering

Type in the search field for quick filtering by sample code or customer.

Barcode Scanner

Scan a sample's barcode label for instant lookup in the table.

Filter Panel

Click the filter icon to open the filter panel:

FilterTypeDescription
Date FromDateStart of receipt date range
Date ToDateEnd of receipt date range
CustomerSelectFilter by customer
StatusSelectFilter by workflow status

Step 7 — Print & Export

ActionDescription
Print ListPrint the samples table as PDF
Export CSVExport data to a CSV file
Barcode LabelPrint a barcode label (Code128 or QR) for an individual sample

FAQ

How does auto-numbering work?

If you leave the sample code blank when creating, the system automatically assigns a code in the format SAM-YYYY-NNNN, where YYYY is the current year and NNNN is a sequential number.

Can I change the sample code after creation?

Yes, the sample code can be modified during editing, as long as it remains unique.

What is the sample-analysis relationship?

Each analysis record is linked to one sample. The sample records the physical reception and preparation, while the analysis records the measurements, evaluations and report generation.

What do the stars in the Preparation column mean?

The stars indicate how many of the 3 preparation steps (drying, grinding, sieving) have been completed. For example, two filled stars out of three means 2 of 3 steps are complete.

Why is the delivery date shown in red?

If the results delivery deadline has passed, the date is displayed in red bold as a visual alert.

How do I scan a sample barcode?

Place the cursor in the search field and scan the barcode with your scanner. The system automatically searches for the sample with the corresponding code.


See also