From ebe480d0891d1ffe7a306dc489ded7fd105ac97b Mon Sep 17 00:00:00 2001 From: PabloDelMedico Date: Mon, 21 Sep 2026 16:11:21 +0200 Subject: [PATCH 1/2] docs: add integration reference implementations section --- .../laboratory-interoperability.md | 523 ++++++++++++++++++ content/reference_implementation/overview.md | 49 ++ .../images/case-surveillance-program.png | Bin 0 -> 92413 bytes implementation_section_index.yml | 3 + 4 files changed, 575 insertions(+) create mode 100644 content/reference_implementation/laboratory-interoperability.md create mode 100644 content/reference_implementation/overview.md create mode 100644 content/reference_implementation/resources/images/case-surveillance-program.png diff --git a/content/reference_implementation/laboratory-interoperability.md b/content/reference_implementation/laboratory-interoperability.md new file mode 100644 index 0000000..ed17bbe --- /dev/null +++ b/content/reference_implementation/laboratory-interoperability.md @@ -0,0 +1,523 @@ +# Laboratory interoperability reference implementation { #lab_interop } + +> This guide accompanies the +> repository [DHIS2 Tracker Lab Result Integration - reference implementation](https://github.com/dhis2/reference-dhis2-tracker-lab-result-integration) +> + +## Introduction { #lab_interop_introduction } + +This guide is for implementers considering, evaluating, or building laboratory interoperability with DHIS2. It sets out +what any laboratory integration is made of and the design decisions you will have to answer for yourself, alongside one +worked set of answers. + +Laboratory results are one of the more common — and more painful — interoperability problems in DHIS2 implementations. +Laboratory systems are almost always external to DHIS2, run by a different team, and rarely designed with DHIS2 in mind. +Results have to reach the right person's record reliably, without manual re-entry and without the risk of landing +against the wrong case. What counts as a relevant result varies by disease and by country, since not every test is +performed at every level of the health system. Beyond getting the result onto the case, it is often useful to track how +the laboratory side is performing — turnaround times, for example. + +Interoperability is not a prerequisite for capturing laboratory data in a surveillance system. Giving laboratory staff +direct access to enter just the relevant results can speed up data capture considerably, at low cost and with no +integration work at all. Whether interoperability is worth the investment over something that simple is a cost/benefit +and sustainability question to work through for your own context before committing — this guide picks up once that +decision has been made in favour of interoperability. + +## What this guide covers — and what's in the repository { #lab_interop_scope } + +Laboratory results are typically typed by hand into whatever case-based surveillance or EMR-style program holds the +patient's record. That is slow, prone to transcription errors, and delays the information reaching the health workers +and managers who need it. Sending the result electronically instead removes the retyping step and the errors that come +with it, and makes the result available to everyone with access to the record as soon as it lands. + +The system on the other side of this integration is usually a **Laboratory Information System (LIS)**: a system built +around laboratory workflow, tracking a specimen from intake through testing to reported result and making that result +available to the staff and clinicians who rely on it. + +On the DHIS2 side, the scenario is +an [integrated surveillance and outbreak response system](https://dhis2.org/events/africa-cdc-toolkit-ebola/): DHIS2 +holds the case record that the laboratory result has to reach. + +This reference implementation covers **the flow of test results into DHIS2 — it does not cover placing test orders.** +The scenario is that a specimen has already been collected and identified, the laboratory has processed it, and the +result now needs to reach the correct record in DHIS2. Generating the specimen ID and placing the underlying laboratory +order are assumed to have happened earlier in the surveillance workflow. + +### This guide vs. the repository { #lab_interop_guide_vs_repository } + +The two are meant to be read together, and they do different jobs: + +| This guide | The [repository](https://github.com/dhis2/reference-dhis2-tracker-lab-result-integration) | +|----------------------------------------------------------------------------|-------------------------------------------------------------------------------------------| +| What laboratory interoperability involves, conceptually | The working code | +| The design decisions you face, the options available, and their tradeoffs | Quick start, Docker setup, and how to run it | +| Which answers this reference implementation chose, and why | Architecture diagrams and implementation detail | +| What it assumes of your DHIS2 configuration before you start | The preconfigured demo database and metadata | +| What to settle before go-live — ownership, error handling, data entry SOPs | Configuration, mapping files, and test scripts | + +Detail this guide leaves out — configuration, mapping files, deployment — lives in the repository. + +## How laboratory interoperability works { #lab_interop_how_it_works } + +Any laboratory results integration is built from the same four parts and moves data in the same shape, whatever +technology sits behind it. This section describes that shape. What this reference implementation puts in each slot — +which standard, which identifier, where the mapping lives, how the two sides talk to each other — is a series of +choices, and each one is set out under [Design decisions](#lab_interop_design_decisions) alongside the alternatives it +passed over. + +### The four moving parts { #lab_interop_components } + +Any laboratory result integration needs four things in place, whatever technology sits behind them: + +* **A destination** — the system holding the case record the result has to reach, and the reason the integration + exists at all. In this guide, DHIS2. +* **A source producing the result** — whatever reports the result once the laboratory has finished processing the + specimen, in a form other systems can consume. In production, the LIS. +* **A shared way of structuring the result** — an agreed structure, ideally backed by an existing standard, that both + sides understand, so that any system producing results in that shape can be consumed without a bespoke integration + per laboratory. See [Which standard and implementation guide](#lab_interop_decision_standard). +* **Something that moves the result between them** — the component that fetches the result, transforms it, and writes + it into the destination. This is the part implementers have to build or configure, and where most of the decisions + below land. Whether it exists as a component of its own is covered + in [Point-to-point or an interoperability layer](#lab_interop_decision_layer). + +None of these roles is tied to a particular product. Swapping in a different laboratory system, a different results +standard, or a different destination changes how each part is implemented, not the shape of the integration. + +### The shape of the flow { #lab_interop_flow } + +Whatever standard, laboratory system or middleware a country ends up with, the data moves in the same shape. A case is +registered in DHIS2 and associated with an identifier that the laboratory will also see. The laboratory processes the +specimen and produces a result, structured according to the agreed format and carrying that same identifier. The result +is then matched back to the right record using that identifier and written into the relevant program. + +Moving the result is a three-step pipeline: + +1. **Fetch** the result from the laboratory system once it's ready. +2. **Transform** it into the shape DHIS2 expects. +3. **Write** it into the correct record via the DHIS2 API. + +Two things have to be settled before any of it can run, and the pipeline itself supplies neither: what that shared +identifier is — see [How a case is uniquely identified](#lab_interop_decision_identifier) — and who holds the queue of +outstanding work, the laboratory system, the middleware, or DHIS2 — +see [How results reach DHIS2: push, poll or both](#lab_interop_decision_push_or_poll). + +## Prerequisites and assumptions { #lab_interop_prerequisites } + +This reference implementation takes a few things as given. Where they don't hold in your context, that work comes before +the integration is useful to you. + +### A specimen ID mechanism { #lab_interop_prereq_specimen_id } + +It assumes your implementation already has a way of assigning a **specimen ID**. How that ID is generated or assigned is +outside the scope of this guide; the results workflow is built on top of it. That reliance brings three conditions with +it: + +* The specimen ID must exist in DHIS2 before the result arrives — captured in the surveillance program prior to + synchronisation. +* The laboratory system must reuse that same, pregenerated ID when it returns the result. +* The ID must be unique across all lab requests, not just within a single case: two cases must never be able to collide + on the same specimen ID. + +This implementation takes the specimen ID as unique and correct — it does not detect or resolve duplicate or malformed +IDs. The specimen ID is not the only possible way to link a result back to a case, and the choice is a design decision +in its own right — see [How a case is uniquely identified](#lab_interop_decision_identifier). + +### The DHIS2 program shape { #lab_interop_prereq_program_shape } + +The DHIS2 instance this reference implementation ships with is preconfigured for that role, with programs covering case +surveillance and contact tracing. It also assumes a particular shape on the DHIS2 side: three logical stages of the same +case record. This is a common shape in case-based surveillance programs, but a modelling choice nonetheless. + +* an **enrollment stage**, where the case is registered against a suspected diagnosis; +* a **lab request stage**, where the specimen ID is captured, establishing the link; +* a **lab result stage**, which starts out empty and is what this integration populates. + +![The case surveillance program the reference implementation ships with, from enrollment through to case classification and outcome. Only the lab request and lab result stages take part in the integration; the others carry the rest of the surveillance workflow.](resources/images/case-surveillance-program.png) + +Both the request and result stages are repeatable, so one case can carry several specimens, each with its own thread of +results. Each result event carries the specimen ID data element — that, and nothing else in the payload, is what puts +the result on the right record, which is also why the specimen ID is mandatory on the request stage. Once a matching +report exists, the lab result form is populated for the surveillance officer to review; no human intervention is needed. + +### Completion as the trigger { #lab_interop_prereq_completion } + +**Completing the request is what makes it visible to the integration.** A lab request event must be marked complete +before it is acted on; one left in progress is never picked up, however well filled in it is. That is deliberate — it +lets data entry finish before half-entered specimen IDs are searched on — but it puts a step in the hands of facility +staff that the integration depends on. Say so explicitly in the data entry standard operating procedure, and watch for +stalled requests after go-live. Completing the request does not place a laboratory order. + +## Design decisions { #lab_interop_design_decisions } + +The sections below set out the decisions an implementer needs to make when building a laboratory results integration. +This reference implementation answers each one a particular way; a different country context may reasonably answer them +differently. Each is presented the same way: what you're deciding, the options, how to choose between them, and what +this reference implementation does. + +**Whatever you decide, write the answers down along with your reasons.** That record is worth as much to whoever +maintains the integration next as the code is. + +| Decision | What is at stake | What this reference implementation chose | +|---------------------------------------------------------------------------------------|----------------------------------------------------|-------------------------------------------------------------------| +| [1. How a case is uniquely identified](#lab_interop_decision_identifier) | Whether a result can reach the right case at all | The specimen ID, captured on the lab request | +| [2. Communication pattern](#lab_interop_decision_communication) | How the two sides coordinate on one piece of work | No shared workflow state; REST on both sides | +| [3. How results reach DHIS2: push, poll or both](#lab_interop_decision_push_or_poll) | Who has to be able to reach whom | Polling, with a dedicated layer calling both sides | +| [4. Which standard and implementation guide](#lab_interop_decision_standard) | How much translation work you take on | HL7 FHIR R4 with the Universal Laboratory Report IG | +| [5. Point-to-point or an interoperability layer](#lab_interop_decision_layer) | Who has to make a change when the mapping changes | A dedicated layer, with the mapping held in DHIS2 | +| [6. Where the result lands in the DHIS2 data model](#lab_interop_decision_data_model) | Whether the history of a result survives | Repeatable result stage, one event per result, updated in place | +| [7. Terminology and code mapping](#lab_interop_decision_terminology) | What happens to a result whose code has no mapping | Laboratory codes bound to DHIS2 metadata through attributes | +| [8. Individual-level or aggregate](#lab_interop_decision_granularity) | Whether matching is needed at all | Individual-level, into Tracker | +| [9. Handling unmatched and failed results](#lab_interop_decision_failures) | Whether people end up trusting the integration | Logged, with an implicit retry next cycle; no queue or alerting | + +### 1. How a case is uniquely identified { #lab_interop_decision_identifier } + +**What you're deciding.** An incoming result has to reach exactly one record in DHIS2. The identifier carrying that +match has to exist on both sides, be unique enough that a result never lands on the wrong case, and be practical for +laboratory staff to capture. + +**Options.** A specimen ID, a national ID, a surveillance-program-specific case ID, an insurance number, a phone number, +or the patient's name. DHIS2 supports several identifier types on the same case, so the choice need not be +all-or-nothing. + +**How to choose.** A specimen ID keeps patient identifiers out of the exchange entirely — a privacy advantage — but it +links a *sample* to a case and says nothing about the person, so it cannot tell you that two cases are the same +individual. A person-level identifier can, at the cost of carrying identifying data across the boundary and of ambiguous +matches. A name can be ambiguous or restricted for privacy reasons; a case ID may not be visible to the laboratory at +all. See the DHIS2 documentation +on [tracked entity attributes as personal identifiers](https://docs.dhis2.org/en/implement/database-design/tracker-system-design/defining-the-tracked-entity.html#tracked-entity-attributes-as-personal-identifiers). + +**What this reference implementation does.** It matches on the specimen ID — usually the identifier already understood +on both sides — captured in a mandatory field on the lab request stage. Capture it by barcode rather than typing +wherever you can. Note that the match only becomes possible once the lab request event is marked complete, +see [Completion as the trigger](#lab_interop_prereq_completion). + +**An alternative: matching on a person-level identifier.** This is not what this reference implementation does, and none +of it ships in the repository. It is set out here because the situation comes up often — no specimen ID shared between +the two systems, or an integration that also has to recognise the same person across separate episodes — and this is +generally how implementations solve it. + +The **National ID** tracked entity attribute is the natural candidate. That path needs four things: + +* **The identifier held on both sides** — if only one side captures it, there is nothing to match on. +* **Attributes to triangulate the match** — the specimen collection date and the date sent to the laboratory narrow the + candidates and reduce accidental mismatches. +* **A date window**, typically from the enrollment date onwards, so an earlier result for the same person isn't matched + to the current case. +* **A record of what has already been synchronised**, normally held in the interoperability layer. + +Even then the match may be genuinely ambiguous, since the same person may have several enrollments, so a manual +confirmation step is part of the design rather than an edge case. What that costs to build and to run is set out +under [Customising this reference implementation for your context](#lab_interop_adapting). + +### 2. Communication pattern between DHIS2 and the laboratory { #lab_interop_decision_communication } + +**What you're deciding.** How the laboratory request and its eventual result move between the two systems, and how much +of the workflow each side needs to know about. Often no explicit workflow-management layer is needed at all — the two +systems simply exchange resources as the moment requires. + +**Options and how to choose.** Work through the questions below for your own context. The right-hand column records how +this reference implementation answers each one. + +| Question to work through | This reference implementation | +|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------| +| Does the state of the workflow need to be shared between DHIS2 and the laboratory system, or is it enough for each side to hold its own view? | Each side holds its own view. There is no shared workflow state and no separate sync-status store | +| Which paradigm do you want to use — REST, messaging, services, or a mix? | REST on both sides: the DHIS2 Web API and the LIS FHIR API | +| Who owns and manages the specimen and result — DHIS2 (as the requester), the laboratory system (as the performer), or another participant, such as a referral laboratory sitting between the two? | DHIS2 as requester, the laboratory system as performer | +| Is there a need for the laboratory to confirm it has accepted the request, or can that be presumed? | Presumed — no acceptance step | +| Is there a need to negotiate whether, or how, the requested test will be performed? | No negotiation step | +| Can DHIS2 and the laboratory system communicate directly — can they post to each other's servers, if using REST? | Neither system contacts the other. A layer sits between them and calls both | +| Is there an ability, or a need, to use a queue server to facilitate the workflow? | No queue server is used | +| How many potential actors are involved — a single laboratory, or several candidate laboratories? | A single laboratory | +| Will the workflow always be directed at a specific laboratory, or is there a pool of laboratories that could choose to perform the requested test? | Always directed at a specific laboratory | + +A context with several candidate laboratories, or a laboratory able to push results as soon as they're ready, may +reasonably answer these differently. + +### 3. How results reach DHIS2: push, poll or both { #lab_interop_decision_push_or_poll } + +**What you're deciding.** How DHIS2 learns that a result is ready. This is usually settled by network reality rather +than preference, so establish it early: it determines who has to be able to reach whom, and who operates what. + +**Option A: poll.** Something asks, on a schedule, whether there is anything new, keeping track of what it has already +taken so nothing imports twice. It needs only *outbound* connectivity from wherever the poller runs — which matters, +because the LIS often sits behind a laboratory firewall while DHIS2 sits in a national data centre, and neither can +accept inbound connections. It also recovers by itself: an hour of downtime is caught up on the next run. + +**Option B: push.** The source notifies the destination as soon as a result is final — in FHIR, via Subscriptions. +Lower latency, no wasted calls. But the LIS must be able to reach an endpoint on your side, somebody has to operate and +secure it, and the LIS needs its own retry policy: a missed notification is a lost result. It also asks more of the LIS +vendor than you may be able to influence. + +**Option C: both.** Push for latency, a periodic poll as the safety net. The most robust arrangement and the most work +to build. + +**How to choose.** Start from connectivity direction and operational ownership, not from latency — laboratory turnaround +is measured in hours or days, so a poll every few minutes is invisible to a surveillance officer. Check what the polling +cost scales with: polling DHIS2 for open cases grows with the number of active cases, not the number of results, which +is worth modelling before national rollout. + +**What this reference implementation does.** It polls both sides; neither system ever initiates contact. On a schedule, +the interoperability layer fetches active enrollments in the surveillance program, finds the completed lab requests +within them, and +searches the laboratory for a report matching each specimen ID. It keeps no separate record of what it has already +imported — it works that out from the result events already in DHIS2 — so there is nothing to reconcile if it restarts. +Only final, amended, appended or corrected reports are picked up. + +### 4. Which standard and implementation guide { #lab_interop_decision_standard } + +**What you're deciding.** The shared structure that lets DHIS2 consume results without a bespoke integration per +laboratory. Few implementers start from a free choice here: the LIS emits what it emits, and the country may already +have a standard. The realistic question is *how much translation work you take on, and where you put it.* + +**Option A: HL7 FHIR with the Universal Laboratory Report IG.** The choice made here. Maintained, internationally +reviewed profiles for exactly this exchange, plus a body of tooling. Both sides must speak FHIR, and the IG is still a +moving target. + +**Option B: a national FHIR IG.** Where the country has one it usually takes precedence, and may be mandated as part of +a national health information exchange architecture. Check before adopting an international IG — retrofitting later is +expensive. + +**Option C: plain FHIR with no IG.** Faster to start with and reasonable for a single known laboratory, but you give up +the guarantees about which elements are present and how they are coded, and end up maintaining those constraints +yourself, informally. + +**Option D: HL7 v2 messages.** A large share of laboratory systems in production emit v2, not FHIR. You then need +something that receives and maps the messages before the rest of the pipeline looks like this one. A v2-only LIS is not +a reason to abandon the integration: it moves the translation upstream and leaves the DHIS2-facing half largely +unchanged. + +**Option E: a proprietary API or flat-file export.** Often the pragmatic reality with a single laboratory, and sometimes +the only thing on offer. It works, but you own the contract — define it, version it, renegotiate it whenever the vendor +changes anything, and start again for the second laboratory. + +**How to choose.** Work through, in this order: what the LIS can actually produce today; whether a national IG or HIE +standard applies; how many laboratories you expect to onboard; and where the translation should sit — in the LIS, in an +interface engine, or in your own interoperability layer. + +**What this reference implementation does.** HL7 FHIR R4 with +the [Universal Laboratory Report IG](https://build.fhir.org/ig/HL7/uv-lab-rep-ig/), chosen for its broad scope: it grew +out of the earlier European Laboratory Report IG into a global, HL7-maintained standard. A HAPI FHIR server stands in +for an LIS, so the demo stays focused on the DHIS2-facing side. Four of the IG's resources are used: + +| Resource | Role in this integration | +|--------------------|---------------------------------------------------------------------------------------| +| `Specimen` | Carries the specimen ID — the link back to the DHIS2 lab request | +| `Observation` | Carries the LOINC code identifying the test performed, and its result | +| `Patient` | The test subject, which can be anonymous so that no patient data crosses the boundary | +| `DiagnosticReport` | Bundles specimen, observation and patient together, and carries the report status | + +Since there is no real LIS here, those resources are created by test scripts in the repository, standing in for the +laboratory analyser. In production the LIS produces them itself. They are a test kit, not part of the integration — an +adaptation drops them. + +### 5. Point-to-point or an interoperability layer { #lab_interop_decision_layer } + +**What you're deciding.** Where the fetch, transform and write logic lives — and with it the mapping, the logging, and +the record of what has been synchronised. What it really decides is who has to make a change when your DHIS2 metadata +changes, which in the long run matters more than the initial build. + +**Option A: direct, point-to-point.** The LIS writes straight to the DHIS2 Web API, or DHIS2 pulls results itself. +Fewest moving parts, nothing extra to host, and defensible for a single laboratory with a cooperative vendor. The cost +comes later: the LIS is coupled to your DHIS2 metadata, so every change becomes a vendor request, and the second +laboratory starts from scratch. + +**Option B: a dedicated interoperability layer.** A component of your own between the two systems, giving you one place +for mapping, logging and error handling, and shielding each side from the other's changes. The cost is another service +to deploy, monitor, secure and staff. + +**Option C: an established HIE or mediator platform** — OpenHIM, for example. Adds routing, audit and client +authentication across many systems rather than just this one. Heavier to operate, and it makes most sense where the +country already has a health information exchange strategy and this is one integration among several. + +**How to choose.** The case for a layer strengthens with the number of laboratories, the number of integrations, and how +likely your metadata is to change. Weigh that against who will actually run it: a layer nobody is funded to operate is a +liability, and a point-to-point integration that works is better than an elegant architecture that goes unmaintained. +Whichever you choose, keep the mapping out of compiled code, so that changing how results land is a configuration change +rather than a release. + +**What this reference implementation does.** A dedicated layer — the IOL, built +on [Apache Camel](https://camel.apache.org/) — configured rather than coded. The part worth borrowing is less the +technology than where the mapping is kept: **both the structural transformation and the terminology mapping live in +DHIS2, not in the layer.** The transformation that turns a laboratory report into a DHIS2 event is a script held in the +DHIS2 datastore, so changing how a result maps onto your stage is a datastore edit rather than a redeployment; the +terminology mapping lives in DHIS2 metadata, +see [Terminology and code mapping](#lab_interop_decision_terminology). That lets a DHIS2 implementer change how results +land without involving the team that maintains the layer — which is most of the reason to prefer a layer over a +point-to-point integration in the first place. + +### 6. Where the result lands in the DHIS2 data model { #lab_interop_decision_data_model } + +**What you're deciding.** How the result is represented in the case record — which decides whether the history of a +result survives, what a reviewer sees, and how the data behaves in analytics. A program design decision, so it is made +once and is awkward to change after data has accumulated. + +A laboratory result is not necessarily final: a laboratory can issue a **correction**, an **amendment**, or an +**appended addition** to a report it has already sent. A design that keeps only the latest value silently discards the +fact that something changed. + +**Option A: a repeatable result stage, one event per incoming result, updated in place.** One form to read. A correction +overwrites the earlier value, so the record shows the current answer and no history. + +**Option B: a repeatable result stage, multiple events per incoming result.** Every correction and amendment is its own event, +so a reviewer sees what changed and when. The cost is that "the result" becomes a derived question: reports and program +indicators have to pick the right event, usually the latest for a specimen, and that logic has to be written +deliberately. + +**How to choose.** Ask how often your laboratory issues corrections, whether a reviewer needs to see that a value +changed, and what you intend to report on. If turnaround time is a goal, both the request and the result need reliable +dates. Decide up front which result counts for analytics — the first final one or the latest amendment — because your +indicators depend on it. + +**What this reference implementation does.** Option A: a repeatable lab result stage holding **one event per incoming +result, updated in place**. A report re-issued as a correction or amendment updates that same event rather than adding +another, so the record shows the current answer; the status change is recorded in the event notes. The program shape +this sits in — and the request stage that links to it — is described +under [The DHIS2 program shape](#lab_interop_prereq_program_shape). + +### 7. Terminology and code mapping { #lab_interop_decision_terminology } + +**What you're deciding.** Every incoming laboratory code has to resolve to the right DHIS2 data element or option. Not +every one will — either the terminology doesn't cover it, or no mapping has been defined for it yet. What happens then +is worth deciding deliberately rather than discovering later. + +**Option A: fall back to free text.** The value is at least captured, but free text is considerably harder to analyse. +Treat it as a fallback for the codes you can't yet resolve rather than a default, and close that gap with a proper +mapping over time. + +**Option B: extend the implementation guide.** Propose new codes, or maintain a local extension of the value set, so the +result stays structured and codeable. This avoids the analytical downside of free text, but means engaging with the IG's +governance process or versioning a local extension — slower than switching a data element to free text. + +**How to choose.** Weigh how often the missing code is likely to recur against how much analytical value is lost by +leaving it as free text in the meantime. Either way, give the mapping an owner: codes are added to terminologies, +laboratories change the panels they run, and DHIS2 metadata evolves — an unmaintained mapping quietly degrades into a +growing share of unmapped results. + +**What this reference implementation does.** Laboratory codes are bound to DHIS2 metadata through **attributes**: each +data element or option that corresponds to a laboratory concept carries the relevant code in a dedicated attribute, and +the integration builds its lookup from those values. Because the mapping lives in DHIS2 metadata rather than in the +layer, an implementer can revise it without involving the team that maintains the integration. Any coding system the +chosen implementation guide supports will do; the [Universal Laboratory Report IG](https://build.fhir.org/ig/HL7/uv-lab-rep-ig/) +allows [LOINC](http://loinc.org) and [NPU](http://terminology.hl7.org/6.2.0/CodeSystem-NPU.html) codes. + +### 8. Individual-level or aggregate { #lab_interop_decision_granularity } + +**What you're deciding.** Whether the surveillance need really requires individual results in a Tracker program, or +whether counts would satisfy it. Getting this wrong in the ambitious direction is expensive: individual-level +interoperability is the hard version of this problem, because it is the version that requires matching. + +**Option A: individual-level, into Tracker.** Necessary when a named case needs its result — case management, contact +tracing, clinical follow-up, line-listed reporting. This is where the identifier and matching decisions apply, and where +most of the cost sits. + +**Option B: aggregate, into a data set.** Enough when the requirement is counts by facility and period. Matching +disappears entirely: no specimen ID, no case linkage, and usually no patient identifiers crossing the boundary at all. +The pipeline is still fetch, transform, write, but the write targets aggregate data values and the mapping becomes test +and result category to data element and category option combination. The hard parts move rather than vanish: aligning +periods, mapping the laboratory's own organisation units onto the DHIS2 hierarchy, and making re-runs safe so figures +are not double counted. + +**Option C: individual-level in, aggregate out.** Import individual results into Tracker for case management and derive +aggregate reporting inside DHIS2. Often the right end state, but only once the individual-level path is justified on its +own terms. + +**How to choose.** This is the cost/benefit question from the introduction, one level down. If the reporting requirement +is genuinely aggregate, a periodic extract from the LIS — or a routine report entered by laboratory staff — may satisfy +it at a fraction of the cost and with none of the matching risk. + +**What this reference implementation does.** Individual-level Tracker data: one result event per specimen, matched to a +specific enrollment. Aggregate laboratory reporting is not addressed. + +### 9. Handling unmatched and failed results { #lab_interop_decision_failures } + +**What you're deciding.** What happens to the results that don't sail through. This decides whether people trust the +integration: one that loses results occasionally and silently is worse than manual entry, because staff stop checking +and stop believing what they see. + +Plan for at least these: no matching lab request; more than one candidate match; several reports for the same specimen +ID; a code with no DHIS2 mapping; a missing or malformed specimen ID; a request never marked complete; the same result +arriving twice; an import DHIS2 rejects; and either system being unreachable. + +**Options.** For genuinely unmatched results: hold them in a queue or review app for manual matching, reject them with a +notification back to the laboratory, or park them in DHIS2 for later reconciliation. + +**How to choose.** This is a policy question as much as a technical one. Someone has to look at failures, through some +interface, on some cadence — a national data manager, the laboratory focal point, or the team running the integration. +Name them before go-live and give them somewhere to look, and make re-processing safe so that a repeat import updates +rather than duplicates. For production, close these gaps: a retry policy, alerting on repeated failures, a periodic +check for lab requests left open past a plausible turnaround time, handling for laboratory results DHIS2 knows nothing +about, and a named owner for the error log. + +**What this reference implementation does.** It is driven from DHIS2's lab requests and only asks the laboratory about +specimen IDs it already knows, so every report it fetches already has a lab request to land on. Within that boundary: an +empty specimen ID is skipped; an incomplete lab request is passed over; a specimen with no report yet is reconsidered on +the next cycle; a correction updates the result event in place. Imports are checked and logged, and a failed import +retries on the next cycle. Visibility is the logs. + +## Customising this reference implementation for your context { #lab_interop_adapting } + +As with other DHIS2 reference implementations, this one is a starting point rather than a drop-in solution. Every design +decision above is an answer this implementation gave; where your answer differs, something has to change with it. The +steps below follow those decisions. Configuration key names, and the full list of them, are in +the [repository](https://github.com/dhis2/reference-dhis2-tracker-lab-result-integration). + +**Revisit your program design.** Start here, because everything else points at it: your own enrollment, request and +result stages, whether the result stage is repeatable, and which result counts for analytics — +see [Where the result lands in the DHIS2 data model](#lab_interop_decision_data_model). If you match on something other +than a specimen ID, the request stage changes shape too — see the next step. + +**If you match on a person-level identifier.** The alternative described +under [How a case is uniquely identified](#lab_interop_decision_identifier) is not a configuration change. Three parts of +the integration have to be reworked: + +* **How the laboratory is searched.** Today it searches on one specimen ID and expects one report. It would instead + search on the person identifier, bounded by a date window, and sift the candidates itself. +* **Where sync state lives.** Today none is kept — what has already been imported is worked out from the result events + in DHIS2, see [How results reach DHIS2: push, poll or both](#lab_interop_decision_push_or_poll). With no specimen ID + to key on, the integration needs a store of its own. +* **Failure handling and manual review.** Today an unmatched result cannot arise — + see [Handling unmatched and failed results](#lab_interop_decision_failures). Here ambiguous and unmatched results are + routine. Nothing resolves them automatically, so the build grows a confirmation step — a Capture app plugin that asks + which enrollment a result belongs to, for example — along with the review workload to staff and the results that will + never resolve. + +**Point it at your own metadata.** The integration is configured with the identifiers of your program, your lab request +and lab result stages, your specimen ID data element and the attribute carrying laboratory codes. All ship as demo +values and must be replaced. These are the concrete expression of the program shape described +under [The DHIS2 program shape](#lab_interop_prereq_program_shape); if that shape differs, expect to revisit them. + +**Bind your metadata to laboratory terminology.** Add the codes your laboratory actually reports to your own data +elements and option set values, through that attribute, so the lookup can be built. Decide in advance what happens to a +result whose code has no mapping, and give the mapping an owner — +see [Terminology and code mapping](#lab_interop_decision_terminology). + +**Replace the transformation script.** The script held in the DHIS2 datastore is written against this implementation's +result stage and the resources the mock laboratory system produces. Yours has to match your own stage's data elements +and what your laboratory system actually emits. That it lives in the datastore rather than in code is the point — it is +what lets you change this without involving the team that maintains the layer; +see [Point-to-point or an interoperability layer](#lab_interop_decision_layer). + +**Swap in the real source system.** Point the integration at the real laboratory system. If it does not speak FHIR with +the implementation guide you have chosen — an HL7 v2 or proprietary feed, for instance — the translation moves upstream +and the DHIS2-facing half stays largely as it is; +see [Which standard and implementation guide](#lab_interop_decision_standard). + +**Choose a polling interval.** Set it from your laboratory's actual turnaround times rather than from how responsive the +demo feels. If your context can support push instead, the trigger changes and +this setting stops mattering — see [How results reach DHIS2: push, poll or both](#lab_interop_decision_push_or_poll). + +**Set connection details and credentials.** The DHIS2 API base URL with a personal access token or a +username and password, and the laboratory system's API URL. The shipped compose file uses well-known demo credentials; +change them before this runs anywhere real. + +## Resources { #lab_interop_resources } + +* [Laboratory interoperability reference implementation](https://github.com/dhis2/reference-dhis2-tracker-lab-result-integration) — + code, quick start, architecture diagram and configuration reference. +* [Universal Laboratory Report Implementation Guide](https://build.fhir.org/ig/HL7/uv-lab-rep-ig/). +* [DHIS2 Web API documentation](https://docs.dhis2.org/en/develop/using-the-api/dhis-core-version-master/introduction.html). +* [DHIS2 documentation: tracked entity attributes as personal identifiers](https://docs.dhis2.org/en/implement/database-design/tracker-system-design/defining-the-tracked-entity.html#tracked-entity-attributes-as-personal-identifiers). + +**Questions and contributions.** Questions or feedback can be posted on +the [DHIS2 Community of Practice](https://community.dhis2.org/). diff --git a/content/reference_implementation/overview.md b/content/reference_implementation/overview.md new file mode 100644 index 0000000..9093a9d --- /dev/null +++ b/content/reference_implementation/overview.md @@ -0,0 +1,49 @@ +# Integration reference implementations { #integration_reference_implementations } + +## Introduction { #iri_introduction } + +An integration reference implementation is a a well-documented, working example that shows one way to solve a common integration problem. You can run it, explore how it's put together, and use it as a starting point for building your own solution. It is meant to be studied and adapted to your own context rather than deployed as-is. + +> **Note** +> +> An integration reference implementation is not ready-to-use software. It needs to be reviewed and adjusted to fit your own systems, data, and security requirements before it can be relied upon. + +Building an integration from scratch takes time and is easy to get wrong, especially when the same kinds of problems come up again and again across different implementations. A reference implementation gives your team a tested example to learn from, so effort goes into adapting the parts that are genuinely specific to your context, rather than re-solving problems that have already been worked out elsewhere. + +## Common integration patterns { #iri_common_patterns } + +These examples tend to cluster around a handful of recurring problems rather than being one-off curiosities. A common one is connecting DHIS2 to an external system that already holds information about a person — an identity registry, a civil registry, another health record — so that a health worker doesn't have to re-enter details that are already known elsewhere. Another is laboratory interoperability: exchanging orders and results with a laboratory information system so that specimen and test data move between DHIS2 and the lab without being re-entered on either side. A third is letting information move safely between different services and providers, using a shared way of identifying and authenticating someone, while still respecting who is allowed to see what. + +Each reference implementation is built around one specific project's actual need, and some are more mature than others: some are documented, tested end-to-end examples meant to be adapted directly, while others are earlier, more exploratory demonstrations meant to show that an idea works before anyone commits to a specific design. Either way, the underlying pattern usually shows up well beyond the original project, which is exactly why it is useful as a shared example rather than something built again from scratch every time. + +## Adapting a reference implementation for deployment { #iri_adapting } + +Turning a reference implementation into something you can actually deploy is a process of deliberate adaptation, not a checklist to click through. It means: + +- **Decide what to keep** as-is and what to replace with your own systems. +- **Adjust the example** to match the data you actually need to exchange, which will rarely be identical to what it started with. +- **Swap out example components** for the real systems in your environment, such as a different lab system or a different identity provider. + +> **Tip** +> +> Keep the automated checks that ship with the example in place as you make changes. They give you a fast way to confirm your adaptation still works as intended, rather than discovering problems only after deployment. + +## Who should be involved { #iri_who_should_be_involved } + +This adaptation work is rarely something one person does alone, and it rarely happens in a single pass. It usually involves whoever owns the systems on the other side of the integration, the team responsible for data protection and information security, and the people who will end up supporting the result day to day. + +Bringing them in early, while the example is still being explored rather than already locked into a deployment plan, tends to save time later: it's much easier to change direction on a working example than on something that has already gone live. Treating the reference implementation as a shared starting point for that conversation, rather than a finished answer to hand over, is usually what makes the eventual adaptation hold up. + +## Confirming your adaptation is production-ready { #iri_production_ready } + +Before treating an adapted reference implementation as production-ready, it's worth working through a short set of questions with that same group of people: + +- Has someone reviewed it against your organization's own security and data protection requirements, not just the example's assumptions? +- Have you confirmed it handles your real data, including the messy, incomplete, or unusual cases the example data may not have covered? +- Have the example-only components — test systems, sample identity providers, demo data — been replaced with your actual systems? +- Do the automated checks that came with the example still pass after your changes, and have you added checks of your own where the adaptation introduced something new? +- Does your team understand the design well enough to support it going forward, rather than treating it as a black box inherited from the example? + +## Conclusion { #iri_conclusion } + +None of this is meant to discourage teams from using reference implementations — quite the opposite. They exist precisely because starting from a working, well-thought-through example is faster and safer than starting from a blank page, and the questions above are simply the difference between borrowing that head start responsibly and copying it blindly. Used this way, a reference implementation shortens the distance between having an integration problem and having a solution your organization actually trusts and owns. diff --git a/content/reference_implementation/resources/images/case-surveillance-program.png b/content/reference_implementation/resources/images/case-surveillance-program.png new file mode 100644 index 0000000000000000000000000000000000000000..894a91b2b6f12ec54635fc282a69a6920c25938f GIT binary patch literal 92413 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 Date: Mon, 21 Sep 2026 16:45:30 +0200 Subject: [PATCH 2/2] Update overview.md Fixed typos --- content/reference_implementation/overview.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/reference_implementation/overview.md b/content/reference_implementation/overview.md index 9093a9d..2ce6e68 100644 --- a/content/reference_implementation/overview.md +++ b/content/reference_implementation/overview.md @@ -2,7 +2,7 @@ ## Introduction { #iri_introduction } -An integration reference implementation is a a well-documented, working example that shows one way to solve a common integration problem. You can run it, explore how it's put together, and use it as a starting point for building your own solution. It is meant to be studied and adapted to your own context rather than deployed as-is. +An integration reference implementation is a well-documented, working example that shows one way to solve a common integration problem. You can run it, explore how it's put together, and use it as a starting point for building your own solution. It is meant to be studied and adapted to your own context rather than deployed as-is. > **Note** > @@ -30,7 +30,7 @@ Turning a reference implementation into something you can actually deploy is a p ## Who should be involved { #iri_who_should_be_involved } -This adaptation work is rarely something one person does alone, and it rarely happens in a single pass. It usually involves whoever owns the systems on the other side of the integration, the team responsible for data protection and information security, and the people who will end up supporting the result day to day. +This adaptation work is rarely something one role does alone, and it rarely happens in a single pass. It usually involves whoever owns the systems on the other side of the integration, the team responsible for data protection and information security, and the people who will end up supporting the result day to day. Bringing them in early, while the example is still being explored rather than already locked into a deployment plan, tends to save time later: it's much easier to change direction on a working example than on something that has already gone live. Treating the reference implementation as a shared starting point for that conversation, rather than a finished answer to hand over, is usually what makes the eventual adaptation hold up.