This page is part of the FHIR Specification (v5.0.0-ballot: FHIR R5 Ballot Preview). The current version which supercedes this version is 5.0.0. For a full list of available versions, see the Directory of published versions
Vocabulary Work Group | Maturity Level: 0 | Trial Use | Use Context: Any |
The canonical URL for this profile is:
http://hl7.org/fhir/StructureDefinition/publishablecodesystem
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
This profile was published on Thu, Jan 1, 1970 00:00+1000 as a draft by HL7.
Description of Profiles, Differentials, Snapshots, and how the XML and JSON presentations work.
This structure is derived from ShareableCodeSystem.
Summary
Mandatory: 1 element
Must-Support: 9 elements
Extensions
This structure refers to these extensions:
This indicates the differences between this profile and the base ShareableCodeSystem structure.
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
CodeSystem | 1..1 | ShareableCodeSystem | Declares the existence of and describes a code system or code system supplement | |
sourceReference | 0..1 | uri | Where did this content come from URL: http://hl7.org/fhir/StructureDefinition/codesystem-sourceReference | |
otherName | 0..* | (Complex) | Alternative names URL: http://hl7.org/fhir/StructureDefinition/codesystem-otherName | |
identifier | S | 0..* | Identifier | Additional identifier for the code system (business identifier) |
date | S | 1..1 | dateTime | Date last changed |
contact | S | 0..* | ContactDetail | Contact details for the publisher |
useContext | S | 0..* | UsageContext | The context that the content is intended to support |
jurisdiction | S | 0..* | CodeableConcept | Intended jurisdiction for code system (if applicable) |
purpose | S | 0..1 | markdown | Why this code system is defined |
copyright | S | 0..1 | markdown | Use and/or publishing restrictions |
approvalDate | 0..1 | date | When the CodeSystem was approved by publisher | |
lastReviewDate | 0..1 | date | When the CodeSystem was last reviewed | |
effectivePeriod | S | 0..1 | Period | When the CodeSystem is expected to be used |
topic | S | 0..* | CodeableConcept | E.g. Education, Treatment, Assessment, etc. |
author | 0..* | ContactDetail | Who authored the CodeSystem | |
editor | 0..* | ContactDetail | Who edited the CodeSystem | |
reviewer | 0..* | ContactDetail | Who reviewed the CodeSystem | |
endorser | 0..* | ContactDetail | Who endorsed the CodeSystem | |
relatedArtifact | 0..* | RelatedArtifact | Additional documentation, citations, etc. | |
Documentation for this format |
This provides the consolidated view (aka snapshot) of the profile after applying the changes in this profile to the base ShareableCodeSystem structure.
Name | Flags | Card. | Type | Description & Constraints | ||||
---|---|---|---|---|---|---|---|---|
CodeSystem | C | 1..1 | ShareableCodeSystem | Declares the existence of and describes a code system or code system supplement | ||||
id | Σ | 0..1 | id | Logical id of this artifact | ||||
meta | Σ | 0..1 | Meta | Metadata about the resource | ||||
implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created | ||||
language | 0..1 | code | Language of the resource content Binding: Common Languages (preferred): IETF language tag
| |||||
text | 0..1 | Narrative | Text summary of the resource, for human interpretation | |||||
contained | 0..* | Resource | Contained, inline Resources | |||||
Slices for extension | 0..* | Extension | Extension Slice: Unordered, Open by value:url | |||||
knowledgeRepresentationLevel | S | 0..* | code | narrative | semi-structured | structured | executable URL: http://hl7.org/fhir/StructureDefinition/cqf-knowledgeRepresentationLevel Binding: Knowledge Representation Level (required) | ||||
sourceReference | 0..1 | uri | Where did this content come from URL: http://hl7.org/fhir/StructureDefinition/codesystem-sourceReference | |||||
otherName | 0..* | (Complex) | Alternative names URL: http://hl7.org/fhir/StructureDefinition/codesystem-otherName | |||||
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored | ||||
url | SΣC | 1..1 | uri | Canonical identifier for this code system, represented as a URI (globally unique) (Coding.system) | ||||
identifier | SΣ | 0..* | Identifier | Additional identifier for the code system (business identifier) | ||||
version | SΣ | 1..1 | string | Business version of the code system (Coding.version) | ||||
name | SΣC | 0..1 | string | Name for this code system (computer friendly) | ||||
title | SΣ | 1..1 | string | Name for this code system (human friendly) | ||||
status | ?!SΣ | 1..1 | code | draft | active | retired | unknown Binding: PublicationStatus (required): The lifecycle status of an artifact. | ||||
experimental | SΣ | 1..1 | boolean | For testing purposes, not real usage | ||||
date | SΣ | 1..1 | dateTime | Date last changed | ||||
publisher | SΣ | 0..1 | string | Name of the publisher/steward (organization or individual) | ||||
contact | SΣ | 0..* | ContactDetail | Contact details for the publisher | ||||
description | S | 1..1 | markdown | Natural language description of the code system | ||||
useContext | SΣ | 0..* | UsageContext | The context that the content is intended to support | ||||
jurisdiction | SΣ | 0..* | CodeableConcept | Intended jurisdiction for code system (if applicable) Binding: Jurisdiction (extensible): Countries and regions within which this artifact is targeted for use. | ||||
purpose | S | 0..1 | markdown | Why this code system is defined | ||||
copyright | S | 0..1 | markdown | Use and/or publishing restrictions | ||||
approvalDate | 0..1 | date | When the CodeSystem was approved by publisher | |||||
lastReviewDate | 0..1 | date | When the CodeSystem was last reviewed | |||||
effectivePeriod | SΣ | 0..1 | Period | When the CodeSystem is expected to be used | ||||
topic | S | 0..* | CodeableConcept | E.g. Education, Treatment, Assessment, etc. Binding: DefinitionTopic (example) | ||||
author | 0..* | ContactDetail | Who authored the CodeSystem | |||||
editor | 0..* | ContactDetail | Who edited the CodeSystem | |||||
reviewer | 0..* | ContactDetail | Who reviewed the CodeSystem | |||||
endorser | 0..* | ContactDetail | Who endorsed the CodeSystem | |||||
relatedArtifact | 0..* | RelatedArtifact | Additional documentation, citations, etc. | |||||
caseSensitive | SΣ | 1..1 | boolean | If code comparison is case sensitive | ||||
valueSet | Σ | 0..1 | canonical(ValueSet) | Canonical reference to the value set with entire code system | ||||
hierarchyMeaning | SΣC | 0..1 | code | grouped-by | is-a | part-of | classified-with Binding: CodeSystemHierarchyMeaning (required): The meaning of the hierarchy of concepts in a code system. | ||||
compositional | Σ | 0..1 | boolean | If code system defines a compositional grammar | ||||
versionNeeded | Σ | 0..1 | boolean | If definitions are not stable | ||||
content | SΣC | 1..1 | code | not-present | example | fragment | complete | supplement Binding: CodeSystemContentMode (required): The extent of the content of the code system (the concepts and codes it defines) are represented in a code system resource. | ||||
supplements | Σ | 0..1 | canonical(CodeSystem) | Canonical URL of Code System this adds designations and properties to | ||||
count | Σ | 0..1 | unsignedInt | Total concepts in the code system | ||||
filter | Σ | 0..* | BackboneElement | Filter that can be used in a value set | ||||
id | 0..1 | string | Unique id for inter-element referencing | |||||
extension | 0..* | Extension | Additional content defined by implementations | |||||
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||
code | Σ | 1..1 | code | Code that identifies the filter | ||||
description | Σ | 0..1 | string | How or why the filter is used | ||||
operator | Σ | 1..* | code | = | is-a | descendent-of | is-not-a | regex | in | not-in | generalizes | child-of | descendent-leaf | exists Binding: FilterOperator (required): The kind of operation to perform as a part of a property based filter. | ||||
value | Σ | 1..1 | string | What to use for the value | ||||
property | Σ | 0..* | BackboneElement | Additional information supplied about each concept | ||||
id | 0..1 | string | Unique id for inter-element referencing | |||||
extension | 0..* | Extension | Additional content defined by implementations | |||||
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||
code | Σ | 1..1 | code | Identifies the property on the concepts, and when referred to in operations | ||||
uri | Σ | 0..1 | uri | Formal identifier for the property | ||||
description | Σ | 0..1 | string | Why the property is defined, and/or what it conveys | ||||
type | Σ | 1..1 | code | code | Coding | string | integer | boolean | dateTime | decimal Binding: PropertyType (required): The type of a property value. | ||||
concept | SC | 0..* | BackboneElement | Concepts in the code system | ||||
id | 0..1 | string | Unique id for inter-element referencing | |||||
extension | 0..* | Extension | Additional content defined by implementations | |||||
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||
code | S | 1..1 | code | Code that identifies concept | ||||
display | S | 0..1 | string | Text to display to the user | ||||
definition | S | 0..1 | string | Formal definition | ||||
designation | C | 0..* | BackboneElement | Additional representations for the concept | ||||
id | 0..1 | string | Unique id for inter-element referencing | |||||
extension | 0..* | Extension | Additional content defined by implementations | |||||
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||
language | 0..1 | code | Human language of the designation Binding: Common Languages (preferred): IETF language tag
| |||||
use | 0..1 | Coding | Details how this designation would be used Binding: Designation Use (extensible): Details of how a designation would be used. | |||||
additionalUse | 0..* | Coding | Additional ways how this designation would be used Binding: Designation Use (extensible): Details of how a designation would be used. | |||||
value | 1..1 | string | The text value for this designation | |||||
property | 0..* | BackboneElement | Property value for the concept | |||||
id | 0..1 | string | Unique id for inter-element referencing | |||||
extension | 0..* | Extension | Additional content defined by implementations | |||||
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||
code | 1..1 | code | Reference to CodeSystem.property.code | |||||
value[x] | 1..1 | Value of the property for this concept | ||||||
valueCode | code | |||||||
valueCoding | Coding | |||||||
valueString | string | |||||||
valueInteger | integer | |||||||
valueBoolean | boolean | |||||||
valueDateTime | dateTime | |||||||
valueDecimal | decimal | |||||||
concept | SC | 0..* | See concept (CodeSystem) | Child Concepts (is-a/contains/categorizes) | ||||
Documentation for this format |
<!-- PublishableCodeSystem --> <CodeSystem xmlns="http://hl7.org/fhir" > <!-- from Element: extension --> <id value="[id]"/><!-- 0..1 Logical id of this artifact --> <meta><!-- I 0..1 Meta Metadata about the resource --></meta> <implicitRules value="[uri]"/><!-- I 0..1 A set of rules under which this content was created --> <language value="[code]"/><!-- I 0..1 Language of the resource content --> <text><!-- I 0..1 Narrative Text summary of the resource, for human interpretation --></text> <contained><!-- 0..* Resource Contained, inline Resources --></contained> <modifierExtension><!-- I 0..* Extension Extensions that cannot be ignored --></modifierExtension> <url value="[uri]"/><!-- I 1..1 Canonical identifier for this code system, represented as a URI (globally unique) (Coding.system) --> <identifier><!-- I 0..* Identifier Additional identifier for the code system (business identifier) --></identifier> <version value="[string]"/><!-- I 1..1 Business version of the code system (Coding.version) --> <name value="[string]"/><!-- I 0..1 Name for this code system (computer friendly) --> <title value="[string]"/><!-- I 1..1 Name for this code system (human friendly) --> <status value="[code]"/><!-- I 1..1 draft | active | retired | unknown --> <experimental value="[boolean]"/><!-- I 1..1 For testing purposes, not real usage --> <date value="[dateTime]"/><!-- I 1..1 Date last changed --> <publisher value="[string]"/><!-- I 0..1 Name of the publisher/steward (organization or individual) --> <contact><!-- I 0..* ContactDetail Contact details for the publisher --></contact> <description value="[markdown]"/><!-- I 1..1 Natural language description of the code system --> <useContext><!-- I 0..* UsageContext The context that the content is intended to support --></useContext> <jurisdiction><!-- I 0..* CodeableConcept Intended jurisdiction for code system (if applicable) --></jurisdiction> <purpose value="[markdown]"/><!-- I 0..1 Why this code system is defined --> <copyright value="[markdown]"/><!-- I 0..1 Use and/or publishing restrictions --> <approvalDate value="[date]"/><!-- I 0..1 When the CodeSystem was approved by publisher --> <lastReviewDate value="[date]"/><!-- I 0..1 When the CodeSystem was last reviewed --> <effectivePeriod><!-- I 0..1 Period When the CodeSystem is expected to be used --></effectivePeriod> <topic><!-- I 0..* CodeableConcept E.g. Education, Treatment, Assessment, etc. --></topic> <author><!-- I 0..* ContactDetail Who authored the CodeSystem --></author> <editor><!-- I 0..* ContactDetail Who edited the CodeSystem --></editor> <reviewer><!-- I 0..* ContactDetail Who reviewed the CodeSystem --></reviewer> <endorser><!-- I 0..* ContactDetail Who endorsed the CodeSystem --></endorser> <relatedArtifact><!-- I 0..* RelatedArtifact Additional documentation, citations, etc. --></relatedArtifact> <caseSensitive value="[boolean]"/><!-- I 1..1 If code comparison is case sensitive --> <valueSet value="[canonical]"/><!-- I 0..1 Canonical reference to the value set with entire code system --> <hierarchyMeaning value="[code]"/><!-- I 0..1 grouped-by | is-a | part-of | classified-with --> <compositional value="[boolean]"/><!-- I 0..1 If code system defines a compositional grammar --> <versionNeeded value="[boolean]"/><!-- I 0..1 If definitions are not stable --> <content value="[code]"/><!-- I 1..1 not-present | example | fragment | complete | supplement --> <supplements value="[canonical]"/><!-- I 0..1 Canonical URL of Code System this adds designations and properties to --> <count value="[unsignedInt]"/><!-- I 0..1 Total concepts in the code system --> <filter> I 0..* BackboneElement <!-- I 0..* Filter that can be used in a value set --> <modifierExtension><!-- I 0..* Extension Extensions that cannot be ignored even if unrecognized --></modifierExtension> <code value="[code]"/><!-- I 1..1 Code that identifies the filter --> <description value="[string]"/><!-- I 0..1 How or why the filter is used --> <operator value="[code]"/><!-- I 1..* = | is-a | descendent-of | is-not-a | regex | in | not-in | generalizes | child-of | descendent-leaf | exists --> <value value="[string]"/><!-- I 1..1 What to use for the value --> </filter> <property> I 0..* BackboneElement <!-- I 0..* Additional information supplied about each concept --> <modifierExtension><!-- I 0..* Extension Extensions that cannot be ignored even if unrecognized --></modifierExtension> <code value="[code]"/><!-- I 1..1 Identifies the property on the concepts, and when referred to in operations --> <uri value="[uri]"/><!-- I 0..1 Formal identifier for the property --> <description value="[string]"/><!-- I 0..1 Why the property is defined, and/or what it conveys --> <type value="[code]"/><!-- I 1..1 code | Coding | string | integer | boolean | dateTime | decimal --> </property> <concept> I 0..* BackboneElement <!-- I 0..* Concepts in the code system --> <modifierExtension><!-- I 0..* Extension Extensions that cannot be ignored even if unrecognized --></modifierExtension> <code value="[code]"/><!-- I 1..1 Code that identifies concept --> <display value="[string]"/><!-- I 0..1 Text to display to the user --> <definition value="[string]"/><!-- I 0..1 Formal definition --> <designation> I 0..* BackboneElement <!-- I 0..* Additional representations for the concept --> <modifierExtension><!-- I 0..* Extension Extensions that cannot be ignored even if unrecognized --></modifierExtension> <language value="[code]"/><!-- I 0..1 Human language of the designation --> <use><!-- I 0..1 Coding Details how this designation would be used --></use> <additionalUse><!-- I 0..* Coding Additional ways how this designation would be used --></additionalUse> <value value="[string]"/><!-- I 1..1 The text value for this designation --> </designation> <property> I 0..* BackboneElement <!-- I 0..* Property value for the concept --> <modifierExtension><!-- I 0..* Extension Extensions that cannot be ignored even if unrecognized --></modifierExtension> <code value="[code]"/><!-- I 1..1 Reference to CodeSystem.property.code --> <value[x]><!-- I 1..1 code|Coding|string|integer| boolean|dateTime|decimal Value of the property for this concept --></value[x]> </property> <concept><!-- See http://hl7.org/fhir/StructureDefinition/CodeSystem#CodeSystem.concept Child Concepts (is-a/contains/categorizes) --></concept> </concept> </CodeSystem>
{ // PublishableCodeSystem // from Element: extension "meta" : { Meta }, // IMetadata about the resource "implicitRules" : "<uri>", // IA set of rules under which this content was created "language" : "<code>", // ILanguage of the resource content "text" : { Narrative }, // IText summary of the resource, for human interpretation "contained" : [{ Resource }], //Contained, inline Resources "extension" : [ // sliced by value:url in the specified order, Open { // narrative | semi-structured | structured | executable // I // from Element: extension }, { // Where did this content come from // I // from Element: extension }, { // Alternative names // I // from Element: extension } ], "modifierExtension" : [{ Extension }], // IExtensions that cannot be ignored "url" : "<uri>", // I R! Canonical identifier for this code system, represented as a URI (globally unique) (Coding.system) "identifier" : [{ Identifier }], // IAdditional identifier for the code system (business identifier) "version" : "<string>", // I R! Business version of the code system (Coding.version) "name" : "<string>", // IName for this code system (computer friendly) "title" : "<string>", // I R! Name for this code system (human friendly) "status" : "<code>", // I R! draft | active | retired | unknown "experimental" : <boolean>, // I R! For testing purposes, not real usage "date" : "<dateTime>", // I R! Date last changed "publisher" : "<string>", // IName of the publisher/steward (organization or individual) "contact" : [{ ContactDetail }], // IContact details for the publisher "description" : "<markdown>", // I R! Natural language description of the code system "useContext" : [{ UsageContext }], // IThe context that the content is intended to support "jurisdiction" : [{ CodeableConcept }], // IIntended jurisdiction for code system (if applicable) "purpose" : "<markdown>", // IWhy this code system is defined "copyright" : "<markdown>", // IUse and/or publishing restrictions "approvalDate" : "<date>", // IWhen the CodeSystem was approved by publisher "lastReviewDate" : "<date>", // IWhen the CodeSystem was last reviewed "effectivePeriod" : { Period }, // IWhen the CodeSystem is expected to be used "topic" : [{ CodeableConcept }], // IE.g. Education, Treatment, Assessment, etc. "author" : [{ ContactDetail }], // IWho authored the CodeSystem "editor" : [{ ContactDetail }], // IWho edited the CodeSystem "reviewer" : [{ ContactDetail }], // IWho reviewed the CodeSystem "endorser" : [{ ContactDetail }], // IWho endorsed the CodeSystem "relatedArtifact" : [{ RelatedArtifact }], // IAdditional documentation, citations, etc. "caseSensitive" : <boolean>, // I R! If code comparison is case sensitive "valueSet" : "<canonical>", // ICanonical reference to the value set with entire code system "hierarchyMeaning" : "<code>", // Igrouped-by | is-a | part-of | classified-with "compositional" : <boolean>, // IIf code system defines a compositional grammar "versionNeeded" : <boolean>, // IIf definitions are not stable "content" : "<code>", // I R! not-present | example | fragment | complete | supplement "supplements" : "<canonical>", // ICanonical URL of Code System this adds designations and properties to "count" : "<unsignedInt>", // ITotal concepts in the code system "filter" : [{ BackboneElement }], // IFilter that can be used in a value set "property" : [{ BackboneElement }], // IAdditional information supplied about each concept "concept" : [{ BackboneElement }], // IConcepts in the code system }
This structure is derived from ShareableCodeSystem.
Differential View
This indicates the differences between this profile and the base ShareableCodeSystem structure.
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
CodeSystem | 1..1 | ShareableCodeSystem | Declares the existence of and describes a code system or code system supplement | |
sourceReference | 0..1 | uri | Where did this content come from URL: http://hl7.org/fhir/StructureDefinition/codesystem-sourceReference | |
otherName | 0..* | (Complex) | Alternative names URL: http://hl7.org/fhir/StructureDefinition/codesystem-otherName | |
identifier | S | 0..* | Identifier | Additional identifier for the code system (business identifier) |
date | S | 1..1 | dateTime | Date last changed |
contact | S | 0..* | ContactDetail | Contact details for the publisher |
useContext | S | 0..* | UsageContext | The context that the content is intended to support |
jurisdiction | S | 0..* | CodeableConcept | Intended jurisdiction for code system (if applicable) |
purpose | S | 0..1 | markdown | Why this code system is defined |
copyright | S | 0..1 | markdown | Use and/or publishing restrictions |
approvalDate | 0..1 | date | When the CodeSystem was approved by publisher | |
lastReviewDate | 0..1 | date | When the CodeSystem was last reviewed | |
effectivePeriod | S | 0..1 | Period | When the CodeSystem is expected to be used |
topic | S | 0..* | CodeableConcept | E.g. Education, Treatment, Assessment, etc. |
author | 0..* | ContactDetail | Who authored the CodeSystem | |
editor | 0..* | ContactDetail | Who edited the CodeSystem | |
reviewer | 0..* | ContactDetail | Who reviewed the CodeSystem | |
endorser | 0..* | ContactDetail | Who endorsed the CodeSystem | |
relatedArtifact | 0..* | RelatedArtifact | Additional documentation, citations, etc. | |
Documentation for this format |
Snapshot View
This provides the consolidated view (aka snapshot) of the profile after applying the changes in this profile to the base ShareableCodeSystem structure.
Name | Flags | Card. | Type | Description & Constraints | ||||
---|---|---|---|---|---|---|---|---|
CodeSystem | C | 1..1 | ShareableCodeSystem | Declares the existence of and describes a code system or code system supplement | ||||
id | Σ | 0..1 | id | Logical id of this artifact | ||||
meta | Σ | 0..1 | Meta | Metadata about the resource | ||||
implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created | ||||
language | 0..1 | code | Language of the resource content Binding: Common Languages (preferred): IETF language tag
| |||||
text | 0..1 | Narrative | Text summary of the resource, for human interpretation | |||||
contained | 0..* | Resource | Contained, inline Resources | |||||
Slices for extension | 0..* | Extension | Extension Slice: Unordered, Open by value:url | |||||
knowledgeRepresentationLevel | S | 0..* | code | narrative | semi-structured | structured | executable URL: http://hl7.org/fhir/StructureDefinition/cqf-knowledgeRepresentationLevel Binding: Knowledge Representation Level (required) | ||||
sourceReference | 0..1 | uri | Where did this content come from URL: http://hl7.org/fhir/StructureDefinition/codesystem-sourceReference | |||||
otherName | 0..* | (Complex) | Alternative names URL: http://hl7.org/fhir/StructureDefinition/codesystem-otherName | |||||
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored | ||||
url | SΣC | 1..1 | uri | Canonical identifier for this code system, represented as a URI (globally unique) (Coding.system) | ||||
identifier | SΣ | 0..* | Identifier | Additional identifier for the code system (business identifier) | ||||
version | SΣ | 1..1 | string | Business version of the code system (Coding.version) | ||||
name | SΣC | 0..1 | string | Name for this code system (computer friendly) | ||||
title | SΣ | 1..1 | string | Name for this code system (human friendly) | ||||
status | ?!SΣ | 1..1 | code | draft | active | retired | unknown Binding: PublicationStatus (required): The lifecycle status of an artifact. | ||||
experimental | SΣ | 1..1 | boolean | For testing purposes, not real usage | ||||
date | SΣ | 1..1 | dateTime | Date last changed | ||||
publisher | SΣ | 0..1 | string | Name of the publisher/steward (organization or individual) | ||||
contact | SΣ | 0..* | ContactDetail | Contact details for the publisher | ||||
description | S | 1..1 | markdown | Natural language description of the code system | ||||
useContext | SΣ | 0..* | UsageContext | The context that the content is intended to support | ||||
jurisdiction | SΣ | 0..* | CodeableConcept | Intended jurisdiction for code system (if applicable) Binding: Jurisdiction (extensible): Countries and regions within which this artifact is targeted for use. | ||||
purpose | S | 0..1 | markdown | Why this code system is defined | ||||
copyright | S | 0..1 | markdown | Use and/or publishing restrictions | ||||
approvalDate | 0..1 | date | When the CodeSystem was approved by publisher | |||||
lastReviewDate | 0..1 | date | When the CodeSystem was last reviewed | |||||
effectivePeriod | SΣ | 0..1 | Period | When the CodeSystem is expected to be used | ||||
topic | S | 0..* | CodeableConcept | E.g. Education, Treatment, Assessment, etc. Binding: DefinitionTopic (example) | ||||
author | 0..* | ContactDetail | Who authored the CodeSystem | |||||
editor | 0..* | ContactDetail | Who edited the CodeSystem | |||||
reviewer | 0..* | ContactDetail | Who reviewed the CodeSystem | |||||
endorser | 0..* | ContactDetail | Who endorsed the CodeSystem | |||||
relatedArtifact | 0..* | RelatedArtifact | Additional documentation, citations, etc. | |||||
caseSensitive | SΣ | 1..1 | boolean | If code comparison is case sensitive | ||||
valueSet | Σ | 0..1 | canonical(ValueSet) | Canonical reference to the value set with entire code system | ||||
hierarchyMeaning | SΣC | 0..1 | code | grouped-by | is-a | part-of | classified-with Binding: CodeSystemHierarchyMeaning (required): The meaning of the hierarchy of concepts in a code system. | ||||
compositional | Σ | 0..1 | boolean | If code system defines a compositional grammar | ||||
versionNeeded | Σ | 0..1 | boolean | If definitions are not stable | ||||
content | SΣC | 1..1 | code | not-present | example | fragment | complete | supplement Binding: CodeSystemContentMode (required): The extent of the content of the code system (the concepts and codes it defines) are represented in a code system resource. | ||||
supplements | Σ | 0..1 | canonical(CodeSystem) | Canonical URL of Code System this adds designations and properties to | ||||
count | Σ | 0..1 | unsignedInt | Total concepts in the code system | ||||
filter | Σ | 0..* | BackboneElement | Filter that can be used in a value set | ||||
id | 0..1 | string | Unique id for inter-element referencing | |||||
extension | 0..* | Extension | Additional content defined by implementations | |||||
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||
code | Σ | 1..1 | code | Code that identifies the filter | ||||
description | Σ | 0..1 | string | How or why the filter is used | ||||
operator | Σ | 1..* | code | = | is-a | descendent-of | is-not-a | regex | in | not-in | generalizes | child-of | descendent-leaf | exists Binding: FilterOperator (required): The kind of operation to perform as a part of a property based filter. | ||||
value | Σ | 1..1 | string | What to use for the value | ||||
property | Σ | 0..* | BackboneElement | Additional information supplied about each concept | ||||
id | 0..1 | string | Unique id for inter-element referencing | |||||
extension | 0..* | Extension | Additional content defined by implementations | |||||
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||
code | Σ | 1..1 | code | Identifies the property on the concepts, and when referred to in operations | ||||
uri | Σ | 0..1 | uri | Formal identifier for the property | ||||
description | Σ | 0..1 | string | Why the property is defined, and/or what it conveys | ||||
type | Σ | 1..1 | code | code | Coding | string | integer | boolean | dateTime | decimal Binding: PropertyType (required): The type of a property value. | ||||
concept | SC | 0..* | BackboneElement | Concepts in the code system | ||||
id | 0..1 | string | Unique id for inter-element referencing | |||||
extension | 0..* | Extension | Additional content defined by implementations | |||||
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||
code | S | 1..1 | code | Code that identifies concept | ||||
display | S | 0..1 | string | Text to display to the user | ||||
definition | S | 0..1 | string | Formal definition | ||||
designation | C | 0..* | BackboneElement | Additional representations for the concept | ||||
id | 0..1 | string | Unique id for inter-element referencing | |||||
extension | 0..* | Extension | Additional content defined by implementations | |||||
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||
language | 0..1 | code | Human language of the designation Binding: Common Languages (preferred): IETF language tag
| |||||
use | 0..1 | Coding | Details how this designation would be used Binding: Designation Use (extensible): Details of how a designation would be used. | |||||
additionalUse | 0..* | Coding | Additional ways how this designation would be used Binding: Designation Use (extensible): Details of how a designation would be used. | |||||
value | 1..1 | string | The text value for this designation | |||||
property | 0..* | BackboneElement | Property value for the concept | |||||
id | 0..1 | string | Unique id for inter-element referencing | |||||
extension | 0..* | Extension | Additional content defined by implementations | |||||
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||
code | 1..1 | code | Reference to CodeSystem.property.code | |||||
value[x] | 1..1 | Value of the property for this concept | ||||||
valueCode | code | |||||||
valueCoding | Coding | |||||||
valueString | string | |||||||
valueInteger | integer | |||||||
valueBoolean | boolean | |||||||
valueDateTime | dateTime | |||||||
valueDecimal | decimal | |||||||
concept | SC | 0..* | See concept (CodeSystem) | Child Concepts (is-a/contains/categorizes) | ||||
Documentation for this format |
XML Template
<!-- PublishableCodeSystem --> <CodeSystem xmlns="http://hl7.org/fhir" > <!-- from Element: extension --> <id value="[id]"/><!-- 0..1 Logical id of this artifact --> <meta><!-- I 0..1 Meta Metadata about the resource --></meta> <implicitRules value="[uri]"/><!-- I 0..1 A set of rules under which this content was created --> <language value="[code]"/><!-- I 0..1 Language of the resource content --> <text><!-- I 0..1 Narrative Text summary of the resource, for human interpretation --></text> <contained><!-- 0..* Resource Contained, inline Resources --></contained> <modifierExtension><!-- I 0..* Extension Extensions that cannot be ignored --></modifierExtension> <url value="[uri]"/><!-- I 1..1 Canonical identifier for this code system, represented as a URI (globally unique) (Coding.system) --> <identifier><!-- I 0..* Identifier Additional identifier for the code system (business identifier) --></identifier> <version value="[string]"/><!-- I 1..1 Business version of the code system (Coding.version) --> <name value="[string]"/><!-- I 0..1 Name for this code system (computer friendly) --> <title value="[string]"/><!-- I 1..1 Name for this code system (human friendly) --> <status value="[code]"/><!-- I 1..1 draft | active | retired | unknown --> <experimental value="[boolean]"/><!-- I 1..1 For testing purposes, not real usage --> <date value="[dateTime]"/><!-- I 1..1 Date last changed --> <publisher value="[string]"/><!-- I 0..1 Name of the publisher/steward (organization or individual) --> <contact><!-- I 0..* ContactDetail Contact details for the publisher --></contact> <description value="[markdown]"/><!-- I 1..1 Natural language description of the code system --> <useContext><!-- I 0..* UsageContext The context that the content is intended to support --></useContext> <jurisdiction><!-- I 0..* CodeableConcept Intended jurisdiction for code system (if applicable) --></jurisdiction> <purpose value="[markdown]"/><!-- I 0..1 Why this code system is defined --> <copyright value="[markdown]"/><!-- I 0..1 Use and/or publishing restrictions --> <approvalDate value="[date]"/><!-- I 0..1 When the CodeSystem was approved by publisher --> <lastReviewDate value="[date]"/><!-- I 0..1 When the CodeSystem was last reviewed --> <effectivePeriod><!-- I 0..1 Period When the CodeSystem is expected to be used --></effectivePeriod> <topic><!-- I 0..* CodeableConcept E.g. Education, Treatment, Assessment, etc. --></topic> <author><!-- I 0..* ContactDetail Who authored the CodeSystem --></author> <editor><!-- I 0..* ContactDetail Who edited the CodeSystem --></editor> <reviewer><!-- I 0..* ContactDetail Who reviewed the CodeSystem --></reviewer> <endorser><!-- I 0..* ContactDetail Who endorsed the CodeSystem --></endorser> <relatedArtifact><!-- I 0..* RelatedArtifact Additional documentation, citations, etc. --></relatedArtifact> <caseSensitive value="[boolean]"/><!-- I 1..1 If code comparison is case sensitive --> <valueSet value="[canonical]"/><!-- I 0..1 Canonical reference to the value set with entire code system --> <hierarchyMeaning value="[code]"/><!-- I 0..1 grouped-by | is-a | part-of | classified-with --> <compositional value="[boolean]"/><!-- I 0..1 If code system defines a compositional grammar --> <versionNeeded value="[boolean]"/><!-- I 0..1 If definitions are not stable --> <content value="[code]"/><!-- I 1..1 not-present | example | fragment | complete | supplement --> <supplements value="[canonical]"/><!-- I 0..1 Canonical URL of Code System this adds designations and properties to --> <count value="[unsignedInt]"/><!-- I 0..1 Total concepts in the code system --> <filter> I 0..* BackboneElement <!-- I 0..* Filter that can be used in a value set --> <modifierExtension><!-- I 0..* Extension Extensions that cannot be ignored even if unrecognized --></modifierExtension> <code value="[code]"/><!-- I 1..1 Code that identifies the filter --> <description value="[string]"/><!-- I 0..1 How or why the filter is used --> <operator value="[code]"/><!-- I 1..* = | is-a | descendent-of | is-not-a | regex | in | not-in | generalizes | child-of | descendent-leaf | exists --> <value value="[string]"/><!-- I 1..1 What to use for the value --> </filter> <property> I 0..* BackboneElement <!-- I 0..* Additional information supplied about each concept --> <modifierExtension><!-- I 0..* Extension Extensions that cannot be ignored even if unrecognized --></modifierExtension> <code value="[code]"/><!-- I 1..1 Identifies the property on the concepts, and when referred to in operations --> <uri value="[uri]"/><!-- I 0..1 Formal identifier for the property --> <description value="[string]"/><!-- I 0..1 Why the property is defined, and/or what it conveys --> <type value="[code]"/><!-- I 1..1 code | Coding | string | integer | boolean | dateTime | decimal --> </property> <concept> I 0..* BackboneElement <!-- I 0..* Concepts in the code system --> <modifierExtension><!-- I 0..* Extension Extensions that cannot be ignored even if unrecognized --></modifierExtension> <code value="[code]"/><!-- I 1..1 Code that identifies concept --> <display value="[string]"/><!-- I 0..1 Text to display to the user --> <definition value="[string]"/><!-- I 0..1 Formal definition --> <designation> I 0..* BackboneElement <!-- I 0..* Additional representations for the concept --> <modifierExtension><!-- I 0..* Extension Extensions that cannot be ignored even if unrecognized --></modifierExtension> <language value="[code]"/><!-- I 0..1 Human language of the designation --> <use><!-- I 0..1 Coding Details how this designation would be used --></use> <additionalUse><!-- I 0..* Coding Additional ways how this designation would be used --></additionalUse> <value value="[string]"/><!-- I 1..1 The text value for this designation --> </designation> <property> I 0..* BackboneElement <!-- I 0..* Property value for the concept --> <modifierExtension><!-- I 0..* Extension Extensions that cannot be ignored even if unrecognized --></modifierExtension> <code value="[code]"/><!-- I 1..1 Reference to CodeSystem.property.code --> <value[x]><!-- I 1..1 code|Coding|string|integer| boolean|dateTime|decimal Value of the property for this concept --></value[x]> </property> <concept><!-- See http://hl7.org/fhir/StructureDefinition/CodeSystem#CodeSystem.concept Child Concepts (is-a/contains/categorizes) --></concept> </concept> </CodeSystem>
JSON Template
{ // PublishableCodeSystem // from Element: extension "meta" : { Meta }, // IMetadata about the resource "implicitRules" : "<uri>", // IA set of rules under which this content was created "language" : "<code>", // ILanguage of the resource content "text" : { Narrative }, // IText summary of the resource, for human interpretation "contained" : [{ Resource }], //Contained, inline Resources "extension" : [ // sliced by value:url in the specified order, Open { // narrative | semi-structured | structured | executable // I // from Element: extension }, { // Where did this content come from // I // from Element: extension }, { // Alternative names // I // from Element: extension } ], "modifierExtension" : [{ Extension }], // IExtensions that cannot be ignored "url" : "<uri>", // I R! Canonical identifier for this code system, represented as a URI (globally unique) (Coding.system) "identifier" : [{ Identifier }], // IAdditional identifier for the code system (business identifier) "version" : "<string>", // I R! Business version of the code system (Coding.version) "name" : "<string>", // IName for this code system (computer friendly) "title" : "<string>", // I R! Name for this code system (human friendly) "status" : "<code>", // I R! draft | active | retired | unknown "experimental" : <boolean>, // I R! For testing purposes, not real usage "date" : "<dateTime>", // I R! Date last changed "publisher" : "<string>", // IName of the publisher/steward (organization or individual) "contact" : [{ ContactDetail }], // IContact details for the publisher "description" : "<markdown>", // I R! Natural language description of the code system "useContext" : [{ UsageContext }], // IThe context that the content is intended to support "jurisdiction" : [{ CodeableConcept }], // IIntended jurisdiction for code system (if applicable) "purpose" : "<markdown>", // IWhy this code system is defined "copyright" : "<markdown>", // IUse and/or publishing restrictions "approvalDate" : "<date>", // IWhen the CodeSystem was approved by publisher "lastReviewDate" : "<date>", // IWhen the CodeSystem was last reviewed "effectivePeriod" : { Period }, // IWhen the CodeSystem is expected to be used "topic" : [{ CodeableConcept }], // IE.g. Education, Treatment, Assessment, etc. "author" : [{ ContactDetail }], // IWho authored the CodeSystem "editor" : [{ ContactDetail }], // IWho edited the CodeSystem "reviewer" : [{ ContactDetail }], // IWho reviewed the CodeSystem "endorser" : [{ ContactDetail }], // IWho endorsed the CodeSystem "relatedArtifact" : [{ RelatedArtifact }], // IAdditional documentation, citations, etc. "caseSensitive" : <boolean>, // I R! If code comparison is case sensitive "valueSet" : "<canonical>", // ICanonical reference to the value set with entire code system "hierarchyMeaning" : "<code>", // Igrouped-by | is-a | part-of | classified-with "compositional" : <boolean>, // IIf code system defines a compositional grammar "versionNeeded" : <boolean>, // IIf definitions are not stable "content" : "<code>", // I R! not-present | example | fragment | complete | supplement "supplements" : "<canonical>", // ICanonical URL of Code System this adds designations and properties to "count" : "<unsignedInt>", // ITotal concepts in the code system "filter" : [{ BackboneElement }], // IFilter that can be used in a value set "property" : [{ BackboneElement }], // IAdditional information supplied about each concept "concept" : [{ BackboneElement }], // IConcepts in the code system }
Alternate definitions: Master Definition (XML, JSON), Schematron
Path | Name | Conformance | ValueSet |
CodeSystem.language | Common Languages | preferred | Common Languages |
CodeSystem.status | PublicationStatus | required | PublicationStatus |
CodeSystem.jurisdiction | Jurisdiction | extensible | Jurisdiction |
CodeSystem.topic | DefinitionTopic | example | DefinitionTopic |
CodeSystem.hierarchyMeaning | CodeSystemHierarchyMeaning | required | CodeSystemHierarchyMeaning |
CodeSystem.content | CodeSystemContentMode | required | CodeSystemContentMode |
CodeSystem.filter.operator | FilterOperator | required | FilterOperator |
CodeSystem.property.type | PropertyType | required | PropertyType |
CodeSystem.concept.designation.language | Common Languages | preferred | Common Languages |
CodeSystem.concept.designation.use | Designation Use | extensible | Designation Use |
CodeSystem.concept.designation.additionalUse | Designation Use | extensible | Designation Use |