Canonical Resource Management Infrastructure Implementation Guide
1.0.0-ballot - Ballot International flag

This page is part of the Canonical Resource Management Infrastructure Implementation Guide (v1.0.0-ballot: STU1 Ballot 1) based on FHIR R4. . For a full list of available versions, see the Directory of published versions

Artifacts Summary

This page provides a list of the FHIR artifacts defined as part of this implementation guide.

Behavior: Capability Statements

The following artifacts define the specific capabilities that different types of systems are expected to have in order to comply with this implementation guide. Systems conforming to this implementation guide are expected to declare conformance to one or more of the following capability statements.

CRMI Artifact Terminology Service

Capability statement for a terminology service supporting artifact authoring and evaulation use cases. A server can support more functionality than defined here, but this defines the minimum expectations.

CRMI Authoring Artifact Repository

Capability statement for a repository service supporting additional authoring and content workflow capabilities for FHIR-based knowledge artifacts above the basic ShareableArtifactRepository.

CRMI Publishable Artifact Repository

Capability statement for a repository service supporting additional publishing capabilities for FHIR-based knowledge artifacts above the basic ShareableArtifactRepository.

CRMI Shareable Artifact Repository

Capability statement for a repository service supporting minimum required capabilities to share FHIR-based artifact specifications. See the Publishable and Authoring Artifact Repository capability statements for more comprehensive support for publishing and authoring workflows.

Behavior: Operation Definitions

These are custom operations that can be supported by and/or invoked by systems conforming to this implementation guide.

CRMI Data Requirements Operation

Determines the effective data requirements for the artifact, including known components and dependencies, and optionally informed by a version manifest.

See $crmi.package and $crmi.data-requirements

TODO: Add example of the use-case that will do dependency tracing, similar to $package but returns only the information and not the actual resources.

CRMI Extension of Value Set Expansion

The definition of a value set is used to create a simple collection of codes suitable for use for data entry or validation.

If the operation is not called at the instance level, one of the in parameters url, context or valueSet must be provided. An expanded value set will be returned, or an OperationOutcome with an error message.

CRMI Package Operation

Packages a specified canonical resource with dependencies.

See $package and $data-requirements

Get Package

Retrieves a FHIR package given the package id and version.

crmi-release

The release operation supports updating the status of an existing draft artifact to active. The operation sets the date element of the resource and pins versions of all direct and transitive references and records them in the program’s manifest. Child artifacts (i.e. artifacts of which the existing artifact is composed) are also released, recursively.

Structures: Resource Profiles

These define constraints on FHIR resources for systems conforming to this implementation guide.

CRMI Capability Statement

The CRMI Capability Statement Profile enables capability statements to express supported CQL versions.

CRMI CareTeamDefinition

Represents the definition of a careteam, suitable for use in various contexts

CRMI Computable Library

The CRMI Computable Library profile defines the must support elements for a computable library used to support artifact logic

CRMI Computable ValueSet

Defines a computable value set as one that SHALL have an expression-based definition (i.e. a value set defined intensionally using expressions of the code systems involved) and MAY have an expansion included. The expression-based definition SHALL be represented in only one of three ways; using the compose element, using the expression extension, or using the rules-text extension to provide a step-by-step process for expanding the value set definition

CRMI Executable Library

The CRMI Execuable Library profile defines the must support elements for an executable library used to support artifact logic

CRMI Executable ValueSet

Defines an executable value set as one that SHALL have an expansion included, as well as a usage warning indicating the expansion is a point-in-time snapshot and must be maintained over time for production usage. The value set expansion specifies the timestamp when the expansion was produced, SHOULD contain the parameters used for the expansion, and SHALL contain the codes that are obtained by evaluating the value set definition. If this is ONLY an executable value set, a computable definition of the value set must be obtained to compute the updated expansion.

CRMI GroupDefinition

Represents the definition of a group of subjects, suitable for use in various contexts, such as a cohort definition, a recommendation inclusion or exclusion criteria, the members of a study, or a population criteria

CRMI LocationDefinition

Represents the definition of a location, suitable for use in various contexts, such as a facility definition

CRMI Manifest Library

Defines and supports the definition of a manifest used to establish specific versions of dependencies used in a collection of knowledge artifacts

CRMI MedicationDefinition

Represents the definition of a medication, suitable for use in various contexts

CRMI MedicationKnowledge Definition

Represents the definition of medication knowledge, suitable for use in various contexts

CRMI Model Info Library

The CRMI Model Information Library profile defines the must support elements for a computable Model Definition library used to support declaration and distribution of CQL ModelInfo such as the FHIR Model Info Library

CRMI Module Definition Library

The CRMI Module Definition Library profile defines the must support elements for a library that communicates the effective data requirements and dependencies of an artifact (or set of artifacts). This is most commonly used as the result of a $data-requirements operation, but could also be persisted statically as a way to persist the calculation of effective data requirements for a specific artifact and input parameters

CRMI PractitionerRoleDefinition

Represents the definition of a practitionerrole, suitable for use in various contexts

CRMI Publishable ActivityDefinition

Supports declaration of the ActivityDefinition metadata required by HL7 and other organizations that share and publish activity definitions with a focus on the aspects of that metadata that are important for post-publication activities including distribution, inclusion in repositories, consumption, and implementation.

CRMI Publishable CapabilityStatement

Supports declaration of the CapabilityStatement metadata required by HL7 and other organizations that share and publish capability statements with a focus on the aspects of that metadata that are important for post-publication activities including distribution, inclusion in repositories, consumption, and implementation.

CRMI Publishable CodeSystem

Defines and enforces the minimum expectations for publication and distribution of a code system, typically as part of an artifact repository or implementation guide publication

CRMI Publishable ConceptMap

Defines and enforces the minimum expectations for publication and distribution of a concept map, typically as part of an artifact repository or implementation guide publication

CRMI Publishable GraphDefinition

Supports declaration of the GraphDefinition metadata required by HL7 and other organizations that share and publish graph definitions with a focus on the aspects of that metadata that are important for post-publication activities including distribution, inclusion in repositories, consumption, and implementation.

CRMI Publishable ImplementationGuide

Supports declaration of the ImplementationGuide metadata required by HL7 and other organizations that share and publish implementation guides with a focus on the aspects of that metadata that are important for post-publication activities including distribution, inclusion in repositories, consumption, and implementation.

CRMI Publishable Library

Supports declaration of the library metadata required by HL7 and other organizations that share and publish libraries with a focus on the aspects of that metadata that are important for post-publication activities including distribution, inclusion in repositories, consumption, and implementation.

CRMI Publishable Measure

Supports declaration of the Measure metadata required by HL7 and other organizations that share and publish measures with a focus on the aspects of that metadata that are important for post-publication activities including distribution, inclusion in repositories, consumption, and implementation.

CRMI Publishable NamingSystem

Defines and enforces the minimum expectations for publication and distribution of a naming system, typically as part of an artifact repository or implementation guide publication

CRMI Publishable OperationDefinition

Supports declaration of the OperationDefinition metadata required by HL7 and other organizations that share and publish operation definitions with a focus on the aspects of that metadata that are important for post-publication activities including distribution, inclusion in repositories, consumption, and implementation.

CRMI Publishable PlanDefinition

Supports declaration of the PlanDefinition metadata required by HL7 and other organizations that share and publish plandefinitions with a focus on the aspects of that metadata that are important for post-publication activities including distribution, inclusion in repositories, consumption, and implementation.

CRMI Publishable Questionnaire

Supports declaration of the Questionnaire metadata required by HL7 and other organizations that share and publish questionnaires with a focus on the aspects of that metadata that are important for post-publication activities including distribution, inclusion in repositories, consumption, and implementation.

CRMI Publishable SearchParameter

Supports declaration of the SearchParameter metadata required by HL7 and other organizations that share and publish search parameters with a focus on the aspects of that metadata that are important for post-publication activities including distribution, inclusion in repositories, consumption, and implementation.

CRMI Publishable StructureDefinition

Supports declaration of the StructureDefinition metadata required by HL7 and other organizations that share and publish structure definitions with a focus on the aspects of that metadata that are important for post-publication activities including distribution, inclusion in repositories, consumption, and implementation.

CRMI Publishable TerminologyCapabilities

Supports declaration of the TerminologyCapabilities metadata required by HL7 and other organizations that share and publish terminology capabilities with a focus on the aspects of that metadata that are important for post-publication activities including distribution, inclusion in repositories, consumption, and implementation.

CRMI Publishable ValueSet

Defines and enforces the minimum expectations for publication and distribution of a value set, typically as part of an artifact repository or implementation guide publication

CRMI Shareable ActivityDefinition

Enforces the minimum information set for the activity definition metadata required by HL7 and other organizations that share and publish activity definitions

CRMI Shareable CapabilityStatement

Enforces the minimum information set for the capabilitystatement metadata required by HL7 and other organizations that share and publish capability statements

CRMI Shareable CodeSystem

Enforces the minimum information set for the code system metadata required by HL7 and other organizations that share and publish code systems

CRMI Shareable ConceptMap

Enforces the minimum information set for the concept map metadata required by HL7 and other organizations that share and publish concept maps

CRMI Shareable GraphDefinition

Enforces the minimum information set for the graph definition metadata required by HL7 and other organizations that share and publish graph definitions

CRMI Shareable ImplementationGuide

Enforces the minimum information set for the implementation guide metadata required by HL7 and other organizations that share and publish implementation guides

CRMI Shareable Library

Enforces the minimum information set for the library metadata required by HL7 and other organizations that share and publish libraries

CRMI Shareable Measure

Enforces the minimum information set for the measure metadata required by HL7 and other organizations that share and publish measures

CRMI Shareable NamingSystem

Enforces the minimum information set for the naming system metadata required by HL7 and other organizations that share and publish naming systems

CRMI Shareable OperationDefinition

Enforces the minimum information set for the operation definition metadata required by HL7 and other organizations that share and publish operation definitions

CRMI Shareable PlanDefinition

Enforces the minimum information set for the plan definition metadata required by HL7 and other organizations that share and publish plan definitions

CRMI Shareable Questionnaire

Enforces the minimum information set for the questionnaire metadata required by HL7 and other organizations that share and publish questionnaires

CRMI Shareable SearchParameter

Enforces the minimum information set for the search parameter metadata required by HL7 and other organizations that share and publish search parameters

CRMI Shareable StructureDefinition

Enforces the minimum information set for the structure definition metadata required by HL7 and other organizations that share and publish structure definitions

CRMI Shareable TerminologyCapabilities

Enforces the minimum information set for the terminology capabilities metadata required by HL7 and other organizations that share and publish terminology capabilities

CRMI Shareable ValueSet

Enforces the minimum information set for the value set metadata required by HL7 and other organizations that share and publish value sets

CRMI Software System Device

The Software System device profile is used to capture software details about the various systems used in authoring, testing, packaging, or evaluation of a knowledge artifact

CRMI SubstanceDefinition

Represents the definition of a substance, suitable for use in various contexts

Structures: Extension Definitions

These define constraints on FHIR data types for systems conforming to this implementation guide.

Artifact Approval Date

When the artifact was approved by publisher.

Artifact Comment

A comment containing additional documentation, a review comment, usage guidance, or other relevant information from a particular user.

Artifact Effective Period

When the artifact is expected to be used.

Artifact Is Owned

Whether or not the referenced artifact is owned by the referencing artifact.

Artifact Last Review Date

When the artifact was last reviewed by the publisher.

Artifact Release Description

Release notes for a release of an artifact.

Artifact Release Label

A human-friendly release label assigned for the version.

Artifact Usage

Describes the clinical usage of the artifact.

Artifact Version Algorithm

Indicates the mechanism used to compare versions to determine which is more current.

Artifact Version Policy

Describes the versioning policy of the artifact.

CRMI Effective Data Requirements

A module definition library that contains the effective data requirements for an artifact (i.e. the calculated data requirements for the expressions directly referenced by the artifact structure).

CRMI Software System

Specifies the software systems used in the packaging and testing of knowledge artifacts. Specifically to support explicitly stating which versions of the various software components were used in the authoring, packaging, and testing.

Default Value

Provides a default value for a parameter definition.

Definition Term

Specifies a term and its associated definition.

Expansion Parameters

Specifies the expansion parameters that should be used to expand the ValueSet, or any ValueSets in the Library (or referenced by components of the Library).

FHIR Query Pattern

A FHIR Query URL pattern that corresponds to the data specified by the data requirement. If multiple FHIR Query URLs are present, they each contribute to the data specified by the data requirement (i.e. the union of the results of the FHIR Queries represents the complete data for the data requirement). This is not a resolveable URL, in that it will contain 1) No base canonical (i.e. it’s a relative query), and 2) Parameters using tokens that are delimited using double-braces and the context parameters are dependent solely on the subjectType, according to the following: Patient: context.patientId, Practitioner: context.practitionerId, Organization: context.organizationId, Location: context.locationId, Device: context.deviceId.

Is Primary Citation

Specifies whether the related artifact is defining a primary citation for the artifact (i.e. one that should appear in the narrative for the artifact specification.

Is Selective

Allows a given data requirement to be identified as “selective”, meaning that it can be used as an additive criteria to filter a population. A selective data requirement is guaranteed to define a subset (not necessarily proper) of the initial population of an artifact. If multiple data requirements are marked selective, they all apply (i.e. AND semantics).

Messages

An OperationOutcome that contains any information, warning, and/or error messages that were generated while processing an operation such as $evaluate or $prepopulate.

ModelInfo Is Included

Specifies whether the profile should be included in the model info constructed for an artifact collection such as an implementation guide. If this extension is not present, included is true by default for resources and profiles, but not data types (unless they are indirectly referenced by included resources or profiles). Note that even if isIncluded is false for a resource or profile, it will still be included in model info if it is a required dependency of some other included resource, profile, or data type.

ModelInfo Is Retrievable

Specifies whether the class constructed for the profile should be marked as retrievable in the model info (meaning whether or not it can appear as the target of a retrieve expression). If this value is not specified, retrievable is true for resources and false for data types.

ModelInfo Label

Specifies the label for the class constructed in the model info for the profile (i.e. an alternative, user-friendly name that can be used as the identifier for the class in CQL expressions).

ModelInfo Primary Code Path

Specifies the primary code path for the class constructed in the model info for the profile (i.e. the path to the code-valued element on the resource that should be used as the default terminology filter when no terminology target is specified in a CQL retrieve).

ModelInfo Settings

Specifies the settings to be used for constructing modelinfo from profile definitions.

Not Done ValueSet

A logical reference (e.g. a reference to ValueSet.url) to a value set/version that identifies a set of possible coded values representing activities that were not requested, ordered, or performed.

Resource Type

Specifies the type of resource the canonical references.

Scope

Defines the scope of an artifact as a string of the form {namespace-name}[@{namespace-uri}]. Namespace name shall be a valid NPM package id, and namespace uri shall be a valid uri. For FHIR implementation guides, scope is inferred using the package id and the base canonical. e.g. fhir.cqf.common@http://fhir.org/guides/cqf/common. This extension can be used on Implementation Guides, Libraries, on any knowledge artifact, to declare the scope of the artifact. In the absence of an explicit scope declaration, the scope of an artifact is inferred based on the IG in which the artifact is defined.

Value Filter

Allows additional value-based filters to be specified as part of a data requirement.

Terminology: Value Sets

These define sets of codes used by systems conforming to this implementation guide.

Artifact Comment Type

The type of artifact comment (documentation, review, guidance)

Artifact Version Policy Values

The versioning policy of an artifact or set of artifacts (metadata or strict)

Knowledge Capability Values

A capability afforded by a knowledge artifact, e.g. shareable, computable, publishable, executable

Knowledge Representation Level Values

A knowledge representation level, narrative, semi-structured, structured, and executable

Value Filter Comparator

The type of comparator operator to use

Terminology: Code Systems

These define new code systems used by systems conforming to this implementation guide.

Artifact Version Policy Codes

The versioning policy of an artifact (metadata, strict)

CRMI Release Version Behavior Codes

Behaviors of ‘version’ parameter application in the $release operation.

Knowledge Capability Codes

A capability afforded by a knowledge artifact, e.g. shareable, computable, publishable, executable

Knowledge Representation Level Codes

A knowledge representation level, narrative, semi-structured, structured, and executable

Software System Type Codes

The type of software system (authoring, testing, tooling, evaluation)

Example: Example Instances

These are example instances that show what data produced and consumed by systems conforming with this implementation guide might look like.

ANCCohort

Cohort definition for antenatal care

CRMI Release Version Behavior

Behaviors of ‘version’ parameter application in the $release operation.

FHIRCommon

This library defines terminologies and functions commonly used in FHIR-based CQL artifacts.

Software System Type

The type of software system (authoring, testing, tooling, evaluation)

anc-b5-de49

Codes representing possible values for the Danger Signs - No danger signs element

anc-b5-de50

Codes representing possible values for the Danger signs element

anc-b5-de51

Codes representing possible values for the Danger Signs - Central cyanosis element

computable-example-library

This library defines terminologies and functions commonly used in FHIR-based CQL artifacts.

computable-example-valueset

Group Valueset with codes representing possible values for the Danger signs Codes Grouper element

cqf-tooling

Example of a SoftwareSystemDevice indicating what tooling was used to process knowledge artifact content

definition-example-careteam

Example of a reusable definition of a CareTeam

definition-example-group

Example of a GroupDefinition

definition-example-location

Example of a reusable definition of a Location

definition-example-medication

Example of a reusable medication definition

definition-example-medicationknowledge

Example of a reusable MedicationKnowledge definition

definition-example-practitionerrole

Example of a reusable PractitionerRole definition

definition-example-substance

Example of a reusable Substance definition

example

Example patient

executable-example-library

This library defines terminologies and functions commonly used in FHIR-based CQL artifacts.

executable-example-valueset

Group Valueset with codes representing possible values for the Danger signs Codes Grouper element

library-evaluation-service-example

Basic conformance statement for a Library Evaluation Service. A server can support more fucntionality than defined here, but this is the minimum amount

manifest-example

This library is an example of an artifact manifest for the DT-01 PlanDefinition from the ANC-Mini IG.

modelinfo-example

Model definition for USCore (v3.1.0) Model

moduledefinition-example

This library is used as an example module definition in the FHIR Quality Measure Implementation Guide

negation-example

Example of an observation illustrating use of the notDoneValue set extension to communicate negation

publishable-example-activitydefinition

Example Publishable Activity Definition for a recommendation to order a medication

publishable-example-capabilitystatement

Basic conformance statement for a Library Evaluation Service. A server can support more fucntionality than defined here, but this is the minimum amount

publishable-example-codesystem

Set of codes representing all concepts used in the implementation guide

publishable-example-conceptmap

A mapping between the FHIR and HL7 v3 AddressUse Code systems

publishable-example-graphdefinition

Example of a Publishable GraphDefinition

publishable-example-implementationguide

This implementation guide demonstrates end-to-end capabilities for computable clinical practice guidelines following the World Health Organization SMART IG approach

publishable-example-library

This library defines terminologies and functions commonly used in FHIR-based CQL artifacts.

publishable-example-measure

Percentage of pregnant women with first ANC contact in the first trimester (before 12 weeks of gestation)

publishable-example-namingsystem

SNOMED CT is a concept-based, scientifically validated terminology that provides a unique and permanent concept identifier that can be included in multiple HL7 data types including CD and CE. The concepts are managed to avoid “semantic drift” so the meaning remains constant. If the concept is found to be ambiguous or the meaning changes, the concept is inactivated but still retained and the identifier is never reused. SNOMED CT’s concepts are interrelated hierarchically and using description logic. SNOMED CT concepts have a unique “fully-specified name”, a preferred term, and, optionally, synonyms. The description languages include English and Spanish.

publishable-example-operationdefinition

Limited implementation of the Populate Questionnaire implementation

publishable-example-plandefinition

Before each contact, during the Quick Check, the health worker should check whether the woman has any of the danger signs listed here – if yes, she should be referred to the hospital urgently; if no, the normal contact should be continued as normal

publishable-example-questionnaire

TODO: description goes here

publishable-example-searchparameter

Search by resource identifier - e.g. same as the read interaction, but can return included resources

publishable-example-structuredefinition

Before each contact, the health worker should check whether the woman has any of the danger signs listed here – if yes, she should refer to the hospital urgently; if no, she should continue to the normal contact

publishable-example-terminologycapabilities

Example Publishable Terminology Capabilities to describe an environment capable of expanding LOINC value sets, but not RxNORM value sets

publishable-example-valueset

Group Valueset with codes representing possible values for the Danger signs Codes Grouper element

qicore-modelinfosettings

Example of a Parameters resource used to specify ModelInfo generation settings

result-example

Example MeasureReport illustrating return of messages encountered during evaluation

shareable-example-activitydefinition

Example Shareable Activity Definition for a recommendation to order a medication

shareable-example-capabilitystatement

Basic conformance statement for a Library Evaluation Service. A server can support more fucntionality than defined here, but this is the minimum amount

shareable-example-codesystem

Set of codes representing all activities used in the implementation guide

shareable-example-conceptmap

A mapping between the FHIR and HL7 v3 AddressUse Code systems

shareable-example-graphdefinition

Example of a Shareable GraphDefinition

shareable-example-implementationguide

This implementation guide demonstrates end-to-end capabilities for computable clinical practice guidelines following the World Health Organization SMART IG approach

shareable-example-library

This library defines terminologies and functions commonly used in FHIR-based CQL artifacts.

shareable-example-measure

Percentage of pregnant women with first ANC contact in the first trimester (before 12 weeks of gestation)

shareable-example-namingsystem

SNOMED CT is a concept-based, scientifically validated terminology that provides a unique and permanent concept identifier that can be included in multiple HL7 data types including CD and CE. The concepts are managed to avoid “semantic drift” so the meaning remains constant. If the concept is found to be ambiguous or the meaning changes, the concept is inactivated but still retained and the identifier is never reused. SNOMED CT’s concepts are interrelated hierarchically and using description logic. SNOMED CT concepts have a unique “fully-specified name”, a preferred term, and, optionally, synonyms. The description languages include English and Spanish.

shareable-example-operationdefinition

Limited implementation of the Populate Questionnaire implementation

shareable-example-plandefinition

Before each contact, during the Quick Check, the health worker should check whether the woman has any of the danger signs listed here – if yes, she should be referred to the hospital urgently; if no, the normal contact should be continued as normal

shareable-example-questionnaire

TODO: description goes here

shareable-example-searchparameter

Search by resource identifier - e.g. same as the read interaction, but can return included resources

shareable-example-structuredefinition

If the woman came to the facility with a specific health concern, select the health concern(s) from the list

shareable-example-terminologycapabilities

Example Shareable Terminology Capabilities to describe an environment capable of expanding LOINC value sets, but not RxNORM value sets

shareable-example-valueset

Codes representing possible values for the Specific health concern(s) element