Release 5 Draft Ballot

This page is part of the FHIR Specification (v4.6.0: R5 Draft Ballot - see ballot notes). 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: R4B R4 R3

Clinical Decision Support Work GroupMaturity Level: 2 Trial UseSecurity Category: Business Compartments: Device, Encounter, Patient, Practitioner, RelatedPerson

Detailed Descriptions for the elements in the RequestGroup resource.

RequestGroup
Element IdRequestGroup
Definition

A group of related requests that can be used to capture intended activities that have inter-dependencies such as "give this medication after that one".

Cardinality0..*
TypeDomainResource
Summaryfalse
RequestGroup.identifier
Element IdRequestGroup.identifier
Definition

Allows a service to provide a unique, business identifier for the request.

NoteThis is a business identifier, not a resource identifier (see discussion)
Cardinality0..*
TypeIdentifier
Requirements

Allows identification of the request as it is known by various participating systems and in a way that remains consistent across servers.

Summarytrue
RequestGroup.instantiatesCanonical
Element IdRequestGroup.instantiatesCanonical
Definition

A canonical URL referencing a FHIR-defined protocol, guideline, orderset or other definition that is adhered to in whole or in part by this request.

Cardinality0..*
Typecanonical
Summarytrue
RequestGroup.instantiatesUri
Element IdRequestGroup.instantiatesUri
Definition

A URL referencing an externally defined protocol, guideline, orderset or other definition that is adhered to in whole or in part by this request.

Cardinality0..*
Typeuri
Summarytrue
RequestGroup.basedOn
Element IdRequestGroup.basedOn
Definition

A plan, proposal or order that is fulfilled in whole or in part by this request.

Cardinality0..*
TypeReference(Any)
Requirements

Allows tracing of authorization for the request and tracking whether proposals/recommendations were acted upon.

Alternate Namesfulfills
Summaryfalse
RequestGroup.replaces
Element IdRequestGroup.replaces
Definition

Completed or terminated request(s) whose function is taken by this new request.

Cardinality0..*
TypeReference(Any)
Requirements

Allows tracing the continuation of a therapy or administrative process instantiated through multiple requests.

Alternate Namessupersedes; prior; renewed order
Summaryfalse
Comments

The replacement could be because the initial request was immediately rejected (due to an issue) or because the previous request was completed, but the need for the action described by the request remains ongoing.

RequestGroup.groupIdentifier
Element IdRequestGroup.groupIdentifier
Definition

A shared identifier common to all requests that were authorized more or less simultaneously by a single author, representing the identifier of the requisition, prescription or similar form.

Cardinality0..1
TypeIdentifier
Requirements

Some business processes need to know if multiple items were ordered as part of the same "prescription" or "requisition" for billing or other purposes.

Alternate Namesgrouperid; requisition
Summarytrue
Comments

Requests are linked either by a "basedOn" relationship (i.e. one request is fulfilling another) or by having a common requisition. Requests that are part of the same requisition are generally treated independently from the perspective of changing their state or maintaining them after initial creation.

RequestGroup.status
Element IdRequestGroup.status
Definition

The current state of the request. For request groups, the status reflects the status of all the requests in the group.

Cardinality1..1
Terminology BindingRequestStatus (Required)
Typecode
Is Modifiertrue (Reason: This element is labeled as a modifier because it is a status element that contains status entered-in-error which means that the resource should not be treated as valid)
Summarytrue
RequestGroup.intent
Element IdRequestGroup.intent
Definition

Indicates the level of authority/intentionality associated with the request and where the request fits into the workflow chain.

Cardinality1..1
Terminology BindingRequestIntent (Required)
Typecode
Is Modifiertrue (Reason: This element changes the interpretation of all descriptive attributes. For example "the time the request is recommended to occur" vs. "the time the request is authorized to occur" or "who is recommended to perform the request" vs. "who is authorized to perform the request)
Requirements

Proposals/recommendations, plans and orders all use the same structure and can exist in the same fulfillment chain.

Alternate Namescategory
Summarytrue
RequestGroup.priority
Element IdRequestGroup.priority
Definition

Indicates how quickly the request should be addressed with respect to other requests.

Cardinality0..1
Terminology BindingRequestPriority (Required)
Typecode
Meaning if MissingIf missing, this request should be performed with normal priority
Summarytrue
RequestGroup.code
Element IdRequestGroup.code
Definition

A code that identifies what the overall request group is.

Cardinality0..1
Terminology BindingActionCode (Example)
TypeCodeableConcept
Summarytrue
Comments

This element can be used to provide a code that captures the meaning of the request group as a whole, as opposed to the code of the action element, which captures the meaning of the individual actions within the request group.

RequestGroup.subject
Element IdRequestGroup.subject
Definition

The subject for which the request group was created.

Cardinality0..1
TypeReference(Patient | Group)
PatternsReference(Patient,Group): Common patterns = Participant
Summaryfalse
RequestGroup.encounter
Element IdRequestGroup.encounter
Definition

Describes the context of the request group, if any.

Cardinality0..1
TypeReference(Encounter)
Summaryfalse
RequestGroup.authoredOn
Element IdRequestGroup.authoredOn
Definition

Indicates when the request group was created.

Cardinality0..1
TypedateTime
Summaryfalse
RequestGroup.author
Element IdRequestGroup.author
Definition

Provides a reference to the author of the request group.

Cardinality0..1
TypeReference(Device | Practitioner | PractitionerRole)
PatternsReference(Device,Practitioner,PractitionerRole): Common patterns = Participant
Summaryfalse
RequestGroup.reason
Element IdRequestGroup.reason
Definition

Describes the reason for the request group in coded or textual form.

Cardinality0..*
Terminology BindingActionReasonCode (Example)
TypeCodeableReference(Condition | Observation | DiagnosticReport | DocumentReference)
PatternsCodeableReference(Condition,Observation,DiagnosticReport,DocumentReference): Common patterns = Event
Summaryfalse
RequestGroup.note
Element IdRequestGroup.note
Definition

Provides a mechanism to communicate additional information about the response.

Cardinality0..*
TypeAnnotation
Summaryfalse
RequestGroup.action
Element IdRequestGroup.action
Definition

The actions, if any, produced by the evaluation of the artifact.

Cardinality0..*
Summaryfalse
Invariants
Defined on this element
rqg-1Rule Must have resource or action but not bothresource.exists() != action.exists()
RequestGroup.action.prefix
Element IdRequestGroup.action.prefix
Definition

A user-visible prefix for the action.

Cardinality0..1
Typestring
Summaryfalse
RequestGroup.action.title
Element IdRequestGroup.action.title
Definition

The title of the action displayed to a user.

Cardinality0..1
Typestring
Summaryfalse
RequestGroup.action.description
Element IdRequestGroup.action.description
Definition

A short description of the action used to provide a summary to display to the user.

Cardinality0..1
Typestring
Summarytrue
RequestGroup.action.textEquivalent
Element IdRequestGroup.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 might not be capable of interpreting it dynamically.

Cardinality0..1
Typestring
Summarytrue
RequestGroup.action.priority
Element IdRequestGroup.action.priority
Definition

Indicates how quickly the action should be addressed with respect to other actions.

Cardinality0..1
Terminology BindingRequestPriority (Required)
Typecode
Summaryfalse
RequestGroup.action.code
Element IdRequestGroup.action.code
Definition

A code that provides meaning for the action or action group. For example, a section may have a LOINC code for a section of a documentation template.

Cardinality0..*
Terminology BindingActionCode (Example)
TypeCodeableConcept
Summaryfalse
RequestGroup.action.documentation
Element IdRequestGroup.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.

Cardinality0..*
TypeRelatedArtifact
Summaryfalse
RequestGroup.action.condition
Element IdRequestGroup.action.condition
Definition

An expression that describes applicability criteria, or start/stop conditions for the action.

Cardinality0..*
Summaryfalse
Comments

When multiple conditions of the same kind are present, the effects are combined using AND semantics, so the overall condition is true only if all of the conditions are true.

RequestGroup.action.condition.kind
Element IdRequestGroup.action.condition.kind
Definition

The kind of condition.

Cardinality1..1
Terminology BindingActionConditionKind (Required)
Typecode
Summaryfalse
Comments

Applicability criteria are used to determine immediate applicability when a plan definition is applied to a given context. Start and stop criteria are carried through application and used to describe enter/exit criteria for an action.

RequestGroup.action.condition.expression
Element IdRequestGroup.action.condition.expression
Definition

An expression that returns true or false, indicating whether or not the condition is satisfied.

Cardinality0..1
TypeExpression
Summaryfalse
Comments

The expression may be inlined, or may be a reference to a named expression within a logic library referenced by the library element.

RequestGroup.action.relatedAction
Element IdRequestGroup.action.relatedAction
Definition

A relationship to another action such as "before" or "30-60 minutes after start of".

Cardinality0..*
Summaryfalse
RequestGroup.action.relatedAction.targetId
Element IdRequestGroup.action.relatedAction.targetId
Definition

The element id of the target related action.

Cardinality1..1
Typeid
Summaryfalse
RequestGroup.action.relatedAction.relationship
Element IdRequestGroup.action.relatedAction.relationship
Definition

The relationship of this action to the related action.

Cardinality1..1
Terminology BindingActionRelationshipType (Required)
Typecode
Summaryfalse
RequestGroup.action.relatedAction.offset[x]
Element IdRequestGroup.action.relatedAction.offset[x]
Definition

A duration or range of durations to apply to the relationship. For example, 30-60 minutes before.

Cardinality0..1
TypeDuration|Range
[x] NoteSee Choice of Data Types for further information about how to use [x]
Summaryfalse
RequestGroup.action.timing[x]
Element IdRequestGroup.action.timing[x]
Definition

An optional value describing when the action should be performed.

Cardinality0..1
TypedateTime|Age|Period|Duration|Range|Timing
[x] NoteSee Choice of Data Types for further information about how to use [x]
Requirements

Allows prompting for activities and detection of missed planned activities.

Summaryfalse
Comments

The intent of the timing element is to provide timing for when the action should be performed. The timing may be absolute (specified as a dateTime or Period) or relative (specified as an Age, Duration, or Range), or it may be a more complex, potentially repeating timing specified using Timing.

RequestGroup.action.location
Element IdRequestGroup.action.location
Definition

Identifies the facility where the action will occur; e.g. home, hospital, specific clinic, etc.

Cardinality0..1
TypeCodeableReference(Location)
Requirements

Helps in planning of activity.

Alternate Namesfacility
Summaryfalse
Comments

May reference a specific clinical location or may just identify a type of location.

RequestGroup.action.participant
Element IdRequestGroup.action.participant
Definition

The participant that should perform or be responsible for this action.

Cardinality0..*
Summaryfalse
Comments

Because request groups represent potential options for performing activities, some specific participants may still be unknown, so this element allows for both definitional participants (in the same way they are specified in ActivityDefinition and PlanDefinition resources) as well as identifying specific participants when they are known.

RequestGroup.action.participant.type
Element IdRequestGroup.action.participant.type
Definition

The type of participant in the action.

Cardinality0..1
Terminology BindingActionParticipantType (Required)
Typecode
Summaryfalse
RequestGroup.action.participant.typeReference
Element IdRequestGroup.action.participant.typeReference
Definition

The type of participant in the action.

Cardinality0..1
TypeReference(CareTeam | Device | Group | HealthcareService | Location | Organization | Patient | Practitioner | PractitionerRole | RelatedPerson)
PatternsReference(CareTeam,Device,Group,HealthcareService,Location,Organization,Patient,Practitioner,PractitionerRole,RelatedPerson): Common patterns = Participant
Summaryfalse
Comments

When this element is a reference, it SHOULD be a reference to a definitional resource (for example, a location type, rather than a specific location).

RequestGroup.action.participant.role
Element IdRequestGroup.action.participant.role
Definition

The role the participant should play in performing the described action.

Cardinality0..1
Terminology BindingActionParticipantRole (Example)
TypeCodeableConcept
Summaryfalse
RequestGroup.action.participant.function
Element IdRequestGroup.action.participant.function
Definition

Indicates how the actor will be involved in the action - author, reviewer, witness, etc.

Cardinality0..1
Terminology BindingActionParticipantFunction (Example)
TypeCodeableConcept
Summaryfalse
RequestGroup.action.participant.actor
Element IdRequestGroup.action.participant.actor
Definition

A reference to the actual participant.

Cardinality0..1
TypeReference(CareTeam | Device | Group | HealthcareService | Location | Organization | Patient | Practitioner | PractitionerRole | RelatedPerson)
PatternsReference(CareTeam,Device,Group,HealthcareService,Location,Organization,Patient,Practitioner,PractitionerRole,RelatedPerson): Common patterns = Participant
Summaryfalse
RequestGroup.action.type
Element IdRequestGroup.action.type
Definition

The type of action to perform (create, update, remove).

Cardinality0..1
Terminology BindingActionType (Extensible)
TypeCodeableConcept
Summaryfalse
RequestGroup.action.groupingBehavior
Element IdRequestGroup.action.groupingBehavior
Definition

Defines the grouping behavior for the action and its children.

Cardinality0..1
Terminology BindingActionGroupingBehavior (Required)
Typecode
Summaryfalse
RequestGroup.action.selectionBehavior
Element IdRequestGroup.action.selectionBehavior
Definition

Defines the selection behavior for the action and its children.

Cardinality0..1
Terminology BindingActionSelectionBehavior (Required)
Typecode
Summaryfalse
RequestGroup.action.requiredBehavior
Element IdRequestGroup.action.requiredBehavior
Definition

Defines expectations around whether an action is required.

Cardinality0..1
Terminology BindingActionRequiredBehavior (Required)
Typecode
Summaryfalse
RequestGroup.action.precheckBehavior
Element IdRequestGroup.action.precheckBehavior
Definition

Defines whether the action should usually be preselected.

Cardinality0..1
Terminology BindingActionPrecheckBehavior (Required)
Typecode
Summaryfalse
RequestGroup.action.cardinalityBehavior
Element IdRequestGroup.action.cardinalityBehavior
Definition

Defines whether the action can be selected multiple times.

Cardinality0..1
Terminology BindingActionCardinalityBehavior (Required)
Typecode
Summaryfalse
RequestGroup.action.resource
Element IdRequestGroup.action.resource
Definition

The resource that is the target of the action (e.g. CommunicationRequest).

Cardinality0..1
TypeReference(Any)
Summaryfalse
Comments

The target resource SHALL be a Request resource with a Request.intent set to "option".

Invariants
Affect this element
rqg-1Rule Must have resource or action but not bothresource.exists() != action.exists()
RequestGroup.action.action
Element IdRequestGroup.action.action
Definition

Sub actions.

Cardinality0..*
TypeSee RequestGroup.action
Summaryfalse
Invariants
Affect this element
rqg-1Rule Must have resource or action but not bothresource.exists() != action.exists()