RequestGroup

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".

Schema

Elements

Name	Required	Type	Description
identifier		Identifier[]	Business identifier Details Allows a service to provide a unique, business identifier for the request.
instantiatesCanonical		canonical[]	Instantiates FHIR protocol or definition Details 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.
instantiatesUri		uri[]	Instantiates external protocol or definition Details A URL referencing an externally defined protocol, guideline, orderset or other definition that is adhered to in whole or in part by this request.
basedOn		Reference<Resource>[]	Fulfills plan, proposal, or order Details A plan, proposal or order that is fulfilled in whole or in part by this request.
replaces		Reference<Resource>[]	Request(s) replaced by this request Details Completed or terminated request(s) whose function is taken by this new request. 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.
groupIdentifier		Identifier	Composite request this is part of Details 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. 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.
status	✓	code	draft | active | on-hold | revoked | completed | entered-in-error | unknown Details The current state of the request. For request groups, the status reflects the status of all the requests in the group.
intent	✓	code	proposal | plan | directive | order | original-order | reflex-order | filler-order | instance-order | option Details Indicates the level of authority/intentionality associated with the request and where the request fits into the workflow chain.
priority		code	routine | urgent | asap | stat Details Indicates how quickly the request should be addressed with respect to other requests.
code		CodeableConcept	What's being requested/ordered Details A code that identifies what the overall request group is. 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.
subject		Reference<Patient | Group>	Who the request group is about Details The subject for which the request group was created.
encounter		Reference<Encounter>	Created as part of Details Describes the context of the request group, if any.
authoredOn		dateTime	When the request group was authored Details Indicates when the request group was created.
author		Reference< Device | Practitioner | PractitionerRole >	Device or practitioner that authored the request group Details Provides a reference to the author of the request group.
reasonCode		CodeableConcept[]	Why the request group is needed Details Describes the reason for the request group in coded or textual form.
reasonReference		Reference< Condition | Observation | DiagnosticReport | DocumentReference >[]	Why the request group is needed Details Indicates another resource whose existence justifies this request group.
note		Annotation[]	Additional notes about the response Details Provides a mechanism to communicate additional information about the response.
action		RequestGroupAction[]	Proposed actions, if any Details The actions, if any, produced by the evaluation of the artifact.
id		string	Unique id for inter-element referencing Details Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
extension		Extension[]	Additional content defined by implementations Details May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
modifierExtension		Extension[]	Extensions that cannot be ignored even if unrecognized Details May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions. Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself). There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
prefix		string	User-visible prefix for the action (e.g. 1. or A.) Details A user-visible prefix for the action.
title		string	User-visible title Details The title of the action displayed to a user.
description		string	Short description of the action Details A short description of the action used to provide a summary to display to the user.
textEquivalent		string	Static text equivalent of the action, used if the dynamic aspects cannot be interpreted by the receiving system Details 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.
priority		code	routine | urgent | asap | stat Details Indicates how quickly the action should be addressed with respect to other actions.
code		CodeableConcept[]	Code representing the meaning of the action or sub-actions Details 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.
documentation		RelatedArtifact[]	Supporting documentation for the intended performer of the action Details 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.
condition		RequestGroupActionCondition[]	Whether or not the action is applicable Details An expression that describes applicability criteria, or start/stop conditions for the action. 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.
id		string	Unique id for inter-element referencing Details Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
extension		Extension[]	Additional content defined by implementations Details May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
modifierExtension		Extension[]	Extensions that cannot be ignored even if unrecognized Details May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions. Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself). There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
kind	✓	code	applicability | start | stop Details The kind of condition. 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.
expression		Expression	Boolean-valued expression Details An expression that returns true or false, indicating whether or not the condition is satisfied. The expression may be inlined, or may be a reference to a named expression within a logic library referenced by the library element.
relatedAction		RequestGroupActionRelatedAction[]	Relationship to another action Details A relationship to another action such as "before" or "30-60 minutes after start of".
id		string	Unique id for inter-element referencing Details Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
extension		Extension[]	Additional content defined by implementations Details May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
modifierExtension		Extension[]	Extensions that cannot be ignored even if unrecognized Details May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions. Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself). There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
actionId	✓	id	What action this is related to Details The element id of the action this is related to.
relationship	✓	code	before-start | before | before-end | concurrent-with-start | concurrent | concurrent-with-end | after-start | after | after-end Details The relationship of this action to the related action.
offset[x]		Duration, Range	Time offset for the relationship Details A duration or range of durations to apply to the relationship. For example, 30-60 minutes before.
timing[x]		dateTime, Age, Period, Duration, Range, Timing	When the action should take place Details An optional value describing when the action should be performed.
participant		Reference< Patient | Practitioner | PractitionerRole | RelatedPerson | Device >[]	Who should perform the action Details The participant that should perform or be responsible for this action.
type		CodeableConcept	create | update | remove | fire-event Details The type of action to perform (create, update, remove).
groupingBehavior		code	visual-group | logical-group | sentence-group Details Defines the grouping behavior for the action and its children.
selectionBehavior		code	any | all | all-or-none | exactly-one | at-most-one | one-or-more Details Defines the selection behavior for the action and its children.
requiredBehavior		code	must | could | must-unless-documented Details Defines expectations around whether an action is required.
precheckBehavior		code	yes | no Details Defines whether the action should usually be preselected.
cardinalityBehavior		code	single | multiple Details Defines whether the action can be selected multiple times.
resource		Reference<Resource>	The target of the action Details The resource that is the target of the action (e.g. CommunicationRequest). The target resource SHALL be a [Request](request.html) resource with a Request.intent set to "option".
action		[]	Sub action Details Sub actions.

Search Parameters

Name	Type	Description	Expression
author	reference	The author of the request group	RequestGroup.author
authored	date	The date the request group was authored	RequestGroup.authoredOn
code	token	The code of the request group	RequestGroup.code
encounter	reference	The encounter the request group applies to	RequestGroup.encounter
group-identifier	token	The group identifier for the request group	RequestGroup.groupIdentifier
identifier	token	External identifiers for the request group	RequestGroup.identifier
instantiates-canonical	reference	The FHIR-based definition from which the request group is realized	RequestGroup.instantiatesCanonical
instantiates-uri	uri	The external definition from which the request group is realized	RequestGroup.instantiatesUri
intent	token	The intent of the request group	RequestGroup.intent
participant	reference	The participant in the requests in the group	RequestGroup.action.participant
patient	reference	The identity of a patient to search for request groups	RequestGroup.subject.where(resolve() is Patient)
priority	token	The priority of the request group	RequestGroup.priority
status	token	The status of the request group	RequestGroup.status
subject	reference	The subject that the request group is about	RequestGroup.subject
priority-order	number	Numeric priority order for resource types using http://hl7.org/fhir/ValueSet/request-priority	iif(priority = 'stat', 50, iif(priority = 'asap', 40, iif(priority = 'urgent', 30, iif(priority = 'routine', 20, 10))))

Inherited Elements

Name	Required	Type	Description
id		string	Logical id of this artifact Details The logical id of the resource, as used in the URL for the resource. Once assigned, this value never changes. The only time that a resource does not have an id is when it is being submitted to the server using a create operation.
meta		Meta	Metadata about the resource Details The metadata about the resource. This is content that is maintained by the infrastructure. Changes to the content might not always be associated with version changes to the resource.
implicitRules		uri	A set of rules under which this content was created Details A reference to a set of rules that were followed when the resource was constructed, and which must be understood when processing the content. Often, this is a reference to an implementation guide that defines the special rules along with other profiles etc. Asserting this rule set restricts the content to be only understood by a limited set of trading partners. This inherently limits the usefulness of the data in the long term. However, the existing health eco-system is highly fractured, and not yet ready to define, collect, and exchange data in a generally computable sense. Wherever possible, implementers and/or specification writers should avoid using this element. Often, when used, the URL is a reference to an implementation guide that defines these special rules as part of it's narrative along with other profiles, value sets, etc.
language		code	Language of the resource content Details The base language in which the resource is written. Language is provided to support indexing and accessibility (typically, services such as text to speech use the language tag). The html language tag in the narrative applies to the narrative. The language tag on the resource may be used to specify the language of other presentations generated from the data in the resource. Not all the content has to be in the base language. The Resource.language should not be assumed to apply to the narrative automatically. If a language is specified, it should it also be specified on the div element in the html (see rules in HTML5 for information about the relationship between xml:lang and the html lang attribute).
text		Narrative	Text summary of the resource, for human interpretation Details A human-readable narrative that contains a summary of the resource and can be used to represent the content of the resource to a human. The narrative need not encode all the structured data, but is required to contain sufficient detail to make it "clinically safe" for a human to just read the narrative. Resource definitions may define what content should be represented in the narrative to ensure clinical safety. Contained resources do not have narrative. Resources that are not contained SHOULD have a narrative. In some cases, a resource may only have text with little or no additional discrete data (as long as all minOccurs=1 elements are satisfied). This may be necessary for data from legacy systems where information is captured as a "text blob" or where text is additionally entered raw or narrated and encoded information is added later.
contained		Resource[]	Contained, inline Resources Details These resources do not have an independent existence apart from the resource that contains them - they cannot be identified independently, and nor can they have their own independent transaction scope. This should never be done when the content can be identified properly, as once identification is lost, it is extremely difficult (and context dependent) to restore it again. Contained resources may have profiles and tags In their meta elements, but SHALL NOT have security labels.
extension		Extension[]	Additional content defined by implementations Details May be used to represent additional information that is not part of the basic definition of the resource. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
modifierExtension		Extension[]	Extensions that cannot be ignored Details May be used to represent additional information that is not part of the basic definition of the resource and that modifies the understanding of the element that contains it and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer is allowed to define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions. Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself). There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

Usage

This resource is a request resource from a FHIR workflow perspective - see Workflow, specifically Request.

The RequestGroup resource is used to represent a group of optional activities that may be performed for a specific patient or context. This resource is often, but not always, the result of applying a specific PlanDefinition to a particular patient. Other than differences that tie the RequestGroup to a particular subject and setting, the actionDefinition element of PlanDefinition is identical to the action element of the RequestGroup, allowing the same features and functionality to be used in both places to describe optionality of and relationships between activities in a workflow.

RequestGroups can contain hierarchical groups of actions, where each specific action references the action to be performed (in terms of a Request resource), and each group describes additional behavior, relationships, and applicable conditions between the actions in the overall group.

Referenced By

• CarePlan
• GuidanceResponse