description
This function filters clinical lists, such as problems, medications, and allergies, enabling display of only part of a list.
type
Data symbol function
syntax
LISTSUBSET(list, list_format, string, match_type, case)
arguments
list |
The list to return a subset of. You can put your own list in, or you can pass it a symbol representing one of the clinical lists, such as problems, medications, or allergies.
|
list_format |
The format of the list being subsetted:
comma - List items are separated by commas
list - List items appear one per line
string - The string to match
|
match_type |
Optional. The type of match to perform:
contains - Searches for items that contain the string
begins - Default. Begins searches for items that begins with the string
|
case |
Whether to consider case in matching:
exact - Must match case exactly
any - Case is not considered
|
returns
A list of items that match the specified string, formatted as specified by list_format
comment
Be very careful how you use this function. For example, you could create a LISTSUBSET function to display problems from the problem list that start with Diab, intending to display all of the patient’s problems that are related to diabetes. However, some diabetes-related problems may not show up, such as peripheral neuropathy.
example 1
{LISTSUBSET(PROB_PRIOR("list"),"list","diab", "contains", "any")
returns
DIABETES MELLITUS W/PERIPH CIRCULAT DISORDERS
(ICD-250.7)
POLYNEUROPATHY IN DIABETES (ICD-357.2)_
This example, from the Childhood Immunizations form included in the Pediatrics clinical content, makes use of the fact that observation terms for immunizations have a "#" character in them.
example 2
{LISTSUBSET(OBS_LIST_CHANGES(), "list", "#",
"contains", "any")}
returns
Added new observation of DPT #4VIS: 06/11/1999 (06/11/1999 9:49)
Added new observation of DPT #4EXP: 06/20/2003 (06/11/1999 9:49)
Added new observation of DPT #4SITE: right deltoid (06/11/1999 9:49)
Added new observation of DPT #4BY: doctor (06/11/1999 9:49)
Added new observation of DPT #4RTE: SQ (06/11/1999 9:49)
Added new observation of DPT #4LOT: 4 (06/11/1999 9:49)
Added new observation of DPT #4MFR: Smith-Kline-Beecham
(06/11/1999 9:49)
Added new observation of DPT #4: done (06/11/1999 9:49)
where used
Chart: letter and handout templates, text components, and quick text.
Encounter Form Editor: MEL expressions
|