This
page
is
part
of
the
FHIR
Specification
(v3.0.2:
(v4.0.1:
R4
-
Mixed
Normative
and
STU
3).
)
in
it's
permanent
home
(it
will
always
be
available
at
this
URL).
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
R4
R3
Clinical
Decision
Support
Work
Group
|
Maturity Level : 2 | Trial Use | Security Category : Patient | Compartments : Not linked to any defined compartments |
A guidance response is the formal response to a guidance request, including any output parameters returned by the evaluation, as well as the description of any proposed actions to be taken.
The
GuidanceResponse
resource
is
used
to
represent
the
result
of
invoking
a
decision
support
service.
It
provides
a
container
for
the
status
of
the
response,
any
warnings
or
messages
returned
by
the
service,
as
well
as
the
any
output
data
of
from
the
module
service
and
any
suggested
actions
to
be
performed.
For
Use
cases
for
the
GuidanceResponse
resource
include:
In
addition,
the
functionality
provided
by
the
CDS
Hooks
specification.
As
part
of
FHIR
Release
4,
it
GuidanceResponse
resource
is
the
intention
to
unify
aligned
with
the
CDS
Hooks
specification
with
the
Clinical
Reasoning
module,
ensuring
that
implementers
have
response
structure
and
so
provides
a
single
consistent
mechanism
to
support
this
use
case
that
meets
record
the
requirements
results
of
both
the
Clinical
Quality
Framework
and
CDS
Hooks
communities.
Although
interactions.
For
a
detailed
discussion
of
how
the
functionality
in
both
specifications
is
conceptually
aligned,
this
unification
will
likely
result
in
changes
to
both
specifications.
The
CQF
and
CDS
Hooks
project
teams
are
committed
to
GuidanceResponse
resource
can
be
used
for
this
unification
and
will
work
purpose,
refer
to
ensure
that
the
resulting
changes
have
as
little
impact
as
possible
on
current
and
ongoing
implementation
efforts,
while
meeting
the
needs
of
both
communities.
The
project
team
is
planning
on
a
workable
implementation
tested
at
the
connectathon
in
May
of
2017,
with
a
trial
ballot
following
Evaluation
topic
in
September
2017,
targeting
publication
as
part
of
the
FHIR
Release
4
specification.
Clinical
Reasoning
module.
Structure
| Name | Flags | Card. | Type |
Description
&
Constraints
|
|---|---|---|---|---|
|
TU | DomainResource |
The
formal
response
to
a
guidance
request
Elements defined in Ancestors: id , meta , implicitRules , language , text , contained , extension , modifierExtension |
|
|
Σ | 0..1 |
|
The
|
|
Σ |
|
Identifier |
Business
identifier
|
|
Σ | 1..1 | What guidance was requested | |
![]() ![]() ![]() |
|
|
uri
|
|
| canonical () | |||
| CodeableConcept | |||
|
?! Σ | 1..1 | code |
success
|
data-requested
|
data-required
|
in-progress
|
failure
|
entered-in-error
GuidanceResponseStatus ( Required ) |
|
0..1 | Reference ( Patient | Group ) | Patient the request was performed for | |
|
0..1 |
Reference
(
Encounter
|
Encounter
|
|
|
0..1 | dateTime | When the guidance response was processed | |
|
0..1 | Reference ( Device ) | Device returning the guidance | |
|
|
0..* | CodeableConcept |
Why
guidance
is
needed
|
|
0..* |
Reference
(
|
Why
guidance
is
needed
|
|
|
0..* | Annotation |
Additional
notes
about
the
response
|
|
|
0..* | Reference ( OperationOutcome ) |
Messages
resulting
from
the
evaluation
of
the
artifact
or
artifacts
|
|
|
0..1 | Reference ( Parameters ) | The output parameters of the evaluation, if any | |
|
0..1 | Reference ( CarePlan | RequestGroup ) | Proposed actions, if any | |
|
0..* | DataRequirement |
Additional
required
data
|
|
Documentation
for
this
format
|
||||
UML Diagram ( Legend )
XML Template
<<GuidanceResponse xmlns="http://hl7.org/fhir"><!-- from Resource: id, meta, implicitRules, and language --> <!-- from DomainResource: text, contained, extension, and modifierExtension -->
< <</identifier> <</module> <<requestIdentifier><!-- 0..1 Identifier The identifier of the request associated with this response, if any --></requestIdentifier> <identifier><!-- 0..* Identifier Business identifier --></identifier> <module[x]><!-- 1..1 uri|canonical|CodeableConcept What guidance was requested --></module[x]> <status value="[code]"/><!-- 1..1 success | data-requested | data-required | in-progress | failure | entered-in-error --> <subject><!-- 0..1 Reference(Patient|Group) Patient the request was performed for --></subject><</context> <<encounter><!-- 0..1 Reference(Encounter) Encounter during which the response was returned --></encounter> <occurrenceDateTime value="[dateTime]"/><!-- 0..1 When the guidance response was processed --> <performer><!-- 0..1 Reference(Device) Device returning the guidance --></performer><</reason[x]><reasonCode><!-- 0..* CodeableConcept Why guidance is needed --></reasonCode> <reasonReference><!-- 0..* Reference(Condition|Observation|DiagnosticReport| DocumentReference) Why guidance is needed --></reasonReference> <note><!-- 0..* Annotation Additional notes about the response --></note> <evaluationMessage><!-- 0..* Reference(OperationOutcome) Messages resulting from the evaluation of the artifact or artifacts --></evaluationMessage> <outputParameters><!-- 0..1 Reference(Parameters) The output parameters of the evaluation, if any --></outputParameters> <result><!-- 0..1 Reference(CarePlan|RequestGroup) Proposed actions, if any --></result> <dataRequirement><!-- 0..* DataRequirement Additional required data --></dataRequirement> </GuidanceResponse>
JSON Template
{
"resourceType" : "",
"resourceType" : "GuidanceResponse",
// from Resource: id, meta, implicitRules, and language
// from DomainResource: text, contained, extension, and modifierExtension
"
"
"
"
"
"
"
"
" },
" },
"
"
"
"
"
"requestIdentifier" : { Identifier }, // The identifier of the request associated with this response, if any
"identifier" : [{ Identifier }], // Business identifier
// module[x]: What guidance was requested. One of these 3:
"moduleUri" : "<uri>",
"moduleCanonical" : "<canonical>",
"moduleCodeableConcept" : { CodeableConcept },
"status" : "<code>", // R! success | data-requested | data-required | in-progress | failure | entered-in-error
"subject" : { Reference(Patient|Group) }, // Patient the request was performed for
"encounter" : { Reference(Encounter) }, // Encounter during which the response was returned
"occurrenceDateTime" : "<dateTime>", // When the guidance response was processed
"performer" : { Reference(Device) }, // Device returning the guidance
"reasonCode" : [{ CodeableConcept }], // Why guidance is needed
"reasonReference" : [{ Reference(Condition|Observation|DiagnosticReport|
DocumentReference) }], // Why guidance is needed
"note" : [{ Annotation }], // Additional notes about the response
"evaluationMessage" : [{ Reference(OperationOutcome) }], // Messages resulting from the evaluation of the artifact or artifacts
"outputParameters" : { Reference(Parameters) }, // The output parameters of the evaluation, if any
"result" : { Reference(CarePlan|RequestGroup) }, // Proposed actions, if any
"dataRequirement" : [{ DataRequirement }] // Additional required data
}
Turtle Template
@prefix fhir: <http://hl7.org/fhir/> .[ a fhir:GuidanceResponse; 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: fhir:fhir:GuidanceResponse.requestIdentifier [ Identifier ]; # 0..1 The identifier of the request associated with this response, if any fhir:GuidanceResponse.identifier [ Identifier ], ... ; # 0..* Business identifier # GuidanceResponse.module[x] : 1..1 What guidance was requested. One of these 3 fhir:GuidanceResponse.moduleUri [ uri ] fhir:GuidanceResponse.moduleCanonical [ canonical ] fhir:GuidanceResponse.moduleCodeableConcept [ CodeableConcept ] fhir:GuidanceResponse.status [ code ]; # 1..1 success | data-requested | data-required | in-progress | failure | entered-in-error fhir:GuidanceResponse.subject [ Reference(Patient|Group) ]; # 0..1 Patient the request was performed forfhir:fhir:GuidanceResponse.encounter [ Reference(Encounter) ]; # 0..1 Encounter during which the response was returned fhir:GuidanceResponse.occurrenceDateTime [ dateTime ]; # 0..1 When the guidance response was processed fhir:GuidanceResponse.performer [ Reference(Device) ]; # 0..1 Device returning the guidance# . One of these 2 fhir: ] fhir:) ]fhir:GuidanceResponse.reasonCode [ CodeableConcept ], ... ; # 0..* Why guidance is needed fhir:GuidanceResponse.reasonReference [ Reference(Condition|Observation|DiagnosticReport|DocumentReference) ], ... ; # 0..* Why guidance is needed fhir:GuidanceResponse.note [ Annotation ], ... ; # 0..* Additional notes about the response fhir:GuidanceResponse.evaluationMessage [ Reference(OperationOutcome) ], ... ; # 0..* Messages resulting from the evaluation of the artifact or artifacts fhir:GuidanceResponse.outputParameters [ Reference(Parameters) ]; # 0..1 The output parameters of the evaluation, if any fhir:GuidanceResponse.result [ Reference(CarePlan|RequestGroup) ]; # 0..1 Proposed actions, if any fhir:GuidanceResponse.dataRequirement [ DataRequirement ], ... ; # 0..* Additional required data ]
Changes
since
DSTU2
R3
| GuidanceResponse | |
| GuidanceResponse.requestIdentifier |
|
| GuidanceResponse.identifier |
|
| GuidanceResponse.module[x] |
|
| GuidanceResponse.status |
|
| GuidanceResponse.encounter |
|
| GuidanceResponse.reasonCode |
|
| GuidanceResponse.reasonReference |
|
| GuidanceResponse.context |
|
| GuidanceResponse.reason[x] |
|
This
resource
did
not
exist
in
Release
2
See
the
Full
Difference
for
further
information
This analysis is available as XML or JSON .
See R3 <--> R4 Conversion Maps (status = 1 test that all execute ok. All tests pass round-trip testing and all r3 resources are valid.)
Structure
| Name | Flags | Card. | Type |
Description
&
Constraints
|
|---|---|---|---|---|
|
TU | DomainResource |
The
formal
response
to
a
guidance
request
Elements defined in Ancestors: id , meta , implicitRules , language , text , contained , extension , modifierExtension |
|
|
Σ | 0..1 |
|
The
|
|
Σ |
|
Identifier |
Business
identifier
|
|
Σ | 1..1 | What guidance was requested | |
![]() ![]() ![]() |
|
|
uri
|
|
| canonical () | |||
| CodeableConcept | |||
|
?! Σ | 1..1 | code |
success
|
data-requested
|
data-required
|
in-progress
|
failure
|
entered-in-error
GuidanceResponseStatus ( Required ) |
|
0..1 | Reference ( Patient | Group ) | Patient the request was performed for | |
|
0..1 |
Reference
(
Encounter
|
Encounter
|
|
|
0..1 | dateTime | When the guidance response was processed | |
|
0..1 | Reference ( Device ) | Device returning the guidance | |
|
|
0..* | CodeableConcept |
Why
guidance
is
needed
|
|
0..* |
Reference
(
|
Why
guidance
is
needed
|
|
|
0..* | Annotation |
Additional
notes
about
the
response
|
|
|
0..* | Reference ( OperationOutcome ) |
Messages
resulting
from
the
evaluation
of
the
artifact
or
artifacts
|
|
|
0..1 | Reference ( Parameters ) | The output parameters of the evaluation, if any | |
|
0..1 | Reference ( CarePlan | RequestGroup ) | Proposed actions, if any | |
|
0..* | DataRequirement |
Additional
required
data
|
|
Documentation
for
this
format
|
||||
XML Template
<<GuidanceResponse xmlns="http://hl7.org/fhir"><!-- from Resource: id, meta, implicitRules, and language --> <!-- from DomainResource: text, contained, extension, and modifierExtension -->
< <</identifier> <</module> <<requestIdentifier><!-- 0..1 Identifier The identifier of the request associated with this response, if any --></requestIdentifier> <identifier><!-- 0..* Identifier Business identifier --></identifier> <module[x]><!-- 1..1 uri|canonical|CodeableConcept What guidance was requested --></module[x]> <status value="[code]"/><!-- 1..1 success | data-requested | data-required | in-progress | failure | entered-in-error --> <subject><!-- 0..1 Reference(Patient|Group) Patient the request was performed for --></subject><</context> <<encounter><!-- 0..1 Reference(Encounter) Encounter during which the response was returned --></encounter> <occurrenceDateTime value="[dateTime]"/><!-- 0..1 When the guidance response was processed --> <performer><!-- 0..1 Reference(Device) Device returning the guidance --></performer><</reason[x]><reasonCode><!-- 0..* CodeableConcept Why guidance is needed --></reasonCode> <reasonReference><!-- 0..* Reference(Condition|Observation|DiagnosticReport| DocumentReference) Why guidance is needed --></reasonReference> <note><!-- 0..* Annotation Additional notes about the response --></note> <evaluationMessage><!-- 0..* Reference(OperationOutcome) Messages resulting from the evaluation of the artifact or artifacts --></evaluationMessage> <outputParameters><!-- 0..1 Reference(Parameters) The output parameters of the evaluation, if any --></outputParameters> <result><!-- 0..1 Reference(CarePlan|RequestGroup) Proposed actions, if any --></result> <dataRequirement><!-- 0..* DataRequirement Additional required data --></dataRequirement> </GuidanceResponse>
JSON Template
{
"resourceType" : "",
"resourceType" : "GuidanceResponse",
// from Resource: id, meta, implicitRules, and language
// from DomainResource: text, contained, extension, and modifierExtension
"
"
"
"
"
"
"
"
" },
" },
"
"
"
"
"
"requestIdentifier" : { Identifier }, // The identifier of the request associated with this response, if any
"identifier" : [{ Identifier }], // Business identifier
// module[x]: What guidance was requested. One of these 3:
"moduleUri" : "<uri>",
"moduleCanonical" : "<canonical>",
"moduleCodeableConcept" : { CodeableConcept },
"status" : "<code>", // R! success | data-requested | data-required | in-progress | failure | entered-in-error
"subject" : { Reference(Patient|Group) }, // Patient the request was performed for
"encounter" : { Reference(Encounter) }, // Encounter during which the response was returned
"occurrenceDateTime" : "<dateTime>", // When the guidance response was processed
"performer" : { Reference(Device) }, // Device returning the guidance
"reasonCode" : [{ CodeableConcept }], // Why guidance is needed
"reasonReference" : [{ Reference(Condition|Observation|DiagnosticReport|
DocumentReference) }], // Why guidance is needed
"note" : [{ Annotation }], // Additional notes about the response
"evaluationMessage" : [{ Reference(OperationOutcome) }], // Messages resulting from the evaluation of the artifact or artifacts
"outputParameters" : { Reference(Parameters) }, // The output parameters of the evaluation, if any
"result" : { Reference(CarePlan|RequestGroup) }, // Proposed actions, if any
"dataRequirement" : [{ DataRequirement }] // Additional required data
}
Turtle Template
@prefix fhir: <http://hl7.org/fhir/> .[ a fhir:GuidanceResponse; 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: fhir:fhir:GuidanceResponse.requestIdentifier [ Identifier ]; # 0..1 The identifier of the request associated with this response, if any fhir:GuidanceResponse.identifier [ Identifier ], ... ; # 0..* Business identifier # GuidanceResponse.module[x] : 1..1 What guidance was requested. One of these 3 fhir:GuidanceResponse.moduleUri [ uri ] fhir:GuidanceResponse.moduleCanonical [ canonical ] fhir:GuidanceResponse.moduleCodeableConcept [ CodeableConcept ] fhir:GuidanceResponse.status [ code ]; # 1..1 success | data-requested | data-required | in-progress | failure | entered-in-error fhir:GuidanceResponse.subject [ Reference(Patient|Group) ]; # 0..1 Patient the request was performed forfhir:fhir:GuidanceResponse.encounter [ Reference(Encounter) ]; # 0..1 Encounter during which the response was returned fhir:GuidanceResponse.occurrenceDateTime [ dateTime ]; # 0..1 When the guidance response was processed fhir:GuidanceResponse.performer [ Reference(Device) ]; # 0..1 Device returning the guidance# . One of these 2 fhir: ] fhir:) ]fhir:GuidanceResponse.reasonCode [ CodeableConcept ], ... ; # 0..* Why guidance is needed fhir:GuidanceResponse.reasonReference [ Reference(Condition|Observation|DiagnosticReport|DocumentReference) ], ... ; # 0..* Why guidance is needed fhir:GuidanceResponse.note [ Annotation ], ... ; # 0..* Additional notes about the response fhir:GuidanceResponse.evaluationMessage [ Reference(OperationOutcome) ], ... ; # 0..* Messages resulting from the evaluation of the artifact or artifacts fhir:GuidanceResponse.outputParameters [ Reference(Parameters) ]; # 0..1 The output parameters of the evaluation, if any fhir:GuidanceResponse.result [ Reference(CarePlan|RequestGroup) ]; # 0..1 Proposed actions, if any fhir:GuidanceResponse.dataRequirement [ DataRequirement ], ... ; # 0..* Additional required data ]
Changes
since
DSTU2
Release
3
| GuidanceResponse | |
| GuidanceResponse.requestIdentifier |
|
| GuidanceResponse.identifier |
|
| GuidanceResponse.module[x] |
|
| GuidanceResponse.status |
|
| GuidanceResponse.encounter |
|
| GuidanceResponse.reasonCode |
|
| GuidanceResponse.reasonReference |
|
| GuidanceResponse.context |
|
| GuidanceResponse.reason[x] |
|
This
resource
did
not
exist
in
Release
2
See
the
Full
Difference
for
further
information
This analysis is available as XML or JSON .
See R3 <--> R4 Conversion Maps (status = 1 test that all execute ok. All tests pass round-trip testing and all r3 resources are valid.)
Alternate
See
the
Profiles
&
Extensions
and
the
alternate
definitions:
Master
Definition
(
XML
,
+
JSON
),
,
XML
Schema
/
Schematron
(for
)
+
JSON
Schema
,
ShEx
(for
Turtle
)
+
see
the
extensions
&
the
dependency
analysis
| Path | Definition | Type | Reference |
|---|---|---|---|
| GuidanceResponse.status |
The
status
of
a
guidance
|
Required | GuidanceResponseStatus |
Although
the
GuidanceResponse
resource
does
define
search
parameters,
it
is
up
to
the
individual
decision
support
service
whether
or
not
historical
records
of
guidance
requests
are
preserved.
A
service
may
might
not
support
searching
on
GuidanceResponses
at
all,
or
it
may
support
searching
only
for
a
pre-defined
expiration
period.
The
search
parameters
are
defined
to
provide
consumers
with
a
consistent
interface
to
searching
if
it
is
available
for
a
specific
service
implementation.
In
any
case,
services
should
detail
the
support
they
do
provide
using
a
CapabilityStatement.
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 |
| identifier | token | The identifier of the guidance response | GuidanceResponse.identifier | |
| patient | reference | The identity of a patient to search for guidance response results |
( Patient ) |
|
| request | token | The identifier of the request associated with the response |
|
|
| subject | reference | The subject that the guidance response is about |
GuidanceResponse.subject
( Group , Patient ) |