eHealth Infrastructure (v2019.5.1)

StructureDefinition: ehealth-library

The Library resource is a general-purpose container for knowledge asset definitions. It can be used to describe and expose existing knowledge assets such as logic libraries and information model descriptions, as well as to describe a collection of knowledge assets.

Scope and Usage

In scope of the eHealth Infrastructure, the Library resource is used for:

  • identifying clinical decision rules
  • specifying input and output parameters for clinical decision rules
  • specifying bindings for these input parameters
Use of Library for defining decision support rules

A Library resource defining a decision support rule is really capturing metadata about the rule rather than the rule logic itself. The rule is identified by identifier, version, and revision while the input and output parameters are specified in the structure named parameter.

In order to support organizations in defining of Library for use in their organizational context, the extension intendedAudience has been added.

Use of Library for binding value sources to decision support rules parameters

A separate Library is used for defining what values to pass in as input parameters when invoking a decision support rule (as defined by another Library resource).

The Library defining the binding identifies the decision support rule Library resource through the extension basedOn. The binding between the decision support rule parameters and the source from which to get a value is defined in the extension parameterBinding.

It is important that the binding defines value sources for each of the input parameters defined in the decision support rule Library resource and that the parameter names and types are correct.

In the parameterBinding elements, a Questionnaire can be referenced through the element resource and identified with identifier, version and revision. The particular questionnaire question to use as binding for a decision support rule parameter is specified in linkId.

Use of Library resources at time of decision support rules invocation

The binding and decision support rule Library resources can be associated with a CarePlan / ProcedureRequest through their references to PlanDefinition / ActivityDefinition resources. When a measurement is submitted in scope of a CarePlan, the answer values in a submitted QuestionnaireResponse can be found and passed in as parameters to the decision support rule as specified by the Library resources.

Formal Views of Profile Content

The official URL for this profile is:

http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-library

This profile builds on Library.

This profile was published on Thu May 16 12:32:10 UTC 2019 as a draft by ehealth.sundhed.dk.

Description of Profiles, Differentials, Snapshots, and how the XML and JSON presentations work.

 

Terminology Bindings

PathNameConformanceValueSet
Library.languageCommon LanguagesextensibleCommon Languages
Library.statusPublicationStatusrequiredPublicationStatus
Library.typeLibraryTypeextensibleLibraryType
Library.jurisdictionJurisdiction ValueSetextensibleJurisdiction ValueSet
Library.topicDefinitionTopicexampleDefinitionTopic
Library.parameter.useOperationParameterUserequiredOperationParameterUse
Library.parameter.typeFHIRAllTypesrequiredFHIRAllTypes

Constraints

IdPathDetailsRequirements
dom-2LibraryIf the resource is contained in another resource, it SHALL NOT contain nested Resources
: contained.contained.empty()
dom-1LibraryIf the resource is contained in another resource, it SHALL NOT contain any narrative
: contained.text.empty()
dom-4LibraryIf 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-3LibraryIf 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()
.