Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Removed an extra space in a bullet and added a download link

Overview

A patient list is a dynamically populated list of patients that meet some set of selection rules. These lists are viewable on the Patient Lists page and are generated on-demand, when a list is requested. The selection rules utilize patient information (that is; patient details, patient attributes, visit details, and visit attributes) along with a comparison value and a value to compare against. For example, a list can be created to show all patients with an active visit that have a last name starting with “br”. The patient list item display templates (header and body) can use patient information along with basic HTML tags to customize the appearance of the patient list items.

...

A patient list is defined through a set results that satisfy a specified set of rules. Administrators create and manage the patient lists via the Manage Patient Lists page. These lists are viewable on the Patient Lists page and are generated on-demand, when a list is requested.  Each list must have a unique name one or more selection rules. The list can optionally have a description, item header template, item body template, and ordering fields.  

Selection Rules 

A list selection rule is used to select which patients will appear in the list and has three parts:

    1. The patient information field

    2. The comparison type (equals, not equals, starts with, contains, is defined, is not defined, etc)

    3. An optional comparison value or field

Screenshot showing the rule definition for a patient listImage Modified

The Add/Edit Patient List page will provide a simple UI to create selection rules and have dropdowns populated with all the patient information fields. When calculating the patients to include in a list, the selection rules will be transformed into HQL that will return the appropriate patients.

...

The ordering of the patient list can optionally be defined as part of the list definition by adding one or more ordering fields using the patient information fields. If no patient list order is defined the default ordering will be used.

Screenshot showing results ordering form for a patient list

 

Patient Information

The patient information fields can reference any of the following fields:

    • Patient Details
    • Patient Attributes
    • Patient Visit Details
    • Patient Visit Attributes

Requirements

  •  OpenHMIS OpenHMIS Commons Module version 3.2+
  • OpenMRS Reference Application version 2.3.1+

...

https://modules.openmrs.org/#/show/276/openhmis-patient-list-module