The three order domains
Work in progress. This page is published before its review is finished so you can use it now. It is being reviewed under OGC-1271, so details may still change. If something on your screen does not match, add a comment to this page.
Part of: Environmental Surveillance workflow overview and Vector Surveillance workflow overview
Concept · all roles
This page describes OpenELIS 3.4.0. The earlier version of this page, with the four-stage wizard, is in LEGACY Versions.
In short
Under Main menu → Order there is one order entry per domain: Add Clinical Order, Add Environmental Order and Add Vector Order. Each one is a short series of steps, shown in a step bar at the top of the screen. A clinical order goes through Enter Order, Prepare Samples and Sample check. On environmental and vector orders the step bar continues after Enter Order with Label & Store and Sample check, and a vector order adds Complete.
The steps in each domain
Domain | Where | Steps in the step bar | An order starts from |
|---|---|---|---|
Clinical | Main menu → Order → Add Clinical Order | Enter Order, Prepare Samples, Sample check | A patient |
Environmental | Main menu → Order → Add Environmental Order | Enter Order, Label & Store, Sample check | A sampling site |
Vector | Main menu → Order → Add Vector Order | Enter Order, Label & Store, Sample check, Complete | A sampling site |
Under Add Clinical Order the Main menu lists Dashboard, Enter Order, Prepare Samples and Sample check. Under Add Environmental Order and Add Vector Order it lists Dashboard, Enter Order, Label & Store and QA Review. On the environmental and vector Enter Order, the step bar shows Sample check where the menu shows QA Review. The vector step bar also has a Complete step, which has no menu entry.
In a clinical order, labelling and storage are part of Prepare Samples rather than a step of their own.
What all three share
Lab Number. Enter Order opens with a Lab Number already filled in and Generate Lab Number beside it.
Step bar and order card. The step bar shows the state of each step, for example Ready for the step in hand and Not started for the steps after it. The card under it shows the Lab Number, the order status (In Progress while the order is being entered) and a step counter.
The environmental and vector Enter Order also share a Requester section, whose help text reads Select the facility that ordered the tests and the responsible provider., and a Program field.
What differs by domain
Domain | What is specific to it |
|---|---|
Clinical | The order belongs to a patient, found with Search for Patient or added with New Patient. Samples are prepared, labelled and stored in Prepare Samples, and checked in Sample check. |
Environmental | The order belongs to a Sampling Site. The Site Name help text reads Only active surveillance sites appear in results. GPS coordinates are pre-filled from the site record. The Collection Date help text reads Applies to every sample on this order. Enter Order also has Default Collection Conditions (Defaults applied to all samples in this batch.: Collection Method, Water Temp (°C), Ambient Temp (°C), Weather, Preservation Method and Field Notes), Applicable Compliance Standards, a Per-Sample Manifest and Tests & Panels. |
Vector | The order also has a Sampling Site and a Collection Date with the same help text. Under Sample, each organism is an Animal/Organism row; Add Animal/Organism adds another. The order card summarises the samples, for example Pool of 1 Sample: No tests selected. An optional Collection Context section is described as recording ecological conditions at the time of collection. |
Lab units and domains
Every lab unit belongs to one domain: Clinical, Environmental or Vector. The domain is set when the unit is created in Manage lab units, where the screen explains that it determines which order entry and sample collection fields apply to orders routed to this lab unit. Changing the domain of an existing unit opens Change Lab Unit Domain?, which reads Historical orders/results were evaluated against the prior domain's rules. New orders will use the new domain's rules.
The administrator account used to check this page sees Add Clinical Order, Add Environmental Order and Add Vector Order, although Lab Unit Management counts no Environmental lab units on that server.
Not yet verified
Whether a user whose lab units all belong to one domain sees only that domain's order entry.
Whether the QA Review menu entry opens the same step that the step bar calls Sample check.
The environmental and vector Label & Store, Sample check and Complete screens on this release: no environmental or vector order was completed for this page.
The clinical Enter Order on this release; the clinical rows rest on the verified clinical pages linked below.
Related
Enter a clinical order, Prepare samples for a clinical order and Complete the sample check for a clinical order
Label and store environmental and vector samples and Complete the sample check for an environmental or vector order
Environmental Surveillance workflow overview and Vector Surveillance workflow overview
Something on this page out of date or unclear? Add an inline comment on this page, or post in OpenELIS Talk.
Provenance
Rewritten 2026-11-06 on testing.openelis-global.org, version 3.4.0-SNAPSHOT, replacing the four-stage wizard description (3.2.x); the earlier title was "The three domains & the shared order wizard". Observed, not driven: the Order menu entries; the environmental and vector Enter Order screens as they open, with their step bars, Lab Number, sections and help text; Lab Unit Management counting 22 Clinical, 0 Environmental and 1 Vector lab units. From verified pages: the clinical steps and patient search from Enter a clinical order (driven 2026-10-07 on 3.3.0); the lab unit domain wording and the Change Lab Unit Domain? dialog from Manage lab units (verified 2026-09-22, Cancel only). Not re-checked: the items under Not yet verified. Review: OGC-1271. Drift contract: domains-concept.