This page is part of the FHIR Specification (v1.6.0: STU 3 Ballot 4). 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
Detailed Descriptions for the elements in the GuidanceResponse resource.
GuidanceResponse | |
Definition | 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. |
Control | 1..1 |
GuidanceResponse.requestId | |
Definition | The id of the request associated with this response. If an id was given as part of the request, it will be reproduced here to enable the requester to more easily identify the response in a multi-request scenario. |
Control | 0..1 |
Type | id |
GuidanceResponse.identifier | |
Definition | Allows a service to provide a unique, business identifier for the response. |
Note | This is a business identifer, not a resource identifier (see discussion) |
Control | 0..1 |
Type | Identifier |
Summary | true |
GuidanceResponse.module | |
Definition | A reference to the knowledge module that was invoked. |
Control | 1..1 |
Type | Reference(DecisionSupportServiceModule) |
Is Modifier | true |
Summary | true |
GuidanceResponse.status | |
Definition | The status of the response. If the evaluation is completed successfully, the status will indicate success. However, in order to complete the evaluation, the engine may require more information. In this case, the status will be data-required, and the response will contain a description of the additional required information. If the evaluation completed successfully, but the engine determines that a potentially more accurate response could be provided if more data was available, the status will be data-requested, and the response will contain a description of the additional requested information. |
Control | 1..1 |
Binding | GuidanceResponseStatus: The status of a guidance response (Required) |
Type | code |
Is Modifier | true |
Summary | true |
GuidanceResponse.subject | |
Definition | The patient for which the request was processed. |
Control | 0..1 |
Type | Reference(Patient | Group) |
GuidanceResponse.context | |
Definition | Allows the context of the guidance response to be provided if available. In a service context, this would likely be unavailable. |
Control | 0..1 |
Type | Reference(Encounter | EpisodeOfCare) |
GuidanceResponse.occurrenceDateTime | |
Definition | Indicates when the guidance response was processed. |
Control | 0..1 |
Type | dateTime |
GuidanceResponse.performer | |
Definition | Provides a reference to the device that performed the guidance. |
Control | 0..1 |
Type | Reference(Device) |
GuidanceResponse.reason[x] | |
Definition | Indicates the reason the request was initiated. This is typically provided as a parameter to the evaluation and echoed by the service, although for some use cases, such as subscription- or event-based scenarios, it may provide an indication of the cause for the response. |
Control | 0..1 |
Type | CodeableConcept|Reference(Any) |
[x] Note | See Choice of Data Types for further information about how to use [x] |
GuidanceResponse.note | |
Definition | Provides a mechanism to communicate additional information about the response. |
Control | 0..* |
Type | Annotation |
GuidanceResponse.evaluationMessage | |
Definition | Messages resulting from the evaluation of the artifact or artifacts. As part of evaluating the request, the engine may produce informational or warning messages. These messages will be provided by this element. |
Control | 0..* |
Type | Reference(OperationOutcome) |
GuidanceResponse.outputParameters | |
Definition | The output parameters of the evaluation, if any. Many modules will result in the return of specific resources such as procedure or communication requests that are returned as part of the operation result. However, modules may define specific outputs that would be returned as the result of the evaluation, and these would be returned in this element. |
Control | 0..1 |
Type | Reference(Parameters) |
GuidanceResponse.action | |
Definition | The actions, if any, produced by the evaluation of the artifact. |
Control | 0..* |
GuidanceResponse.action.actionIdentifier | |
Definition | A unique identifier for the action. The identifier SHALL be unique within the container in which it appears, and MAY be universally unique. |
Control | 0..1 |
Type | Identifier |
GuidanceResponse.action.label | |
Definition | A user-visible label for the action. |
Control | 0..1 |
Type | string |
GuidanceResponse.action.title | |
Definition | The title of the action displayed to a user. |
Control | 0..1 |
Type | string |
GuidanceResponse.action.description | |
Definition | A short description of the action used to provide a summary to display to the user. |
Control | 0..1 |
Type | string |
GuidanceResponse.action.textEquivalent | |
Definition | A text equivalent of the action to be performed. This provides a human-interpretable description of the action when the definition is consumed by a system that may not be capable of interpreting it dynamically. |
Control | 0..1 |
Type | string |
GuidanceResponse.action.concept | |
Definition | The concept represented by this action or its sub-actions. |
Control | 0..* |
Type | CodeableConcept |
GuidanceResponse.action.documentation | |
Definition | Didactic or other informational resources associated with the action that can be provided to the CDS recipient. Information resources can include inline text commentary and links to web resources. |
Control | 0..* |
Type | RelatedResource |
GuidanceResponse.action.relatedAction | |
Definition | A relationship to another action such as "before" or "30-60 minutes after start of". |
Control | 0..1 |
GuidanceResponse.action.relatedAction.actionIdentifier | |
Definition | The unique identifier of the related action. |
Control | 1..1 |
Type | Identifier |
GuidanceResponse.action.relatedAction.relationship | |
Definition | The relationship of this action to the related action. |
Control | 1..1 |
Binding | PlanActionRelationshipType: Defines the types of relationships between actions (Required) |
Type | code |
GuidanceResponse.action.relatedAction.offset[x] | |
Definition | A duration or range of durations to apply to the relationship. For example, 30-60 minutes before. |
Control | 0..1 |
Type | Duration|Range |
[x] Note | See Choice of Data Types for further information about how to use [x] |
GuidanceResponse.action.relatedAction.anchor | |
Definition | An optional indicator for how the relationship is anchored to the related action. For example "before the start" or "before the end" of the related action. |
Control | 0..1 |
Binding | PlanActionRelationshipAnchor: Defines possible anchors for the relationship between actions (Required) |
Type | code |
GuidanceResponse.action.timing[x] | |
Definition | An optional value describing when the action should be performed. |
Control | 0..1 |
Type | dateTime|Period|Duration|Range |
[x] Note | See Choice of Data Types for further information about how to use [x] |
GuidanceResponse.action.participant | |
Definition | The participant in the action. |
Control | 0..* |
Type | Reference(Patient | Person | Practitioner | RelatedPerson) |
GuidanceResponse.action.type | |
Definition | The type of action to perform (create, update, remove). |
Control | 0..1 |
Binding | PlanActionType: The type of action to be performed (Extensible) |
Type | Coding |
GuidanceResponse.action.groupingBehavior | |
Definition | Defines the grouping behavior for the action and its children. |
Control | 0..1 |
Binding | PlanActionGroupingBehavior: Defines organization behavior of a group (Required) |
Type | code |
GuidanceResponse.action.selectionBehavior | |
Definition | Defines the selection behavior for the action and its children. |
Control | 0..1 |
Binding | PlanActionSelectionBehavior: Defines selection behavior of a group (Required) |
Type | code |
GuidanceResponse.action.requiredBehavior | |
Definition | Defines the requiredness behavior for the action. |
Control | 0..1 |
Binding | PlanActionRequiredBehavior: Defines requiredness behavior for selecting an action or an action group (Required) |
Type | code |
GuidanceResponse.action.precheckBehavior | |
Definition | Defines whether the action should usually be preselected. |
Control | 0..1 |
Binding | PlanActionPrecheckBehavior: Defines selection frequency behavior for an action or group (Required) |
Type | code |
GuidanceResponse.action.cardinalityBehavior | |
Definition | Defines whether the action can be selected multiple times. |
Control | 0..1 |
Binding | PlanActionCardinalityBehavior: Defines behavior for an action or a group for how many times that item may be repeated (Required) |
Type | code |
GuidanceResponse.action.resource | |
Definition | The resource that is the target of the action (e.g. CommunicationRequest). |
Control | 0..1 |
Type | Reference(Any) |
GuidanceResponse.action.action | |
Definition | Sub actions. |
Control | 0..* |
Type | See GuidanceResponse.action |
GuidanceResponse.dataRequirement | |
Definition | If the evaluation could not be completed due to lack of information, or additional information would potentially result in a more accurate response, this element will a description of the data required in order to proceed with the evaluation. A subsequent request to the service should include this data. |
Control | 0..* |
Type | DataRequirement |