📖 User Manual
The OpenELIS Global manual for laboratory staff and for the administrators who set OpenELIS up. Each page says which OpenELIS version it was checked against. Pages marked Older format come from the previous manual and are being rewritten; they are still the best guide for those workflows. Pages marked In review are published before their review is finished, so you can use them now; details may still change.
Start here
New to OpenELIS: Navigating OpenELIS Global, then The three domains and the shared order wizard.
Entering and resulting orders: Entering laboratory orders, Enter and save results, Triage and release results and, for releases before 3.2.2, Validate and release results.
Setting up a laboratory: Introduction to administration, then the Test catalog workflow overview.
Lire en français : 📖 Manuel de l’utilisateur.
How the manual is organised
Section | What it covers |
|---|---|
Day-to-day work in the laboratory: orders, samples, results, validation, reports, the surveillance workflows, pathology, NCEs and lab notebooks. | |
Setting OpenELIS up and keeping it running: users, site settings, the test catalog, programs and rules, result reporting and reference data. | |
Short, text-only versions of the common workflows, for when you have done a task once and need a reminder. Older format. | |
Earlier versions of pages that have been rewritten, and retired screens, kept for sites still on older releases. | |
The French manual. It links the pages already translated and points to the English page where there is no translation yet. | |
Feature-by-feature reference, such as sample storage, Westgard QC, aliquots and reflex tests. |
End User Manual
For laboratory technicians, biologists, pathologists and reception staff. Open the End User Manual folder.
Getting around OpenELIS
Logging in, the Main menu, shortcuts and where to get help inside the application. Open the folder.
Page | What it helps you do |
|---|---|
Log in and find your way around the Main menu and screens. Older format. | |
Links to commonly used screens. Older format. | |
Fixes for common problems, such as required fields that block saving. Older format. | |
The help and forms available from inside OpenELIS. Older format. | |
How to log out. Older format. |
Orders and samples
From registering an order to storing and aliquoting its samples. Open the folder.
Page | What it helps you do |
|---|---|
How clinical, environmental and vector orders share one four-stage order wizard. | |
Search for or add a patient, create an order and print its labels. Older format. | |
Complete the sample check for an environmental or vector order | Run the acceptance checklist on each sample and release the order for testing. In review. |
Review orders sent to OpenELIS electronically, with their sample and test information. Older format. | |
Enter a group of orders that share a sample type, test or facility of origin in one pass. Older format. | |
Find an order to view or modify it. | |
Find a sample by accession number and create aliquots (sub-samples) from it. | |
Record where sample items are stored and manage their status and disposal. | |
Add a patient record so the patient can be linked to orders. In review. | |
Find an existing patient to view or edit their record. In review. | |
Combine two duplicate patient records into one. In review. | |
Register a clinical order: the patient, the requesting site and provider, and its sample types and tests. In review. | |
Record each sample of an order: collection, arrival, labels and storage. In review. | |
Confirm each sample is acceptable and release the order to the laboratory. In review. | |
Print order and sample labels and assign storage for environmental and vector orders. In review. |
Results, validation and reports
Recording results, releasing them and reporting on them. Open the folder.
Page | What it helps you do |
|---|---|
List the tests waiting in a lab unit, test, panel or priority, and print the work plan. In review. | |
Enter results for samples awaiting results and save them so they move on to validation. | |
Work through the validation queue, release clear results in one action, and correct or retest the rest. OpenELIS 3.2.2 and later. | |
Review entered results and release them, or send them back for retesting. Releases before 3.2.2. | |
Turn on electronic signatures and use them to sign result entry and validation. | |
Generate printable reports and data exports. | |
The older results entry screen, for sites that still use it. | |
Build a CSV extract of samples, tests, results and turnaround times without SQL, and rerun it for a new period. In review. |
Environmental surveillance
Environmental samples (water, soil, food) tested against a regulatory standard. Open the folder.
Page | What it helps you do |
|---|---|
The workflow end to end, from sampling-site order to compliance certificate. | |
Register an environmental sample against a regulatory standard and submit it for testing. | |
The concepts behind evaluating environmental results against a standard. | |
Produce the compliance certificate for a validated, standard-linked environmental order. | |
Record results for an environmental order and read the automatic pass or fail verdict. In review. | |
Review and release environmental results so they are final. In review. |
Vector surveillance
Pooled field collections of mosquitoes, larvae, fleas and rodents. Open the folder.
Page | What it helps you do |
|---|---|
The workflow end to end, from order entry through validation. | |
Register a pooled field collection and submit it for testing. | |
Identify the species in a pool and deconvolute it. | |
Capture larval and pupal survey counts and read the computed entomological indices. | |
The concepts behind pooled testing and deconvolution. |
Pathology, immunohistochemistry and cytology
The anatomic pathology modules. Open the folder.
Page | What it helps you do |
|---|---|
Record pathology cases and the examination of tissues, cells and fluids. Older format. | |
Request and record immunohistochemistry tests. Older format. | |
Create, process and finalize cytology requests. Older format. |
Non-conforming events
Recording and following up deviations from laboratory policy and procedure. Open the folder.
Page | What it helps you do |
|---|---|
Record a quality event such as a damaged or mislabelled sample, link the affected sample and find the event under All NCEs. |
Quality assurance
External quality assessment, statistical QC, alerts and accreditation. Open the folder.
Page | What it helps you do |
|---|---|
Run an EQA scheme for other laboratories: enrol them, ship panels, score results and follow up failures. In review. | |
Enrol in an EQA scheme, test the panel, submit results and act on the scores. In review. | |
Find statistical QC in OpenELIS and check each day whether any control has failed. In review. | |
Register a new lot of control material so its results are judged against the lot's targets. In review. | |
See the alerts OpenELIS has raised, such as overdue STAT orders and EQA deadlines, and record what was done. In review. | |
Record the bodies that accredit your laboratory and their tests, so reports carry the right logo. In review. |
Laboratory notebooks
Project notebooks for research and specimen-processing workflows. Open the folder.
Page | What it helps you do |
|---|---|
The entry page for the notebook workflows. Older format. | |
Set up a project notebook, then work samples through its stages from processing to archiving, one how-to page per stage. Older format. |
Administrator Guide
For the people who configure OpenELIS for their laboratory. Access to these screens is set by user permissions. Open the Administrator Guide folder.
Getting started with administration
What the Admin area does and how to reach it. Open the folder.
Page | What it helps you do |
|---|---|
What the administrator guide covers. Older format. | |
Open the Admin area from the Main menu. Older format. | |
The main screens and menus, from an administrator’s point of view. Older format. |
Users, organizations and providers
Who can log in, and who OpenELIS works with. Open the folder.
Page | What it helps you do |
|---|---|
Create user accounts and set each user’s roles and permissions. | |
Register the referring clinics, referral labs, health districts, sampling sites and vendors OpenELIS works with. In review. | |
Register the clinicians who order tests, so they can be chosen on an order. | |
Load or update organizations, wards, sampling sites and geographic areas in bulk from CSV files. In review. | |
Keep the list of administrative areas that patient addresses, organizations and sampling sites point to. In review. | |
Record the fixed places where environmental samples are collected. In review. |
Site and system settings
Laboratory identity and system-wide behaviour. Open the folder.
Page | What it helps you do |
|---|---|
Set the properties that identify your laboratory and control site-wide behaviour. | |
Look up what each setting under Admin → General Configurations does: order entry, result entry, patient entry, validation, non-conformity, work plan and printed report settings. | |
Choose how lab (accession) numbers are generated for new orders. | |
Set the system-wide properties for facility identity, integrations, notifications and paging. | |
Set the holidays and weekend days excluded from turnaround time. | |
Change the logging level at runtime and watch the live application log. | |
Rebuild the index behind global search. | |
Choose which entries appear in the Main menu, and how each one is shown. |
Test catalog
Everything about a test, in the unified Test Catalogue Management editor. Open the folder.
Page | What it helps you do |
|---|---|
The test catalog pages, in the order you usually configure a test. | |
Define a new test so it can be ordered and resulted. | |
Define a new specimen type so tests can be configured and samples collected for it. | |
Define a laboratory unit so tests can be assigned and orders routed to it. | |
Bundle several tests so they can be ordered together. | |
Locate a test in the catalog and open it for editing. | |
Set a test’s domain, AMR surveillance flag and status. | |
Define how a test’s results are captured: components, type and unit. | |
Define normal and critical ranges and check demographic coverage. | |
Associate testing methods with a test. | |
Map a test to LOINC, SNOMED, CIEL or OCL codes. | |
Include a test in one or more panels and set its position. | |
Control the order tests appear in for a sample type. | |
Record storage conditions, stability and disposal for a test’s samples. | |
Create or edit a reusable barcode label definition. | |
Define the acceptance criteria staff confirm, per domain, and how strictly they are enforced. | |
How the Test Catalogue Management editor is laid out and how its sections save. In review. | |
Start a new test from a copy of an existing one. In review. | |
The editor sections that show information kept elsewhere, and where to change it. In review. | |
Create and maintain lab units: their domain, whether they are active, their tests and their display order. In review. | |
Load or update the test catalog from CSV files instead of editing tests one at a time. In review. | |
Write the CSV files a site's test catalog is loaded from. In review. |
Programs, rules and notifications
How orders are grouped, and what OpenELIS does automatically with results. Open the folder.
Page | What it helps you do |
|---|---|
Set up the programs orders are filed under, and the extra questions reception answers for them. | |
Manage the coded value lists OpenELIS uses, such as result value options. | |
Add a follow-up test or note automatically when a result meets a condition. | |
Compute a test’s result automatically from other results, values or patient attributes. | |
Choose which notifications are sent for each test, to patient or provider, by email or SMS. |
Result reporting and analyzers
Getting results in from instruments and out to other systems. Open the folder.
Page | What it helps you do |
|---|---|
Set the external endpoints OpenELIS sends results and surveillance reports to. | |
Configure laboratory analyzers, set up field mappings and monitor results coming in. Older format. | |