This page is part of the FHIR Specification (v1.8.0: STU 3 Draft). The current version which supercedes this version is 5.0.0. For a full list of available versions, see the Directory of published versions . Page versions: R5 R4B R4 R3
Clinical Decision Support Work Group | Maturity Level: 0 | Compartments: Not linked to any defined compartments |
The Library resource is a general-purpose container for knowledge asset definitions. It can be used to describe and expose exist knowledge assets such as logic libraries and information model descriptions, as well as to describe a collection of knowledge assets.
This resource is a draft proposal for use as part of an approach to Clinical Quality within FHIR, and is documented as part of the Clinical Reasoning module.
The Library resource is a general purpose container for clinical knowledge that is defined using a non-FHIR representation. For example, a shareable library of clinical logic, written in Clinical Quality Language (CQL), or the XML Schema for an information model. In addition to representing the metadata of the library, the resource has elements for tracking dependencies, as well as for representing the parameters and data requirements for any expression functionality provided by the library.
The actual content of the library is represented using the Attachment data type, and may either be referenced with a url, or the content may be embedded as a base-64 encoded string. Either way, the contentType
element of the attachment is used to indicate the representation of the library content.
Note that because the library content may be embedded as well as be retrievable from an external repository via the attachment URL, the possibility exists for the embedded content to be different from the content on the repository. With proper versioning and governance, this should never occur, but to minimize the potential impact of this possibility, implementers SHALL give precedence to the embedded content of a library when it is present.
The Library resource is definitional in nature, meaning it is intended to represent shareable knowledge independent of any particular patient. This is in contrast to the DocumentReference resource, which captures non-FHIR content related to a specific patient, and the Media and Binary resources which capture multimedia content and raw binary content, respectively.
This resource is referenced by ActivityDefinition, Measure and PlanDefinition
Structure
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
Library | DomainResource | Represents a library of quality improvement components | ||
url | Σ | 0..1 | uri | Logical uri to reference this library (globally unique) |
identifier | Σ | 0..* | Identifier | Additional identifier for the library |
version | Σ | 0..1 | string | Business version of the library |
name | Σ | 0..1 | string | Name for this library (Computer friendly) |
title | Σ | 0..1 | string | Name for this library (Human friendly) |
type | ?!Σ | 1..1 | CodeableConcept | logic-library | model-definition | asset-collection | module-definition LibraryType (Extensible) |
status | ?!Σ | 1..1 | code | draft | active | retired PublicationStatus (Required) |
experimental | ?!Σ | 0..1 | boolean | If for testing purposes, not real usage |
date | Σ | 0..1 | dateTime | Date this was last changed |
description | 0..1 | markdown | Natural language description of the library | |
purpose | 0..1 | markdown | Why this library is defined | |
usage | 0..1 | string | Describes the clinical usage of the library | |
approvalDate | 0..1 | date | When library approved by publisher | |
lastReviewDate | 0..1 | date | Last review date for the library | |
effectivePeriod | Σ | 0..1 | Period | The effective date range for the library |
useContext | Σ | 0..* | UsageContext | Content intends to support these contexts |
jurisdiction | Σ | 0..* | CodeableConcept | Intended jurisdiction for library (if applicable) Jurisdiction ValueSet (Extensible) |
topic | 0..* | CodeableConcept | Descriptional topics for the library | |
contributor | 0..* | Contributor | A content contributor | |
publisher | Σ | 0..1 | string | Name of the publisher (Organization or individual) |
contact | Σ | 0..* | ContactDetail | Contact details for the publisher |
copyright | 0..1 | markdown | Use and/or publishing restrictions | |
relatedArtifact | 0..* | RelatedArtifact | Related artifacts for the library | |
parameter | 0..* | ParameterDefinition | Parameters defined by the library | |
dataRequirement | 0..* | DataRequirement | Data requirements of the library | |
content | 0..* | Attachment | The content of the library | |
Documentation for this format |
UML Diagram (Legend)
XML Template
<Library xmlns="http://hl7.org/fhir"> <!-- from Resource: id, meta, implicitRules, and language --> <!-- from DomainResource: text, contained, extension, and modifierExtension --> <url value="[uri]"/><!-- 0..1 Logical uri to reference this library (globally unique) --> <identifier><!-- 0..* Identifier Additional identifier for the library --></identifier> <version value="[string]"/><!-- 0..1 Business version of the library --> <name value="[string]"/><!-- 0..1 Name for this library (Computer friendly) --> <title value="[string]"/><!-- 0..1 Name for this library (Human friendly) --> <type><!-- 1..1 CodeableConcept logic-library | model-definition | asset-collection | module-definition --></type> <status value="[code]"/><!-- 1..1 draft | active | retired --> <experimental value="[boolean]"/><!-- 0..1 If for testing purposes, not real usage --> <date value="[dateTime]"/><!-- 0..1 Date this was last changed --> <description value="[markdown]"/><!-- 0..1 Natural language description of the library --> <purpose value="[markdown]"/><!-- 0..1 Why this library is defined --> <usage value="[string]"/><!-- 0..1 Describes the clinical usage of the library --> <approvalDate value="[date]"/><!-- 0..1 When library approved by publisher --> <lastReviewDate value="[date]"/><!-- 0..1 Last review date for the library --> <effectivePeriod><!-- 0..1 Period The effective date range for the library --></effectivePeriod> <useContext><!-- 0..* UsageContext Content intends to support these contexts --></useContext> <jurisdiction><!-- 0..* CodeableConcept Intended jurisdiction for library (if applicable) --></jurisdiction> <topic><!-- 0..* CodeableConcept Descriptional topics for the library --></topic> <contributor><!-- 0..* Contributor A content contributor --></contributor> <publisher value="[string]"/><!-- 0..1 Name of the publisher (Organization or individual) --> <contact><!-- 0..* ContactDetail Contact details for the publisher --></contact> <copyright value="[markdown]"/><!-- 0..1 Use and/or publishing restrictions --> <relatedArtifact><!-- 0..* RelatedArtifact Related artifacts for the library --></relatedArtifact> <parameter><!-- 0..* ParameterDefinition Parameters defined by the library --></parameter> <dataRequirement><!-- 0..* DataRequirement Data requirements of the library --></dataRequirement> <content><!-- 0..* Attachment The content of the library --></content> </Library>
JSON Template
{ "resourceType" : "Library", // from Resource: id, meta, implicitRules, and language // from DomainResource: text, contained, extension, and modifierExtension "url" : "<uri>", // Logical uri to reference this library (globally unique) "identifier" : [{ Identifier }], // Additional identifier for the library "version" : "<string>", // Business version of the library "name" : "<string>", // Name for this library (Computer friendly) "title" : "<string>", // Name for this library (Human friendly) "type" : { CodeableConcept }, // R! logic-library | model-definition | asset-collection | module-definition "status" : "<code>", // R! draft | active | retired "experimental" : <boolean>, // If for testing purposes, not real usage "date" : "<dateTime>", // Date this was last changed "description" : "<markdown>", // Natural language description of the library "purpose" : "<markdown>", // Why this library is defined "usage" : "<string>", // Describes the clinical usage of the library "approvalDate" : "<date>", // When library approved by publisher "lastReviewDate" : "<date>", // Last review date for the library "effectivePeriod" : { Period }, // The effective date range for the library "useContext" : [{ UsageContext }], // Content intends to support these contexts "jurisdiction" : [{ CodeableConcept }], // Intended jurisdiction for library (if applicable) "topic" : [{ CodeableConcept }], // Descriptional topics for the library "contributor" : [{ Contributor }], // A content contributor "publisher" : "<string>", // Name of the publisher (Organization or individual) "contact" : [{ ContactDetail }], // Contact details for the publisher "copyright" : "<markdown>", // Use and/or publishing restrictions "relatedArtifact" : [{ RelatedArtifact }], // Related artifacts for the library "parameter" : [{ ParameterDefinition }], // Parameters defined by the library "dataRequirement" : [{ DataRequirement }], // Data requirements of the library "content" : [{ Attachment }] // The content of the library }
Turtle Template
@prefix fhir: <http://hl7.org/fhir/> . [ a fhir:Library; fhir:nodeRole fhir:treeRoot; # if this is the parser root # from Resource: .id, .meta, .implicitRules, and .language # from DomainResource: .text, .contained, .extension, and .modifierExtension fhir:Library.url [ uri ]; # 0..1 Logical uri to reference this library (globally unique) fhir:Library.identifier [ Identifier ], ... ; # 0..* Additional identifier for the library fhir:Library.version [ string ]; # 0..1 Business version of the library fhir:Library.name [ string ]; # 0..1 Name for this library (Computer friendly) fhir:Library.title [ string ]; # 0..1 Name for this library (Human friendly) fhir:Library.type [ CodeableConcept ]; # 1..1 logic-library | model-definition | asset-collection | module-definition fhir:Library.status [ code ]; # 1..1 draft | active | retired fhir:Library.experimental [ boolean ]; # 0..1 If for testing purposes, not real usage fhir:Library.date [ dateTime ]; # 0..1 Date this was last changed fhir:Library.description [ markdown ]; # 0..1 Natural language description of the library fhir:Library.purpose [ markdown ]; # 0..1 Why this library is defined fhir:Library.usage [ string ]; # 0..1 Describes the clinical usage of the library fhir:Library.approvalDate [ date ]; # 0..1 When library approved by publisher fhir:Library.lastReviewDate [ date ]; # 0..1 Last review date for the library fhir:Library.effectivePeriod [ Period ]; # 0..1 The effective date range for the library fhir:Library.useContext [ UsageContext ], ... ; # 0..* Content intends to support these contexts fhir:Library.jurisdiction [ CodeableConcept ], ... ; # 0..* Intended jurisdiction for library (if applicable) fhir:Library.topic [ CodeableConcept ], ... ; # 0..* Descriptional topics for the library fhir:Library.contributor [ Contributor ], ... ; # 0..* A content contributor fhir:Library.publisher [ string ]; # 0..1 Name of the publisher (Organization or individual) fhir:Library.contact [ ContactDetail ], ... ; # 0..* Contact details for the publisher fhir:Library.copyright [ markdown ]; # 0..1 Use and/or publishing restrictions fhir:Library.relatedArtifact [ RelatedArtifact ], ... ; # 0..* Related artifacts for the library fhir:Library.parameter [ ParameterDefinition ], ... ; # 0..* Parameters defined by the library fhir:Library.dataRequirement [ DataRequirement ], ... ; # 0..* Data requirements of the library fhir:Library.content [ Attachment ], ... ; # 0..* The content of the library ]
Changes since DSTU2
This resource did not exist in Release 2
Structure
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
Library | DomainResource | Represents a library of quality improvement components | ||
url | Σ | 0..1 | uri | Logical uri to reference this library (globally unique) |
identifier | Σ | 0..* | Identifier | Additional identifier for the library |
version | Σ | 0..1 | string | Business version of the library |
name | Σ | 0..1 | string | Name for this library (Computer friendly) |
title | Σ | 0..1 | string | Name for this library (Human friendly) |
type | ?!Σ | 1..1 | CodeableConcept | logic-library | model-definition | asset-collection | module-definition LibraryType (Extensible) |
status | ?!Σ | 1..1 | code | draft | active | retired PublicationStatus (Required) |
experimental | ?!Σ | 0..1 | boolean | If for testing purposes, not real usage |
date | Σ | 0..1 | dateTime | Date this was last changed |
description | 0..1 | markdown | Natural language description of the library | |
purpose | 0..1 | markdown | Why this library is defined | |
usage | 0..1 | string | Describes the clinical usage of the library | |
approvalDate | 0..1 | date | When library approved by publisher | |
lastReviewDate | 0..1 | date | Last review date for the library | |
effectivePeriod | Σ | 0..1 | Period | The effective date range for the library |
useContext | Σ | 0..* | UsageContext | Content intends to support these contexts |
jurisdiction | Σ | 0..* | CodeableConcept | Intended jurisdiction for library (if applicable) Jurisdiction ValueSet (Extensible) |
topic | 0..* | CodeableConcept | Descriptional topics for the library | |
contributor | 0..* | Contributor | A content contributor | |
publisher | Σ | 0..1 | string | Name of the publisher (Organization or individual) |
contact | Σ | 0..* | ContactDetail | Contact details for the publisher |
copyright | 0..1 | markdown | Use and/or publishing restrictions | |
relatedArtifact | 0..* | RelatedArtifact | Related artifacts for the library | |
parameter | 0..* | ParameterDefinition | Parameters defined by the library | |
dataRequirement | 0..* | DataRequirement | Data requirements of the library | |
content | 0..* | Attachment | The content of the library | |
Documentation for this format |
XML Template
<Library xmlns="http://hl7.org/fhir"> <!-- from Resource: id, meta, implicitRules, and language --> <!-- from DomainResource: text, contained, extension, and modifierExtension --> <url value="[uri]"/><!-- 0..1 Logical uri to reference this library (globally unique) --> <identifier><!-- 0..* Identifier Additional identifier for the library --></identifier> <version value="[string]"/><!-- 0..1 Business version of the library --> <name value="[string]"/><!-- 0..1 Name for this library (Computer friendly) --> <title value="[string]"/><!-- 0..1 Name for this library (Human friendly) --> <type><!-- 1..1 CodeableConcept logic-library | model-definition | asset-collection | module-definition --></type> <status value="[code]"/><!-- 1..1 draft | active | retired --> <experimental value="[boolean]"/><!-- 0..1 If for testing purposes, not real usage --> <date value="[dateTime]"/><!-- 0..1 Date this was last changed --> <description value="[markdown]"/><!-- 0..1 Natural language description of the library --> <purpose value="[markdown]"/><!-- 0..1 Why this library is defined --> <usage value="[string]"/><!-- 0..1 Describes the clinical usage of the library --> <approvalDate value="[date]"/><!-- 0..1 When library approved by publisher --> <lastReviewDate value="[date]"/><!-- 0..1 Last review date for the library --> <effectivePeriod><!-- 0..1 Period The effective date range for the library --></effectivePeriod> <useContext><!-- 0..* UsageContext Content intends to support these contexts --></useContext> <jurisdiction><!-- 0..* CodeableConcept Intended jurisdiction for library (if applicable) --></jurisdiction> <topic><!-- 0..* CodeableConcept Descriptional topics for the library --></topic> <contributor><!-- 0..* Contributor A content contributor --></contributor> <publisher value="[string]"/><!-- 0..1 Name of the publisher (Organization or individual) --> <contact><!-- 0..* ContactDetail Contact details for the publisher --></contact> <copyright value="[markdown]"/><!-- 0..1 Use and/or publishing restrictions --> <relatedArtifact><!-- 0..* RelatedArtifact Related artifacts for the library --></relatedArtifact> <parameter><!-- 0..* ParameterDefinition Parameters defined by the library --></parameter> <dataRequirement><!-- 0..* DataRequirement Data requirements of the library --></dataRequirement> <content><!-- 0..* Attachment The content of the library --></content> </Library>
JSON Template
{ "resourceType" : "Library", // from Resource: id, meta, implicitRules, and language // from DomainResource: text, contained, extension, and modifierExtension "url" : "<uri>", // Logical uri to reference this library (globally unique) "identifier" : [{ Identifier }], // Additional identifier for the library "version" : "<string>", // Business version of the library "name" : "<string>", // Name for this library (Computer friendly) "title" : "<string>", // Name for this library (Human friendly) "type" : { CodeableConcept }, // R! logic-library | model-definition | asset-collection | module-definition "status" : "<code>", // R! draft | active | retired "experimental" : <boolean>, // If for testing purposes, not real usage "date" : "<dateTime>", // Date this was last changed "description" : "<markdown>", // Natural language description of the library "purpose" : "<markdown>", // Why this library is defined "usage" : "<string>", // Describes the clinical usage of the library "approvalDate" : "<date>", // When library approved by publisher "lastReviewDate" : "<date>", // Last review date for the library "effectivePeriod" : { Period }, // The effective date range for the library "useContext" : [{ UsageContext }], // Content intends to support these contexts "jurisdiction" : [{ CodeableConcept }], // Intended jurisdiction for library (if applicable) "topic" : [{ CodeableConcept }], // Descriptional topics for the library "contributor" : [{ Contributor }], // A content contributor "publisher" : "<string>", // Name of the publisher (Organization or individual) "contact" : [{ ContactDetail }], // Contact details for the publisher "copyright" : "<markdown>", // Use and/or publishing restrictions "relatedArtifact" : [{ RelatedArtifact }], // Related artifacts for the library "parameter" : [{ ParameterDefinition }], // Parameters defined by the library "dataRequirement" : [{ DataRequirement }], // Data requirements of the library "content" : [{ Attachment }] // The content of the library }
Turtle Template
@prefix fhir: <http://hl7.org/fhir/> . [ a fhir:Library; fhir:nodeRole fhir:treeRoot; # if this is the parser root # from Resource: .id, .meta, .implicitRules, and .language # from DomainResource: .text, .contained, .extension, and .modifierExtension fhir:Library.url [ uri ]; # 0..1 Logical uri to reference this library (globally unique) fhir:Library.identifier [ Identifier ], ... ; # 0..* Additional identifier for the library fhir:Library.version [ string ]; # 0..1 Business version of the library fhir:Library.name [ string ]; # 0..1 Name for this library (Computer friendly) fhir:Library.title [ string ]; # 0..1 Name for this library (Human friendly) fhir:Library.type [ CodeableConcept ]; # 1..1 logic-library | model-definition | asset-collection | module-definition fhir:Library.status [ code ]; # 1..1 draft | active | retired fhir:Library.experimental [ boolean ]; # 0..1 If for testing purposes, not real usage fhir:Library.date [ dateTime ]; # 0..1 Date this was last changed fhir:Library.description [ markdown ]; # 0..1 Natural language description of the library fhir:Library.purpose [ markdown ]; # 0..1 Why this library is defined fhir:Library.usage [ string ]; # 0..1 Describes the clinical usage of the library fhir:Library.approvalDate [ date ]; # 0..1 When library approved by publisher fhir:Library.lastReviewDate [ date ]; # 0..1 Last review date for the library fhir:Library.effectivePeriod [ Period ]; # 0..1 The effective date range for the library fhir:Library.useContext [ UsageContext ], ... ; # 0..* Content intends to support these contexts fhir:Library.jurisdiction [ CodeableConcept ], ... ; # 0..* Intended jurisdiction for library (if applicable) fhir:Library.topic [ CodeableConcept ], ... ; # 0..* Descriptional topics for the library fhir:Library.contributor [ Contributor ], ... ; # 0..* A content contributor fhir:Library.publisher [ string ]; # 0..1 Name of the publisher (Organization or individual) fhir:Library.contact [ ContactDetail ], ... ; # 0..* Contact details for the publisher fhir:Library.copyright [ markdown ]; # 0..1 Use and/or publishing restrictions fhir:Library.relatedArtifact [ RelatedArtifact ], ... ; # 0..* Related artifacts for the library fhir:Library.parameter [ ParameterDefinition ], ... ; # 0..* Parameters defined by the library fhir:Library.dataRequirement [ DataRequirement ], ... ; # 0..* Data requirements of the library fhir:Library.content [ Attachment ], ... ; # 0..* The content of the library ]
Changes since DSTU2
This resource did not exist in Release 2
Alternate definitions: Master Definition (XML, JSON), XML Schema/Schematron (for ) + JSON Schema, ShEx (for Turtle), JSON-LD (for RDF as JSON-LD),
Path | Definition | Type | Reference |
---|---|---|---|
Library.type | The type of knowledge asset this library contains | Extensible | LibraryType |
Library.status | The lifecycle status of a Value Set or Concept Map. | Required | PublicationStatus |
Library.jurisdiction | Countries and regions within which this artifact is targeted for use | Extensible | Jurisdiction ValueSet |
Search parameters for this resource. The common parameters also apply. See Searching for more information about searching in REST, messaging, and services.
Name | Type | Description | Paths | In Common |
date | date | The library publication date | Library.date | |
description | string | Text search against the description of the library | Library.description | |
effective | date | Effective time associated with the library | Library.effectivePeriod | |
identifier | token | External identifiers for the library | Library.identifier | |
jurisdiction | token | Intended jurisdiction for library | Library.jurisdiction | |
name | string | Name of the library | Library.name | |
publisher | string | Name of the publisher of the library | Library.publisher | |
status | token | The current status of the library | Library.status | |
title | string | Text search against the title of the library | Library.title | |
topic | token | Topics associated with the module | Library.topic | |
url | uri | The uri that identifies the library | Library.url | |
version | token | The version identifier of the library | Library.version |