This
page
is
part
of
the
FHIR
Specification
(v4.3.0:
R4B
-
STU
(v5.0.0-snapshot3:
R5
Snapshot
#3,
to
support
Connectathon
32
).
The
current
version
which
supercedes
this
version
is
5.0.0
.
For
a
full
list
of
available
versions,
see
the
Directory
of
published
versions
.
Page
versions:
R5
R4B
R4
R3
Clinical
Decision
Support
Work
Group
|
Maturity Level : 3 | Trial Use | Security Category : Business | Compartments : Not linked to any defined compartments |
This resource allows for the definition of various types of plans as a sharable, consumable, and executable artifact. The resource is general enough to support the description of a broad range of clinical and non-clinical artifacts such as clinical decision support rules, order sets, protocols, and drug quality specifications.
This resource is a definition resource from a FHIR workflow perspective - see Workflow , specifically Definition .
A plan definition is a pre-defined group of actions to be taken in particular circumstances, often including conditional elements, options, and other decision points. The resource is flexible enough to be used to represent a variety of workflows, as well as clinical decision support and quality improvement assets, including order sets, protocols, and decision support rules.
PlanDefinitions can contain hierarchical groups of action definitions, where each action definition describes an activity to be performed (often in terms of an ActivityDefinition resource), and each group defines additional behavior, relationships, and applicable conditions between the actions in the overall definition.
In
addition
to
describing
what
should
take
place,
each
action
in
a
plan
definition
can
specify
when
and
whether
the
action
should
take
place.
For
when
the
action
should
be
taken,
the
trigger
element
specifies
the
action
should
be
taken
in
response
to
some
trigger
occurring
(such
as
a
particular
point
in
a
workflow
being
reached,
or
as
the
result
of
a
prescription
being
ordered).
For
whether
the
action
should
be
taken,
the
condition
element
can
be
used
to
provide
an
expression
that
evaluates
to
true
or
false
to
indicate
the
applicability
of
the
action
to
the
specific
context.
The
process
of
applying
a
PlanDefinition
to
a
particular
context
typically
produces
request
resources
representing
the
actions
that
should
be
performed,
typically
grouped
within
a
CarePlan
and/or
RequestGroup
RequestOrchestration
to
capture
relationships
between
the
resulting
request
resources.
Each ActivityDefinition is used to construct a specific resource, based on the definition of the activity and combined with contextual information for the particular patient that the plan definition is being applied to.
As
with
the
ActivityDefinition,
a
PlanDefinition
may
provide
information
about
how
to
transform
the
activity
to
a
specific
intent
resource,
either
by
specifying
a
StructureMap
that
can
be
used
to
perform
the
transformation
completely,
or
by
specifying
values
for
specific
elements
of
the
resulting
resource
using
dynamicValue
elements
in
the
action.
Note that these mechanisms are provided on both the ActivityDefinition and the PlanDefinition to allow both reusable transformation descriptions, as well as customization of those descriptions within specific contexts. As such, the transform descriptions specified on the PlanDefinition override transform descriptions defined on the ActivityDefinition.
Dynamic values within the definitions can be provided by specifying the expression directly, or by referencing an expression defined within a library. For more information on how to reference expressions within resources, refer to the Using Expressions topic.
As an example, the Low Suicide Risk example order set from the Clinical Decision Support Knowledge Artifact Specification can be represented using the PlanDefinition and ActivityDefinition structures: Low Suicide Risk Example Order Set .
In
addition
to
the
representation
of
PlanDefinitions,
the
$apply
operation
allows
PlanDefinitions
to
be
applied
to
a
specific
context
such
as
a
patient,
practitioner,
or
institution.
For
Order
Sets
specifically,
this
operation
is
expected
to
place
the
orders
defined
by
the
order
set,
consistent
with
the
service
functional
requirements
defined
by
the
Order
Set
specification
.
The PlanDefinition resource is used to describe series, sequences, or groups of actions to be taken, while the ActivityDefinition resource is used to define each specific step or activity to be performed.
As the name implies, the PlanDefinition resource is strictly definitional. It does not represent the intention to take any action, nor does it represent that any actions have been taken. Rather, the resource provides a definition that can be applied in the appropriate circumstances. When the plan definition is applied, the result will in general be a set of actions that should be (or potentially even have been) performed.
Note that the PlanDefinition still has action-level information, as well as a reference to an ActivityDefinition . The action-level information defined in the PlanDefinition itself is used to describe how the actions are related to each other within the plan, where the ActivityDefinition contains only information about the activity itself. In addition, there is some overlapping information that allows the resources to be used independently, or in combination. See the Applying a PlanDefinition section for more information.
Structure
Name
|
Flags
|
Card.
|
Type
|
Description
&
Constraints
|
|---|---|---|---|---|
|
TU | DomainResource |
The
definition
of
a
plan
for
a
series
of
actions,
independent
of
any
specific
patient
or
context
+ Warning: Name should be usable as an identifier for the module by machine processing applications such as code generation Elements defined in Ancestors: id , meta , implicitRules , language , text , contained , extension , modifierExtension Interfaces Implemented: MetadataResource |
|
|
Σ C | 0..1 | uri |
Canonical
identifier
for
this
plan
definition,
represented
as
a
URI
(globally
unique)
+ Warning: URL should not contain | or # - these characters make processing canonical references problematic |
|
Σ | 0..* | Identifier |
Additional
identifier
for
the
plan
definition
|
|
Σ | 0..1 | string |
Business
version
of
the
plan
definition
|
|
Σ
|
0..1 | string |
Name
for
this
plan
definition
(computer
friendly)
|
|
Σ T | 0..1 | string |
Name
for
this
plan
definition
(human
friendly)
|
|
T | 0..1 | string |
Subordinate
title
of
the
plan
definition
|
|
Σ | 0..1 | CodeableConcept |
order-set
|
clinical-protocol
|
eca-rule
|
workflow-definition
PlanDefinitionType ( Extensible ) |
|
?! Σ | 1..1 | code |
draft
|
active
|
retired
|
unknown
PublicationStatus ( Required ) |
|
Σ | 0..1 | boolean |
For
testing
purposes,
not
real
usage
|
|
0..1 |
Type
of
individual
the
plan
definition
is
focused
on
|
||
|
CodeableConcept | |||
|
Reference ( Group | MedicinalProductDefinition | SubstanceDefinition | AdministrableProductDefinition | ManufacturedItemDefinition | PackagedProductDefinition ) | |||
|
canonical
(
|
|||
|
Σ | 0..1 | dateTime |
Date
last
changed
|
|
Σ T | 0..1 | string |
Name
of
the
|
|
Σ | 0..* | ContactDetail |
Contact
details
for
the
publisher
|
|
Σ T | 0..1 | markdown |
Natural
language
description
of
the
plan
definition
|
|
Σ | 0..* | UsageContext |
The
context
that
the
content
is
intended
to
support
|
|
Σ | 0..* | CodeableConcept |
Intended
jurisdiction
for
plan
definition
(if
applicable)
Jurisdiction ValueSet ( Extensible ) |
|
T | 0..1 | markdown |
Why
this
plan
definition
is
defined
|
|
T | 0..1 | string |
Describes
the
clinical
usage
of
the
plan
|
|
0..1 | markdown |
Use
and/or
publishing
restrictions
|
|
|
0..1 | date |
When
the
plan
definition
was
approved
by
publisher
|
|
|
0..1 | date |
When
the
plan
definition
was
last
reviewed
|
|
|
Σ | 0..1 | Period |
When
the
plan
definition
is
expected
to
be
used
|
|
0..* | CodeableConcept |
E.g.
Education,
Treatment,
Assessment
DefinitionTopic ( Example ) |
|
|
0..* | ContactDetail |
Who
authored
the
content
|
|
|
0..* | ContactDetail |
Who
edited
the
content
|
|
|
0..* | ContactDetail |
Who
reviewed
the
content
|
|
|
0..* | ContactDetail |
Who
endorsed
the
content
|
|
|
0..* | RelatedArtifact |
Additional
documentation,
citations
|
|
|
0..* | canonical ( Library ) |
Logic
used
by
the
plan
definition
|
|
|
0..* | BackboneElement |
What
the
plan
is
trying
to
accomplish
|
|
|
0..1 | CodeableConcept |
E.g.
Treatment,
dietary,
behavioral
GoalCategory ( Example ) |
|
|
1..1 | CodeableConcept |
Code
or
text
describing
the
goal
SNOMED CT Clinical Findings ( Example ) |
|
|
0..1 | CodeableConcept |
high-priority
|
medium-priority
|
low-priority
GoalPriority ( Preferred ) |
|
|
0..1 | CodeableConcept |
When
goal
pursuit
begins
GoalStartEvent ( Example ) |
|
|
0..* | CodeableConcept |
What
does
the
goal
address
Condition/Problem/Diagnosis Codes ( Example ) |
|
|
0..* | RelatedArtifact |
Supporting
documentation
for
the
goal
|
|
|
0..* | BackboneElement |
Target
outcome
for
the
goal
|
|
|
0..1 | CodeableConcept |
The
parameter
whose
value
is
to
be
tracked
LOINC Codes ( Example ) |
|
|
0..1 |
The
target
value
to
be
achieved
|
||
|
Quantity | |||
|
Range | |||
|
CodeableConcept | |||
| string | |||
![]() ![]() ![]() ![]() ![]() |
|
boolean | ||
| integer | |||
![]() ![]() ![]() ![]() ![]() | Ratio | |||
|
0..1 | Duration |
Reach
goal
within
|
|
| 0..* | BackboneElement |
Actors
within
the
plan
| |
| T | 0..1 | string |
User-visible
title
|
![]() ![]() ![]() | T | 0..1 | markdown |
Describes
the
actor
|
![]()
| 1..* | BackboneElement |
Who
or
what
can
be
this
actor
| |
![]() ![]() ![]() ![]() | 0..1 | code |
careteam
|
device
|
group
|
healthcareservice
|
location
|
organization
|
patient
|
practitioner
|
practitionerrole
|
relatedperson
ActionParticipantType ( Required ) | |
![]() ![]() ![]() ![]() | 0..1 | canonical ( CapabilityStatement ) |
Who
or
what
can
participate
| |
![]() ![]() ![]() ![]() | 0..1 | Reference ( CareTeam | Device | DeviceDefinition | Endpoint | Group | HealthcareService | Location | Organization | Patient | Practitioner | PractitionerRole | RelatedPerson ) |
Who
or
what
can
participate
| |
![]() ![]() ![]() ![]() | 0..1 | CodeableConcept |
E.g.
Nurse,
Surgeon,
Parent
ActionParticipantRole
(
Example
)
| |
![]()
|
0..* | BackboneElement |
Action
defined
by
the
plan
|
|
|
0..1 | string |
Unique
id
for
the
action
in
the
PlanDefinition
| |
![]() ![]() ![]() | 0..1 | string |
User-visible
prefix
for
the
action
(e.g.
1.
or
A.)
|
|
|
T | 0..1 | string |
User-visible
title
|
|
T | 0..1 | string |
Brief
description
of
the
action
|
|
T | 0..1 | string |
Static
text
equivalent
of
the
action,
used
if
the
dynamic
aspects
cannot
be
interpreted
by
the
receiving
system
|
|
0..1 | code |
routine
|
urgent
|
asap
|
stat
RequestPriority ( Required ) |
|
|
0..1 | CodeableConcept |
Code
representing
the
meaning
of
the
action
or
sub-actions
ActionCode ( Example ) |
|
|
0..* | CodeableConcept |
Why
the
action
should
be
performed
ActionReasonCode ( Example ) |
|
|
0..* | RelatedArtifact |
Supporting
documentation
for
the
intended
performer
of
the
action
|
|
|
0..* | id |
What
goals
this
action
supports
|
|
|
0..1 |
Type
of
individual
the
action
is
focused
on
|
||
|
CodeableConcept | |||
|
Reference ( Group ) | |||
|
canonical () | |||
|
0..* | TriggerDefinition |
When
the
action
should
be
triggered
|
|
|
0..* | BackboneElement |
Whether
or
not
the
action
is
applicable
|
|
|
1..1 | code |
applicability
|
start
|
stop
ActionConditionKind ( Required ) |
|
|
0..1 | Expression |
Boolean-valued
expression
|
|
|
C | 0..* | BackboneElement |
Input
data
requirements
+ Rule: Input data elements must have a requirement or a relatedData, but not both |
![]() ![]() ![]() ![]() |
T |
| string |
User-visible
title
|
![]() ![]() ![]() ![]() | 0..1 | DataRequirement |
What
data
is
provided
| |
![]() ![]() ![]() ![]() |
| id |
What
data
|
|
|
C | 0..* |
|
Output
data
definition
+ Rule: Output data element must have a requirement or a relatedData, but not both |
|
T |
|
|
|
|
0..1 | DataRequirement |
| |
![]() ![]() ![]() ![]() | 0..1 | string |
What
data
is
provided
| |
![]() ![]() ![]() |
0..* | BackboneElement |
Relationship
to
another
action
| |
![]() ![]() ![]() ![]() | 1..1 | id |
What
action
is
this
related
to
|
|
|
1..1 | code |
before-start
|
before
|
before-end
|
concurrent-with-start
|
concurrent
|
concurrent-with-end
|
after-start
|
after
|
after-end
ActionRelationshipType ( Required ) |
|
|
0..1 |
Time
offset
for
the
relationship
|
||
|
Duration | |||
|
Range | |||
|
0..1 |
When
the
action
should
take
place
|
||
|
Age | |||
|
Duration | |||
|
|
|||
|
Timing | |||
| 0..1 | CodeableReference ( Location ) |
Where
it
should
happen
| |
![]() ![]() ![]() | 0..* | BackboneElement |
Who
should
participate
in
the
action
|
|
|
0..1 |
|
What
actor
|
|
|
0..1 |
|
careteam
|
device
|
group
|
healthcareservice
|
location
|
organization
|
patient
|
practitioner
|
practitionerrole
|
relatedperson
ActionParticipantType ( Required ) |
|
|
0..1 |
|
Who
or
what
can
participate
|
|
|
|
|
Who
|
|
|
|
|
(
|
|
|
0..1 | CodeableConcept |
E.g.
|
|
|
0..1 | CodeableConcept |
create
|
update
|
remove
|
fire-event
ActionType ( Extensible ) |
|
|
0..1 | code |
visual-group
|
logical-group
|
sentence-group
ActionGroupingBehavior ( Required ) |
|
|
0..1 | code |
any
|
all
|
all-or-none
|
exactly-one
|
at-most-one
|
one-or-more
ActionSelectionBehavior ( Required ) |
|
|
0..1 | code |
must
|
could
|
must-unless-documented
ActionRequiredBehavior ( Required ) |
|
|
0..1 | code |
yes
|
no
ActionPrecheckBehavior ( Required ) |
|
|
0..1 | code |
single
|
multiple
ActionCardinalityBehavior ( Required ) |
|
|
0..1 |
Description
of
the
activity
to
be
performed
|
||
|
canonical ( ActivityDefinition | ObservationDefinition | PlanDefinition | Questionnaire | SpecimenDefinition ) | |||
|
uri | |||
|
0..1 | canonical ( StructureMap ) |
Transform
to
apply
the
template
|
|
|
0..* | BackboneElement |
Dynamic
aspects
of
the
definition
|
|
|
0..1 | string |
The
path
to
the
element
to
be
set
dynamically
|
|
|
0..1 | Expression |
An
expression
that
provides
the
dynamic
value
for
the
customization
|
|
|
0..* | see action |
A
sub-action
|
|
| Σ | 0..1 |
Preconditions
for
service
SNOMED CT Medication As Needed Reason Codes ( Example ) | |
![]() ![]() ![]() | boolean | |||
![]() ![]() ![]() | CodeableConcept | |||
Documentation
for
this
format
|
||||
See the Extensions for this resource
UML Diagram ( Legend )
XML Template
<PlanDefinition xmlns="http://hl7.org/fhir"><!-- from Resource: id, meta, implicitRules, and language --> <!-- from DomainResource: text, contained, extension, and modifierExtension -->
<<url value="[uri]"/><!-- 0..1 Canonical identifier for this plan definition, represented as a URI (globally unique) --> <identifier><!-- 0..* Identifier Additional identifier for the plan definition --></identifier> <version value="[string]"/><!-- 0..1 Business version of the plan definition --><<name value="[string]"/><!-- I 0..1 Name for this plan definition (computer friendly) --> <title value="[string]"/><!-- 0..1 Name for this plan definition (human friendly) --> <subtitle value="[string]"/><!-- 0..1 Subordinate title of the plan definition --> <type><!-- 0..1 CodeableConcept order-set | clinical-protocol | eca-rule | workflow-definition --></type> <status value="[code]"/><!-- 1..1 draft | active | retired | unknown --> <experimental value="[boolean]"/><!-- 0..1 For testing purposes, not real usage --><( | </subject[x]> < <<subject[x]><!-- 0..1 CodeableConcept|Reference(AdministrableProductDefinition| Group|ManufacturedItemDefinition|MedicinalProductDefinition| PackagedProductDefinition|SubstanceDefinition)|canonical(EvidenceVariable) Type of individual the plan definition is focused on --></subject[x]> <date value="[dateTime]"/><!-- 0..1 Date last changed --> <publisher value="[string]"/><!-- 0..1 Name of the publisher/steward (organization or individual) --> <contact><!-- 0..* ContactDetail Contact details for the publisher --></contact> <description value="[markdown]"/><!-- 0..1 Natural language description of the plan definition --> <useContext><!-- 0..* UsageContext The context that the content is intended to support --></useContext> <jurisdiction><!-- 0..* CodeableConcept Intended jurisdiction for plan definition (if applicable) --></jurisdiction> <purpose value="[markdown]"/><!-- 0..1 Why this plan definition is defined --> <usage value="[string]"/><!-- 0..1 Describes the clinical usage of the plan --> <copyright value="[markdown]"/><!-- 0..1 Use and/or publishing restrictions --> <approvalDate value="[date]"/><!-- 0..1 When the plan definition was approved by publisher --> <lastReviewDate value="[date]"/><!-- 0..1 When the plan definition was last reviewed --> <effectivePeriod><!-- 0..1 Period When the plan definition is expected to be used --></effectivePeriod> <topic><!-- 0..* CodeableConcept E.g. Education, Treatment, Assessment --></topic> <author><!-- 0..* ContactDetail Who authored the content --></author> <editor><!-- 0..* ContactDetail Who edited the content --></editor> <reviewer><!-- 0..* ContactDetail Who reviewed the content --></reviewer> <endorser><!-- 0..* ContactDetail Who endorsed the content --></endorser> <relatedArtifact><!-- 0..* RelatedArtifact Additional documentation, citations --></relatedArtifact> <library><!-- 0..* canonical(Library) Logic used by the plan definition --></library> <goal> <!-- 0..* What the plan is trying to accomplish --> <category><!-- 0..1 CodeableConcept E.g. Treatment, dietary, behavioral --></category> <description><!-- 1..1 CodeableConcept Code or text describing the goal --></description> <priority><!-- 0..1 CodeableConcept high-priority | medium-priority | low-priority --></priority> <start><!-- 0..1 CodeableConcept When goal pursuit begins --></start> <addresses><!-- 0..* CodeableConcept What does the goal address --></addresses> <documentation><!-- 0..* RelatedArtifact Supporting documentation for the goal --></documentation> <target> <!-- 0..* Target outcome for the goal --> <measure><!-- 0..1 CodeableConcept The parameter whose value is to be tracked --></measure><</detail[x]><detail[x]><!-- 0..1 Quantity|Range|CodeableConcept|string|boolean|integer| Ratio The target value to be achieved --></detail[x]> <due><!-- 0..1 Duration Reach goal within --></due> </target> </goal> <actor> <!-- 0..* Actors within the plan --> <title value="[string]"/><!-- 0..1 User-visible title --> <description value="[markdown]"/><!-- 0..1 Describes the actor --> <option> <!-- 1..* Who or what can be this actor --> <type value="[code]"/><!-- 0..1 careteam | device | group | healthcareservice | location | organization | patient | practitioner | practitionerrole | relatedperson --> <typeCanonical><!-- 0..1 canonical(CapabilityStatement) Who or what can participate --></typeCanonical> <typeReference><!-- 0..1 Reference(CareTeam|Device|DeviceDefinition|Endpoint| Group|HealthcareService|Location|Organization|Patient|Practitioner| PractitionerRole|RelatedPerson) Who or what can participate --></typeReference> <role><!-- 0..1 CodeableConcept E.g. Nurse, Surgeon, Parent--></role> </option> </actor> <action> <!-- 0..* Action defined by the plan -->
<<linkId value="[string]"/><!-- 0..1 Unique id for the action in the PlanDefinition --> <prefix value="[string]"/><!-- 0..1 User-visible prefix for the action (e.g. 1. or A.) --> <title value="[string]"/><!-- 0..1 User-visible title --> <description value="[string]"/><!-- 0..1 Brief description of the action --> <textEquivalent value="[string]"/><!-- 0..1 Static text equivalent of the action, used if the dynamic aspects cannot be interpreted by the receiving system --> <priority value="[code]"/><!-- 0..1 routine | urgent | asap | stat --><</code><code><!-- 0..1 CodeableConcept Code representing the meaning of the action or sub-actions --></code> <reason><!-- 0..* CodeableConcept Why the action should be performed --></reason> <documentation><!-- 0..* RelatedArtifact Supporting documentation for the intended performer of the action --></documentation> <goalId value="[id]"/><!-- 0..* What goals this action supports --><</subject[x]> <</trigger><subject[x]><!-- 0..1 CodeableConcept|Reference(Group)|canonical Type of individual the action is focused on --></subject[x]> <trigger><!-- 0..* TriggerDefinition When the action should be triggered --></trigger> <condition> <!-- 0..* Whether or not the action is applicable --> <kind value="[code]"/><!-- 1..1 applicability | start | stop --> <expression><!-- 0..1 Expression Boolean-valued expression --></expression> </condition><</input> <</output><input> <!-- 0..* Input data requirements --> <title value="[string]"/><!-- 0..1 User-visible title --> <requirement><!-- 0..1 DataRequirement What data is provided --></requirement> <relatedData value="[id]"/><!-- 0..1 What data is provided --> </input> <output> <!-- 0..* Output data definition --> <title value="[string]"/><!-- 0..1 User-visible title --> <requirement><!-- 0..1 DataRequirement What data is provided --></requirement> <relatedData value="[string]"/><!-- 0..1 What data is provided --> </output> <relatedAction> <!-- 0..* Relationship to another action --><<targetId value="[id]"/><!-- 1..1 What action is this related to --> <relationship value="[code]"/><!-- 1..1 before-start | before | before-end | concurrent-with-start | concurrent | concurrent-with-end | after-start | after | after-end --> <offset[x]><!-- 0..1 Duration|Range Time offset for the relationship --></offset[x]> </relatedAction><</timing[x]><timing[x]><!-- 0..1 Age|Duration|Range|Timing When the action should take place --></timing[x]> <location><!-- 0..1 CodeableReference(Location) Where it should happen --></location> <participant> <!-- 0..* Who should participate in the action -->< <</role><actorId value="[string]"/><!-- 0..1 What actor --> <type value="[code]"/><!-- 0..1 careteam | device | group | healthcareservice | location | organization | patient | practitioner | practitionerrole | relatedperson --> <typeCanonical><!-- 0..1 canonical(CapabilityStatement) Who or what can participate --></typeCanonical> <typeReference><!-- 0..1 Reference(CareTeam|Device|DeviceDefinition|Endpoint| Group|HealthcareService|Location|Organization|Patient|Practitioner| PractitionerRole|RelatedPerson) Who or what can participate --></typeReference> <role><!-- 0..1 CodeableConcept E.g. Nurse, Surgeon, Parent--></role> <function><!-- 0..1 CodeableConcept E.g. Author, Reviewer, Witness, etc. --></function> </participant> <type><!-- 0..1 CodeableConcept create | update | remove | fire-event --></type> <groupingBehavior value="[code]"/><!-- 0..1 visual-group | logical-group | sentence-group --> <selectionBehavior value="[code]"/><!-- 0..1 any | all | all-or-none | exactly-one | at-most-one | one-or-more --> <requiredBehavior value="[code]"/><!-- 0..1 must | could | must-unless-documented --> <precheckBehavior value="[code]"/><!-- 0..1 yes | no --> <cardinalityBehavior value="[code]"/><!-- 0..1 single | multiple -->
<| </definition[x]><definition[x]><!-- 0..1 canonical(ActivityDefinition|ObservationDefinition| PlanDefinition|Questionnaire|SpecimenDefinition)|uri Description of the activity to be performed --></definition[x]> <transform><!-- 0..1 canonical(StructureMap) Transform to apply the template --></transform> <dynamicValue> <!-- 0..* Dynamic aspects of the definition --> <path value="[string]"/><!-- 0..1 The path to the element to be set dynamically --> <expression><!-- 0..1 Expression An expression that provides the dynamic value for the customization --></expression> </dynamicValue> <action><!-- 0..* Content as for PlanDefinition.action A sub-action --></action> </action> <asNeeded[x]><!-- 0..1 boolean|CodeableConcept Preconditions for service --></asNeeded[x]> </PlanDefinition>
JSON Template
{
"resourceType" : "PlanDefinition",
// from Resource: id, meta, implicitRules, and language
// from DomainResource: text, contained, extension, and modifierExtension
"
"url" : "<uri>", // Canonical identifier for this plan definition, represented as a URI (globally unique)
"identifier" : [{ Identifier }], // Additional identifier for the plan definition
"version" : "<string>", // Business version of the plan definition
"
"name" : "<string>", // I Name for this plan definition (computer friendly)
"title" : "<string>", // Name for this plan definition (human friendly)
"subtitle" : "<string>", // Subordinate title of the plan definition
"type" : { CodeableConcept }, // order-set | clinical-protocol | eca-rule | workflow-definition
"status" : "<code>", // R! draft | active | retired | unknown
"experimental" : <boolean>, // For testing purposes, not real usage
// subject[x]: Type of individual the plan definition is focused on. One of these 3:
"subjectCodeableConcept" : { CodeableConcept },
" },
"|
"subjectReference" : { Reference(AdministrableProductDefinition|Group|
ManufacturedItemDefinition|MedicinalProductDefinition|
PackagedProductDefinition|SubstanceDefinition) },
"
"
"subjectCanonical" : "<canonical(EvidenceVariable)>",
"date" : "<dateTime>", // Date last changed
"publisher" : "<string>", // Name of the publisher/steward (organization or individual)
"contact" : [{ ContactDetail }], // Contact details for the publisher
"description" : "<markdown>", // Natural language description of the plan definition
"useContext" : [{ UsageContext }], // The context that the content is intended to support
"jurisdiction" : [{ CodeableConcept }], // Intended jurisdiction for plan definition (if applicable)
"purpose" : "<markdown>", // Why this plan definition is defined
"usage" : "<string>", // Describes the clinical usage of the plan
"copyright" : "<markdown>", // Use and/or publishing restrictions
"approvalDate" : "<date>", // When the plan definition was approved by publisher
"lastReviewDate" : "<date>", // When the plan definition was last reviewed
"effectivePeriod" : { Period }, // When the plan definition is expected to be used
"topic" : [{ CodeableConcept }], // E.g. Education, Treatment, Assessment
"author" : [{ ContactDetail }], // Who authored the content
"editor" : [{ ContactDetail }], // Who edited the content
"reviewer" : [{ ContactDetail }], // Who reviewed the content
"endorser" : [{ ContactDetail }], // Who endorsed the content
"relatedArtifact" : [{ RelatedArtifact }], // Additional documentation, citations
"
"library" : ["<canonical(Library)>"], // Logic used by the plan definition
"goal" : [{ // What the plan is trying to accomplish
"category" : { CodeableConcept }, // E.g. Treatment, dietary, behavioral
"description" : { CodeableConcept }, // R! Code or text describing the goal
"priority" : { CodeableConcept }, // high-priority | medium-priority | low-priority
"start" : { CodeableConcept }, // When goal pursuit begins
"addresses" : [{ CodeableConcept }], // What does the goal address
"documentation" : [{ RelatedArtifact }], // Supporting documentation for the goal
"target" : [{ // Target outcome for the goal
"measure" : { CodeableConcept }, // The parameter whose value is to be tracked
// detail[x]: The target value to be achieved. One of these 7:
"detailQuantity" : { Quantity },
"detailRange" : { Range },
"detailCodeableConcept" : { CodeableConcept },
"detailString" : "<string>",
"detailBoolean" : <boolean>,
"detailInteger" : <integer>,
"detailRatio" : { Ratio },
"due" : { Duration } // Reach goal within
}]
}],
"actor" : [{ // Actors within the plan
"title" : "<string>", // User-visible title
"description" : "<markdown>", // Describes the actor
"option" : [{ // R! Who or what can be this actor
"type" : "<code>", // careteam | device | group | healthcareservice | location | organization | patient | practitioner | practitionerrole | relatedperson
"typeCanonical" : "<canonical(CapabilityStatement)>", // Who or what can participate
"typeReference" : { Reference(CareTeam|Device|DeviceDefinition|Endpoint|
Group|HealthcareService|Location|Organization|Patient|Practitioner|
PractitionerRole|RelatedPerson) }, // Who or what can participate
"role" : { CodeableConcept } // E.g. Nurse, Surgeon, Parent
}]
}],
"action" : [{ // Action defined by the plan
"
"linkId" : "<string>", // Unique id for the action in the PlanDefinition
"prefix" : "<string>", // User-visible prefix for the action (e.g. 1. or A.)
"title" : "<string>", // User-visible title
"description" : "<string>", // Brief description of the action
"textEquivalent" : "<string>", // Static text equivalent of the action, used if the dynamic aspects cannot be interpreted by the receiving system
"priority" : "<code>", // routine | urgent | asap | stat
"
"code" : { CodeableConcept }, // Code representing the meaning of the action or sub-actions
"reason" : [{ CodeableConcept }], // Why the action should be performed
"documentation" : [{ RelatedArtifact }], // Supporting documentation for the intended performer of the action
"goalId" : ["<id>"], // What goals this action supports
// subject[x]: Type of individual the action is focused on. One of these 3:
"subjectCodeableConcept" : { CodeableConcept },
"subjectReference" : { Reference(Group) },
"subjectCanonical" : "<canonical>",
"
"trigger" : [{ TriggerDefinition }], // When the action should be triggered
"condition" : [{ // Whether or not the action is applicable
"kind" : "<code>", // R! applicability | start | stop
"expression" : { Expression } // Boolean-valued expression
}],
"
"
"input" : [{ // Input data requirements
"title" : "<string>", // User-visible title
"requirement" : { DataRequirement }, // What data is provided
"relatedData" : "<id>" // What data is provided
}],
"output" : [{ // Output data definition
"title" : "<string>", // User-visible title
"requirement" : { DataRequirement }, // What data is provided
"relatedData" : "<string>" // What data is provided
}],
"relatedAction" : [{ // Relationship to another action
"
"targetId" : "<id>", // R! What action is this related to
"relationship" : "<code>", // R! before-start | before | before-end | concurrent-with-start | concurrent | concurrent-with-end | after-start | after | after-end
// offset[x]: Time offset for the relationship. One of these 2:
" }
"offsetDuration" : { Duration },
"offsetRange" : { Range }
}],
">",
// timing[x]: When the action should take place. One of these 4:
"timingAge" : { Age },
" },
"timingDuration" : { Duration },
"timingRange" : { Range },
"timingTiming" : { Timing },
"location" : { CodeableReference(Location) }, // Where it should happen
"participant" : [{ // Who should participate in the action
"
"
"actorId" : "<string>", // What actor
"type" : "<code>", // careteam | device | group | healthcareservice | location | organization | patient | practitioner | practitionerrole | relatedperson
"typeCanonical" : "<canonical(CapabilityStatement)>", // Who or what can participate
"typeReference" : { Reference(CareTeam|Device|DeviceDefinition|Endpoint|
Group|HealthcareService|Location|Organization|Patient|Practitioner|
PractitionerRole|RelatedPerson) }, // Who or what can participate
"role" : { CodeableConcept }, // E.g. Nurse, Surgeon, Parent
"function" : { CodeableConcept } // E.g. Author, Reviewer, Witness, etc.
}],
"type" : { CodeableConcept }, // create | update | remove | fire-event
"groupingBehavior" : "<code>", // visual-group | logical-group | sentence-group
"selectionBehavior" : "<code>", // any | all | all-or-none | exactly-one | at-most-one | one-or-more
"requiredBehavior" : "<code>", // must | could | must-unless-documented
"precheckBehavior" : "<code>", // yes | no
"cardinalityBehavior" : "<code>", // single | multiple
// definition[x]: Description of the activity to be performed. One of these 2:
"|
},
">",
"
"definitionCanonical" : "<canonical(ActivityDefinition|ObservationDefinition|PlanDefinition|Questionnaire|SpecimenDefinition)>",
"definitionUri" : "<uri>",
"transform" : "<canonical(StructureMap)>", // Transform to apply the template
"dynamicValue" : [{ // Dynamic aspects of the definition
"path" : "<string>", // The path to the element to be set dynamically
"expression" : { Expression } // An expression that provides the dynamic value for the customization
}],
"action" : [{ Content as for PlanDefinition.action }] // A sub-action
}]
}],
// asNeeded[x]: Preconditions for service. One of these 2:
"asNeededBoolean" : <boolean>,
"asNeededCodeableConcept" : { CodeableConcept }
}
Turtle Template
@prefix fhir: <http://hl7.org/fhir/> .[ a fhir:PlanDefinition; fhir:nodeRole fhir:treeRoot; # if this is the parser root # from Resource: .id, .meta, .implicitRules, and .language # from DomainResource: .text, .contained, .extension, and .modifierExtension
fhir:fhir:PlanDefinition.url [ uri ]; # 0..1 Canonical identifier for this plan definition, represented as a URI (globally unique) fhir:PlanDefinition.identifier [ Identifier ], ... ; # 0..* Additional identifier for the plan definition fhir:PlanDefinition.version [ string ]; # 0..1 Business version of the plan definitionfhir:fhir:PlanDefinition.name [ string ]; # 0..1 I Name for this plan definition (computer friendly) fhir:PlanDefinition.title [ string ]; # 0..1 Name for this plan definition (human friendly) fhir:PlanDefinition.subtitle [ string ]; # 0..1 Subordinate title of the plan definition fhir:PlanDefinition.type [ CodeableConcept ]; # 0..1 order-set | clinical-protocol | eca-rule | workflow-definition fhir:PlanDefinition.status [ code ]; # 1..1 draft | active | retired | unknown fhir:PlanDefinition.experimental [ boolean ]; # 0..1 For testing purposes, not real usage # PlanDefinition.subject[x] : 0..1 Type of individual the plan definition is focused on. One of these 3 fhir:PlanDefinition.subjectCodeableConcept [ CodeableConcept ]fhir:) ] fhir:|fhir:PlanDefinition.subjectReference [ Reference(AdministrableProductDefinition|Group|ManufacturedItemDefinition| MedicinalProductDefinition|PackagedProductDefinition|SubstanceDefinition) ]fhir: fhir:fhir:PlanDefinition.subjectCanonical [ canonical(EvidenceVariable) ] fhir:PlanDefinition.date [ dateTime ]; # 0..1 Date last changed fhir:PlanDefinition.publisher [ string ]; # 0..1 Name of the publisher/steward (organization or individual) fhir:PlanDefinition.contact [ ContactDetail ], ... ; # 0..* Contact details for the publisher fhir:PlanDefinition.description [ markdown ]; # 0..1 Natural language description of the plan definition fhir:PlanDefinition.useContext [ UsageContext ], ... ; # 0..* The context that the content is intended to support fhir:PlanDefinition.jurisdiction [ CodeableConcept ], ... ; # 0..* Intended jurisdiction for plan definition (if applicable) fhir:PlanDefinition.purpose [ markdown ]; # 0..1 Why this plan definition is defined fhir:PlanDefinition.usage [ string ]; # 0..1 Describes the clinical usage of the plan fhir:PlanDefinition.copyright [ markdown ]; # 0..1 Use and/or publishing restrictions fhir:PlanDefinition.approvalDate [ date ]; # 0..1 When the plan definition was approved by publisher fhir:PlanDefinition.lastReviewDate [ date ]; # 0..1 When the plan definition was last reviewed fhir:PlanDefinition.effectivePeriod [ Period ]; # 0..1 When the plan definition is expected to be used fhir:PlanDefinition.topic [ CodeableConcept ], ... ; # 0..* E.g. Education, Treatment, Assessment fhir:PlanDefinition.author [ ContactDetail ], ... ; # 0..* Who authored the content fhir:PlanDefinition.editor [ ContactDetail ], ... ; # 0..* Who edited the content fhir:PlanDefinition.reviewer [ ContactDetail ], ... ; # 0..* Who reviewed the content fhir:PlanDefinition.endorser [ ContactDetail ], ... ; # 0..* Who endorsed the content fhir:PlanDefinition.relatedArtifact [ RelatedArtifact ], ... ; # 0..* Additional documentation, citations fhir:PlanDefinition.library [ canonical(Library) ], ... ; # 0..* Logic used by the plan definition fhir:PlanDefinition.goal [ # 0..* What the plan is trying to accomplish fhir:PlanDefinition.goal.category [ CodeableConcept ]; # 0..1 E.g. Treatment, dietary, behavioral fhir:PlanDefinition.goal.description [ CodeableConcept ]; # 1..1 Code or text describing the goal fhir:PlanDefinition.goal.priority [ CodeableConcept ]; # 0..1 high-priority | medium-priority | low-priority fhir:PlanDefinition.goal.start [ CodeableConcept ]; # 0..1 When goal pursuit begins fhir:PlanDefinition.goal.addresses [ CodeableConcept ], ... ; # 0..* What does the goal address fhir:PlanDefinition.goal.documentation [ RelatedArtifact ], ... ; # 0..* Supporting documentation for the goal fhir:PlanDefinition.goal.target [ # 0..* Target outcome for the goal fhir:PlanDefinition.goal.target.measure [ CodeableConcept ]; # 0..1 The parameter whose value is to be tracked# . One of these 3# PlanDefinition.goal.target.detail[x] : 0..1 The target value to be achieved. One of these 7 fhir:PlanDefinition.goal.target.detailQuantity [ Quantity ] fhir:PlanDefinition.goal.target.detailRange [ Range ] fhir:PlanDefinition.goal.target.detailCodeableConcept [ CodeableConcept ] fhir:PlanDefinition.goal.target.detailString [ string ] fhir:PlanDefinition.goal.target.detailBoolean [ boolean ] fhir:PlanDefinition.goal.target.detailInteger [ integer ] fhir:PlanDefinition.goal.target.detailRatio [ Ratio ] fhir:PlanDefinition.goal.target.due [ Duration ]; # 0..1 Reach goal within ], ...; ], ...; fhir:PlanDefinition.actor [ # 0..* Actors within the plan fhir:PlanDefinition.actor.title [ string ]; # 0..1 User-visible title fhir:PlanDefinition.actor.description [ markdown ]; # 0..1 Describes the actor fhir:PlanDefinition.actor.option [ # 1..* Who or what can be this actor fhir:PlanDefinition.actor.option.type [ code ]; # 0..1 careteam | device | group | healthcareservice | location | organization | patient | practitioner | practitionerrole | relatedperson fhir:PlanDefinition.actor.option.typeCanonical [ canonical(CapabilityStatement) ]; # 0..1 Who or what can participate fhir:PlanDefinition.actor.option.typeReference [ Reference(CareTeam|Device|DeviceDefinition|Endpoint|Group|HealthcareService|Location| Organization|Patient|Practitioner|PractitionerRole|RelatedPerson) ]; # 0..1 Who or what can participate fhir:PlanDefinition.actor.option.role [ CodeableConcept ]; # 0..1 E.g. Nurse, Surgeon, Parent ], ...; ], ...; fhir:PlanDefinition.action [ # 0..* Action defined by the planfhir:fhir:PlanDefinition.action.linkId [ string ]; # 0..1 Unique id for the action in the PlanDefinition fhir:PlanDefinition.action.prefix [ string ]; # 0..1 User-visible prefix for the action (e.g. 1. or A.) fhir:PlanDefinition.action.title [ string ]; # 0..1 User-visible title fhir:PlanDefinition.action.description [ string ]; # 0..1 Brief description of the action fhir:PlanDefinition.action.textEquivalent [ string ]; # 0..1 Static text equivalent of the action, used if the dynamic aspects cannot be interpreted by the receiving system fhir:PlanDefinition.action.priority [ code ]; # 0..1 routine | urgent | asap | statfhir:fhir:PlanDefinition.action.code [ CodeableConcept ]; # 0..1 Code representing the meaning of the action or sub-actions fhir:PlanDefinition.action.reason [ CodeableConcept ], ... ; # 0..* Why the action should be performed fhir:PlanDefinition.action.documentation [ RelatedArtifact ], ... ; # 0..* Supporting documentation for the intended performer of the action fhir:PlanDefinition.action.goalId [ id ], ... ; # 0..* What goals this action supports # PlanDefinition.action.subject[x] : 0..1 Type of individual the action is focused on. One of these 3 fhir:PlanDefinition.action.subjectCodeableConcept [ CodeableConcept ] fhir:PlanDefinition.action.subjectReference [ Reference(Group) ] fhir:PlanDefinition.action.subjectCanonical [ canonical ]fhir:fhir:PlanDefinition.action.trigger [ TriggerDefinition ], ... ; # 0..* When the action should be triggered fhir:PlanDefinition.action.condition [ # 0..* Whether or not the action is applicable fhir:PlanDefinition.action.condition.kind [ code ]; # 1..1 applicability | start | stop fhir:PlanDefinition.action.condition.expression [ Expression ]; # 0..1 Boolean-valued expression ], ...;fhir: fhir:fhir:PlanDefinition.action.input [ # 0..* Input data requirements fhir:PlanDefinition.action.input.title [ string ]; # 0..1 User-visible title fhir:PlanDefinition.action.input.requirement [ DataRequirement ]; # 0..1 What data is provided fhir:PlanDefinition.action.input.relatedData [ id ]; # 0..1 What data is provided ], ...; fhir:PlanDefinition.action.output [ # 0..* Output data definition fhir:PlanDefinition.action.output.title [ string ]; # 0..1 User-visible title fhir:PlanDefinition.action.output.requirement [ DataRequirement ]; # 0..1 What data is provided fhir:PlanDefinition.action.output.relatedData [ string ]; # 0..1 What data is provided ], ...; fhir:PlanDefinition.action.relatedAction [ # 0..* Relationship to another actionfhir:fhir:PlanDefinition.action.relatedAction.targetId [ id ]; # 1..1 What action is this related to fhir:PlanDefinition.action.relatedAction.relationship [ code ]; # 1..1 before-start | before | before-end | concurrent-with-start | concurrent | concurrent-with-end | after-start | after | after-end # PlanDefinition.action.relatedAction.offset[x] : 0..1 Time offset for the relationship. One of these 2 fhir:PlanDefinition.action.relatedAction.offsetDuration [ Duration ] fhir:PlanDefinition.action.relatedAction.offsetRange [ Range ] ], ...;# . One of these 6 fhir: ]# PlanDefinition.action.timing[x] : 0..1 When the action should take place. One of these 4 fhir:PlanDefinition.action.timingAge [ Age ]fhir: ]fhir:PlanDefinition.action.timingDuration [ Duration ] fhir:PlanDefinition.action.timingRange [ Range ] fhir:PlanDefinition.action.timingTiming [ Timing ] fhir:PlanDefinition.action.location [ CodeableReference(Location) ]; # 0..1 Where it should happen fhir:PlanDefinition.action.participant [ # 0..* Who should participate in the actionfhir:fhir:PlanDefinition.action.participant.actorId [ string ]; # 0..1 What actor fhir:PlanDefinition.action.participant.type [ code ]; # 0..1 careteam | device | group | healthcareservice | location | organization | patient | practitioner | practitionerrole | relatedperson fhir:PlanDefinition.action.participant.typeCanonical [ canonical(CapabilityStatement) ]; # 0..1 Who or what can participate fhir:PlanDefinition.action.participant.typeReference [ Reference(CareTeam|Device|DeviceDefinition|Endpoint|Group|HealthcareService|Location| Organization|Patient|Practitioner|PractitionerRole|RelatedPerson) ]; # 0..1 Who or what can participate fhir:PlanDefinition.action.participant.role [ CodeableConcept ]; # 0..1 E.g. Nurse, Surgeon, Parent fhir:PlanDefinition.action.participant.function [ CodeableConcept ]; # 0..1 E.g. Author, Reviewer, Witness, etc. ], ...; fhir:PlanDefinition.action.type [ CodeableConcept ]; # 0..1 create | update | remove | fire-event fhir:PlanDefinition.action.groupingBehavior [ code ]; # 0..1 visual-group | logical-group | sentence-group fhir:PlanDefinition.action.selectionBehavior [ code ]; # 0..1 any | all | all-or-none | exactly-one | at-most-one | one-or-more fhir:PlanDefinition.action.requiredBehavior [ code ]; # 0..1 must | could | must-unless-documented fhir:PlanDefinition.action.precheckBehavior [ code ]; # 0..1 yes | no fhir:PlanDefinition.action.cardinalityBehavior [ code ]; # 0..1 single | multiple# . One of these 2 fhir:) ] fhir: ]# PlanDefinition.action.definition[x] : 0..1 Description of the activity to be performed. One of these 2 fhir:PlanDefinition.action.definitionCanonical [ canonical(ActivityDefinition|ObservationDefinition|PlanDefinition|Questionnaire| SpecimenDefinition) ] fhir:PlanDefinition.action.definitionUri [ uri ] fhir:PlanDefinition.action.transform [ canonical(StructureMap) ]; # 0..1 Transform to apply the template fhir:PlanDefinition.action.dynamicValue [ # 0..* Dynamic aspects of the definition fhir:PlanDefinition.action.dynamicValue.path [ string ]; # 0..1 The path to the element to be set dynamically fhir:PlanDefinition.action.dynamicValue.expression [ Expression ]; # 0..1 An expression that provides the dynamic value for the customization ], ...; fhir:PlanDefinition.action.action [ See PlanDefinition.action ], ... ; # 0..* A sub-action ], ...; # PlanDefinition.asNeeded[x] : 0..1 Preconditions for service. One of these 2 fhir:PlanDefinition.asNeededBoolean [ boolean ] fhir:PlanDefinition.asNeededCodeableConcept [ CodeableConcept ] ]
Changes since R4
| PlanDefinition | |
| PlanDefinition.subject[x] |
|
| PlanDefinition.goal.target.detail[x] |
|
| PlanDefinition.actor |
|
| PlanDefinition.actor.title |
|
| PlanDefinition.actor.description |
|
| PlanDefinition.actor.option |
|
| PlanDefinition.actor.option.type |
|
| PlanDefinition.actor.option.typeCanonical |
|
| PlanDefinition.actor.option.typeReference |
|
| PlanDefinition.actor.option.role |
|
| PlanDefinition.action.linkId |
|
| PlanDefinition.action.code |
|
| PlanDefinition.action.subject[x] |
|
| PlanDefinition.action.input |
|
| PlanDefinition.action.input.title |
|
| PlanDefinition.action.input.requirement |
|
| PlanDefinition.action.input.relatedData |
|
| PlanDefinition.action.output |
|
| PlanDefinition.action.output.title |
|
| PlanDefinition.action.output.requirement |
|
| PlanDefinition.action.output.relatedData |
|
| PlanDefinition.action.relatedAction.targetId |
|
| PlanDefinition.action.timing[x] |
|
| PlanDefinition.action.location |
|
| PlanDefinition.action.participant.actorId |
|
| PlanDefinition.action.participant.type |
|
| PlanDefinition.action.participant.typeCanonical |
|
| PlanDefinition.action.participant.typeReference |
|
| PlanDefinition.action.participant.function |
|
| PlanDefinition.asNeeded[x] |
|
| PlanDefinition.action.relatedAction.actionId |
|
See the Full Difference for further information
This analysis is available as XML or JSON .
Conversions
between
R3
and
R4
See
R3
<-->
R4
Conversion
Maps
(status
=
11
tests
of
which
6
fail
to
execute
.
All
tests
pass
round-trip
testing
and
5
r3
resources
are
invalid
(0
errors).
)
Structure
Name
|
Flags
|
Card.
|
Type
|
Description
&
Constraints
|
|---|---|---|---|---|
|
TU | DomainResource |
The
definition
of
a
plan
for
a
series
of
actions,
independent
of
any
specific
patient
or
context
+ Warning: Name should be usable as an identifier for the module by machine processing applications such as code generation Elements defined in Ancestors: id , meta , implicitRules , language , text , contained , extension , modifierExtension Interfaces Implemented: MetadataResource |
|
|
Σ C | 0..1 | uri |
Canonical
identifier
for
this
plan
definition,
represented
as
a
URI
(globally
unique)
+ Warning: URL should not contain | or # - these characters make processing canonical references problematic |
|
Σ | 0..* | Identifier |
Additional
identifier
for
the
plan
definition
|
|
Σ | 0..1 | string |
Business
version
of
the
plan
definition
|
|
Σ
|
0..1 | string |
Name
for
this
plan
definition
(computer
friendly)
|
|
Σ T | 0..1 | string |
Name
for
this
plan
definition
(human
friendly)
|
|
T | 0..1 | string |
Subordinate
title
of
the
plan
definition
|
|
Σ | 0..1 | CodeableConcept |
order-set
|
clinical-protocol
|
eca-rule
|
workflow-definition
PlanDefinitionType ( Extensible ) |
|
?! Σ | 1..1 | code |
draft
|
active
|
retired
|
unknown
PublicationStatus ( Required ) |
|
Σ | 0..1 | boolean |
For
testing
purposes,
not
real
usage
|
|
0..1 |
Type
of
individual
the
plan
definition
is
focused
on
|
||
|
CodeableConcept | |||
|
Reference ( Group | MedicinalProductDefinition | SubstanceDefinition | AdministrableProductDefinition | ManufacturedItemDefinition | PackagedProductDefinition ) | |||
|
canonical
(
|
|||
|
Σ | 0..1 | dateTime |
Date
last
changed
|
|
Σ T | 0..1 | string |
Name
of
the
|
|
Σ | 0..* | ContactDetail |
Contact
details
for
the
publisher
|
|
Σ T | 0..1 | markdown |
Natural
language
description
of
the
plan
definition
|
|
Σ | 0..* | UsageContext |
The
context
that
the
content
is
intended
to
support
|
|
Σ | 0..* | CodeableConcept |
Intended
jurisdiction
for
plan
definition
(if
applicable)
Jurisdiction ValueSet ( Extensible ) |
|
T | 0..1 | markdown |
Why
this
plan
definition
is
defined
|
|
T | 0..1 | string |
Describes
the
clinical
usage
of
the
plan
|
|
0..1 | markdown |
Use
and/or
publishing
restrictions
|
|
|
0..1 | date |
When
the
plan
definition
was
approved
by
publisher
|
|
|
0..1 | date |
When
the
plan
definition
was
last
reviewed
|
|
|
Σ | 0..1 | Period |
When
the
plan
definition
is
expected
to
be
used
|
|
0..* | CodeableConcept |
E.g.
Education,
Treatment,
Assessment
DefinitionTopic ( Example ) |
|
|
0..* | ContactDetail |
Who
authored
the
content
|
|
|
0..* | ContactDetail |
Who
edited
the
content
|
|
|
0..* | ContactDetail |
Who
reviewed
the
content
|
|
|
0..* | ContactDetail |
Who
endorsed
the
content
|
|
|
0..* | RelatedArtifact |
Additional
documentation,
citations
|
|
|
0..* | canonical ( Library ) |
Logic
used
by
the
plan
definition
|
|
|
0..* | BackboneElement |
What
the
plan
is
trying
to
accomplish
|
|
|
0..1 | CodeableConcept |
E.g.
Treatment,
dietary,
behavioral
GoalCategory ( Example ) |
|
|
1..1 | CodeableConcept |
Code
or
text
describing
the
goal
SNOMED CT Clinical Findings ( Example ) |
|
|
0..1 | CodeableConcept |
high-priority
|
medium-priority
|
low-priority
GoalPriority ( Preferred ) |
|
|
0..1 | CodeableConcept |
When
goal
pursuit
begins
GoalStartEvent ( Example ) |
|
|
0..* | CodeableConcept |
What
does
the
goal
address
Condition/Problem/Diagnosis Codes ( Example ) |
|
|
0..* | RelatedArtifact |
Supporting
documentation
for
the
goal
|
|
|
0..* | BackboneElement |
Target
outcome
for
the
goal
|
|
|
0..1 | CodeableConcept |
The
parameter
whose
value
is
to
be
tracked
LOINC Codes ( Example ) |
|
|
0..1 |
The
target
value
to
be
achieved
|
||
|
Quantity | |||
|
Range | |||
|
CodeableConcept | |||
| string | |||
![]() ![]() ![]() ![]() ![]() |
|
boolean | ||
| integer | |||
![]() ![]() ![]() ![]() ![]() | Ratio | |||
|
0..1 | Duration |
Reach
goal
within
|
|
| 0..* | BackboneElement |
Actors
within
the
plan
| |
![]() ![]() ![]() | T | 0..1 | string |
User-visible
title
|
![]() ![]() ![]() | T | 0..1 | markdown |
Describes
the
actor
|
![]()
| 1..* | BackboneElement |
Who
or
what
can
be
this
actor
| |
![]() ![]() ![]() ![]() | 0..1 | code |
careteam
|
device
|
group
|
healthcareservice
|
location
|
organization
|
patient
|
practitioner
|
practitionerrole
|
relatedperson
ActionParticipantType ( Required ) | |
![]() ![]() ![]() ![]() | 0..1 | canonical ( CapabilityStatement ) |
Who
or
what
can
participate
| |
![]() ![]() ![]() ![]() | 0..1 | Reference ( CareTeam | Device | DeviceDefinition | Endpoint | Group | HealthcareService | Location | Organization | Patient | Practitioner | PractitionerRole | RelatedPerson ) |
Who
or
what
can
participate
| |
![]() ![]() ![]() ![]() | 0..1 | CodeableConcept |
E.g.
Nurse,
Surgeon,
Parent
ActionParticipantRole
(
Example
)
| |
![]()
|
0..* | BackboneElement |
Action
defined
by
the
plan
|
|
|
0..1 | string |
Unique
id
for
the
action
in
the
PlanDefinition
| |
![]() ![]() ![]() | 0..1 | string |
User-visible
prefix
for
the
action
(e.g.
1.
or
A.)
|
|
|
T | 0..1 | string |
User-visible
title
|
|
T | 0..1 | string |
Brief
description
of
the
action
|
|
T | 0..1 | string |
Static
text
equivalent
of
the
action,
used
if
the
dynamic
aspects
cannot
be
interpreted
by
the
receiving
system
|
|
0..1 | code |
routine
|
urgent
|
asap
|
stat
RequestPriority ( Required ) |
|
|
0..1 | CodeableConcept |
Code
representing
the
meaning
of
the
action
or
sub-actions
ActionCode ( Example ) |
|
|
0..* | CodeableConcept |
Why
the
action
should
be
performed
ActionReasonCode ( Example ) |
|
|
0..* | RelatedArtifact |
Supporting
documentation
for
the
intended
performer
of
the
action
|
|
|
0..* | id |
What
goals
this
action
supports
|
|
|
0..1 |
Type
of
individual
the
action
is
focused
on
|
||
|
CodeableConcept | |||
|
Reference ( Group ) | |||
|
canonical () | |||
|
0..* | TriggerDefinition |
When
the
action
should
be
triggered
|
|
|
0..* | BackboneElement |
Whether
or
not
the
action
is
applicable
|
|
|
1..1 | code |
applicability
|
start
|
stop
ActionConditionKind ( Required ) |
|
|
0..1 | Expression |
Boolean-valued
expression
|
|
|
C | 0..* | BackboneElement |
Input
data
requirements
+ Rule: Input data elements must have a requirement or a relatedData, but not both |
![]() ![]() ![]() ![]() |
T |
| string |
User-visible
title
|
![]() ![]() ![]() ![]() | 0..1 | DataRequirement |
What
data
is
provided
| |
![]() ![]() ![]() ![]() | 0..1 |
|
What
data
|
|
|
C | 0..* |
|
Output
data
definition
+ Rule: Output data element must have a requirement or a relatedData, but not both |
|
T |
|
|
|
|
0..1 | DataRequirement |
| |
![]() ![]() ![]() ![]() | 0..1 | string |
What
data
is
provided
| |
![]() ![]() ![]() |
0..* | BackboneElement |
Relationship
to
another
action
| |
![]() ![]() ![]() ![]() | 1..1 | id |
What
action
is
this
related
to
|
|
|
1..1 | code |
before-start
|
before
|
before-end
|
concurrent-with-start
|
concurrent
|
concurrent-with-end
|
after-start
|
after
|
after-end
ActionRelationshipType ( Required ) |
|
|
0..1 |
Time
offset
for
the
relationship
|
||
|
Duration | |||
|
Range | |||
|
0..1 |
When
the
action
should
take
place
|
||
|
Age | |||
| Duration | |||
|
|
|||
|
Timing | |||
![]() ![]() ![]() | 0..1 | CodeableReference ( Location ) |
Where
it
should
happen
| |
![]() ![]() ![]() | 0..* |
|
Who
should
participate
in
the
action
|
|
|
0..1 |
|
What
actor
|
|
|
0..1 |
|
careteam
|
device
|
group
|
healthcareservice
|
location
|
organization
|
patient
|
practitioner
|
practitionerrole
|
relatedperson
ActionParticipantType ( Required ) |
|
|
0..1 |
|
Who
or
what
can
participate
|
|
|
|
|
Who
|
|
|
|
|
(
|
|
|
0..1 | CodeableConcept |
E.g.
|
|
|
0..1 | CodeableConcept |
create
|
update
|
remove
|
fire-event
ActionType ( Extensible ) |
|
|
0..1 | code |
visual-group
|
logical-group
|
sentence-group
ActionGroupingBehavior ( Required ) |
|
|
0..1 | code |
any
|
all
|
all-or-none
|
exactly-one
|
at-most-one
|
one-or-more
ActionSelectionBehavior ( Required ) |
|
|
0..1 | code |
must
|
could
|
must-unless-documented
ActionRequiredBehavior ( Required ) |
|
|
0..1 | code |
yes
|
no
ActionPrecheckBehavior ( Required ) |
|
|
0..1 | code |
single
|
multiple
ActionCardinalityBehavior ( Required ) |
|
|
0..1 |
Description
of
the
activity
to
be
performed
|
||
|
canonical ( ActivityDefinition | ObservationDefinition | PlanDefinition | Questionnaire | SpecimenDefinition ) | |||
|
uri | |||
|
0..1 | canonical ( StructureMap ) |
Transform
to
apply
the
template
|
|
|
0..* | BackboneElement |
Dynamic
aspects
of
the
definition
|
|
|
0..1 | string |
The
path
to
the
element
to
be
set
dynamically
|
|
|
0..1 | Expression |
An
expression
that
provides
the
dynamic
value
for
the
customization
|
|
|
0..* | see action |
A
sub-action
|
|
| Σ | 0..1 |
Preconditions
for
service
SNOMED CT Medication As Needed Reason Codes ( Example ) |
|
| boolean | |||
![]() ![]() ![]() | CodeableConcept | |||
Documentation
for
this
format
|
||||
See the Extensions for this resource
XML Template
<PlanDefinition xmlns="http://hl7.org/fhir"><!-- from Resource: id, meta, implicitRules, and language --> <!-- from DomainResource: text, contained, extension, and modifierExtension -->
<<url value="[uri]"/><!-- 0..1 Canonical identifier for this plan definition, represented as a URI (globally unique) --> <identifier><!-- 0..* Identifier Additional identifier for the plan definition --></identifier> <version value="[string]"/><!-- 0..1 Business version of the plan definition --><<name value="[string]"/><!-- I 0..1 Name for this plan definition (computer friendly) --> <title value="[string]"/><!-- 0..1 Name for this plan definition (human friendly) --> <subtitle value="[string]"/><!-- 0..1 Subordinate title of the plan definition --> <type><!-- 0..1 CodeableConcept order-set | clinical-protocol | eca-rule | workflow-definition --></type> <status value="[code]"/><!-- 1..1 draft | active | retired | unknown --> <experimental value="[boolean]"/><!-- 0..1 For testing purposes, not real usage --><( | </subject[x]> < <<subject[x]><!-- 0..1 CodeableConcept|Reference(AdministrableProductDefinition| Group|ManufacturedItemDefinition|MedicinalProductDefinition| PackagedProductDefinition|SubstanceDefinition)|canonical(EvidenceVariable) Type of individual the plan definition is focused on --></subject[x]> <date value="[dateTime]"/><!-- 0..1 Date last changed --> <publisher value="[string]"/><!-- 0..1 Name of the publisher/steward (organization or individual) --> <contact><!-- 0..* ContactDetail Contact details for the publisher --></contact> <description value="[markdown]"/><!-- 0..1 Natural language description of the plan definition --> <useContext><!-- 0..* UsageContext The context that the content is intended to support --></useContext> <jurisdiction><!-- 0..* CodeableConcept Intended jurisdiction for plan definition (if applicable) --></jurisdiction> <purpose value="[markdown]"/><!-- 0..1 Why this plan definition is defined --> <usage value="[string]"/><!-- 0..1 Describes the clinical usage of the plan --> <copyright value="[markdown]"/><!-- 0..1 Use and/or publishing restrictions --> <approvalDate value="[date]"/><!-- 0..1 When the plan definition was approved by publisher --> <lastReviewDate value="[date]"/><!-- 0..1 When the plan definition was last reviewed --> <effectivePeriod><!-- 0..1 Period When the plan definition is expected to be used --></effectivePeriod> <topic><!-- 0..* CodeableConcept E.g. Education, Treatment, Assessment --></topic> <author><!-- 0..* ContactDetail Who authored the content --></author> <editor><!-- 0..* ContactDetail Who edited the content --></editor> <reviewer><!-- 0..* ContactDetail Who reviewed the content --></reviewer> <endorser><!-- 0..* ContactDetail Who endorsed the content --></endorser> <relatedArtifact><!-- 0..* RelatedArtifact Additional documentation, citations --></relatedArtifact> <library><!-- 0..* canonical(Library) Logic used by the plan definition --></library> <goal> <!-- 0..* What the plan is trying to accomplish --> <category><!-- 0..1 CodeableConcept E.g. Treatment, dietary, behavioral --></category> <description><!-- 1..1 CodeableConcept Code or text describing the goal --></description> <priority><!-- 0..1 CodeableConcept high-priority | medium-priority | low-priority --></priority> <start><!-- 0..1 CodeableConcept When goal pursuit begins --></start> <addresses><!-- 0..* CodeableConcept What does the goal address --></addresses> <documentation><!-- 0..* RelatedArtifact Supporting documentation for the goal --></documentation> <target> <!-- 0..* Target outcome for the goal --> <measure><!-- 0..1 CodeableConcept The parameter whose value is to be tracked --></measure><</detail[x]><detail[x]><!-- 0..1 Quantity|Range|CodeableConcept|string|boolean|integer| Ratio The target value to be achieved --></detail[x]> <due><!-- 0..1 Duration Reach goal within --></due> </target> </goal> <actor> <!-- 0..* Actors within the plan --> <title value="[string]"/><!-- 0..1 User-visible title --> <description value="[markdown]"/><!-- 0..1 Describes the actor --> <option> <!-- 1..* Who or what can be this actor --> <type value="[code]"/><!-- 0..1 careteam | device | group | healthcareservice | location | organization | patient | practitioner | practitionerrole | relatedperson --> <typeCanonical><!-- 0..1 canonical(CapabilityStatement) Who or what can participate --></typeCanonical> <typeReference><!-- 0..1 Reference(CareTeam|Device|DeviceDefinition|Endpoint| Group|HealthcareService|Location|Organization|Patient|Practitioner| PractitionerRole|RelatedPerson) Who or what can participate --></typeReference> <role><!-- 0..1 CodeableConcept E.g. Nurse, Surgeon, Parent--></role> </option> </actor> <action> <!-- 0..* Action defined by the plan -->
<<linkId value="[string]"/><!-- 0..1 Unique id for the action in the PlanDefinition --> <prefix value="[string]"/><!-- 0..1 User-visible prefix for the action (e.g. 1. or A.) --> <title value="[string]"/><!-- 0..1 User-visible title --> <description value="[string]"/><!-- 0..1 Brief description of the action --> <textEquivalent value="[string]"/><!-- 0..1 Static text equivalent of the action, used if the dynamic aspects cannot be interpreted by the receiving system --> <priority value="[code]"/><!-- 0..1 routine | urgent | asap | stat --><</code><code><!-- 0..1 CodeableConcept Code representing the meaning of the action or sub-actions --></code> <reason><!-- 0..* CodeableConcept Why the action should be performed --></reason> <documentation><!-- 0..* RelatedArtifact Supporting documentation for the intended performer of the action --></documentation> <goalId value="[id]"/><!-- 0..* What goals this action supports --><</subject[x]> <</trigger><subject[x]><!-- 0..1 CodeableConcept|Reference(Group)|canonical Type of individual the action is focused on --></subject[x]> <trigger><!-- 0..* TriggerDefinition When the action should be triggered --></trigger> <condition> <!-- 0..* Whether or not the action is applicable --> <kind value="[code]"/><!-- 1..1 applicability | start | stop --> <expression><!-- 0..1 Expression Boolean-valued expression --></expression> </condition><</input> <</output><input> <!-- 0..* Input data requirements --> <title value="[string]"/><!-- 0..1 User-visible title --> <requirement><!-- 0..1 DataRequirement What data is provided --></requirement> <relatedData value="[id]"/><!-- 0..1 What data is provided --> </input> <output> <!-- 0..* Output data definition --> <title value="[string]"/><!-- 0..1 User-visible title --> <requirement><!-- 0..1 DataRequirement What data is provided --></requirement> <relatedData value="[string]"/><!-- 0..1 What data is provided --> </output> <relatedAction> <!-- 0..* Relationship to another action --><<targetId value="[id]"/><!-- 1..1 What action is this related to --> <relationship value="[code]"/><!-- 1..1 before-start | before | before-end | concurrent-with-start | concurrent | concurrent-with-end | after-start | after | after-end --> <offset[x]><!-- 0..1 Duration|Range Time offset for the relationship --></offset[x]> </relatedAction><</timing[x]><timing[x]><!-- 0..1 Age|Duration|Range|Timing When the action should take place --></timing[x]> <location><!-- 0..1 CodeableReference(Location) Where it should happen --></location> <participant> <!-- 0..* Who should participate in the action -->< <</role><actorId value="[string]"/><!-- 0..1 What actor --> <type value="[code]"/><!-- 0..1 careteam | device | group | healthcareservice | location | organization | patient | practitioner | practitionerrole | relatedperson --> <typeCanonical><!-- 0..1 canonical(CapabilityStatement) Who or what can participate --></typeCanonical> <typeReference><!-- 0..1 Reference(CareTeam|Device|DeviceDefinition|Endpoint| Group|HealthcareService|Location|Organization|Patient|Practitioner| PractitionerRole|RelatedPerson) Who or what can participate --></typeReference> <role><!-- 0..1 CodeableConcept E.g. Nurse, Surgeon, Parent--></role> <function><!-- 0..1 CodeableConcept E.g. Author, Reviewer, Witness, etc. --></function> </participant> <type><!-- 0..1 CodeableConcept create | update | remove | fire-event --></type> <groupingBehavior value="[code]"/><!-- 0..1 visual-group | logical-group | sentence-group --> <selectionBehavior value="[code]"/><!-- 0..1 any | all | all-or-none | exactly-one | at-most-one | one-or-more --> <requiredBehavior value="[code]"/><!-- 0..1 must | could | must-unless-documented --> <precheckBehavior value="[code]"/><!-- 0..1 yes | no --> <cardinalityBehavior value="[code]"/><!-- 0..1 single | multiple -->
<| </definition[x]><definition[x]><!-- 0..1 canonical(ActivityDefinition|ObservationDefinition| PlanDefinition|Questionnaire|SpecimenDefinition)|uri Description of the activity to be performed --></definition[x]> <transform><!-- 0..1 canonical(StructureMap) Transform to apply the template --></transform> <dynamicValue> <!-- 0..* Dynamic aspects of the definition --> <path value="[string]"/><!-- 0..1 The path to the element to be set dynamically --> <expression><!-- 0..1 Expression An expression that provides the dynamic value for the customization --></expression> </dynamicValue> <action><!-- 0..* Content as for PlanDefinition.action A sub-action --></action> </action> <asNeeded[x]><!-- 0..1 boolean|CodeableConcept Preconditions for service --></asNeeded[x]> </PlanDefinition>
JSON Template
{
"resourceType" : "PlanDefinition",
// from Resource: id, meta, implicitRules, and language
// from DomainResource: text, contained, extension, and modifierExtension
"
"url" : "<uri>", // Canonical identifier for this plan definition, represented as a URI (globally unique)
"identifier" : [{ Identifier }], // Additional identifier for the plan definition
"version" : "<string>", // Business version of the plan definition
"
"name" : "<string>", // I Name for this plan definition (computer friendly)
"title" : "<string>", // Name for this plan definition (human friendly)
"subtitle" : "<string>", // Subordinate title of the plan definition
"type" : { CodeableConcept }, // order-set | clinical-protocol | eca-rule | workflow-definition
"status" : "<code>", // R! draft | active | retired | unknown
"experimental" : <boolean>, // For testing purposes, not real usage
// subject[x]: Type of individual the plan definition is focused on. One of these 3:
"subjectCodeableConcept" : { CodeableConcept },
" },
"|
"subjectReference" : { Reference(AdministrableProductDefinition|Group|
ManufacturedItemDefinition|MedicinalProductDefinition|
PackagedProductDefinition|SubstanceDefinition) },
"
"
"subjectCanonical" : "<canonical(EvidenceVariable)>",
"date" : "<dateTime>", // Date last changed
"publisher" : "<string>", // Name of the publisher/steward (organization or individual)
"contact" : [{ ContactDetail }], // Contact details for the publisher
"description" : "<markdown>", // Natural language description of the plan definition
"useContext" : [{ UsageContext }], // The context that the content is intended to support
"jurisdiction" : [{ CodeableConcept }], // Intended jurisdiction for plan definition (if applicable)
"purpose" : "<markdown>", // Why this plan definition is defined
"usage" : "<string>", // Describes the clinical usage of the plan
"copyright" : "<markdown>", // Use and/or publishing restrictions
"approvalDate" : "<date>", // When the plan definition was approved by publisher
"lastReviewDate" : "<date>", // When the plan definition was last reviewed
"effectivePeriod" : { Period }, // When the plan definition is expected to be used
"topic" : [{ CodeableConcept }], // E.g. Education, Treatment, Assessment
"author" : [{ ContactDetail }], // Who authored the content
"editor" : [{ ContactDetail }], // Who edited the content
"reviewer" : [{ ContactDetail }], // Who reviewed the content
"endorser" : [{ ContactDetail }], // Who endorsed the content
"relatedArtifact" : [{ RelatedArtifact }], // Additional documentation, citations
"
"library" : ["<canonical(Library)>"], // Logic used by the plan definition
"goal" : [{ // What the plan is trying to accomplish
"category" : { CodeableConcept }, // E.g. Treatment, dietary, behavioral
"description" : { CodeableConcept }, // R! Code or text describing the goal
"priority" : { CodeableConcept }, // high-priority | medium-priority | low-priority
"start" : { CodeableConcept }, // When goal pursuit begins
"addresses" : [{ CodeableConcept }], // What does the goal address
"documentation" : [{ RelatedArtifact }], // Supporting documentation for the goal
"target" : [{ // Target outcome for the goal
"measure" : { CodeableConcept }, // The parameter whose value is to be tracked
// detail[x]: The target value to be achieved. One of these 7:
"detailQuantity" : { Quantity },
"detailRange" : { Range },
"detailCodeableConcept" : { CodeableConcept },
"detailString" : "<string>",
"detailBoolean" : <boolean>,
"detailInteger" : <integer>,
"detailRatio" : { Ratio },
"due" : { Duration } // Reach goal within
}]
}],
"actor" : [{ // Actors within the plan
"title" : "<string>", // User-visible title
"description" : "<markdown>", // Describes the actor
"option" : [{ // R! Who or what can be this actor
"type" : "<code>", // careteam | device | group | healthcareservice | location | organization | patient | practitioner | practitionerrole | relatedperson
"typeCanonical" : "<canonical(CapabilityStatement)>", // Who or what can participate
"typeReference" : { Reference(CareTeam|Device|DeviceDefinition|Endpoint|
Group|HealthcareService|Location|Organization|Patient|Practitioner|
PractitionerRole|RelatedPerson) }, // Who or what can participate
"role" : { CodeableConcept } // E.g. Nurse, Surgeon, Parent
}]
}],
"action" : [{ // Action defined by the plan
"
"linkId" : "<string>", // Unique id for the action in the PlanDefinition
"prefix" : "<string>", // User-visible prefix for the action (e.g. 1. or A.)
"title" : "<string>", // User-visible title
"description" : "<string>", // Brief description of the action
"textEquivalent" : "<string>", // Static text equivalent of the action, used if the dynamic aspects cannot be interpreted by the receiving system
"priority" : "<code>", // routine | urgent | asap | stat
"
"code" : { CodeableConcept }, // Code representing the meaning of the action or sub-actions
"reason" : [{ CodeableConcept }], // Why the action should be performed
"documentation" : [{ RelatedArtifact }], // Supporting documentation for the intended performer of the action
"goalId" : ["<id>"], // What goals this action supports
// subject[x]: Type of individual the action is focused on. One of these 3:
"subjectCodeableConcept" : { CodeableConcept },
"subjectReference" : { Reference(Group) },
"subjectCanonical" : "<canonical>",
"
"trigger" : [{ TriggerDefinition }], // When the action should be triggered
"condition" : [{ // Whether or not the action is applicable
"kind" : "<code>", // R! applicability | start | stop
"expression" : { Expression } // Boolean-valued expression
}],
"
"
"input" : [{ // Input data requirements
"title" : "<string>", // User-visible title
"requirement" : { DataRequirement }, // What data is provided
"relatedData" : "<id>" // What data is provided
}],
"output" : [{ // Output data definition
"title" : "<string>", // User-visible title
"requirement" : { DataRequirement }, // What data is provided
"relatedData" : "<string>" // What data is provided
}],
"relatedAction" : [{ // Relationship to another action
"
"targetId" : "<id>", // R! What action is this related to
"relationship" : "<code>", // R! before-start | before | before-end | concurrent-with-start | concurrent | concurrent-with-end | after-start | after | after-end
// offset[x]: Time offset for the relationship. One of these 2:
" }
"offsetDuration" : { Duration },
"offsetRange" : { Range }
}],
">",
// timing[x]: When the action should take place. One of these 4:
"timingAge" : { Age },
" },
"timingDuration" : { Duration },
"timingRange" : { Range },
"timingTiming" : { Timing },
"location" : { CodeableReference(Location) }, // Where it should happen
"participant" : [{ // Who should participate in the action
"
"
"actorId" : "<string>", // What actor
"type" : "<code>", // careteam | device | group | healthcareservice | location | organization | patient | practitioner | practitionerrole | relatedperson
"typeCanonical" : "<canonical(CapabilityStatement)>", // Who or what can participate
"typeReference" : { Reference(CareTeam|Device|DeviceDefinition|Endpoint|
Group|HealthcareService|Location|Organization|Patient|Practitioner|
PractitionerRole|RelatedPerson) }, // Who or what can participate
"role" : { CodeableConcept }, // E.g. Nurse, Surgeon, Parent
"function" : { CodeableConcept } // E.g. Author, Reviewer, Witness, etc.
}],
"type" : { CodeableConcept }, // create | update | remove | fire-event
"groupingBehavior" : "<code>", // visual-group | logical-group | sentence-group
"selectionBehavior" : "<code>", // any | all | all-or-none | exactly-one | at-most-one | one-or-more
"requiredBehavior" : "<code>", // must | could | must-unless-documented
"precheckBehavior" : "<code>", // yes | no
"cardinalityBehavior" : "<code>", // single | multiple
// definition[x]: Description of the activity to be performed. One of these 2:
"|
},
">",
"
"definitionCanonical" : "<canonical(ActivityDefinition|ObservationDefinition|PlanDefinition|Questionnaire|SpecimenDefinition)>",
"definitionUri" : "<uri>",
"transform" : "<canonical(StructureMap)>", // Transform to apply the template
"dynamicValue" : [{ // Dynamic aspects of the definition
"path" : "<string>", // The path to the element to be set dynamically
"expression" : { Expression } // An expression that provides the dynamic value for the customization
}],
"action" : [{ Content as for PlanDefinition.action }] // A sub-action
}]
}],
// asNeeded[x]: Preconditions for service. One of these 2:
"asNeededBoolean" : <boolean>,
"asNeededCodeableConcept" : { CodeableConcept }
}
Turtle Template
@prefix fhir: <http://hl7.org/fhir/> .[ a fhir:PlanDefinition; fhir:nodeRole fhir:treeRoot; # if this is the parser root # from Resource: .id, .meta, .implicitRules, and .language # from DomainResource: .text, .contained, .extension, and .modifierExtension
fhir:fhir:PlanDefinition.url [ uri ]; # 0..1 Canonical identifier for this plan definition, represented as a URI (globally unique) fhir:PlanDefinition.identifier [ Identifier ], ... ; # 0..* Additional identifier for the plan definition fhir:PlanDefinition.version [ string ]; # 0..1 Business version of the plan definitionfhir:fhir:PlanDefinition.name [ string ]; # 0..1 I Name for this plan definition (computer friendly) fhir:PlanDefinition.title [ string ]; # 0..1 Name for this plan definition (human friendly) fhir:PlanDefinition.subtitle [ string ]; # 0..1 Subordinate title of the plan definition fhir:PlanDefinition.type [ CodeableConcept ]; # 0..1 order-set | clinical-protocol | eca-rule | workflow-definition fhir:PlanDefinition.status [ code ]; # 1..1 draft | active | retired | unknown fhir:PlanDefinition.experimental [ boolean ]; # 0..1 For testing purposes, not real usage # PlanDefinition.subject[x] : 0..1 Type of individual the plan definition is focused on. One of these 3 fhir:PlanDefinition.subjectCodeableConcept [ CodeableConcept ]fhir:) ] fhir:|fhir:PlanDefinition.subjectReference [ Reference(AdministrableProductDefinition|Group|ManufacturedItemDefinition| MedicinalProductDefinition|PackagedProductDefinition|SubstanceDefinition) ]fhir: fhir:fhir:PlanDefinition.subjectCanonical [ canonical(EvidenceVariable) ] fhir:PlanDefinition.date [ dateTime ]; # 0..1 Date last changed fhir:PlanDefinition.publisher [ string ]; # 0..1 Name of the publisher/steward (organization or individual) fhir:PlanDefinition.contact [ ContactDetail ], ... ; # 0..* Contact details for the publisher fhir:PlanDefinition.description [ markdown ]; # 0..1 Natural language description of the plan definition fhir:PlanDefinition.useContext [ UsageContext ], ... ; # 0..* The context that the content is intended to support fhir:PlanDefinition.jurisdiction [ CodeableConcept ], ... ; # 0..* Intended jurisdiction for plan definition (if applicable) fhir:PlanDefinition.purpose [ markdown ]; # 0..1 Why this plan definition is defined fhir:PlanDefinition.usage [ string ]; # 0..1 Describes the clinical usage of the plan fhir:PlanDefinition.copyright [ markdown ]; # 0..1 Use and/or publishing restrictions fhir:PlanDefinition.approvalDate [ date ]; # 0..1 When the plan definition was approved by publisher fhir:PlanDefinition.lastReviewDate [ date ]; # 0..1 When the plan definition was last reviewed fhir:PlanDefinition.effectivePeriod [ Period ]; # 0..1 When the plan definition is expected to be used fhir:PlanDefinition.topic [ CodeableConcept ], ... ; # 0..* E.g. Education, Treatment, Assessment fhir:PlanDefinition.author [ ContactDetail ], ... ; # 0..* Who authored the content fhir:PlanDefinition.editor [ ContactDetail ], ... ; # 0..* Who edited the content fhir:PlanDefinition.reviewer [ ContactDetail ], ... ; # 0..* Who reviewed the content fhir:PlanDefinition.endorser [ ContactDetail ], ... ; # 0..* Who endorsed the content fhir:PlanDefinition.relatedArtifact [ RelatedArtifact ], ... ; # 0..* Additional documentation, citations fhir:PlanDefinition.library [ canonical(Library) ], ... ; # 0..* Logic used by the plan definition fhir:PlanDefinition.goal [ # 0..* What the plan is trying to accomplish fhir:PlanDefinition.goal.category [ CodeableConcept ]; # 0..1 E.g. Treatment, dietary, behavioral fhir:PlanDefinition.goal.description [ CodeableConcept ]; # 1..1 Code or text describing the goal fhir:PlanDefinition.goal.priority [ CodeableConcept ]; # 0..1 high-priority | medium-priority | low-priority fhir:PlanDefinition.goal.start [ CodeableConcept ]; # 0..1 When goal pursuit begins fhir:PlanDefinition.goal.addresses [ CodeableConcept ], ... ; # 0..* What does the goal address fhir:PlanDefinition.goal.documentation [ RelatedArtifact ], ... ; # 0..* Supporting documentation for the goal fhir:PlanDefinition.goal.target [ # 0..* Target outcome for the goal fhir:PlanDefinition.goal.target.measure [ CodeableConcept ]; # 0..1 The parameter whose value is to be tracked# . One of these 3# PlanDefinition.goal.target.detail[x] : 0..1 The target value to be achieved. One of these 7 fhir:PlanDefinition.goal.target.detailQuantity [ Quantity ] fhir:PlanDefinition.goal.target.detailRange [ Range ] fhir:PlanDefinition.goal.target.detailCodeableConcept [ CodeableConcept ] fhir:PlanDefinition.goal.target.detailString [ string ] fhir:PlanDefinition.goal.target.detailBoolean [ boolean ] fhir:PlanDefinition.goal.target.detailInteger [ integer ] fhir:PlanDefinition.goal.target.detailRatio [ Ratio ] fhir:PlanDefinition.goal.target.due [ Duration ]; # 0..1 Reach goal within ], ...; ], ...; fhir:PlanDefinition.actor [ # 0..* Actors within the plan fhir:PlanDefinition.actor.title [ string ]; # 0..1 User-visible title fhir:PlanDefinition.actor.description [ markdown ]; # 0..1 Describes the actor fhir:PlanDefinition.actor.option [ # 1..* Who or what can be this actor fhir:PlanDefinition.actor.option.type [ code ]; # 0..1 careteam | device | group | healthcareservice | location | organization | patient | practitioner | practitionerrole | relatedperson fhir:PlanDefinition.actor.option.typeCanonical [ canonical(CapabilityStatement) ]; # 0..1 Who or what can participate fhir:PlanDefinition.actor.option.typeReference [ Reference(CareTeam|Device|DeviceDefinition|Endpoint|Group|HealthcareService|Location| Organization|Patient|Practitioner|PractitionerRole|RelatedPerson) ]; # 0..1 Who or what can participate fhir:PlanDefinition.actor.option.role [ CodeableConcept ]; # 0..1 E.g. Nurse, Surgeon, Parent ], ...; ], ...; fhir:PlanDefinition.action [ # 0..* Action defined by the planfhir:fhir:PlanDefinition.action.linkId [ string ]; # 0..1 Unique id for the action in the PlanDefinition fhir:PlanDefinition.action.prefix [ string ]; # 0..1 User-visible prefix for the action (e.g. 1. or A.) fhir:PlanDefinition.action.title [ string ]; # 0..1 User-visible title fhir:PlanDefinition.action.description [ string ]; # 0..1 Brief description of the action fhir:PlanDefinition.action.textEquivalent [ string ]; # 0..1 Static text equivalent of the action, used if the dynamic aspects cannot be interpreted by the receiving system fhir:PlanDefinition.action.priority [ code ]; # 0..1 routine | urgent | asap | statfhir:fhir:PlanDefinition.action.code [ CodeableConcept ]; # 0..1 Code representing the meaning of the action or sub-actions fhir:PlanDefinition.action.reason [ CodeableConcept ], ... ; # 0..* Why the action should be performed fhir:PlanDefinition.action.documentation [ RelatedArtifact ], ... ; # 0..* Supporting documentation for the intended performer of the action fhir:PlanDefinition.action.goalId [ id ], ... ; # 0..* What goals this action supports # PlanDefinition.action.subject[x] : 0..1 Type of individual the action is focused on. One of these 3 fhir:PlanDefinition.action.subjectCodeableConcept [ CodeableConcept ] fhir:PlanDefinition.action.subjectReference [ Reference(Group) ] fhir:PlanDefinition.action.subjectCanonical [ canonical ]fhir:fhir:PlanDefinition.action.trigger [ TriggerDefinition ], ... ; # 0..* When the action should be triggered fhir:PlanDefinition.action.condition [ # 0..* Whether or not the action is applicable fhir:PlanDefinition.action.condition.kind [ code ]; # 1..1 applicability | start | stop fhir:PlanDefinition.action.condition.expression [ Expression ]; # 0..1 Boolean-valued expression ], ...;fhir: fhir:fhir:PlanDefinition.action.input [ # 0..* Input data requirements fhir:PlanDefinition.action.input.title [ string ]; # 0..1 User-visible title fhir:PlanDefinition.action.input.requirement [ DataRequirement ]; # 0..1 What data is provided fhir:PlanDefinition.action.input.relatedData [ id ]; # 0..1 What data is provided ], ...; fhir:PlanDefinition.action.output [ # 0..* Output data definition fhir:PlanDefinition.action.output.title [ string ]; # 0..1 User-visible title fhir:PlanDefinition.action.output.requirement [ DataRequirement ]; # 0..1 What data is provided fhir:PlanDefinition.action.output.relatedData [ string ]; # 0..1 What data is provided ], ...; fhir:PlanDefinition.action.relatedAction [ # 0..* Relationship to another actionfhir:fhir:PlanDefinition.action.relatedAction.targetId [ id ]; # 1..1 What action is this related to fhir:PlanDefinition.action.relatedAction.relationship [ code ]; # 1..1 before-start | before | before-end | concurrent-with-start | concurrent | concurrent-with-end | after-start | after | after-end # PlanDefinition.action.relatedAction.offset[x] : 0..1 Time offset for the relationship. One of these 2 fhir:PlanDefinition.action.relatedAction.offsetDuration [ Duration ] fhir:PlanDefinition.action.relatedAction.offsetRange [ Range ] ], ...;# . One of these 6 fhir: ]# PlanDefinition.action.timing[x] : 0..1 When the action should take place. One of these 4 fhir:PlanDefinition.action.timingAge [ Age ]fhir: ]fhir:PlanDefinition.action.timingDuration [ Duration ] fhir:PlanDefinition.action.timingRange [ Range ] fhir:PlanDefinition.action.timingTiming [ Timing ] fhir:PlanDefinition.action.location [ CodeableReference(Location) ]; # 0..1 Where it should happen fhir:PlanDefinition.action.participant [ # 0..* Who should participate in the actionfhir:fhir:PlanDefinition.action.participant.actorId [ string ]; # 0..1 What actor fhir:PlanDefinition.action.participant.type [ code ]; # 0..1 careteam | device | group | healthcareservice | location | organization | patient | practitioner | practitionerrole | relatedperson fhir:PlanDefinition.action.participant.typeCanonical [ canonical(CapabilityStatement) ]; # 0..1 Who or what can participate fhir:PlanDefinition.action.participant.typeReference [ Reference(CareTeam|Device|DeviceDefinition|Endpoint|Group|HealthcareService|Location| Organization|Patient|Practitioner|PractitionerRole|RelatedPerson) ]; # 0..1 Who or what can participate fhir:PlanDefinition.action.participant.role [ CodeableConcept ]; # 0..1 E.g. Nurse, Surgeon, Parent fhir:PlanDefinition.action.participant.function [ CodeableConcept ]; # 0..1 E.g. Author, Reviewer, Witness, etc. ], ...; fhir:PlanDefinition.action.type [ CodeableConcept ]; # 0..1 create | update | remove | fire-event fhir:PlanDefinition.action.groupingBehavior [ code ]; # 0..1 visual-group | logical-group | sentence-group fhir:PlanDefinition.action.selectionBehavior [ code ]; # 0..1 any | all | all-or-none | exactly-one | at-most-one | one-or-more fhir:PlanDefinition.action.requiredBehavior [ code ]; # 0..1 must | could | must-unless-documented fhir:PlanDefinition.action.precheckBehavior [ code ]; # 0..1 yes | no fhir:PlanDefinition.action.cardinalityBehavior [ code ]; # 0..1 single | multiple# . One of these 2 fhir:) ] fhir: ]# PlanDefinition.action.definition[x] : 0..1 Description of the activity to be performed. One of these 2 fhir:PlanDefinition.action.definitionCanonical [ canonical(ActivityDefinition|ObservationDefinition|PlanDefinition|Questionnaire| SpecimenDefinition) ] fhir:PlanDefinition.action.definitionUri [ uri ] fhir:PlanDefinition.action.transform [ canonical(StructureMap) ]; # 0..1 Transform to apply the template fhir:PlanDefinition.action.dynamicValue [ # 0..* Dynamic aspects of the definition fhir:PlanDefinition.action.dynamicValue.path [ string ]; # 0..1 The path to the element to be set dynamically fhir:PlanDefinition.action.dynamicValue.expression [ Expression ]; # 0..1 An expression that provides the dynamic value for the customization ], ...; fhir:PlanDefinition.action.action [ See PlanDefinition.action ], ... ; # 0..* A sub-action ], ...; # PlanDefinition.asNeeded[x] : 0..1 Preconditions for service. One of these 2 fhir:PlanDefinition.asNeededBoolean [ boolean ] fhir:PlanDefinition.asNeededCodeableConcept [ CodeableConcept ] ]
Changes since Release 4
| PlanDefinition | |
| PlanDefinition.subject[x] |
|
| PlanDefinition.goal.target.detail[x] |
|
| PlanDefinition.actor |
|
| PlanDefinition.actor.title |
|
| PlanDefinition.actor.description |
|
| PlanDefinition.actor.option |
|
| PlanDefinition.actor.option.type |
|
| PlanDefinition.actor.option.typeCanonical |
|
| PlanDefinition.actor.option.typeReference |
|
| PlanDefinition.actor.option.role |
|
| PlanDefinition.action.linkId |
|
| PlanDefinition.action.code |
|
| PlanDefinition.action.subject[x] |
|
| PlanDefinition.action.input |
|
| PlanDefinition.action.input.title |
|
| PlanDefinition.action.input.requirement |
|
| PlanDefinition.action.input.relatedData |
|
| PlanDefinition.action.output |
|
| PlanDefinition.action.output.title |
|
| PlanDefinition.action.output.requirement |
|
| PlanDefinition.action.output.relatedData |
|
| PlanDefinition.action.relatedAction.targetId |
|
| PlanDefinition.action.timing[x] |
|
| PlanDefinition.action.location |
|
| PlanDefinition.action.participant.actorId |
|
| PlanDefinition.action.participant.type |
|
| PlanDefinition.action.participant.typeCanonical |
|
| PlanDefinition.action.participant.typeReference |
|
| PlanDefinition.action.participant.function |
|
| PlanDefinition.asNeeded[x] |
|
| PlanDefinition.action.relatedAction.actionId |
|
See the Full Difference for further information
This analysis is available as XML or JSON .
Conversions
between
R3
and
R4
See
R3
<-->
R4
Conversion
Maps
(status
=
11
tests
of
which
6
fail
to
execute
.
All
tests
pass
round-trip
testing
and
5
r3
resources
are
invalid
(0
errors).
)
See
the
Profiles
&
Extensions
and
the
alternate
Additional
definitions:
Master
Definition
XML
+
JSON
,
XML
Schema
/
Schematron
+
JSON
Schema
,
ShEx
(for
Turtle
)
+
see
,
the
extensions
spreadsheet
version
&
the
dependency
analysis
| Path | Definition | Type | Reference |
|---|---|---|---|
| PlanDefinition.type |
The type of PlanDefinition. |
Extensible | PlanDefinitionType |
| PlanDefinition.status |
The lifecycle status of an artifact. |
Required | PublicationStatus |
| PlanDefinition.subject[x] |
All Resource Types that represent participant resources |
Extensible |
|
| PlanDefinition.jurisdiction |
This value set defines a base set of codes for country, country subdivision and region for indicating where a resource is intended to be used.
Note:
The
codes
for
countries
and
country
subdivisions
are
taken
from
ISO
3166
|
Extensible |
|
| PlanDefinition.topic |
High-level categorization of the definition, used for searching, sorting, and filtering. |
Example | DefinitionTopic |
| PlanDefinition.goal.category |
Example codes for grouping goals to use for filtering or presentation. |
Example | GoalCategory |
| PlanDefinition.goal.description |
This
value
set
includes
all
the
"Clinical
finding"
SNOMED
CT
|
Example | SNOMEDCTClinicalFindings |
| PlanDefinition.goal.priority |
Indicates the level of importance associated with reaching or sustaining a goal. |
Preferred | GoalPriority |
| PlanDefinition.goal.start |
Identifies types of events that might trigger the start of a goal. |
Example | GoalStartEvent |
| PlanDefinition.goal.addresses |
Example value set for Condition/Problem/Diagnosis codes. |
Example |
|
| PlanDefinition.goal.target.measure |
This value set includes all LOINC codes |
Example |
LOINCCodes
(a
valid
code
from
LOINC
)
|
| PlanDefinition.actor.option.type | The type of participant for the action. | Required | ActionParticipantType |
| PlanDefinition.actor.option.role | Either a practitioner role or a relationship type. Note from UTG import - may have been a temporary entry that subsequently disappeared from the FHIR source; unable to locate. Version set to 0.1.0 | Example |
ActionParticipantRole
|
| PlanDefinition.action.priority |
Identifies the level of importance to be assigned to actioning the request. |
Required | RequestPriority |
| PlanDefinition.action.code |
Provides examples of actions to be performed. |
Example | ActionCode |
| PlanDefinition.action.reason |
Provides examples of reasons for actions to be performed. |
Example | ActionReasonCode |
| PlanDefinition.action.subject[x] |
All Resource Types that represent participant resources |
Extensible |
|
| PlanDefinition.action.condition.kind |
Defines the kinds of conditions that can appear on actions. |
Required | ActionConditionKind |
| PlanDefinition.action.relatedAction.relationship |
Defines the types of relationships between actions. |
Required | ActionRelationshipType |
| PlanDefinition.action.participant.type |
The type of participant for the action. |
Required | ActionParticipantType |
| PlanDefinition.action.participant.role |
Either a practitioner role or a relationship type. Note from UTG import - may have been a temporary entry that subsequently disappeared from the FHIR source; unable to locate. Version set to 0.1.0 |
Example |
ActionParticipantRole
|
| PlanDefinition.action.participant.function | The function performed by the participant for the action. | Example | ActionParticipantFunction |
| PlanDefinition.action.type |
The type of action to be performed. |
Extensible | ActionType |
| PlanDefinition.action.groupingBehavior |
Defines organization behavior of a group. |
Required | ActionGroupingBehavior |
| PlanDefinition.action.selectionBehavior |
Defines selection behavior of a group. |
Required | ActionSelectionBehavior |
| PlanDefinition.action.requiredBehavior |
Defines expectations around whether an action or action group is required. |
Required | ActionRequiredBehavior |
| PlanDefinition.action.precheckBehavior |
Defines selection frequency behavior for an action or group. |
Required | ActionPrecheckBehavior |
| PlanDefinition.action.cardinalityBehavior |
Defines behavior for an action or a group for how many times that item may be repeated. |
Required | ActionCardinalityBehavior |
| PlanDefinition.asNeeded[x] | This value set includes all clinical findings from SNOMED CT - provided as an exemplar value set. | Example | SNOMEDCTMedicationAsNeededReasonCodes |
|
|
Level | Location | Description | Expression |
cnl-0
|
Warning | (base) | Name should be usable as an identifier for the module by machine processing applications such as code generation |
name.exists()
implies
|
pld-0
| Rule | PlanDefinition.action.input | Input data elements must have a requirement or a relatedData, but not both | requirement.exists() xor relatedData.exists() |
pld-1
| Rule | PlanDefinition.action.output | Output data element must have a requirement or a relatedData, but not both | requirement.exists() xor relatedData.exists() |
cnl-1
| Warning | PlanDefinition.url | URL should not contain | or # - these characters make processing canonical references problematic | url.matches('([^|#])*') |
The
following
diagram
illustrates
the
relationship
between
the
PlanDefinition
and
ActivityDefinition
resources,
as
well
as
a
typical
application
realization
to
CarePlan,
RequestGroup,
RequestOrchestration
and
Request
Request-pattern
resources.
The
resources
depicted
on
the
left
side
of
the
arrow
are
definition
resources,
while
the
ones
on
the
right
side
of
the
arrow
are
request
resources,
with
the
arrow
representing
the
$apply
operation:
The PlanDefinition and ActivityDefinition resources support the representation of a broad range of use cases including order sets, flow sheets, event-condition-action rules, clinical protocols, and research trials. To support this range of use cases, as well as the variability in capabilities of systems that use these types of artifacts, this specification is not prescriptive about exactly how these definitions are applied to produce request and event resources. However, the approach depicted above provides a general framework for the process, and the following steps provide more detail on the potential approach:
instantiatesCanonical
element
reference
goal
definitions
in
the
action
element
of
the
PlanDefinition
Processing for each action proceeds according to the following steps:
action
element
in
the
linkId
,
set
the
linkId>
element
of
the
new
action
to
the
same
value.
Note
that
for
legacy
PlanDefinitions,
this
action
linking
was
accomplished
with
the
id
id
element
of
the
newly
created
action
action
to
the
corresponding
elements
of
the
newly
created
action
in
the
title
,
description
,
textEquivalent
,
timing
,
and
so
on
definition
element:
resource
element
of
the
status
intent
of
the
target
resource
to
option
so
that
it
is
clearly
indicated
as
part
of
a
action
(see
the
section
on
Overlap
below
for
details)
resource
element
of
the
status
intent
of
the
action
such
as
title
,
description
,
and
dynamicValue
.
resource
element
of
the
action
to
the
Questionnaire,
indicating
that
the
activity
to
be
performed
is
filling
out
the
given
questionnaire.
The
parameters
to
the
$apply
operation
are
available
within
dynamicValue
CQL
and
FHIRPath
expressions
as
context
variables,
accessible
by
the
name
of
the
parameter
prefixed
with
a
percent
(%)
symbol.
For
example,
to
access
the
subject
given
to
the
apply,
use
the
expression
%subject
.
The
value
of
the
%subject
context
variable
in
a
dynamicValue
expression
is
determined
using
the
current
subject
,
as
specified
by
the
subject
element
on
the
PlanDefinition,
current
PlanDefinition.action,
or
ActivityDefinition.
In
addition
to
the
$apply
operation
parameters,
the
context
variable
%action
can
be
used
within
the
path
element
of
a
dynamicValue
to
specify
the
current
action
target.
For
example,
to
specify
the
path
to
the
description
element
of
the
current
action,
use
%action.description
.
Note that result of this operation is transient (i.e. none of the resources created by the operation are persisted in the server, they are all returned as contained resources in the result). The result effectively represents a proposed set of activities, and it is up to the caller to determine whether and how those activities are actually carried out.
As
noted
in
the
Boundaries
section,
there
is
some
overlap
between
the
content
that
can
be
represented
within
the
action
element
of
a
PlanDefinition,
and
the
elements
of
the
ActivityDefinition
resource.
This
overlap
allows
for
both
resources
to
be
used
independently,
as
well
as
in
combination.
For
example,
a
PlanDefinition
may
be
used
without
any
supporting
ActivityDefinitions
to
describe
a
particular
workflow,
where
it
is
sufficient
to
describe
the
actions
simply
as
textual
descriptions
of
what
needs
to
take
place.
On
the
other
hand,
the
PlanDefinition
may
be
used
together
with
ActivityDefinition
to
provide
a
detailed
structural
representation
of
the
activities
to
be
performed.
In
general,
where
there
is
overlap,
the
elements
from
the
PlanDefinition
provide
overriding
behavior.
Specifically,
the
following
elements
of
action
overlap
with
ActivityDefinition:
| Element | Behavior |
|---|---|
| title |
The
title
element
in
ActivityDefinition
is
the
title
of
the
activity
"as
defined",
where
the
title
element
in
PlanDefinition
reflects
the
title
in
the
scope
of
the
plan.
|
| description |
The
description
element
in
ActivityDefinition
is
the
description
of
the
activity
"as
defined",
where
the
description
element
in
PlanDefinition
reflects
the
description
in
the
scope
of
the
plan.
|
| code |
The
code
element
in
ActivityDefinition
represents
the
meaning
of
the
activity
"as
defined",
where
the
code
element
in
PlanDefinition
represents
the
meaning
in
the
scope
of
the
plan.
|
| documentation |
The
documentation
element
in
PlanDefinition
represents
additional
documentation
for
the
action
specific
to
the
scope
of
the
plan,
where
the
relatedArtifact
element
in
ActivityDefinition
provides
documentation
specific
to
the
activity
itself.
|
| timing |
The
timing
element
in
ActivityDefinition
represents
timings
associated
within
the
activity
itself,
where
the
timing
element
in
PlanDefinition
represents
the
timing
of
the
activity
with
respect
to
the
plan
and
its
other
actions.
When
a
timing
is
provided
on
both,
the
timing
defined
in
the
plan
generally
takes
precedence.
|
| asNeeded |
The
asNeeded
element
allows
pre-conditions
to
be
associated
with
an
action
or
activity.
When
asNeeded
is
specified
on
both,
the
value
specified
in
the
plan
generally
takes
precedence.
|
| participant |
The
participant
element
in
ActivityDefinition
represents
what
type
of
actor
is
expected
to
perform
the
activity
generally,
where
the
participant
element
in
PlanDefinition
represents
the
type
of
actor
that
is
expected
to
perform
the
activity
in
the
context
of
the
plan.
|
| transform |
The
transform
element
in
ActivityDefinition
describes
the
transformation
of
the
definition
to
a
request
or
event
resource
in
general,
where
the
transform
element
in
PlanDefinition
describes
the
transformation
within
the
scope
of
the
plan.
When
a
transform
is
present
in
both,
the
transform
in
the
plan
takes
precedence.
|
| dynamicValue |
The
dynamicValue
element
in
ActivityDefinition
defines
values
for
elements
of
the
target
request
or
event
resource
in
general,
where
the
dynamicValue
element
in
PlanDefinition
defines
values
within
the
scope
of
the
plan.
When
dynamic
values
are
present
in
both,
the
dynamic
values
from
the
ActivityDefinition
are
applied
first
(in
the
order
in
which
they
appear
on
the
ActivityDefinition),
followed
by
the
dynamic
values
from
the
PlanDefinition
(in
the
order
in
which
they
appear
on
the
PlanDefinition).
|
Search parameters for this resource. The common parameters also apply. See Searching for more information about searching in REST, messaging, and services.
| Name | Type | Description | Expression | In Common |
| composed-of | reference | What resource is being referenced |
PlanDefinition.relatedArtifact.where(type='composed-of').resource
(Any) |
6 Resources |
| context | token | A use context assigned to the plan definition | (PlanDefinition.useContext.value as CodeableConcept) | 30 Resources |
| context-quantity | quantity | A quantity- or range-valued use context assigned to the plan definition | (PlanDefinition.useContext.value as Quantity) | (PlanDefinition.useContext.value as Range) | 30 Resources |
| context-type | token | A type of use context assigned to the plan definition | PlanDefinition.useContext.code | 30 Resources |
| context-type-quantity | composite | A use context type and quantity- or range-based value assigned to the plan definition |
On
PlanDefinition.useContext:
context-type: code context-quantity: |
30 Resources |
| context-type-value | composite | A use context type and value assigned to the plan definition |
On
PlanDefinition.useContext:
context-type: code context: |
30 Resources |
|
date
|
date | The plan definition publication date | PlanDefinition.date | 30 Resources |
| definition | reference | Activity or plan definitions used by plan definition |
( SpecimenDefinition , Questionnaire , ObservationDefinition , PlanDefinition , ActivityDefinition ) |
|
| depends-on | reference | What resource is being referenced |
PlanDefinition.relatedArtifact.where(type='depends-on').resource
|
PlanDefinition.library
( Library , Any) |
6 Resources |
| derived-from | reference | What resource is being referenced |
PlanDefinition.relatedArtifact.where(type='derived-from').resource
(Any) |
10 Resources |
|
description
|
string | The description of the plan definition | PlanDefinition.description | 28 Resources |
| effective | date | The time during which the plan definition is intended to be in use | PlanDefinition.effectivePeriod | 12 Resources |
| identifier | token | External identifier for the plan definition | PlanDefinition.identifier | 28 Resources |
| jurisdiction | token | Intended jurisdiction for the plan definition | PlanDefinition.jurisdiction | 26 Resources |
|
name
|
string | Computationally friendly name of the plan definition | PlanDefinition.name | 26 Resources |
| predecessor | reference | What resource is being referenced |
PlanDefinition.relatedArtifact.where(type='predecessor').resource
(Any) |
10 Resources |
|
publisher
|
string | Name of the publisher of the plan definition | PlanDefinition.publisher | 30 Resources |
|
status
|
token | The current status of the plan definition | PlanDefinition.status | 34 Resources |
| successor | reference | What resource is being referenced |
PlanDefinition.relatedArtifact.where(type='successor').resource
(Any) |
6 Resources |
|
title
|
string | The human-friendly name of the plan definition | PlanDefinition.title | 27 Resources |
| topic | token | Topics associated with the module | PlanDefinition.topic | 10 Resources |
| type | token | The type of artifact the plan (e.g. order-set, eca-rule, protocol) | PlanDefinition.type | |
|
url
|
uri | The uri that identifies the plan definition | PlanDefinition.url | 33 Resources |
|
version
|
token | The business version of the plan definition | PlanDefinition.version | 30 Resources |