R4 Ballot #1 (Mixed Normative/Trial use) Current Build
This page was published as part of FHIR v3.3.0: R4 Ballot #1 : Mixed Normative/Trial use (First Normative ballot). It has been superceded by R4 . For a full list of available versions, see the Directory of published versions .

4.10 4.11 Resource NamingSystem - Content

FHIR Infrastructure Work Group Maturity Level : 1   Trial Use Security Category : Anonymous Compartments : Not linked to any defined compartments

A curated namespace that issues unique symbols within that namespace for the identification of concepts, people, devices, etc. Represents a "System" used within the Identifier and Coding data types.

Defines a specific code system or identifier system, so that it can be noted in a registry for other systems to find and understand an identifier.

The CodeSystem resource defines the content of a code system, and also its preferred identifier. The NamingSystem resource identifies the existence of a code or identifier system, and its possible and preferred identifiers. The key difference between the resources is who creates and manages them - CodeSystem resources are managed by the owner of the code system resource, who can properly define the features and content of the code system. NamingSystem resources, on the other hand, are frequently defined by 3rd parties that encounter the code system in use, and need to describe the use, but do not have the authority to define the features and content. Additionally, there may be multiple authoritative NamingSystem resources for a code system, but there should only be one CodeSystem resource.

For discussion of policy for creating well maintained OIDs and URIs for resources, see The HL7 WIKI Confluence site .

No resources refer to this resource directly.

This resource does not implement any patterns.

Structure

Name Flags Card. Type Description & Constraints doco
. . NamingSystem I TU DomainResource System of unique identification
+ Warning: Name should be usable as an identifier for the module by machine processing applications such as code generation
+ Rule: Root systems cannot have uuid identifiers
+ Rule: Can't have more than one preferred identifier for a type
Elements defined in Ancestors: id , meta , implicitRules , language , text , contained , extension , modifierExtension
. . . name Σ I 1..1 string Name for this naming system (computer friendly)
. . . status ?! Σ 1..1 code draft | active | retired | unknown
PublicationStatus ( Required )
. . . kind Σ 1..1 code codesystem | identifier | root
NamingSystemType ( Required )
. . . date Σ 1..1 dateTime Date last changed
. . . publisher Σ 0..1 string Name of the publisher (organization or individual)
. . . contact Σ 0..* ContactDetail Contact details for the publisher
. . . responsible 0..1 string Who maintains system namespace?
. . . type 0..1 CodeableConcept e.g. driver, provider, patient, bank etc.
Identifier Type Codes IdentifierType ( Extensible )
. . . description 0..1 markdown Natural language description of the naming system
. . . useContext Σ 0..* UsageContext The context that the content is intended to support
. . . jurisdiction Σ 0..* CodeableConcept Intended jurisdiction for naming system (if applicable)
Jurisdiction ValueSet ( Extensible )
. . . usage 0..1 string How/where is it used
. . . uniqueId Σ 1..* BackboneElement Unique identifiers used for system
. . . . type Σ 1..1 code oid | uuid | uri | other
NamingSystemIdentifierType ( Required )
. . . . value Σ 1..1 string The unique identifier
. . . . preferred 0..1 boolean Is this the id that should be used for this type
. . . . comment 0..1 string Notes about identifier usage
. . . . period 0..1 Period When is identifier valid?

doco Documentation for this format

UML Diagram ( Legend )

NamingSystem ( DomainResource ) A natural language name identifying the naming system. This name should be usable as an identifier for the module by machine processing applications such as code generation name : string [1..1] The status of this naming system. Enables tracking the life-cycle of the content (this element modifies the meaning of other elements) status : code [1..1] « The lifecycle status of an artifact. (Strength=Required) PublicationStatus ! » Indicates the purpose for the naming system - what kinds of things does it make unique? kind : code [1..1] « Identifies the purpose of the naming system. (Strength=Required) NamingSystemType ! » The date (and optionally time) when the naming system was published. The date must change when the business version changes and it must change if the status code changes. In addition, it should change when the substantive content of the naming system changes date : dateTime [1..1] The name of the organization or individual that published the naming system publisher : string [0..1] Contact details to assist a user in finding and communicating with the publisher contact : ContactDetail [0..*] The name of the organization that is responsible for issuing identifiers or codes for this namespace and ensuring their non-collision responsible : string [0..1] Categorizes a naming system for easier search by grouping related naming systems type : CodeableConcept [0..1] « A coded type for an identifier that can be used to determine which identifier to use for a specific purpose. (Strength=Extensible) Identifier Type + » A free text natural language description of the naming system from a consumer's perspective. Details about what the namespace identifies including scope, granularity, version labeling, etc description : markdown [0..1] The content was developed with a focus and intent of supporting the contexts that are listed. These terms contexts may be general categories (gender, age, ...) or may be references to specific programs (insurance plans, studies, ...) and may be used to assist with indexing and searching for appropriate naming system instances useContext : UsageContext [0..*] A legal or geographic region in which the naming system is intended to be used jurisdiction : CodeableConcept [0..*] « Countries and regions within which this artifact is targeted for use use. (Strength=Extensible) Jurisdiction ValueSet + » Provides guidance on the use of the namespace, including the handling of formatting characters, use of upper vs. lower case, etc usage : string [0..1] UniqueId Identifies the unique identifier scheme used for this particular identifier type : code [1..1] « Identifies the style of unique identifier used to identify a namespace. (Strength=Required) NamingSystemIdentifierType ! » The string that should be sent over the wire to identify the code system or identifier system value : string [1..1] Indicates whether this identifier is the "preferred" identifier of this type preferred : boolean [0..1] Notes about the past or intended usage of this identifier comment : string [0..1] Identifies the period of time over which this identifier is considered appropriate to refer to the naming system. Outside of this window, the identifier might be non-deterministic period : Period [0..1] Indicates how the system may be identified when referenced in electronic exchange uniqueId [1..*]

XML Template

<NamingSystem xmlns="http://hl7.org/fhir"> doco
 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <

 <name value="[string]"/><!-- ?? 1..1 Name for this naming system (computer friendly) -->

 <status value="[code]"/><!-- 1..1 draft | active | retired | unknown -->
 <kind value="[code]"/><!-- 1..1 codesystem | identifier | root -->
 <date value="[dateTime]"/><!-- 1..1 Date last changed -->
 <publisher value="[string]"/><!-- 0..1 Name of the publisher (organization or individual) -->
 <contact><!-- 0..* ContactDetail Contact details for the publisher --></contact>
 <responsible value="[string]"/><!-- 0..1 Who maintains system namespace? -->
 <type><!-- 0..1 CodeableConcept e.g. driver,  provider,  patient, bank etc. --></type>
 <description value="[markdown]"/><!-- 0..1 Natural language description of the naming system -->
 <</useContext>

 <useContext><!-- 0..* UsageContext The context that the content is intended to support --></useContext>

 <jurisdiction><!-- 0..* CodeableConcept Intended jurisdiction for naming system (if applicable) --></jurisdiction>
 <usage value="[string]"/><!-- 0..1 How/where is it used -->
 <uniqueId>  <!-- 1..* Unique identifiers used for system -->
  <type value="[code]"/><!-- 1..1 oid | uuid | uri | other -->
  <value value="[string]"/><!-- 1..1 The unique identifier -->
  <preferred value="[boolean]"/><!-- 0..1 Is this the id that should be used for this type -->
  <comment value="[string]"/><!-- 0..1 Notes about identifier usage -->
  <period><!-- 0..1 Period When is identifier valid? --></period>
 </uniqueId>
</NamingSystem>

Turtle Template

@prefix fhir: <http://hl7.org/fhir/> .doco
[ a fhir:NamingSystem;
  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:NamingSystem.name [ string ]; # 1..1 Name for this naming system (computer friendly)
  fhir:NamingSystem.status [ code ]; # 1..1 draft | active | retired | unknown
  fhir:NamingSystem.kind [ code ]; # 1..1 codesystem | identifier | root
  fhir:NamingSystem.date [ dateTime ]; # 1..1 Date last changed
  fhir:NamingSystem.publisher [ string ]; # 0..1 Name of the publisher (organization or individual)
  fhir:NamingSystem.contact [ ContactDetail ], ... ; # 0..* Contact details for the publisher
  fhir:NamingSystem.responsible [ string ]; # 0..1 Who maintains system namespace?
  fhir:NamingSystem.type [ CodeableConcept ]; # 0..1 e.g. driver,  provider,  patient, bank etc.
  fhir:NamingSystem.description [ markdown ]; # 0..1 Natural language description of the naming system
  fhir:

  fhir:NamingSystem.useContext [ UsageContext ], ... ; # 0..* The context that the content is intended to support

  fhir:NamingSystem.jurisdiction [ CodeableConcept ], ... ; # 0..* Intended jurisdiction for naming system (if applicable)
  fhir:NamingSystem.usage [ string ]; # 0..1 How/where is it used
  fhir:NamingSystem.uniqueId [ # 1..* Unique identifiers used for system
    fhir:NamingSystem.uniqueId.type [ code ]; # 1..1 oid | uuid | uri | other
    fhir:NamingSystem.uniqueId.value [ string ]; # 1..1 The unique identifier
    fhir:NamingSystem.uniqueId.preferred [ boolean ]; # 0..1 Is this the id that should be used for this type
    fhir:NamingSystem.uniqueId.comment [ string ]; # 0..1 Notes about identifier usage
    fhir:NamingSystem.uniqueId.period [ Period ]; # 0..1 When is identifier valid?
  ], ...;
]

Changes since R3

NamingSystem
NamingSystem.replacedBy NamingSystem.status
  • deleted Change value set from http://hl7.org/fhir/ValueSet/publication-status|4.0.0 to http://hl7.org/fhir/ValueSet/publication-status|4.1.0
NamingSystem.kind
  • Change value set from http://hl7.org/fhir/ValueSet/namingsystem-type|4.0.0 to http://hl7.org/fhir/ValueSet/namingsystem-type|4.1.0
NamingSystem.uniqueId.type
  • Change value set from http://hl7.org/fhir/ValueSet/namingsystem-identifier-type|4.0.0 to http://hl7.org/fhir/ValueSet/namingsystem-identifier-type|4.1.0

See the Full Difference for further information

This analysis is available as XML or JSON .

See R2 <--> R3 <--> R4 Conversion Maps (status = 3 tests that all execute ok. All tests pass 1 fail round-trip testing and all 3 r3 resources are valid.). Note: these have note yet been updated to be R3 to R4 invalid (0 errors). )

Structure

Name Flags Card. Type Description & Constraints doco
. . NamingSystem I TU DomainResource System of unique identification
+ Warning: Name should be usable as an identifier for the module by machine processing applications such as code generation
+ Rule: Root systems cannot have uuid identifiers
+ Rule: Can't have more than one preferred identifier for a type
Elements defined in Ancestors: id , meta , implicitRules , language , text , contained , extension , modifierExtension
. . . name Σ I 1..1 string Name for this naming system (computer friendly)
. . . status ?! Σ 1..1 code draft | active | retired | unknown
PublicationStatus ( Required )
. . . kind Σ 1..1 code codesystem | identifier | root
NamingSystemType ( Required )
. . . date Σ 1..1 dateTime Date last changed
. . . publisher Σ 0..1 string Name of the publisher (organization or individual)
. . . contact Σ 0..* ContactDetail Contact details for the publisher
. . . responsible 0..1 string Who maintains system namespace?
. . . type 0..1 CodeableConcept e.g. driver, provider, patient, bank etc.
Identifier Type Codes IdentifierType ( Extensible )
. . . description 0..1 markdown Natural language description of the naming system
. . . useContext Σ 0..* UsageContext The context that the content is intended to support
. . . jurisdiction Σ 0..* CodeableConcept Intended jurisdiction for naming system (if applicable)
Jurisdiction ValueSet ( Extensible )
. . . usage 0..1 string How/where is it used
. . . uniqueId Σ 1..* BackboneElement Unique identifiers used for system
. . . . type Σ 1..1 code oid | uuid | uri | other
NamingSystemIdentifierType ( Required )
. . . . value Σ 1..1 string The unique identifier
. . . . preferred 0..1 boolean Is this the id that should be used for this type
. . . . comment 0..1 string Notes about identifier usage
. . . . period 0..1 Period When is identifier valid?

doco Documentation for this format

UML Diagram ( Legend )

NamingSystem ( DomainResource ) A natural language name identifying the naming system. This name should be usable as an identifier for the module by machine processing applications such as code generation name : string [1..1] The status of this naming system. Enables tracking the life-cycle of the content (this element modifies the meaning of other elements) status : code [1..1] « The lifecycle status of an artifact. (Strength=Required) PublicationStatus ! » Indicates the purpose for the naming system - what kinds of things does it make unique? kind : code [1..1] « Identifies the purpose of the naming system. (Strength=Required) NamingSystemType ! » The date (and optionally time) when the naming system was published. The date must change when the business version changes and it must change if the status code changes. In addition, it should change when the substantive content of the naming system changes date : dateTime [1..1] The name of the organization or individual that published the naming system publisher : string [0..1] Contact details to assist a user in finding and communicating with the publisher contact : ContactDetail [0..*] The name of the organization that is responsible for issuing identifiers or codes for this namespace and ensuring their non-collision responsible : string [0..1] Categorizes a naming system for easier search by grouping related naming systems type : CodeableConcept [0..1] « A coded type for an identifier that can be used to determine which identifier to use for a specific purpose. (Strength=Extensible) Identifier Type + » A free text natural language description of the naming system from a consumer's perspective. Details about what the namespace identifies including scope, granularity, version labeling, etc description : markdown [0..1] The content was developed with a focus and intent of supporting the contexts that are listed. These terms contexts may be general categories (gender, age, ...) or may be references to specific programs (insurance plans, studies, ...) and may be used to assist with indexing and searching for appropriate naming system instances useContext : UsageContext [0..*] A legal or geographic region in which the naming system is intended to be used jurisdiction : CodeableConcept [0..*] « Countries and regions within which this artifact is targeted for use use. (Strength=Extensible) Jurisdiction ValueSet + » Provides guidance on the use of the namespace, including the handling of formatting characters, use of upper vs. lower case, etc usage : string [0..1] UniqueId Identifies the unique identifier scheme used for this particular identifier type : code [1..1] « Identifies the style of unique identifier used to identify a namespace. (Strength=Required) NamingSystemIdentifierType ! » The string that should be sent over the wire to identify the code system or identifier system value : string [1..1] Indicates whether this identifier is the "preferred" identifier of this type preferred : boolean [0..1] Notes about the past or intended usage of this identifier comment : string [0..1] Identifies the period of time over which this identifier is considered appropriate to refer to the naming system. Outside of this window, the identifier might be non-deterministic period : Period [0..1] Indicates how the system may be identified when referenced in electronic exchange uniqueId [1..*]

XML Template

<NamingSystem xmlns="http://hl7.org/fhir"> doco
 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <

 <name value="[string]"/><!-- ?? 1..1 Name for this naming system (computer friendly) -->

 <status value="[code]"/><!-- 1..1 draft | active | retired | unknown -->
 <kind value="[code]"/><!-- 1..1 codesystem | identifier | root -->
 <date value="[dateTime]"/><!-- 1..1 Date last changed -->
 <publisher value="[string]"/><!-- 0..1 Name of the publisher (organization or individual) -->
 <contact><!-- 0..* ContactDetail Contact details for the publisher --></contact>
 <responsible value="[string]"/><!-- 0..1 Who maintains system namespace? -->
 <type><!-- 0..1 CodeableConcept e.g. driver,  provider,  patient, bank etc. --></type>
 <description value="[markdown]"/><!-- 0..1 Natural language description of the naming system -->
 <</useContext>

 <useContext><!-- 0..* UsageContext The context that the content is intended to support --></useContext>

 <jurisdiction><!-- 0..* CodeableConcept Intended jurisdiction for naming system (if applicable) --></jurisdiction>
 <usage value="[string]"/><!-- 0..1 How/where is it used -->
 <uniqueId>  <!-- 1..* Unique identifiers used for system -->
  <type value="[code]"/><!-- 1..1 oid | uuid | uri | other -->
  <value value="[string]"/><!-- 1..1 The unique identifier -->
  <preferred value="[boolean]"/><!-- 0..1 Is this the id that should be used for this type -->
  <comment value="[string]"/><!-- 0..1 Notes about identifier usage -->
  <period><!-- 0..1 Period When is identifier valid? --></period>
 </uniqueId>
</NamingSystem>

Turtle Template

@prefix fhir: <http://hl7.org/fhir/> .doco
[ a fhir:NamingSystem;
  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:NamingSystem.name [ string ]; # 1..1 Name for this naming system (computer friendly)
  fhir:NamingSystem.status [ code ]; # 1..1 draft | active | retired | unknown
  fhir:NamingSystem.kind [ code ]; # 1..1 codesystem | identifier | root
  fhir:NamingSystem.date [ dateTime ]; # 1..1 Date last changed
  fhir:NamingSystem.publisher [ string ]; # 0..1 Name of the publisher (organization or individual)
  fhir:NamingSystem.contact [ ContactDetail ], ... ; # 0..* Contact details for the publisher
  fhir:NamingSystem.responsible [ string ]; # 0..1 Who maintains system namespace?
  fhir:NamingSystem.type [ CodeableConcept ]; # 0..1 e.g. driver,  provider,  patient, bank etc.
  fhir:NamingSystem.description [ markdown ]; # 0..1 Natural language description of the naming system
  fhir:

  fhir:NamingSystem.useContext [ UsageContext ], ... ; # 0..* The context that the content is intended to support

  fhir:NamingSystem.jurisdiction [ CodeableConcept ], ... ; # 0..* Intended jurisdiction for naming system (if applicable)
  fhir:NamingSystem.usage [ string ]; # 0..1 How/where is it used
  fhir:NamingSystem.uniqueId [ # 1..* Unique identifiers used for system
    fhir:NamingSystem.uniqueId.type [ code ]; # 1..1 oid | uuid | uri | other
    fhir:NamingSystem.uniqueId.value [ string ]; # 1..1 The unique identifier
    fhir:NamingSystem.uniqueId.preferred [ boolean ]; # 0..1 Is this the id that should be used for this type
    fhir:NamingSystem.uniqueId.comment [ string ]; # 0..1 Notes about identifier usage
    fhir:NamingSystem.uniqueId.period [ Period ]; # 0..1 When is identifier valid?
  ], ...;
]

Changes since DSTU2 Release 3

NamingSystem
NamingSystem.replacedBy NamingSystem.status
  • deleted Change value set from http://hl7.org/fhir/ValueSet/publication-status|4.0.0 to http://hl7.org/fhir/ValueSet/publication-status|4.1.0
NamingSystem.kind
  • Change value set from http://hl7.org/fhir/ValueSet/namingsystem-type|4.0.0 to http://hl7.org/fhir/ValueSet/namingsystem-type|4.1.0
NamingSystem.uniqueId.type
  • Change value set from http://hl7.org/fhir/ValueSet/namingsystem-identifier-type|4.0.0 to http://hl7.org/fhir/ValueSet/namingsystem-identifier-type|4.1.0

See the Full Difference for further information

This analysis is available as XML or JSON .

See R2 <--> R3 <--> R4 Conversion Maps (status = 3 tests that all execute ok. All tests pass 1 fail round-trip testing and all 3 r3 resources are valid.). Note: these have note yet been updated to be R3 to R4 invalid (0 errors). )

 

Alternate See the Profiles & Extensions and the alternate definitions: Master Definition XML + JSON , XML Schema / Schematron + JSON Schema , ShEx (for Turtle ) + see the extensions , the spreadsheet version & the dependency analysis a

Path Definition Type Reference
NamingSystem.status The lifecycle status of an artifact. Required PublicationStatus
NamingSystem.kind Identifies the purpose of the naming system. Required NamingSystemType
NamingSystem.type A coded type for an identifier that can be used to determine which identifier to use for a specific purpose. Extensible Identifier Type Codes
NamingSystem.jurisdiction Countries and regions within which this artifact is targeted for use use. Extensible Jurisdiction ValueSet
NamingSystem.uniqueId.type Identifies the style of unique identifier used to identify a namespace. Required NamingSystemIdentifierType

id Level Location Description Expression
nsd-0 Warning (base) Name should be usable as an identifier for the module by machine processing applications such as code generation name.matches('[A-Z]([A-Za-z0-9_]){0,254}')
nsd-1 : Rule (base) Root systems cannot have uuid identifiers ( expression : kind != 'root' or uniqueId.all(type != 'uuid') )
nsd-2 : Rule (base) Can't have more than one preferred identifier for a type ( expression : uniqueId.where(preferred = true).select(type).isDistinct() )

In some cases, the same code or identifier system might accidentally be created more than once in a registry, for example because someone failed to check for an existing entry before adding a new one or knows the same concept with a different name. If this occurs, one of the system entries should be deleted and the remaining entry should have its uniqueId updated to include any identifiers present on the original entry (and possibly have its descriptive information modified to include additional information from the duplicate entry).

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 Expression In Common
contact string Name of an individual to contact NamingSystem.contact.name
context token A use context assigned to the naming system (NamingSystem.useContext.value as CodeableConcept)
context-quantity quantity A quantity- or range-valued use context assigned to the naming system (NamingSystem.useContext.value as Quantity) | (NamingSystem.useContext.value as Range)
context-type token A type of use context assigned to the naming system NamingSystem.useContext.code
context-type-quantity composite A use context type and quantity- or range-based value assigned to the naming system On NamingSystem.useContext:
  context-type: code
  context-quantity: value.as(Quantity) | value.as(Range)
context-type-value composite A use context type and value assigned to the naming system On NamingSystem.useContext:
  context-type: code
  context: value.as(CodeableConcept)
date date The naming system publication date NamingSystem.date
description string The description of the naming system NamingSystem.description
id-type token oid | uuid | uri | other NamingSystem.uniqueId.type
jurisdiction token Intended jurisdiction for the naming system NamingSystem.jurisdiction
kind token codesystem | identifier | root NamingSystem.kind
name string Computationally friendly name of the naming system NamingSystem.name
period date When is identifier valid? NamingSystem.uniqueId.period
publisher string Name of the publisher of the naming system NamingSystem.publisher
responsible string Who maintains system namespace? NamingSystem.responsible
status token The current status of the naming system NamingSystem.status
telecom token Contact details for individual or organization NamingSystem.contact.telecom
type token e.g. driver, provider, patient, bank etc. NamingSystem.type
value string The unique identifier NamingSystem.uniqueId.value