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
Contents:
This page provides a list of the FHIR artifacts defined as part of this implementation guide.
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. |
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
|
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. |
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. |
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 |
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. |
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 |
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) |
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 |