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.
Administrators create and manage the patient lists via the Manage Patient Lists page. 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.
Feature Summary
Features included in this release are:
- Configurable Patient Lists
- Selection Rules
- Display Templates
- Ordering
- Patient Lists Page
- Mobile Device Support
Module Functionality
Customizable Patient Lists
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. Administrators create and manage the patient lists via the Manage Patient Lists page. 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:
The patient information field
The comparison type (equals, not equals, starts with, contains, is defined, is not defined, etc)
An optional comparison value or field
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.
Display Templates
The appearance of each patient item on the patient list is customizable via display templates. Each list can define a header and body display templates. The header template is used to set the appearance of the single-line patient item header while the body template is used to set the appearance of the patient item body. If no display templates are defined the default templates will be used. The template can use basic HTML tags along with any of the patient information fields to create the format needed. Each patient list item has two parts:
List Item Header
Optional List Item Body
The template will use a common (yet-to-be-determined) web template language.
Requirements
OpenHMIS Commons Module version 3.2+
OpenMRS Reference Application version 2.3.1+