International Patient Summary Implementation Guide
2.0.0 -
International Patient Summary Implementation Guide
2.0.0 -
International Patient Summary Implementation Guide, published by HL7 International / Patient Care. This guide is not an authorized publication; it is the continuous build for version 2.0.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/fhir-ips/ and changes regularly. See the Directory of published versions
| Official URL: http://hl7.org/fhir/uv/ips/StructureDefinition/Flag-alert-uv-ips | Version: 2.0.0 | |||
| Standards status: Trial-use Active as of 2024-07-03 | Maturity Level: 3 | Computable Name: FlagAlertUvIps | ||
This profile constrains the Flag resource by the International Patient Summary (IPS) FHIR Implementation Guide. A record of an alert is represented in the patient summary as an instance of a Flag resource constrained by this profile.
This specialized Flag is used to convey information about an alert specific to an IPS. Information is flagged to raise awareness of potential concerns and/or dangers to/from the subject of the IPS. It brings information to the fore and may reference other information from the summary (through the supportingInfo extension) as well as present obstacles to care.
Usages:
You can also check for usages in the FHIR IG Statistics
Description Differentials, Snapshots, and other representations.
| Name | Flags | Card. | Type | Description & Constraints Filter:   | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
  Flag |
0..* | Flag | Key information to flag to healthcare providers | |||||||||
  implicitRules |
?!Σ | 0..1 | uri | A set of rules under which this content was created | ||||||||
  Slices for extension |
0..* | Extension | Extension Slice: Unordered, Open by value:url | |||||||||
   extension:flag-priority |
SO | 0..1 | CodeableConcept | An alarm code URL: http://hl7.org/fhir/StructureDefinition/flag-priority Binding: FlagPriorityCodes (example): A code of the alarm.
| ||||||||
 modifierExtension |
?! | 0..* | Extension | Extensions that cannot be ignored | ||||||||
| status |
?!Σ | 1..1 | code | active | inactive | entered-in-error Binding: FlagStatus (required): Indicates whether this flag is active and needs to be displayed to a user, or whether it is no longer needed or was entered in error. Fixed Value: active | ||||||||
 category |
SOΣ | 0..* | CodeableConceptIPS | Clinical, administrative, etc. Binding: FlagCategory (example): A general category for flags for filtering/display purposes.
| ||||||||
| code |
SOΣ | 1..1 | CodeableConceptIPS | Coded or textual message to display to user Binding: FlagCode (example): Detail codes identifying specific flagged issues.
| ||||||||
  subject |
SOΣ | 1..1 | Reference(Patient | Location | Group | Organization | Practitioner | PlanDefinition | Medication | Procedure) | Who/What is flag about?
| ||||||||
  reference |
SOΣC | 1..1 | string | Literal reference, Relative, internal or absolute URL
| ||||||||
| Documentation for this format | ||||||||||||
| Name | Creator (IPS) | Consumer (IPS) |
|---|---|---|
| Flag |
||
 Slices for extension |
||
| extension:flag-priority |
|
|
| category |
|
|
| code |
|
|
| subject |
|
|
| reference |
|
|
| Documentation for this format | ||
| Path | Status | Usage | ValueSet | Version | Source |
| Flag.status | Base | required | FlagStatus | 📍4.0.1 | FHIR Std. |
| Flag.category | Base | example | Flag Category | 📍4.0.1 | FHIR Std. |
| Flag.code | Base | example | Flag Code | 📍4.0.1 | FHIR Std. |
| Id | Grade | Path(s) | Description | Expression |
| dom-2 | error | Flag | If the resource is contained in another resource, it SHALL NOT contain nested Resources |
contained.contained.empty()
|
| dom-3 | error | Flag | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource |
contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
|
| dom-4 | error | Flag | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated |
contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
|
| dom-5 | error | Flag | If a resource is contained in another resource, it SHALL NOT have a security label |
contained.meta.security.empty()
|
| dom-6 | best practice | Flag | A resource should have narrative for robust management |
text.`div`.exists()
|
| ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children |
hasValue() or (children().count() > id.count())
|
| ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both |
extension.exists() != value.exists()
|
| Name | Creator (IPS) | Consumer (IPS) |
|---|---|---|
| Flag |
||
| Slices for extension |
||
| extension:flag-priority |
|
|
| category |
|
|
| code |
|
|
 subject |
|
|
| reference |
|
|
| Documentation for this format | ||
| Name | Flags | Card. | Type | Description & Constraints Filter: | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Flag |
0..* | Flag | Key information to flag to healthcare providers | |||||||||
| id |
Σ | 0..1 | id | Logical id of this artifact | ||||||||
| meta |
Σ | 0..1 | Meta | Metadata about the resource | ||||||||
| implicitRules |
?!Σ | 0..1 | uri | A set of rules under which this content was created | ||||||||
| language |
0..1 | code | Language of the resource content Binding: CommonLanguages (preferred): A human language.
| |||||||||
| text |
0..1 | Narrative | Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements | |||||||||
| contained |
0..* | Resource | Contained, inline Resources | |||||||||
| Slices for extension |
0..* | Extension | Extension Slice: Unordered, Open by value:url | |||||||||
| extension:flag-priority |
SO | 0..1 | CodeableConcept | An alarm code URL: http://hl7.org/fhir/StructureDefinition/flag-priority Binding: FlagPriorityCodes (example): A code of the alarm.
| ||||||||
| modifierExtension |
?! | 0..* | Extension | Extensions that cannot be ignored | ||||||||
| identifier |
Σ | 0..* | Identifier | Business identifier | ||||||||
| status |
?!Σ | 1..1 | code | active | inactive | entered-in-error Binding: FlagStatus (required): Indicates whether this flag is active and needs to be displayed to a user, or whether it is no longer needed or was entered in error. Fixed Value: active | ||||||||
| category |
SOΣ | 0..* | CodeableConceptIPS | Clinical, administrative, etc. Binding: FlagCategory (example): A general category for flags for filtering/display purposes.
| ||||||||
| code |
SOΣ | 1..1 | CodeableConceptIPS | Coded or textual message to display to user Binding: FlagCode (example): Detail codes identifying specific flagged issues.
| ||||||||
| subject |
SOΣ | 1..1 | Reference(Patient | Location | Group | Organization | Practitioner | PlanDefinition | Medication | Procedure) | Who/What is flag about?
| ||||||||
| id |
0..1 | string | Unique id for inter-element referencing | |||||||||
| extension |
0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |||||||||
| reference |
SOΣC | 1..1 | string | Literal reference, Relative, internal or absolute URL
| ||||||||
| type |
Σ | 0..1 | uri | Type the reference refers to (e.g. "Patient") Binding: ResourceType (extensible): Aa resource (or, for logical models, the URI of the logical model). | ||||||||
| identifier |
Σ | 0..1 | Identifier | Logical reference, when literal reference is not known | ||||||||
| display |
Σ | 0..1 | string | Text alternative for the resource | ||||||||
| period |
Σ | 0..1 | Period | Time period when flag is active | ||||||||
| encounter |
Σ | 0..1 | Reference(Encounter) | Alert relevant during encounter | ||||||||
| author |
Σ | 0..1 | Reference(Device | Organization | Patient | Practitioner | PractitionerRole) | Flag creator | ||||||||
| Documentation for this format | ||||||||||||
| Name | Creator (IPS) | Consumer (IPS) |
|---|---|---|
| Flag |
||
| Slices for extension |
||
| extension:flag-priority |
|
|
| category |
|
|
| code |
|
|
| subject |
|
|
| reference |
|
|
| Documentation for this format | ||
| Path | Status | Usage | ValueSet | Version | Source |
| Flag.language | Base | preferred | Common Languages | 📍4.0.1 | FHIR Std. |
| Flag.status | Base | required | FlagStatus | 📍4.0.1 | FHIR Std. |
| Flag.category | Base | example | Flag Category | 📍4.0.1 | FHIR Std. |
| Flag.code | Base | example | Flag Code | 📍4.0.1 | FHIR Std. |
| Flag.subject.type | Base | extensible | ResourceType | 📍4.0.1 | FHIR Std. |
| Id | Grade | Path(s) | Description | Expression |
| dom-2 | error | Flag | If the resource is contained in another resource, it SHALL NOT contain nested Resources |
contained.contained.empty()
|
| dom-3 | error | Flag | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource |
contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
|
| dom-4 | error | Flag | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated |
contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
|
| dom-5 | error | Flag | If a resource is contained in another resource, it SHALL NOT have a security label |
contained.meta.security.empty()
|
| dom-6 | best practice | Flag | A resource should have narrative for robust management |
text.`div`.exists()
|
| ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children |
hasValue() or (children().count() > id.count())
|
| ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both |
extension.exists() != value.exists()
|
| Name | Creator (IPS) | Consumer (IPS) |
|---|---|---|
| Flag |
||
| Slices for extension |
||
| extension:flag-priority |
|
|
| category |
|
|
| code |
|
|
| subject |
|
|
| reference |
|
|
| Documentation for this format | ||
Summary
Mandatory: 1 element
Must-Support: 5 elements
Fixed: 1 element
Structures
This structure refers to these other structures:
Extensions
This structure refers to these extensions:
Maturity: 3
Key Elements View
| Name | Flags | Card. | Type | Description & Constraints Filter: | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Flag |
0..* | Flag | Key information to flag to healthcare providers | |||||||||
| implicitRules |
?!Σ | 0..1 | uri | A set of rules under which this content was created | ||||||||
| Slices for extension |
0..* | Extension | Extension Slice: Unordered, Open by value:url | |||||||||
| extension:flag-priority |
SO | 0..1 | CodeableConcept | An alarm code URL: http://hl7.org/fhir/StructureDefinition/flag-priority Binding: FlagPriorityCodes (example): A code of the alarm.
| ||||||||
| modifierExtension |
?! | 0..* | Extension | Extensions that cannot be ignored | ||||||||
| status |
?!Σ | 1..1 | code | active | inactive | entered-in-error Binding: FlagStatus (required): Indicates whether this flag is active and needs to be displayed to a user, or whether it is no longer needed or was entered in error. Fixed Value: active | ||||||||
| category |
SOΣ | 0..* | CodeableConceptIPS | Clinical, administrative, etc. Binding: FlagCategory (example): A general category for flags for filtering/display purposes.
| ||||||||
| code |
SOΣ | 1..1 | CodeableConceptIPS | Coded or textual message to display to user Binding: FlagCode (example): Detail codes identifying specific flagged issues.
| ||||||||
| subject |
SOΣ | 1..1 | Reference(Patient | Location | Group | Organization | Practitioner | PlanDefinition | Medication | Procedure) | Who/What is flag about?
| ||||||||
| reference |
SOΣC | 1..1 | string | Literal reference, Relative, internal or absolute URL
| ||||||||
| Documentation for this format | ||||||||||||
| Name | Creator (IPS) | Consumer (IPS) |
|---|---|---|
| Flag |
||
| Slices for extension |
||
| extension:flag-priority |
|
|
| category |
|
|
| code |
|
|
| subject |
|
|
| reference |
|
|
| Documentation for this format | ||
| Path | Status | Usage | ValueSet | Version | Source |
| Flag.status | Base | required | FlagStatus | 📍4.0.1 | FHIR Std. |
| Flag.category | Base | example | Flag Category | 📍4.0.1 | FHIR Std. |
| Flag.code | Base | example | Flag Code | 📍4.0.1 | FHIR Std. |
| Id | Grade | Path(s) | Description | Expression |
| dom-2 | error | Flag | If the resource is contained in another resource, it SHALL NOT contain nested Resources |
contained.contained.empty()
|
| dom-3 | error | Flag | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource |
contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
|
| dom-4 | error | Flag | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated |
contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
|
| dom-5 | error | Flag | If a resource is contained in another resource, it SHALL NOT have a security label |
contained.meta.security.empty()
|
| dom-6 | best practice | Flag | A resource should have narrative for robust management |
text.`div`.exists()
|
| ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children |
hasValue() or (children().count() > id.count())
|
| ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both |
extension.exists() != value.exists()
|
Differential View
| Name | Flags | Card. | Type | Description & Constraints Filter: | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Flag |
Flag | |||||||||||
| Slices for extension |
0..* | Extension | Extension Slice: Unordered, Open by value:url | |||||||||
| extension:flag-priority |
SO | 0..1 | CodeableConcept | An alarm code URL: http://hl7.org/fhir/StructureDefinition/flag-priority Binding: FlagPriorityCodes (example): A code of the alarm.
| ||||||||
| status |
1..1 | code | active | inactive | entered-in-error Fixed Value: active | |||||||||
| category |
SO | 0..* | CodeableConceptIPS | Clinical, administrative, etc.
| ||||||||
| code |
SO | 1..1 | CodeableConceptIPS | Coded or textual message to display to user
| ||||||||
| subject |
SO | 1..1 | Reference(Patient | Location | Group | Organization | Practitioner | PlanDefinition | Medication | Procedure) | Who/What is flag about?
| ||||||||
| reference |
SO | 1..1 | string | Literal reference, Relative, internal or absolute URL
| ||||||||
| Documentation for this format | ||||||||||||
| Name | Creator (IPS) | Consumer (IPS) |
|---|---|---|
| Flag |
||
| Slices for extension |
||
| extension:flag-priority |
|
|
| category |
|
|
| code |
|
|
| subject |
|
|
| reference |
|
|
| Documentation for this format | ||
Snapshot ViewView
| Name | Flags | Card. | Type | Description & Constraints Filter: | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Flag |
0..* | Flag | Key information to flag to healthcare providers | |||||||||
| id |
Σ | 0..1 | id | Logical id of this artifact | ||||||||
| meta |
Σ | 0..1 | Meta | Metadata about the resource | ||||||||
| implicitRules |
?!Σ | 0..1 | uri | A set of rules under which this content was created | ||||||||
| language |
0..1 | code | Language of the resource content Binding: CommonLanguages (preferred): A human language.
| |||||||||
| text |
0..1 | Narrative | Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements | |||||||||
| contained |
0..* | Resource | Contained, inline Resources | |||||||||
| Slices for extension |
0..* | Extension | Extension Slice: Unordered, Open by value:url | |||||||||
| extension:flag-priority |
SO | 0..1 | CodeableConcept | An alarm code URL: http://hl7.org/fhir/StructureDefinition/flag-priority Binding: FlagPriorityCodes (example): A code of the alarm.
| ||||||||
| modifierExtension |
?! | 0..* | Extension | Extensions that cannot be ignored | ||||||||
| identifier |
Σ | 0..* | Identifier | Business identifier | ||||||||
| status |
?!Σ | 1..1 | code | active | inactive | entered-in-error Binding: FlagStatus (required): Indicates whether this flag is active and needs to be displayed to a user, or whether it is no longer needed or was entered in error. Fixed Value: active | ||||||||
| category |
SOΣ | 0..* | CodeableConceptIPS | Clinical, administrative, etc. Binding: FlagCategory (example): A general category for flags for filtering/display purposes.
| ||||||||
| code |
SOΣ | 1..1 | CodeableConceptIPS | Coded or textual message to display to user Binding: FlagCode (example): Detail codes identifying specific flagged issues.
| ||||||||
| subject |
SOΣ | 1..1 | Reference(Patient | Location | Group | Organization | Practitioner | PlanDefinition | Medication | Procedure) | Who/What is flag about?
| ||||||||
| id |
0..1 | string | Unique id for inter-element referencing | |||||||||
| extension |
0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |||||||||
| reference |
SOΣC | 1..1 | string | Literal reference, Relative, internal or absolute URL
| ||||||||
| type |
Σ | 0..1 | uri | Type the reference refers to (e.g. "Patient") Binding: ResourceType (extensible): Aa resource (or, for logical models, the URI of the logical model). | ||||||||
| identifier |
Σ | 0..1 | Identifier | Logical reference, when literal reference is not known | ||||||||
| display |
Σ | 0..1 | string | Text alternative for the resource | ||||||||
| period |
Σ | 0..1 | Period | Time period when flag is active | ||||||||
| encounter |
Σ | 0..1 | Reference(Encounter) | Alert relevant during encounter | ||||||||
| author |
Σ | 0..1 | Reference(Device | Organization | Patient | Practitioner | PractitionerRole) | Flag creator | ||||||||
| Documentation for this format | ||||||||||||
| Name | Creator (IPS) | Consumer (IPS) |
|---|---|---|
| Flag |
||
| Slices for extension |
||
| extension:flag-priority |
|
|
| category |
|
|
| code |
|
|
| subject |
|
|
| reference |
|
|
| Documentation for this format | ||
| Path | Status | Usage | ValueSet | Version | Source |
| Flag.language | Base | preferred | Common Languages | 📍4.0.1 | FHIR Std. |
| Flag.status | Base | required | FlagStatus | 📍4.0.1 | FHIR Std. |
| Flag.category | Base | example | Flag Category | 📍4.0.1 | FHIR Std. |
| Flag.code | Base | example | Flag Code | 📍4.0.1 | FHIR Std. |
| Flag.subject.type | Base | extensible | ResourceType | 📍4.0.1 | FHIR Std. |
| Id | Grade | Path(s) | Description | Expression |
| dom-2 | error | Flag | If the resource is contained in another resource, it SHALL NOT contain nested Resources |
contained.contained.empty()
|
| dom-3 | error | Flag | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource |
contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
|
| dom-4 | error | Flag | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated |
contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
|
| dom-5 | error | Flag | If a resource is contained in another resource, it SHALL NOT have a security label |
contained.meta.security.empty()
|
| dom-6 | best practice | Flag | A resource should have narrative for robust management |
text.`div`.exists()
|
| ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children |
hasValue() or (children().count() > id.count())
|
| ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both |
extension.exists() != value.exists()
|
| Name | Creator (IPS) | Consumer (IPS) |
|---|---|---|
| Flag |
||
| Slices for extension |
||
| extension:flag-priority |
|
|
| category |
|
|
| code |
|
|
| subject |
|
|
| reference |
|
|
| Documentation for this format | ||
Summary
Mandatory: 1 element
Must-Support: 5 elements
Fixed: 1 element
Structures
This structure refers to these other structures:
Extensions
This structure refers to these extensions:
Maturity: 3
Other representations of profile: CSV, Excel, Schematron
IG © 2020+ HL7 International / Patient Care.
Package hl7.fhir.uv.ips#2.0.0 based on FHIR 4.0.1.
Generated 2025-10-29
Links: Table of Contents |
QA Report
| Version History |
|
Propose a change