LIMS Admin Value Flags - hmislk/hmis GitHub Wiki

Value Flags

A value flag is a rule attached to an investigation parameter that triggers a custom message when a result falls within a defined threshold. Unlike a standard reference range indicator (which simply shows H or L), flags can carry clinical messages — for example, "Show this result to the doctor immediately" or "Repeat the sample — value is critically high." Flags support age-based and sex-based filtering, so the same parameter can trigger different messages for different patient groups.


When to Use Flags

Use flags when:

  • A result value is not just abnormal, but clinically critical and requires immediate action.
  • You want to display a specific advisory message on the report rather than just an H/L indicator.
  • Different age groups or sexes warrant different alert levels for the same parameter.

Accessing Flag Configuration

  1. Go to Administration → Manage Lab Services → Manage Investigations tab → Manage Investigations.
  2. Select the investigation and click Flags. The Manage Flag page opens.

Adding a Flag

  1. Select Flag (the flag field) and Select Value (the result field it checks).
  2. Fill in the trigger conditions and messages below.

Range and patient group

Field Description
Sex Male or Female. A rule applies only to patients of that sex, so add one rule for each sex
From Age / To Age The patient age range for this rule, in days (for example 6570 to 43800 for 18 to 120 years)
From Value / To Value The normal range. Below From Value shows the low message; above To Value shows the high message; in between shows the within-range message

Messages

Field When it is shown
Message if Low The value is below From Value
Message if High The value is above To Value
Message if Within the Range The value is between the two

For a text result, the high message is shown when the text matches the rule's Max Value, and the low message when it matches its Min Value. Set these in the Flag List columns after saving the rule.

  1. Click Save. The rule appears in the Flag List, where Filter by Flag shows only the rules for one flag and Remove deletes a rule.

Example: serum potassium, adults

Add two rules (one Male, one Female) with From Age 6570, To Age 43800, From Value 3.5, To Value 5.1, and:

  • Message if Low: "L"
  • Message if High: "H"
  • Message if Within the Range: left empty

Several rules for one flag

Add more rules for other age groups. The first rule whose sex and age match the patient is used, so make the age ranges not overlap.


How Flags Appear During Result Entry

When an MLT enters a value that meets a flag condition:

  • The matching message fills the flag field of the report.
  • The MLT can still save and approve the report. Flags are informational; they do not block approval.

Flags and the "Requires Immediate Doctor Review" Toggle

Flags are separate from the manual Requires Immediate Doctor Review toggle. Flags are automatic (triggered by value thresholds); the toggle is manual (set by an authorised user after reviewing the result). Both can be active on the same report.

See Result Flags & Critical Values for the user-facing explanation.


Back to LIMS Administration