Setting up your laboratory

Getting started

Setting up your laboratory

This page is the checklist for getting a new company ready for its first request. Follow the steps in order: each one uses what the step before it set up.

Who this is for: Laboratory owners and administrators · You need: the "Manage …" permissions for the pages you set up; the person who registered the company has them all

The idea in short

Everything you set up once and change rarely lives on the Settings page, which you open from the bottom of the sidebar. Settings is split into tabs: Organization, Lab setup, Forms & reports, Regulatory and Integrations. Each tile on a tab opens one settings page.

Settings shows only the tiles your role has permission for. If a tile you need is missing, ask an administrator to add the permission to your role. See Users, roles and permissions.

You can set up a lot at once by importing Parameters from Excel or adding them from the EU pesticides database. Everything else is entered by hand.

📷 Screenshot: the Settings page on the Organization tab, with its tiles

How to set up your laboratory, step by step

Step Settings tab › tile What you set up Required?
1 Organization › Company Company details, request numbering Yes
2 Organization › Laboratories Your laboratories Yes
3 Organization › Departments Sections that work is assigned to, and their members Yes
4 Organization › Roles What each role may see and do Yes
5 Organization › Users The people who sign in Yes
6 Lab setup › Products What you receive for testing Yes
7 Lab setup › Parameters What you measure Yes
8 Lab setup › Groups of Parameters Ready-made sets of parameters Yes
9 Forms & reports › Predefined Fields Fields you reuse across forms Optional
10 Forms & reports › Forms The forms requests are filled in with Yes
11 Forms & reports › Report Templates How reports are laid out Optional
12 Regulatory › Regulatory Frameworks, catalogs Legal limits to check results against Optional
13 Integrations › Lab Integrations Connection to SmartQC Optional

Products (step 6) and groups of parameters (step 8) refer to each other. You can create the products first with just a name, and add their groups of parameters after step 8.

1. Company details and tracking numbers

  1. Open Settings › Organization › Company.
  2. Fill in the company name, tax and registration numbers, address, the email addresses for official mail, analysis results and invoices, and a contact person.
  3. Under Request numbering, set the Internal number format and the External number format, or leave them blank to use the default format. A preview shows the number the first request of today would get.
  4. Click Save changes.

The format is built from placeholders such as the date, the form's code and a running count. See Tracking numbers.

2. Laboratories

  1. Open Settings › Organization › Laboratories and click New laboratory.
  2. Enter the Name, Type, Location and Examination type.

Forms, products and groups of parameters are later made available per laboratory. See Company, laboratories and departments.

3. Departments

  1. Open Settings › Organization › Departments and click New department.
  2. Enter the Name, pick the Laboratory and the Leader.
  3. Under Members, add the people who work in the department.

Work is assigned to departments: each group of parameters has a responsible department, and its members see that work in their work orders list. You can add members after you create the users in step 5.

4. Roles

  1. Open Settings › Organization › Roles and click New role.
  2. Enter a name and tick the permissions the role gets, for example "Manage requests" for reception staff or "Verify work order tasks" for reviewers.

Each user has one role. The Default role can't be deleted. See Users, roles and permissions.

5. Users

  1. Open Settings › Organization › Users and click Invite user.
  2. Enter the First name, Last name, Email and a first Password, and pick the Role.
  3. Give the person their email and password yourself. SmartLIMS doesn't send an invitation email.

If your organization uses the SmartLabSys platform, people can instead sign in with their SmartLabSys account, and SmartLIMS adds them to your company the first time they do. See Signing in and finding your way.

Then go back to Departments and add the users as members. If a person should see only some laboratories' forms on New request, assign them those laboratories. See How to choose which laboratories someone works in.

6. Products

  1. Open Settings › Lab setup › Products and click New product.
  2. Enter the Name and pick the Laboratories that test it.
  3. Under Groups of parameters, add the groups usually tested on this product (after step 8).
  4. Optionally enter a Default expert opinion, and link the product to the Catalog product so regulatory limits can be found for it.

When you add a product to a work order, all its groups of parameters come with it. See Products, parameters and groups.

7. Parameters

  1. Open Settings › Lab setup › Parameters.
  2. Add parameters in one of three ways:
    • New parameter: enter one by hand, with its Unit, reference range, LOD, LOQ, Measurement uncertainty and the Accredited flag.
    • Import from Excel: upload a spreadsheet and match its columns to the parameter fields. See Importing from Excel.
    • Add from EU jurisdiction: pick pesticide substances from the EU database. Each one is linked to the catalog automatically.

8. Groups of parameters

  1. Open Settings › Lab setup › Groups of Parameters and click New group of parameters.
  2. Enter the Name, pick the Responsible department and the Leading analyst, and pick the Laboratories.
  3. Under Parameters, add the parameters and the Standard (method) for each. With Overrides you can change a parameter's unit or reference values for this group only.

9. Predefined fields (optional)

If several forms ask for the same information, for example the sampling date, create it once under Settings › Forms & reports › Predefined Fields with New predefined field. You then pick it from the library when you build a form. See Custom fields and formulas.

10. Forms

  1. Open Settings › Forms & reports › Forms and click New form.
  2. Enter the Name and the Code. The code can appear in the request number.
  3. Pick the Laboratories that use the form.
  4. Add General fields (filled in once per request) with Add general field, and Item / sample fields (filled in for each sample) with Add item field. Use Pick from library... for predefined fields.
  5. Under Report setup, pick the report template and the people who approve reports and expert opinions.

Forms have versions. A request keeps the version it was created with, so changing a form never changes old requests. See Forms and report templates.

11. Report templates (optional)

Under Settings › Forms & reports › Report Templates, New report template creates a template that you then pick on a form. SmartLIMS doesn't generate formal test reports yet. See Forms and report templates.

12. Regulatory frameworks and catalogs (optional)

If you check results against legal limits, for example EU maximum residue levels (MRL):

  1. Link your products to the Catalog product and your parameters to the Catalog substance. Parameters added from the EU jurisdiction are already linked.
  2. Under Settings › Regulatory › Regulatory Frameworks, use the system frameworks already provided (you can't edit them), or click New framework to add your own rulebook. Add its limits one by one with Add limit, or all at once with Import limits from Excel.

The Product Catalog and Parameter Catalog are shared by all SmartLIMS companies, so a change there affects everyone. Give their permissions to very few people. See Regulatory limits and catalogs.

13. Integrations (optional)

If your customers send requests through SmartQC, connect it under Settings › Integrations › Lab Integrations. Once the connection exists, a QC Request Mappers tile appears, where you decide how incoming requests turn into yours. See SmartQC.

Financial (invoicing) is connected on the SmartLabSys platform, not in SmartLIMS Settings. See Financial (invoicing).

📷 Screenshot: a form's edit page with general fields and item / sample fields

Tips

  • Before your first real request, create a test request with each form to check its fields and the request number.
  • Start with a few roles that match how your lab actually works, for example reception, analyst, reviewer and manager. You can refine them later.
  • A department without members has nobody to see its work. Check that every responsible department has members.
↑↓ to move ↵ to open esc to close