Finnish PHR Implementation Guide STU3

• 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()

• rim:Entity. Role, or Act
• workflow:Request
• rim:Act[classCode=PCPR, moodCode=INT]
• w5:clinical.careprovision

The only time that a resource does not have an id is when it is being submitted to the server using a create operation.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• rim:N/A

Note that FHIR strings may not exceed 1MB in size

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a

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.

• ele-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()

• rim:n/a
• rim:N/A

The server assigns this value, and ignores what the client specifies, except in the case that the server is imposing version integrity on updates/deletes.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a

This value is always populated except when the resource is first being created. The server / resource manager sets this value; what a client provides is irrelevant.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a

It is up to the server and/or other infrastructure of policy to determine whether/how these claims are verified and/or updated over time. The list of profile URLs is a set.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

http://phr.kanta.fi/StructureDefinition/fiphr-sd-selfcareplan-stu3

• rim:n/a

Finnish PHR: Security Labels from the Healthcare Privacy and Security Classification System.

The security labels can be updated without changing the stated version of the resource The list of security labels is a set. Uniqueness is based the system/code, and version and display are ignored.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• v2:CE/CNE/CWE subset one of the sets of component 1-3 or 4-6
• rim:CV
• orim:fhir:Coding rdfs:subClassOf dt:CDCoding

Note that FHIR strings may not exceed 1MB in size

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a

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.

• ele-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()

• rim:n/a
• rim:N/A

Need to be unambiguous about the source of the definition of the symbol.

The URI may be an OID (urn:oid:...) or a UUID (urn:uuid:...). OIDs and UUIDs SHALL be references to the HL7 OID registry. Otherwise, the URI should come from HL7's list of FHIR defined special URIs or it should de-reference to some definition that establish the system clearly and unambiguously.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

http://hl7.org/fhir/v3/Confidentiality

• rim:n/a
• v2:C*E.3
• rim:./codeSystem
• orim:fhir:Coding.system rdfs:subPropertyOf dt:CDCoding.codeSystem

Where the terminology does not clearly define what string should be used to identify code system versions, the recommendation is to use the date (expressed in FHIR date format) on which that version was officially published as the version date.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• v2:C*E.7
• rim:./codeSystemVersion
• orim:fhir:Coding.version rdfs:subPropertyOf dt:CDCoding.codeSystemVersion

Need to refer to a particular code in the system.

Note that FHIR strings may not exceed 1MB in size

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• v2:C*E.1
• rim:./code
• orim:fhir:Coding.code rdfs:subPropertyOf dt:CDCoding.code

Need to be able to carry a human-readable meaning of the code for readers that do not know the system.

Note that FHIR strings may not exceed 1MB in size

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• v2:C*E.2 - but note this is not well followed
• rim:CV.displayName
• orim:fhir:Coding.display rdfs:subPropertyOf dt:CDCoding.displayName

This has been identified as a clinical safety criterium - that this exact system/code pair was chosen explicitly, rather than inferred by the system based on some rules or language processing.

Amongst a set of alternatives, a directly chosen code is the most appropriate starting point for new translations. There is some ambiguity about what exactly 'directly chosen' implies, and trading partner agreement may be needed to clarify the use of this element and its consequences more completely.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• v2:Sometimes implied by being first
• rim:CD.codingRationale
• orim:fhir:Coding.userSelected fhir:mapsTo dt:CDCoding.codingRationale. fhir:Coding.userSelected fhir:hasMap fhir:Coding.userSelected.map. fhir:Coding.userSelected.map a fhir:Map; fhir:target dt:CDCoding.codingRationale. fhir:Coding.userSelected\#true a [ fhir:source "true"; fhir:target dt:CDCoding.codingRationale\#O ]

Codes that represent various types of tags, commonly workflow-related; e.g. "Needs review by Dr. Jones"

The tags can be updated without changing the stated version of the resource. The list of tags is a set. Uniqueness is based the system/code, and version and display are ignored.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• v2:CE/CNE/CWE subset one of the sets of component 1-3 or 4-6
• rim:CV
• orim:fhir:Coding rdfs:subClassOf dt:CDCoding

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.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a

Finnish PHR: A code of human language.

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

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a

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 in formation is added later.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• rim:N/A
• rim:Act.text?

Goal can be achieving a particular change or merely maintaining a current state or even slowing a decline.

• 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()

• rim:Entity. Role, or Act
• rim:N/A
• v2:GOL.1
• rim:.outboundRelationship[typeCode<=OBJ].
• w5:clinical.careprovision

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.

• ele-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()

• rim:n/a
• rim:N/A

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.

• ele-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()

• rim:n/a
• rim:N/A

Note that FHIR strings may not exceed 1MB in size

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a

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.

• ele-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()

• rim:n/a
• rim:N/A

.

• ele-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()

• rim:n/a
• rim:N/A

Note that FHIR strings may not exceed 1MB in size

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a

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.

• ele-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()

• rim:n/a
• rim:N/A

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.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

name

• rim:n/a
• rim:N/A

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• rim:N/A

.

• ele-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()

• rim:n/a
• rim:N/A

Note that FHIR strings may not exceed 1MB in size

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a

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.

• ele-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()

• rim:n/a
• rim:N/A

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.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

applicationId

• rim:n/a
• rim:N/A

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• rim:N/A

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.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

http://phr.kanta.fi/StructureDefinition/fiphr-ext-creatingapplication

• rim:n/a
• rim:N/A

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• rim:N/A

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.

• ele-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()

• rim:n/a
• rim:N/A

Need to allow connection to a wider workflow.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
• rim:II - see see identifier pattern at http://wiki.hl7.org/index.php?title=Common_Design_Patterns#Identifier_Pattern for relevant discussion. The Identifier class is a little looser than the v3 type II because it allows URIs as well as registered OIDs or GUIDs. Also maps to Role[classCode=IDENT]
• servd:Identifier
• workflow:Request.identifier
• v2:PTH-3
• rim:.id
• w5:id

Need to allow connection to a wider workflow.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
• rim:II - see see identifier pattern at http://wiki.hl7.org/index.php?title=Common_Design_Patterns#Identifier_Pattern for relevant discussion. The Identifier class is a little looser than the v3 type II because it allows URIs as well as registered OIDs or GUIDs. Also maps to Role[classCode=IDENT]
• servd:Identifier
• workflow:Request.identifier
• v2:PTH-3
• rim:.id
• w5:id

Note that FHIR strings may not exceed 1MB in size

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a

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.

• ele-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()

• rim:n/a
• rim:N/A

Identifies the purpose for this identifier, if known .

Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.

This is labeled as "Is Modifier" because applications should not mistake a temporary id for a permanent one. Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

official

• rim:n/a
• v2:N/A
• rim:Role.code or implied by context

A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

Allows users to make use of identifiers when the identifier system is not known.

This element deals only with general categories of identifiers. It SHOULD not be used for codes that correspond 1..1 with the Identifier.system. Some identifiers may fall into multiple categories due to common usage.

Where the system is known, a type is unnecessary because the type is always part of the system definition. However systems often need to handle identifiers where the system is not known. There is not a 1:1 relationship between type and system, since many different systems have the same type.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• v2:CE/CNE/CWE
• rim:CD
• orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
• v2:CX.5
• rim:Role.code or implied by context

There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.

see http://en.wikipedia.org/wiki/Uniform_resource_identifier

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

urn:ietf:rfc:3986

• rim:n/a
• v2:CX.4 / EI-2-4
• rim:II.root or Role.id.root
• servd:./IdentifierType

If the value is a full URI, then the system SHALL be urn:ietf:rfc:3986. The value's primary purpose is computational mapping. As a result, it may be normalized for comparison purposes (e.g. removing non-significant whitespace, dashes, etc.) A value formatted for human display can be conveyed using the Rendered Value extension.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• v2:CX.1 / EI.1
• rim:II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
• servd:./Value

This is not a duration - that's a measure of time (a separate type), but a duration that occurs at a fixed value of time. A Period specifies a range of time; the context of use will specify whether the entire range applies (e.g. "the patient was an inpatient of the hospital for this time range") or one value from the range applies (e.g. "give to the patient between these two times"). If duration is required, specify the type as Interval|Duration.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())
• per-1:If present, start SHALL have a lower value than end
  start.empty() or end.empty() or (start <= end)

• rim:n/a
• v2:DR
• rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
• v2:CX.7 + CX.8
• rim:Role.effectiveTime or implied by context
• servd:./StartDate and ./EndDate

The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())
• ref-1:SHALL have a contained resource if a local reference is provided
  reference.startsWith('#').not() or (reference.substring(1).trace('url') in %resource.contained.id.trace('ids'))

• rim:n/a
• rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
• v2:CX.4 / (CX.4,CX.9,CX.10)
• rim:II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
• servd:./IdentifierIssuingAuthority

Need to allow connection to a wider workflow.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
• rim:II - see see identifier pattern at http://wiki.hl7.org/index.php?title=Common_Design_Patterns#Identifier_Pattern for relevant discussion. The Identifier class is a little looser than the v3 type II because it allows URIs as well as registered OIDs or GUIDs. Also maps to Role[classCode=IDENT]
• servd:Identifier
• workflow:Request.identifier
• v2:PTH-3
• rim:.id
• w5:id

Note that FHIR strings may not exceed 1MB in size

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a

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.

• ele-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()

• rim:n/a
• rim:N/A

Identifies the purpose for this identifier, if known .

Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.

This is labeled as "Is Modifier" because applications should not mistake a temporary id for a permanent one. Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• v2:N/A
• rim:Role.code or implied by context

A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

Allows users to make use of identifiers when the identifier system is not known.

This element deals only with general categories of identifiers. It SHOULD not be used for codes that correspond 1..1 with the Identifier.system. Some identifiers may fall into multiple categories due to common usage.

Where the system is known, a type is unnecessary because the type is always part of the system definition. However systems often need to handle identifiers where the system is not known. There is not a 1:1 relationship between type and system, since many different systems have the same type.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• v2:CE/CNE/CWE
• rim:CD
• orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
• v2:CX.5
• rim:Role.code or implied by context

There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.

see http://en.wikipedia.org/wiki/Uniform_resource_identifier

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• v2:CX.4 / EI-2-4
• rim:II.root or Role.id.root
• servd:./IdentifierType

If the value is a full URI, then the system SHALL be urn:ietf:rfc:3986. The value's primary purpose is computational mapping. As a result, it may be normalized for comparison purposes (e.g. removing non-significant whitespace, dashes, etc.) A value formatted for human display can be conveyed using the Rendered Value extension.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• v2:CX.1 / EI.1
• rim:II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
• servd:./Value

This is not a duration - that's a measure of time (a separate type), but a duration that occurs at a fixed value of time. A Period specifies a range of time; the context of use will specify whether the entire range applies (e.g. "the patient was an inpatient of the hospital for this time range") or one value from the range applies (e.g. "give to the patient between these two times"). If duration is required, specify the type as Interval|Duration.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())
• per-1:If present, start SHALL have a lower value than end
  start.empty() or end.empty() or (start <= end)

• rim:n/a
• v2:DR
• rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
• v2:CX.7 + CX.8
• rim:Role.effectiveTime or implied by context
• servd:./StartDate and ./EndDate

The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())
• ref-1:SHALL have a contained resource if a local reference is provided
  reference.startsWith('#').not() or (reference.substring(1).trace('url') in %resource.contained.id.trace('ids'))

• rim:n/a
• rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
• v2:CX.4 / (CX.4,CX.9,CX.10)
• rim:II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
• servd:./IdentifierIssuingAuthority

References SHALL be a reference to an actual FHIR resource, and SHALL be resolveable (allowing for access control, temporary unavailability, etc). Resolution can be either by retrieval from the URL, or, where applicable by resource type, by treating an absolute reference as a canonical URL and looking it up in a local registry/repository.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())
• ref-1:SHALL have a contained resource if a local reference is provided
  reference.startsWith('#').not() or (reference.substring(1).trace('url') in %resource.contained.id.trace('ids'))

• rim:n/a
• rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
• workflow:Request.definition

Allows tracing of the care plan and tracking whether proposals/recommendations were acted upon.

References SHALL be a reference to an actual FHIR resource, and SHALL be resolveable (allowing for access control, temporary unavailability, etc). Resolution can be either by retrieval from the URL, or, where applicable by resource type, by treating an absolute reference as a canonical URL and looking it up in a local registry/repository.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())
• ref-1:SHALL have a contained resource if a local reference is provided
  reference.startsWith('#').not() or (reference.substring(1).trace('url') in %resource.contained.id.trace('ids'))

• rim:n/a
• rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
• workflow:Request.basedOn

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

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

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())
• ref-1:SHALL have a contained resource if a local reference is provided
  reference.startsWith('#').not() or (reference.substring(1).trace('url') in %resource.contained.id.trace('ids'))

• rim:n/a
• rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
• workflow:Request.replaces

Each care plan is an independent request, such that having a care plan be part of another care plan can cause issues with cascading statuses. As such, this element is still being discussed.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())
• ref-1:SHALL have a contained resource if a local reference is provided
  reference.startsWith('#').not() or (reference.substring(1).trace('url') in %resource.contained.id.trace('ids'))

• rim:n/a
• rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)

Indicates whether the plan is currently being acted upon, represents future intentions or is now a historical record.

Allows clinicians to determine whether the plan is actionable or not.

The unknown code is not to be used to convey other statuses. The unknown code should be used when one of the statuses applies, but the authoring system doesn't know the current state of the care plan.

This element is labeled as a modifier because the status contains the code entered-in-error] that marks the plan as not currently valid.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• workflow:Request.status (uses different ValueSet)
• v2:PTH-5
• rim:.statusCode planned = new active = active completed = completed
• w5:status

Codes indicating the degree of authority/intentionality associated with a care plan

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

This element is labeled as a modifier because the intent alters when and how the resource is actually applicable.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

plan

• rim:n/a
• workflow:Request.intent

Identifies what "kind" of self-care plan this is to support differentiation between multiple co-existing plans.

Used for filtering what plan(s) are retrieved and displayed to different types of users.

There may be multiple axis of categorization and one plan may serve multiple purposes. In some cases, this may be redundant with references to CarePlan.concern.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• v2:CE/CNE/CWE
• rim:CD
• orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
• workflow:Request.supportingInfo
• w5:class

Note that FHIR strings may not exceed 1MB in size

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a

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.

• ele-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()

• rim:n/a
• rim:N/A

Allows for translations and alternate encodings within a code system. Also supports communication of the same instance to systems requiring different encodings.

Codes may be defined very casually in enumerations, or code lists, up to very formal definitions such as SNOMED CT - see the HL7 v3 Core Principles for more information. Ordering of codings is undefined and SHALL NOT be used to infer meaning. Generally, at most only one of the coding values will be labeled as UserSelected = true.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• v2:CE/CNE/CWE subset one of the sets of component 1-3 or 4-6
• rim:CV
• orim:fhir:Coding rdfs:subClassOf dt:CDCoding
• v2:C*E.1-8, C*E.10-22
• rim:union(., ./translation)
• orim:fhir:CodeableConcept.coding rdfs:subPropertyOf dt:CD.coding

Note that FHIR strings may not exceed 1MB in size

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a

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.

• ele-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()

• rim:n/a
• rim:N/A

Need to be unambiguous about the source of the definition of the symbol.

The URI may be an OID (urn:oid:...) or a UUID (urn:uuid:...). OIDs and UUIDs SHALL be references to the HL7 OID registry. Otherwise, the URI should come from HL7's list of FHIR defined special URIs or it should de-reference to some definition that establish the system clearly and unambiguously.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

http://phr.kanta.fi/CodeSystem/fiphr-cs-careplancategory

• rim:n/a
• v2:C*E.3
• rim:./codeSystem
• orim:fhir:Coding.system rdfs:subPropertyOf dt:CDCoding.codeSystem

Where the terminology does not clearly define what string should be used to identify code system versions, the recommendation is to use the date (expressed in FHIR date format) on which that version was officially published as the version date.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• v2:C*E.7
• rim:./codeSystemVersion
• orim:fhir:Coding.version rdfs:subPropertyOf dt:CDCoding.codeSystemVersion

Need to refer to a particular code in the system.

Note that FHIR strings may not exceed 1MB in size

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• v2:C*E.1
• rim:./code
• orim:fhir:Coding.code rdfs:subPropertyOf dt:CDCoding.code

Need to be able to carry a human-readable meaning of the code for readers that do not know the system.

Note that FHIR strings may not exceed 1MB in size

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• v2:C*E.2 - but note this is not well followed
• rim:CV.displayName
• orim:fhir:Coding.display rdfs:subPropertyOf dt:CDCoding.displayName

This has been identified as a clinical safety criterium - that this exact system/code pair was chosen explicitly, rather than inferred by the system based on some rules or language processing.

Amongst a set of alternatives, a directly chosen code is the most appropriate starting point for new translations. There is some ambiguity about what exactly 'directly chosen' implies, and trading partner agreement may be needed to clarify the use of this element and its consequences more completely.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• v2:Sometimes implied by being first
• rim:CD.codingRationale
• orim:fhir:Coding.userSelected fhir:mapsTo dt:CDCoding.codingRationale. fhir:Coding.userSelected fhir:hasMap fhir:Coding.userSelected.map. fhir:Coding.userSelected.map a fhir:Map; fhir:target dt:CDCoding.codingRationale. fhir:Coding.userSelected\#true a [ fhir:source "true"; fhir:target dt:CDCoding.codingRationale\#O ]

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.

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

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• v2:C*E.9. But note many systems use C*E.2 for this
• rim:./originalText[mediaType/code="text/plain"]/data
• orim:fhir:CodeableConcept.text rdfs:subPropertyOf dt:CD.originalText

Note that FHIR strings may not exceed 1MB in size

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a

Provides more detail than conveyed by category.

Note that FHIR strings may not exceed 1MB in size

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• w5:what

References SHALL be a reference to an actual FHIR resource, and SHALL be resolveable (allowing for access control, temporary unavailability, etc). Resolution can be either by retrieval from the URL, or, where applicable by resource type, by treating an absolute reference as a canonical URL and looking it up in a local registry/repository.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())
• ref-1:SHALL have a contained resource if a local reference is provided
  reference.startsWith('#').not() or (reference.substring(1).trace('url') in %resource.contained.id.trace('ids'))

• rim:n/a
• rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
• workflow:Request.subject
• v2:PID-3
• rim:.participation[typeCode=PAT].role[classCode=PAT]
• w5:who.focus

Note that FHIR strings may not exceed 1MB in size

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a

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.

• ele-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()

• rim:n/a
• rim:N/A

Using absolute URLs provides a stable scalable approach suitable for a cloud/web context, while using relative/logical references provides a flexible approach suitable for use when trading across closed eco-system boundaries. Absolute URLs do not need to point to a FHIR RESTful server, though this is the preferred approach. If the URL conforms to the structure "/[type]/[id]" then it should be assumed that the reference is to a FHIR RESTful server.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• rim:N/A

When an identifier is provided in place of a reference, any system processing the reference will only be able to resolve the identifier to a reference if it understands the business context in which the identifier is used. Sometimes this is global (e.g. a national identifier) but often it is not. For this reason, none of the useful mechanisms described for working with references (e.g. chaining, includes) are possible, nor should servers be expected to be able resolve the reference. Servers may accept an identifier based reference untouched, resolve it, and/or reject it - see CapabilityStatement.rest.resource.referencePolicy.

When both an identifier and a literal reference are provided, the literal reference is preferred. Applications processing the resource are allowed - but not required - to check that the identifier matches the literal reference

Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
• rim:II - see see identifier pattern at http://wiki.hl7.org/index.php?title=Common_Design_Patterns#Identifier_Pattern for relevant discussion. The Identifier class is a little looser than the v3 type II because it allows URIs as well as registered OIDs or GUIDs. Also maps to Role[classCode=IDENT]
• servd:Identifier
• rim:.identifier

This is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• rim:N/A

Activities conducted as a result of the care plan may well occur as part of other encounters/episodes.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())
• ref-1:SHALL have a contained resource if a local reference is provided
  reference.startsWith('#').not() or (reference.substring(1).trace('url') in %resource.contained.id.trace('ids'))

• rim:n/a
• rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
• workflow:Request.context
• v2:Associated PV1
• rim:.
• w5:context

Allows tracking what plan(s) are in effect at a particular time.

Any activities scheduled as part of the plan should be constrained to the specified period regardless of whether the activities are planned within a single encounter/episode or across multiple encounters/episodes (e.g. the longitudinal management of a chronic condition).

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())
• per-1:If present, start SHALL have a lower value than end
  start.empty() or end.empty() or (start <= end)

• rim:n/a
• v2:DR
• rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
• workflow:Request.occurrencePeriod
• v2:GOL-7 / GOL-8
• rim:.effectiveTime
• w5:when.init

Collaborative care plans may have multiple authors.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())
• ref-1:SHALL have a contained resource if a local reference is provided
  reference.startsWith('#').not() or (reference.substring(1).trace('url') in %resource.contained.id.trace('ids'))

• rim:n/a
• rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
• workflow:Request.requester.agent (if only one author)
• w5:who.source

Note that FHIR strings may not exceed 1MB in size

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a

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.

• ele-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()

• rim:n/a
• rim:N/A

Using absolute URLs provides a stable scalable approach suitable for a cloud/web context, while using relative/logical references provides a flexible approach suitable for use when trading across closed eco-system boundaries. Absolute URLs do not need to point to a FHIR RESTful server, though this is the preferred approach. If the URL conforms to the structure "/[type]/[id]" then it should be assumed that the reference is to a FHIR RESTful server.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• rim:N/A

When an identifier is provided in place of a reference, any system processing the reference will only be able to resolve the identifier to a reference if it understands the business context in which the identifier is used. Sometimes this is global (e.g. a national identifier) but often it is not. For this reason, none of the useful mechanisms described for working with references (e.g. chaining, includes) are possible, nor should servers be expected to be able resolve the reference. Servers may accept an identifier based reference untouched, resolve it, and/or reject it - see CapabilityStatement.rest.resource.referencePolicy.

When both an identifier and a literal reference are provided, the literal reference is preferred. Applications processing the resource are allowed - but not required - to check that the identifier matches the literal reference

Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
• rim:II - see see identifier pattern at http://wiki.hl7.org/index.php?title=Common_Design_Patterns#Identifier_Pattern for relevant discussion. The Identifier class is a little looser than the v3 type II because it allows URIs as well as registered OIDs or GUIDs. Also maps to Role[classCode=IDENT]
• servd:Identifier
• rim:.identifier

This is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• rim:N/A

Allows representation of care teams, helps scope care plan. In some cases may be a determiner of access permissions.

References SHALL be a reference to an actual FHIR resource, and SHALL be resolveable (allowing for access control, temporary unavailability, etc). Resolution can be either by retrieval from the URL, or, where applicable by resource type, by treating an absolute reference as a canonical URL and looking it up in a local registry/repository.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())
• ref-1:SHALL have a contained resource if a local reference is provided
  reference.startsWith('#').not() or (reference.substring(1).trace('url') in %resource.contained.id.trace('ids'))

• rim:n/a
• rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
• workflow:Request.performer (similar but does not entail CareTeam)
• w5:who.actor

Links plan to the conditions it manages. The element can identify risks addressed by the plan as well as active conditions. (The Condition resource can include things like "at risk for hypertension" or "fall risk".) Also scopes plans - multiple plans may exist addressing different concerns.

References SHALL be a reference to an actual FHIR resource, and SHALL be resolveable (allowing for access control, temporary unavailability, etc). Resolution can be either by retrieval from the URL, or, where applicable by resource type, by treating an absolute reference as a canonical URL and looking it up in a local registry/repository.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())
• ref-1:SHALL have a contained resource if a local reference is provided
  reference.startsWith('#').not() or (reference.substring(1).trace('url') in %resource.contained.id.trace('ids'))

• rim:n/a
• rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
• workflow:Request.reasonReference
• v2:PRB-4
• rim:.actRelationship[typeCode=SUBJ].target[classCode=CONC, moodCode=EVN]
• w5:why

Identifies barriers and other considerations associated with the care plan.

Use "concern" to identify specific conditions addressed by the care plan.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())
• ref-1:SHALL have a contained resource if a local reference is provided
  reference.startsWith('#').not() or (reference.substring(1).trace('url') in %resource.contained.id.trace('ids'))

• rim:n/a
• rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
• workflow:Request.supportingInfo

Note that FHIR strings may not exceed 1MB in size

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a

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.

• ele-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()

• rim:n/a
• rim:N/A

Using absolute URLs provides a stable scalable approach suitable for a cloud/web context, while using relative/logical references provides a flexible approach suitable for use when trading across closed eco-system boundaries. Absolute URLs do not need to point to a FHIR RESTful server, though this is the preferred approach. If the URL conforms to the structure "/[type]/[id]" then it should be assumed that the reference is to a FHIR RESTful server.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• rim:N/A

When an identifier is provided in place of a reference, any system processing the reference will only be able to resolve the identifier to a reference if it understands the business context in which the identifier is used. Sometimes this is global (e.g. a national identifier) but often it is not. For this reason, none of the useful mechanisms described for working with references (e.g. chaining, includes) are possible, nor should servers be expected to be able resolve the reference. Servers may accept an identifier based reference untouched, resolve it, and/or reject it - see CapabilityStatement.rest.resource.referencePolicy.

When both an identifier and a literal reference are provided, the literal reference is preferred. Applications processing the resource are allowed - but not required - to check that the identifier matches the literal reference

Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
• rim:II - see see identifier pattern at http://wiki.hl7.org/index.php?title=Common_Design_Patterns#Identifier_Pattern for relevant discussion. The Identifier class is a little looser than the v3 type II because it allows URIs as well as registered OIDs or GUIDs. Also maps to Role[classCode=IDENT]
• servd:Identifier
• rim:.identifier

This is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• rim:N/A

Provides context for plan. Allows plan effectiveness to be evaluated by clinicians.

Goal can be achieving a particular change or merely maintaining a current state or even slowing a decline.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())
• ref-1:SHALL have a contained resource if a local reference is provided
  reference.startsWith('#').not() or (reference.substring(1).trace('url') in %resource.contained.id.trace('ids'))

• rim:n/a
• rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
• v2:GOL.1
• rim:.outboundRelationship[typeCode<=OBJ].

Note that FHIR strings may not exceed 1MB in size

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a

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.

• ele-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()

• rim:n/a
• rim:N/A

Using absolute URLs provides a stable scalable approach suitable for a cloud/web context, while using relative/logical references provides a flexible approach suitable for use when trading across closed eco-system boundaries. Absolute URLs do not need to point to a FHIR RESTful server, though this is the preferred approach. If the URL conforms to the structure "/[type]/[id]" then it should be assumed that the reference is to a FHIR RESTful server.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• rim:N/A

When an identifier is provided in place of a reference, any system processing the reference will only be able to resolve the identifier to a reference if it understands the business context in which the identifier is used. Sometimes this is global (e.g. a national identifier) but often it is not. For this reason, none of the useful mechanisms described for working with references (e.g. chaining, includes) are possible, nor should servers be expected to be able resolve the reference. Servers may accept an identifier based reference untouched, resolve it, and/or reject it - see CapabilityStatement.rest.resource.referencePolicy.

When both an identifier and a literal reference are provided, the literal reference is preferred. Applications processing the resource are allowed - but not required - to check that the identifier matches the literal reference

Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
• rim:II - see see identifier pattern at http://wiki.hl7.org/index.php?title=Common_Design_Patterns#Identifier_Pattern for relevant discussion. The Identifier class is a little looser than the v3 type II because it allows URIs as well as registered OIDs or GUIDs. Also maps to Role[classCode=IDENT]
• servd:Identifier
• rim:.identifier

This is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• rim:N/A

Allows systems to prompt for performance of planned activities, and validate plans against best practice.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())
• cpl-3:Provide a reference or detail, not both
  detail.empty() or reference.empty()

• rim:n/a
• workflow:no mapping NOTE: This is a list of contained Request-Event tuples!
• rim:.outboundRelationship[typeCode=COMP].target

Note that FHIR strings may not exceed 1MB in size

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a

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.

• ele-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()

• rim:n/a
• rim:N/A

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.

• ele-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()

• rim:n/a
• rim:N/A

Identifies the results of the activity

Note that this should not duplicate the activity status (e.g. completed or in progress).

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• v2:CE/CNE/CWE
• rim:CD
• orim:fhir:CodeableConcept rdfs:subClassOf dt:CD

Note that FHIR strings may not exceed 1MB in size

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a

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.

• ele-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()

• rim:n/a
• rim:N/A

Allows for translations and alternate encodings within a code system. Also supports communication of the same instance to systems requiring different encodings.

Codes may be defined very casually in enumerations, or code lists, up to very formal definitions such as SNOMED CT - see the HL7 v3 Core Principles for more information. Ordering of codings is undefined and SHALL NOT be used to infer meaning. Generally, at most only one of the coding values will be labeled as UserSelected = true.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• v2:CE/CNE/CWE subset one of the sets of component 1-3 or 4-6
• rim:CV
• orim:fhir:Coding rdfs:subClassOf dt:CDCoding
• v2:C*E.1-8, C*E.10-22
• rim:union(., ./translation)
• orim:fhir:CodeableConcept.coding rdfs:subPropertyOf dt:CD.coding

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.

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

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• v2:C*E.9. But note many systems use C*E.2 for this
• rim:./originalText[mediaType/code="text/plain"]/data
• orim:fhir:CodeableConcept.text rdfs:subPropertyOf dt:CD.originalText

Links plan to resulting actions.

The activity outcome is independent of the outcome of the related goal(s). For example, if the goal is to achieve a target body weight of 150 lb and an activity is defined to diet, then the activity outcome could be calories consumed whereas the goal outcome is an observation for the actual body weight measured.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())
• ref-1:SHALL have a contained resource if a local reference is provided
  reference.startsWith('#').not() or (reference.substring(1).trace('url') in %resource.contained.id.trace('ids'))

• rim:n/a
• rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
• workflow:Event that is outcome of Request in activity.reference
• rim:.inboundRelationship[typeCode=FLFS].source

Can be used to capture information about adherence, progress, concerns, etc.

This element should NOT be used to describe the activity to be performed - that occurs either within the resource pointed to by activity.detail.reference or in activity.detail.description.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• v2:N/A
• rim:Act
• workflow:Event.status (Annotation instead of CodableConcept)
• v2:NTE?
• rim:.inboundRelationship[typeCode=SUBJ].source[classCode=OBS, moodCode=EVN, code="annotation"].value

Note that FHIR strings may not exceed 1MB in size

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a

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.

• ele-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()

• rim:n/a
• rim:N/A

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• v2:N/A
• rim:Act.participant[typeCode=AUT].role

Note that FHIR strings may not exceed 1MB in size

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a

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.

• ele-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()

• rim:n/a
• rim:N/A

Using absolute URLs provides a stable scalable approach suitable for a cloud/web context, while using relative/logical references provides a flexible approach suitable for use when trading across closed eco-system boundaries. Absolute URLs do not need to point to a FHIR RESTful server, though this is the preferred approach. If the URL conforms to the structure "/[type]/[id]" then it should be assumed that the reference is to a FHIR RESTful server.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• rim:N/A

When an identifier is provided in place of a reference, any system processing the reference will only be able to resolve the identifier to a reference if it understands the business context in which the identifier is used. Sometimes this is global (e.g. a national identifier) but often it is not. For this reason, none of the useful mechanisms described for working with references (e.g. chaining, includes) are possible, nor should servers be expected to be able resolve the reference. Servers may accept an identifier based reference untouched, resolve it, and/or reject it - see CapabilityStatement.rest.resource.referencePolicy.

When both an identifier and a literal reference are provided, the literal reference is preferred. Applications processing the resource are allowed - but not required - to check that the identifier matches the literal reference

Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
• rim:II - see see identifier pattern at http://wiki.hl7.org/index.php?title=Common_Design_Patterns#Identifier_Pattern for relevant discussion. The Identifier class is a little looser than the v3 type II because it allows URIs as well as registered OIDs or GUIDs. Also maps to Role[classCode=IDENT]
• servd:Identifier
• rim:.identifier

This is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• rim:N/A

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• v2:N/A
• rim:Act.effectiveTime

Note that FHIR strings may not exceed 1MB in size

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• v2:N/A
• rim:Act.text

Details in a form consistent with other applications and contexts of use.

Standard extension exists (goal-pertainstogoal) that allows goals to be referenced from any of the referenced resources in CarePlan.activity.reference.
The goal should be visible when the resource referenced by CarePlan.activity.reference is viewed indepedently from the CarePlan. Requests that are pointed to by a CarePlan using this element should not point to this CarePlan using the "basedOn" element. i.e. Requests that are part of a CarePlan are not "based on" the CarePlan.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())
• ref-1:SHALL have a contained resource if a local reference is provided
  reference.startsWith('#').not() or (reference.substring(1).trace('url') in %resource.contained.id.trace('ids'))

• rim:n/a
• rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
• workflow:Request that resulted in Event in activity.actionResulting
• rim:.outboundRelationship[typeCode=COMP].target

Details in a simple form for generic care plan systems.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• rim:.outboundRelationship[typeCode=COMP, subsetCode=SUMM].target

Note that FHIR strings may not exceed 1MB in size

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a

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.

• ele-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()

• rim:n/a
• rim:N/A

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.

• ele-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()

• rim:n/a
• rim:N/A

High-level categorization of the type of activity in a self-care plan.

May determine what types of extensions are permitted.

Not all terminology uses fit this general pattern. In some cases, models should not use CodeableConcept and use Coding directly and provide their own structure for managing text, codings, translations and the relationship between elements and pre- and post-coordination.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• v2:CE/CNE/CWE
• rim:CD
• orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
• workflow:Request.supportingInformation
• rim:.inboundRelationship[typeCode=COMP].source[classCode=LIST].code

Note that FHIR strings may not exceed 1MB in size

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a

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.

• ele-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()

• rim:n/a
• rim:N/A

Allows for translations and alternate encodings within a code system. Also supports communication of the same instance to systems requiring different encodings.

Codes may be defined very casually in enumerations, or code lists, up to very formal definitions such as SNOMED CT - see the HL7 v3 Core Principles for more information. Ordering of codings is undefined and SHALL NOT be used to infer meaning. Generally, at most only one of the coding values will be labeled as UserSelected = true.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• v2:CE/CNE/CWE subset one of the sets of component 1-3 or 4-6
• rim:CV
• orim:fhir:Coding rdfs:subClassOf dt:CDCoding
• v2:C*E.1-8, C*E.10-22
• rim:union(., ./translation)
• orim:fhir:CodeableConcept.coding rdfs:subPropertyOf dt:CD.coding

Note that FHIR strings may not exceed 1MB in size

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a

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.

• ele-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()

• rim:n/a
• rim:N/A

Need to be unambiguous about the source of the definition of the symbol.

The URI may be an OID (urn:oid:...) or a UUID (urn:uuid:...). OIDs and UUIDs SHALL be references to the HL7 OID registry. Otherwise, the URI should come from HL7's list of FHIR defined special URIs or it should de-reference to some definition that establish the system clearly and unambiguously.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

http://phr.kanta.fi/CodeSystem/fiphr-cs-activitycategory

• rim:n/a
• v2:C*E.3
• rim:./codeSystem
• orim:fhir:Coding.system rdfs:subPropertyOf dt:CDCoding.codeSystem

Where the terminology does not clearly define what string should be used to identify code system versions, the recommendation is to use the date (expressed in FHIR date format) on which that version was officially published as the version date.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• v2:C*E.7
• rim:./codeSystemVersion
• orim:fhir:Coding.version rdfs:subPropertyOf dt:CDCoding.codeSystemVersion

Need to refer to a particular code in the system.

Note that FHIR strings may not exceed 1MB in size

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• v2:C*E.1
• rim:./code
• orim:fhir:Coding.code rdfs:subPropertyOf dt:CDCoding.code

Need to be able to carry a human-readable meaning of the code for readers that do not know the system.

Note that FHIR strings may not exceed 1MB in size

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• v2:C*E.2 - but note this is not well followed
• rim:CV.displayName
• orim:fhir:Coding.display rdfs:subPropertyOf dt:CDCoding.displayName

This has been identified as a clinical safety criterium - that this exact system/code pair was chosen explicitly, rather than inferred by the system based on some rules or language processing.

Amongst a set of alternatives, a directly chosen code is the most appropriate starting point for new translations. There is some ambiguity about what exactly 'directly chosen' implies, and trading partner agreement may be needed to clarify the use of this element and its consequences more completely.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• v2:Sometimes implied by being first
• rim:CD.codingRationale
• orim:fhir:Coding.userSelected fhir:mapsTo dt:CDCoding.codingRationale. fhir:Coding.userSelected fhir:hasMap fhir:Coding.userSelected.map. fhir:Coding.userSelected.map a fhir:Map; fhir:target dt:CDCoding.codingRationale. fhir:Coding.userSelected\#true a [ fhir:source "true"; fhir:target dt:CDCoding.codingRationale\#O ]

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.

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

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• v2:C*E.9. But note many systems use C*E.2 for this
• rim:./originalText[mediaType/code="text/plain"]/data
• orim:fhir:CodeableConcept.text rdfs:subPropertyOf dt:CD.originalText

Allows Questionnaires that the patient (or practitioner) should fill in to fulfill the care plan activity.

References SHALL be a reference to an actual FHIR resource, and SHALL be resolveable (allowing for access control, temporary unavailability, etc). Resolution can be either by retrieval from the URL, or, where applicable by resource type, by treating an absolute reference as a canonical URL and looking it up in a local registry/repository.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())
• ref-1:SHALL have a contained resource if a local reference is provided
  reference.startsWith('#').not() or (reference.substring(1).trace('url') in %resource.contained.id.trace('ids'))

• rim:n/a
• rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
• workflow:Request.definition

Note that FHIR strings may not exceed 1MB in size

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a

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.

• ele-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()

• rim:n/a
• rim:N/A

Using absolute URLs provides a stable scalable approach suitable for a cloud/web context, while using relative/logical references provides a flexible approach suitable for use when trading across closed eco-system boundaries. Absolute URLs do not need to point to a FHIR RESTful server, though this is the preferred approach. If the URL conforms to the structure "/[type]/[id]" then it should be assumed that the reference is to a FHIR RESTful server.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• rim:N/A

When an identifier is provided in place of a reference, any system processing the reference will only be able to resolve the identifier to a reference if it understands the business context in which the identifier is used. Sometimes this is global (e.g. a national identifier) but often it is not. For this reason, none of the useful mechanisms described for working with references (e.g. chaining, includes) are possible, nor should servers be expected to be able resolve the reference. Servers may accept an identifier based reference untouched, resolve it, and/or reject it - see CapabilityStatement.rest.resource.referencePolicy.

When both an identifier and a literal reference are provided, the literal reference is preferred. Applications processing the resource are allowed - but not required - to check that the identifier matches the literal reference

Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
• rim:II - see see identifier pattern at http://wiki.hl7.org/index.php?title=Common_Design_Patterns#Identifier_Pattern for relevant discussion. The Identifier class is a little looser than the v3 type II because it allows URIs as well as registered OIDs or GUIDs. Also maps to Role[classCode=IDENT]
• servd:Identifier
• rim:.identifier

This is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• rim:N/A

Detailed description of the type of activity; e.g. What lab test, what procedure, what kind of encounter.

Allows matching performed to planned as well as validation against protocols.

Tends to be less relevant for activities involving particular products. Codes should not convey negation - use "prohibited" instead.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• v2:CE/CNE/CWE
• rim:CD
• orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
• workflow:Request.code
• v2:OBR-4 / RXE-2 / RXO-1 / RXD-2
• rim:.code

Note that FHIR strings may not exceed 1MB in size

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a

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.

• ele-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()

• rim:n/a
• rim:N/A

Allows for translations and alternate encodings within a code system. Also supports communication of the same instance to systems requiring different encodings.

Codes may be defined very casually in enumerations, or code lists, up to very formal definitions such as SNOMED CT - see the HL7 v3 Core Principles for more information. Ordering of codings is undefined and SHALL NOT be used to infer meaning. Generally, at most only one of the coding values will be labeled as UserSelected = true.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• v2:CE/CNE/CWE subset one of the sets of component 1-3 or 4-6
• rim:CV
• orim:fhir:Coding rdfs:subClassOf dt:CDCoding
• v2:C*E.1-8, C*E.10-22
• rim:union(., ./translation)
• orim:fhir:CodeableConcept.coding rdfs:subPropertyOf dt:CD.coding

Note that FHIR strings may not exceed 1MB in size

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a

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.

• ele-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()

• rim:n/a
• rim:N/A

Need to be unambiguous about the source of the definition of the symbol.

The URI may be an OID (urn:oid:...) or a UUID (urn:uuid:...). OIDs and UUIDs SHALL be references to the HL7 OID registry. Otherwise, the URI should come from HL7's list of FHIR defined special URIs or it should de-reference to some definition that establish the system clearly and unambiguously.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• v2:C*E.3
• rim:./codeSystem
• orim:fhir:Coding.system rdfs:subPropertyOf dt:CDCoding.codeSystem

Where the terminology does not clearly define what string should be used to identify code system versions, the recommendation is to use the date (expressed in FHIR date format) on which that version was officially published as the version date.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• v2:C*E.7
• rim:./codeSystemVersion
• orim:fhir:Coding.version rdfs:subPropertyOf dt:CDCoding.codeSystemVersion

Need to refer to a particular code in the system.

Note that FHIR strings may not exceed 1MB in size

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• v2:C*E.1
• rim:./code
• orim:fhir:Coding.code rdfs:subPropertyOf dt:CDCoding.code

Need to be able to carry a human-readable meaning of the code for readers that do not know the system.

Note that FHIR strings may not exceed 1MB in size

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• v2:C*E.2 - but note this is not well followed
• rim:CV.displayName
• orim:fhir:Coding.display rdfs:subPropertyOf dt:CDCoding.displayName

This has been identified as a clinical safety criterium - that this exact system/code pair was chosen explicitly, rather than inferred by the system based on some rules or language processing.

Amongst a set of alternatives, a directly chosen code is the most appropriate starting point for new translations. There is some ambiguity about what exactly 'directly chosen' implies, and trading partner agreement may be needed to clarify the use of this element and its consequences more completely.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• v2:Sometimes implied by being first
• rim:CD.codingRationale
• orim:fhir:Coding.userSelected fhir:mapsTo dt:CDCoding.codingRationale. fhir:Coding.userSelected fhir:hasMap fhir:Coding.userSelected.map. fhir:Coding.userSelected.map a fhir:Map; fhir:target dt:CDCoding.codingRationale. fhir:Coding.userSelected\#true a [ fhir:source "true"; fhir:target dt:CDCoding.codingRationale\#O ]

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.

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

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• v2:C*E.9. But note many systems use C*E.2 for this
• rim:./originalText[mediaType/code="text/plain"]/data
• orim:fhir:CodeableConcept.text rdfs:subPropertyOf dt:CD.originalText

Identifies why a care plan activity is needed. Can include any health condition codes as well as such concepts as "general wellness", prophylaxis, surgical preparation, etc.

This could be a diagnosis code. If a full condition record exists or additional detail is needed, use reasonCondition instead.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• v2:CE/CNE/CWE
• rim:CD
• orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
• workflow:Request.reasonCode

Note that FHIR strings may not exceed 1MB in size

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a

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.

• ele-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()

• rim:n/a
• rim:N/A

Allows for translations and alternate encodings within a code system. Also supports communication of the same instance to systems requiring different encodings.

Codes may be defined very casually in enumerations, or code lists, up to very formal definitions such as SNOMED CT - see the HL7 v3 Core Principles for more information. Ordering of codings is undefined and SHALL NOT be used to infer meaning. Generally, at most only one of the coding values will be labeled as UserSelected = true.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• v2:CE/CNE/CWE subset one of the sets of component 1-3 or 4-6
• rim:CV
• orim:fhir:Coding rdfs:subClassOf dt:CDCoding
• v2:C*E.1-8, C*E.10-22
• rim:union(., ./translation)
• orim:fhir:CodeableConcept.coding rdfs:subPropertyOf dt:CD.coding

Note that FHIR strings may not exceed 1MB in size

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a

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.

• ele-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()

• rim:n/a
• rim:N/A

Need to be unambiguous about the source of the definition of the symbol.

The URI may be an OID (urn:oid:...) or a UUID (urn:uuid:...). OIDs and UUIDs SHALL be references to the HL7 OID registry. Otherwise, the URI should come from HL7's list of FHIR defined special URIs or it should de-reference to some definition that establish the system clearly and unambiguously.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• v2:C*E.3
• rim:./codeSystem
• orim:fhir:Coding.system rdfs:subPropertyOf dt:CDCoding.codeSystem

Where the terminology does not clearly define what string should be used to identify code system versions, the recommendation is to use the date (expressed in FHIR date format) on which that version was officially published as the version date.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• v2:C*E.7
• rim:./codeSystemVersion
• orim:fhir:Coding.version rdfs:subPropertyOf dt:CDCoding.codeSystemVersion

Need to refer to a particular code in the system.

Note that FHIR strings may not exceed 1MB in size

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• v2:C*E.1
• rim:./code
• orim:fhir:Coding.code rdfs:subPropertyOf dt:CDCoding.code

Need to be able to carry a human-readable meaning of the code for readers that do not know the system.

Note that FHIR strings may not exceed 1MB in size

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• v2:C*E.2 - but note this is not well followed
• rim:CV.displayName
• orim:fhir:Coding.display rdfs:subPropertyOf dt:CDCoding.displayName

This has been identified as a clinical safety criterium - that this exact system/code pair was chosen explicitly, rather than inferred by the system based on some rules or language processing.

Amongst a set of alternatives, a directly chosen code is the most appropriate starting point for new translations. There is some ambiguity about what exactly 'directly chosen' implies, and trading partner agreement may be needed to clarify the use of this element and its consequences more completely.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• v2:Sometimes implied by being first
• rim:CD.codingRationale
• orim:fhir:Coding.userSelected fhir:mapsTo dt:CDCoding.codingRationale. fhir:Coding.userSelected fhir:hasMap fhir:Coding.userSelected.map. fhir:Coding.userSelected.map a fhir:Map; fhir:target dt:CDCoding.codingRationale. fhir:Coding.userSelected\#true a [ fhir:source "true"; fhir:target dt:CDCoding.codingRationale\#O ]

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.

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

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())

• rim:n/a
• v2:C*E.9. But note many systems use C*E.2 for this
• rim:./originalText[mediaType/code="text/plain"]/data
• orim:fhir:CodeableConcept.text rdfs:subPropertyOf dt:CD.originalText

Conditions can be identified at the activity level that are not identified as reasons for the overall plan.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())
• ref-1:SHALL have a contained resource if a local reference is provided
  reference.startsWith('#').not() or (reference.substring(1).trace('url') in %resource.contained.id.trace('ids'))

• rim:n/a
• rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
• workflow:Request.reasonReference

So that participants know the link explicitly.

References SHALL be a reference to an actual FHIR resource, and SHALL be resolveable (allowing for access control, temporary unavailability, etc). Resolution can be either by retrieval from the URL, or, where applicable by resource type, by treating an absolute reference as a canonical URL and looking it up in a local registry/repository.

• ele-1:All FHIR elements must have a @value or children
  hasValue() | (children().count() > id.count())
• ref-1:SHALL have a contained resource if a local reference is provided
  reference.startsWith('#').not() or (reference.substring(1).trace('url') in %resource.contained.id.trace('ids'))