The three order domains

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

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

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

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.