This
page
is
part
of
the
FHIR
Specification
(v3.0.2:
STU
3).
The
current
version
which
supercedes
this
version
is
5.0.0
.
For
a
full
list
Continuous
Integration
Build
of
available
versions,
see
FHIR
(will
be
incorrect/inconsistent
at
times).
See
the
Directory
of
published
versions
.
Page
versions:
R5
R4B
R4
R3
R2
Responsible
Owner:
FHIR
Infrastructure
Work
Group
|
Normative
|
|
Compartments : Device , Patient , Practitioner |
Detailed Descriptions for the elements in the List resource.
| List | |||||||||
|
| List | ||||||||
| Definition |
A
|
||||||||
| Short Display | A list is a curated collection of resources | ||||||||
| Cardinality | 0..* | ||||||||
|
| DomainResource | ||||||||
| Alternate Names | Collection; WorkingList; Organizer | ||||||||
|
| false | ||||||||
| Constraints |
|
||||||||
| List.identifier | |||||||||
|
| List.identifier | ||||||||
| Definition |
Identifier for the List assigned for business purposes outside the context of FHIR. |
||||||||
|
| Business identifier | ||||||||
| Note |
This
is
a
business
|
||||||||
|
|
0..* | ||||||||
| Type | Identifier | ||||||||
| Summary | false | ||||||||
| List.status | |||||||||
|
| List.status | ||||||||
| Definition |
Indicates the current state of this list. |
||||||||
| Short Display | current | retired | entered-in-error | ||||||||
| Cardinality | 1..1 | ||||||||
| Terminology Binding |
|
||||||||
| Type | code | ||||||||
| Is Modifier | true (Reason: This element is labeled as a modifier because it is a status element that contains status entered-in-error which means that the resource should not be treated as valid) | ||||||||
| Summary | true | ||||||||
| Comments |
This element is labeled as a modifier because the status contains codes that mark the resource as not currently valid. |
||||||||
| List.mode | |||||||||
|
| List.mode | ||||||||
| Definition |
How this list was prepared - whether it is a working list that is suitable for being maintained on an ongoing basis, or if it represents a snapshot of a list of items from another source, or whether it is a prepared list where items may be marked as added, modified or deleted. |
||||||||
| Short Display | working | snapshot | changes | ||||||||
| Cardinality | 1..1 | ||||||||
| Terminology Binding |
|
||||||||
| Type | code | ||||||||
| Is Modifier | true (Reason: If set to "changes", the list is considered incomplete, while the other two codes indicate the list is complete, which changes the understanding of the elements listed) | ||||||||
| Requirements |
Lists are used in various ways, and it must be known in what way it is safe to use them. |
||||||||
| Summary | true | ||||||||
| Comments |
This
element
is
labeled
as
a
modifier
because
a
change
list
must
not
be
|
||||||||
| List.title | |||||||||
|
| List.title | ||||||||
| Definition |
A label for the list assigned by the author. |
||||||||
| Short Display | Descriptive name for the list | ||||||||
| Cardinality | 0..1 | ||||||||
| Type | string | ||||||||
| Requirements |
Allows customization beyond just the code identifying the kind of list. |
||||||||
| Summary | true | ||||||||
| List.code | |||||||||
|
|
List.code | ||||||||
| Definition |
This code defines the purpose of the list - why it was created. |
||||||||
| Short Display | What the purpose of this list is | ||||||||
| Cardinality | 0..1 | ||||||||
| Terminology Binding | Example Use Codes for List ( Example ) | ||||||||
| Type | CodeableConcept | ||||||||
| Requirements |
Lists often contain subsets of resources rather than an exhaustive list. The code identifies what type of subset is included. |
||||||||
| Summary | true | ||||||||
| Comments |
If there is no code, the purpose of the list is implied where it is used, such as in a document section using Document.section.code. |
||||||||
| List.subject | |||||||||
|
| List.subject | ||||||||
| Definition |
The
common
|
||||||||
| Short Display | If all resources have the same subject(s) | ||||||||
|
|
|
||||||||
| Type |
Reference
(
|
||||||||
| Requirements |
The primary purpose of listing the subject explicitly is to help with finding the right list. |
||||||||
| Summary | true | ||||||||
| Comments |
Some purely arbitrary lists do not have a common subject, so this is optional. Lists having multiple subjects may raise challenges for systems that base access control or other security considerations on linkages to 'subject'. E.g. if a List is associated with multiple Patient subjects, then it would be nominally part of multiple patient compartments, which might drive access rights. |
||||||||
| List.encounter | |||||||||
|
| List.encounter | ||||||||
| Definition |
The encounter that is the context in which this list was created. |
||||||||
| Short Display | Context in which list created | ||||||||
|
|
0..1 | ||||||||
| Type | Reference ( Encounter ) | ||||||||
| Summary | false | ||||||||
| List.date | |||||||||
|
| List.date | ||||||||
| Definition |
|
||||||||
| Short Display | When the list was prepared | ||||||||
| Cardinality | 0..1 | ||||||||
| Type | dateTime | ||||||||
| Requirements |
Identifies how current the list is which affects relevance. |
||||||||
| Summary | true | ||||||||
| Comments |
The actual important date is the date of currency of the resources that were summarized, but it is usually assumed that these are current when the preparation occurs. |
||||||||
| List.source | |||||||||
|
|
List.source | ||||||||
| Definition |
The entity responsible for deciding what the contents of the list were. Where the list was created by a human, this is the same as the author of the list. |
||||||||
| Short Display | Who and/or what defined the list contents (aka Author) | ||||||||
|
|
0..1 | ||||||||
| Type | Reference ( Practitioner | PractitionerRole | Patient | Device | Organization | RelatedPerson | CareTeam | Group ) | ||||||||
| Requirements |
Allows follow-up as well as context. |
||||||||
| Alternate Names | Author | ||||||||
| Summary | true | ||||||||
| Comments |
The primary source is the entity that made the decisions what items are in the list. This may be software or user. |
||||||||
| List.orderedBy | |||||||||
|
|
List.orderedBy | ||||||||
| Definition |
What order applies to the items in the list. |
||||||||
| Short Display | What order the list has | ||||||||
| Cardinality | 0..1 | ||||||||
| Terminology Binding | List Order Codes ( Preferred ) | ||||||||
| Type | CodeableConcept | ||||||||
| Requirements |
Important for presentation and rendering. Lists may be sorted to place more important information first or to group related entries. |
||||||||
|
| false | ||||||||
| Comments |
Applications SHOULD render ordered lists in the order provided, but MAY allow users to re-order based on their own preferences as well. If there is no order specified, the order is unknown, though there may still be some order. |
||||||||
| List.note | |||||||||
|
| List.note | ||||||||
| Definition |
Comments that apply to the overall list. |
||||||||
| Short Display | Comments about the list | ||||||||
|
|
0..* | ||||||||
| Type | Annotation | ||||||||
| Summary | false | ||||||||
| List.entry | |||||||||
|
| List.entry | ||||||||
| Definition |
Entries in this list. |
||||||||
| Short Display | Entries in the list | ||||||||
| Cardinality | 0..* | ||||||||
|
|
Order has no meaning unless specifically asserted by List.orderedBy, in which case the List SHALL be interpreted as being ordered as specified by List.orderedBy. | ||||||||
| Summary | false | ||||||||
| Comments |
If there are no entries in the list, an emptyReason SHOULD be provided. |
||||||||
|
|
|
||||||||
| List.entry.flag | |||||||||
|
| List.entry.flag | ||||||||
| Definition |
The flag allows the system constructing the list to indicate the role and significance of the item in the list. |
||||||||
| Short Display | Status/Workflow information about this item | ||||||||
|
|
0..1 | ||||||||
| Terminology Binding | Patient Medicine Change Types ( Example ) | ||||||||
| Type | CodeableConcept | ||||||||
| Requirements |
This field is present to support various clinical uses of lists, such as a discharge summary medication list, where flags specify whether the medication was added, modified, or deleted from the list. |
||||||||
|
|
false | ||||||||
| Comments |
The
flag
can
only
be
understood
in
the
context
of
the
List.code.
If
the
flag
means
that
the
entry
has
actually
been
deleted
from
the
list,
the
deleted
element
SHALL
be
|
||||||||
| List.entry.deleted | |||||||||
|
|
List.entry.deleted | ||||||||
| Definition |
True if this item is marked as deleted in the list. |
||||||||
| Short Display | If this item is actually marked as deleted | ||||||||
| Cardinality | 0..1 | ||||||||
| Type | boolean | ||||||||
| Is Modifier | true (Reason: If deleted is true, then the item included in the list isn't actually part of the list anymore) | ||||||||
|
|
|
||||||||
| Requirements |
The
flag
element
may
contain
codes
that
an
application
processing
the
list
does
not
understand.
However
there
can
be
no
ambiguity
if
a
list
item
is
actually
marked
as
|
||||||||
|
| false | ||||||||
| Comments |
If
the
flag
means
that
the
entry
has
actually
been
deleted
from
the
list,
the
deleted
element
SHALL
be
true.
|
||||||||
|
|
|||||||||
| Element Id | List.entry.date | ||||||||
| Definition |
When this item was added to the list. |
||||||||
| Short Display | When item added to list | ||||||||
|
|
0..1 | ||||||||
| Type | dateTime | ||||||||
| Requirements |
The date may be significant for understanding the meaning of items in a working list. |
||||||||
|
|
false | ||||||||
| List.entry.item | |||||||||
|
| List.entry.item | ||||||||
| Definition |
A reference to the actual resource from which data was derived. |
||||||||
| Short Display | Actual entry | ||||||||
| Cardinality | 1..1 | ||||||||
| Type | Reference ( Any ) | ||||||||
| Summary | false | ||||||||
| List.emptyReason | |||||||||
|
| List.emptyReason | ||||||||
| Definition |
If the list is empty, why the list is empty. |
||||||||
| Short Display | Why list is empty | ||||||||
| Cardinality | 0..1 | ||||||||
| Terminology Binding | List Empty Reasons ( Preferred ) | ||||||||
| Type | CodeableConcept | ||||||||
| Requirements |
Allows
capturing
things
like
|
||||||||
|
| false | ||||||||
| Comments |
The various reasons for an empty list make a significant interpretation to its interpretation. Note that this code is for use when the entire list has been suppressed, and not for when individual items are omitted - implementers may consider using a text note or a flag on an entry in these cases. |
||||||||
|
|
|
||||||||