RIVO-Noord Zorgviewer Implementation Guide
1.11.0 - sprint49 Netherlands flag

This page is part of the RIVO-Noord Zorgviewer Implementation Guide (v1.11.0: Release) based on FHIR (HL7® FHIR® Standard) R3. This is the current published version in its permanent home (it will always be available at this URL). For a full list of available versions, see the Directory of published versions

Resource Profile: Alert - Detailed Descriptions

Active as of 2025-01-20

Definitions for the Flag resource profile.

Guidance on how to interpret the contents of this table can be found here

0. Flag
Definition

Prospective warnings of potential issues when providing care to the patient.

ShortAlertKey information to flag to healthcare providers
Control0..*
Alternate NamesBarriers to Care, Alert, Warning
Invariantsdom-2: If the resource is contained in another resource, it SHALL NOT contain nested Resources (contained.contained.empty())
dom-1: If the resource is contained in another resource, it SHALL NOT contain any narrative (contained.text.empty())
dom-4: 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-3: If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource (contained.where(('#'+id in %resource.descendants().reference).not()).empty())
dom-2: If the resource is contained in another resource, it SHALL NOT contain nested Resources (contained.contained.empty())
dom-1: If the resource is contained in another resource, it SHALL NOT contain any narrative (contained.text.empty())
dom-4: 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-3: If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource (contained.where(('#'+id in %resource.descendants().reference).not()).empty())
2. Flag.implicitRules
Definition

A reference to a set of rules that were followed when the resource was constructed, and which must be understood when processing the content.

ShortA set of rules under which this content was created
Comments

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.

This element is labelled as a modifier because the implicit rules may provide additional knowledge about the resource that modifies it's meaning or interpretation.

Control0..1
Typeuri
Is Modifiertrue because No Modifier Reason provideed in previous versions of FHIR
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
Summarytrue
4. Flag.extension:ConcernReference
Slice NameConcernReference
Definition

Points to the Observation, AllergyIntolerance or other record that provides additional supporting information about this flag.

ShortResource with details for flag
Control0..1
This element is affected by the following invariants: ele-1
TypeExtension(Flag details) (Extension Type: Reference(Resource))
Must Supporttrue
Invariantsele-1: All FHIR elements must have a @value or children (hasValue() | (children().count() > id.count()))
ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
6. Flag.extension:ConcernReference.url
Definition

Source of the definition for the extension code - a logical name or a URL.

Shortidentifies the meaning of the extension
Comments

The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.

Control1..1
Typeuri
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
XML FormatIn the XML format, this property is represented as an attribute.
Fixed Valuehttp://hl7.org/fhir/StructureDefinition/flag-detail
8. Flag.extension:ConcernReference.valueReference:valueReference
Slice NamevalueReference
Definition

Value of extension - may be a resource or one of a constrained set of the data types (see Extensibility in the spec for list).

ShortValue of extension
Comments

Within the context of zib-Alert the concern reference is only supposed to refer to zib-Problem. The reference is unconstrained to allow other use cases.

Control0..1
TypeReference(Resource), date, dateTime, Meta, code, string, Address, Attachment, integer, oid, Count, instant, ContactPoint, HumanName, Money, Identifier, Coding, markdown, SampledData, Ratio, id, positiveInt, Age, Distance, Period, Quantity, Duration, Range, uri, Annotation, boolean, base64Binary, Signature, unsignedInt, time, Timing, decimal, CodeableConcept
10. Flag.modifierExtension
Definition

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. Usually modifier elements provide negation or qualification. In order 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.

ShortExtensions that cannot be ignored
Comments

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.

Control0..*
TypeExtension
Is Modifiertrue because No Modifier Reason provideed in previous versions of FHIR
Alternate Namesextensions, user content
12. Flag.status
Definition

Supports basic workflow.

Shortactive | inactive | entered-in-error
Comments

This element is labeled as a modifier because the status contains codes that mark the resource as not currently valid.

Control1..1
BindingThe codes SHALL be taken from FlagStatushttp://hl7.org/fhir/ValueSet/flag-status
(required to http://hl7.org/fhir/ValueSet/flag-status)

Indicates whether this flag is active and needs to be displayed to a user, or whether it is no longer needed or entered in error.

Typecode
Is Modifiertrue because No Modifier Reason provideed in previous versions of FHIR
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
Summarytrue
14. Flag.category
Definition

Indicates the type of alert, meaning a rough description of the cause or origin of the warning.


Allows an flag to be divided into different categories like clinical, administrative etc. Intended to be used as a means of filtering which flags are displayed to particular user or in a given context.

ShortAlertTypeClinical, administrative, etc.
Control0..1
BindingUnless not suitable, these codes SHALL be taken from For example codes, see AlertTypeCodelijsthttp://hl7.org/fhir/ValueSet/flag-category
(extensible to http://decor.nictiz.nl/fhir/ValueSet/2.16.840.1.113883.2.4.3.11.60.40.2.8.3.1--20171231000000)

Indicates the type of alert, meaning a rough description of the cause or origin of the warning.


A general category for flags for filtering/display purposes.

TypeCodeableConcept
Summarytrue
Alternate NamesAlertType
Example<br/><b>Example of AlertType</b>:{ "coding" : [{ "system" : "http://loinc.org", "code" : "75323-6", "display" : "condition", "userSelected" : false }] }
16. Flag.category.text
Definition

A human language representation of the concept as seen/selected/uttered by the user who entered the data and/or which represents the intended meaning of the user.

ShortPlain text representation of the concept
Comments

Very often the text is the same as a displayName of one of the codings.

Control0..1
Typestring
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
Must Supporttrue
Summarytrue
Requirements

The codes from the terminologies do not always capture the correct meaning with all the nuances of the human using them, or sometimes there is no appropriate code at all. In these cases, the text is used to capture the full meaning of the source.

18. Flag.code
Definition

A warning, other than a condition or problem. For example, a patient can be given an ‘Aggressive patient' alert. The warning can be entered in code (there are codes for frequently used alerts), but seeing the dynamic nature of the warnings cf. SARS and Ebola, these alerts will often be entered as free text.


The coded value or textual component of the flag to display to the user.

ShortAlertNameCoded or textual message to display to user
Comments

According to HCIM Alert this element does not need to be filled if a reference to HCIM Problem exists. In that case, instead of leaving this element empty, the NullFlavor with .coding.code equal to 'OTH' SHOULD be used.


If non coded, use CodeableConcept.text. This element should always be included in the narrative.

Control1..1
BindingUnless not suitable, these codes SHALL be taken from For example codes, see AlertNaamCodelijsthttp://hl7.org/fhir/ValueSet/flag-code
(extensible to http://decor.nictiz.nl/fhir/ValueSet/2.16.840.1.113883.2.4.3.11.60.40.2.8.3.2--20171231000000)
TypeCodeableConcept
Summarytrue
Alternate NamesAlertNaam
Example<br/><b>Example of AlertName</b>:{ "coding" : [{ "system" : "http://snomed.info/sct", "code" : "432415000", "display" : "Methicillin resistant staphylococcus aureus carrier" }] }
20. Flag.code.text
Definition

A human language representation of the concept as seen/selected/uttered by the user who entered the data and/or which represents the intended meaning of the user.

ShortPlain text representation of the concept
Comments

Very often the text is the same as a displayName of one of the codings.

Control0..1
Typestring
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
Must Supporttrue
Summarytrue
Requirements

The codes from the terminologies do not always capture the correct meaning with all the nuances of the human using them, or sometimes there is no appropriate code at all. In these cases, the text is used to capture the full meaning of the source.

22. Flag.subject
Definition

The patient, location, group , organization , or practitioner, etc. this is about record this flag is associated with.

ShortWho/What is flag about?
Control1..1
TypeReference(nl-core-patient, nl-core-location, Group, nl-core-organization, nl-core-practitioner, PlanDefinition, HCIM PharmaceuticalProduct, HCIM Procedure, Patient, Location, Organization, Practitioner, Medication, Procedure)
Summarytrue
24. Flag.subject.extension:practitionerRole
Slice NamepractitionerRole
Definition

Optional Extension Element - found in all resources.

ShortOptional Extensions Element
Control0..1
TypeExtension(PractitionerRole Reference) (Extension Type: Reference)
26. Flag.period
Definition

The period of time from the activation of the flag to inactivation of the flag. If the flag is active, the end of the period should be unspecified.

ShortTime period when flag is active
Control0..1
TypePeriod
Summarytrue
28. Flag.period.start
Definition

The date and time at which the described condition was entered as a warning. This can be an exact date and time, or a rough indication of the date (such as only the year, or the month and the year).


The start of the period. The boundary is inclusive.

ShortStartDateTimeStarting time with inclusive boundary
Comments

If the low element is missing, the meaning is that the low boundary is not known.

Control0..1
This element is affected by the following invariants: per-1
TypedateTime
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
Must Supporttrue
Summarytrue
Alternate NamesBeginDatumTijd
Example<br/><b>Example of StartDateTime</b>:2017-02-07