National Directory of Healthcare Providers & Services (NDH) Implementation Guide
2.0.0-current - ci-build United States of America flag

National Directory of Healthcare Providers & Services (NDH) Implementation Guide, published by HL7 International / Patient Administration. This guide is not an authorized publication; it is the continuous build for version 2.0.0-current built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/fhir-us-ndh/ and changes regularly. See the Directory of published versions

Extension: NDH Associated Servers

Official URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-associatedServers Version: 2.0.0-current
Standards status: Trial-use Active as of 2026-04-22 Maturity Level: 4 Computable Name: AssociatedServers

This extension is designed to store information about servers that may be associated with the current endpoint. It defines a set of servers that could be linked to this endpoint. If a server is associated, the server's type and URL will be included. For example, if your system features two types of endpoints: a standard endpoint and a proxy endpoint associated with the server. For example, the proxy endpoint can be configured to interface with AEGIS software, allowing the software to record transactions and ensure compliance with pertinent standards or regulations. Implementing such a configuration in a production environment would offer the flexibility to switch between standard and proxy modes (associated server) as necessary. Consequently, it is essential to have both standard and proxy endpoints readily available for seamless transitions as required.

Context of Use

    This extension may be used on the following element(s)

Usage info

Usages:

You can also check for usages in the FHIR IG Statistics

Formal Views of Extension Content

Description Differentials, Snapshots, and other representations.

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Extension 0..* Extension NDH Associated Servers
... extension 1..* Extension Extension
... Slices for extension Content/Rules for all slices
.... extension:associatedServersType S 1..1 Extension Associated Server Type
..... extension 0..0 Extension
..... url 1..1 uri "associatedServersType"
..... value[x] 1..1 CodeableConcept Value of extension
Binding: Associated Servers Type Value Set (extensible)
.... extension:serverURL S 0..1 Extension Binary
..... extension 0..0 Extension
..... url 1..1 uri "serverURL"
..... value[x] 1..1 string Value of extension
... url 1..1 uri "http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-associatedServers"

doco Documentation for this format

Terminology Bindings (Differential)

Path Status Usage ValueSet Version Source
Extension.extension:associatedServersType.​value[x] Base extensible Associated Servers Type Value Set 📦2.0.0-current This IG
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Extension 0..* Extension NDH Associated Servers
... id 0..1 string Unique id for inter-element referencing
... Slices for extension 1..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:associatedServersType S 1..1 Extension Associated Server Type
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "associatedServersType"
..... value[x] 1..1 CodeableConcept Value of extension
Binding: Associated Servers Type Value Set (extensible)
.... extension:serverURL S 0..1 Extension Binary
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "serverURL"
..... value[x] 1..1 string Value of extension
... url 1..1 uri "http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-associatedServers"

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Extension.extension:associatedServersType.​value[x] Base extensible Associated Servers Type Value Set 📦2.0.0-current This IG

Constraints

Id Grade Path(s) Description Expression
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()

Summary

Complex Extension: This extension is designed to store information about servers that may be associated with the current endpoint. It defines a set of servers that could be linked to this endpoint. If a server is associated, the server's type and URL will be included. For example, if your system features two types of endpoints: a standard endpoint and a proxy endpoint associated with the server. For example, the proxy endpoint can be configured to interface with AEGIS software, allowing the software to record transactions and ensure compliance with pertinent standards or regulations. Implementing such a configuration in a production environment would offer the flexibility to switch between standard and proxy modes (associated server) as necessary. Consequently, it is essential to have both standard and proxy endpoints readily available for seamless transitions as required.

  • associatedServersType: CodeableConcept: An Extension
  • serverURL: string: An Extension

Maturity: 4

Differential ViewDifferential View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Extension 0..* Extension NDH Associated Servers
... extension 1..* Extension Extension
... Slices for extension Content/Rules for all slices
.... extension:associatedServersType S 1..1 Extension Associated Server Type
..... extension 0..0 Extension
..... url 1..1 uri "associatedServersType"
..... value[x] 1..1 CodeableConcept Value of extension
Binding: Associated Servers Type Value Set (extensible)
.... extension:serverURL S 0..1 Extension Binary
..... extension 0..0 Extension
..... url 1..1 uri "serverURL"
..... value[x] 1..1 string Value of extension
... url 1..1 uri "http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-associatedServers"

doco Documentation for this format

Terminology Bindings (Differential)

Path Status Usage ValueSet Version Source
Extension.extension:associatedServersType.​value[x] Base extensible Associated Servers Type Value Set 📦2.0.0-current This IG

Snapshot View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Extension 0..* Extension NDH Associated Servers
... id 0..1 string Unique id for inter-element referencing
... Slices for extension 1..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:associatedServersType S 1..1 Extension Associated Server Type
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "associatedServersType"
..... value[x] 1..1 CodeableConcept Value of extension
Binding: Associated Servers Type Value Set (extensible)
.... extension:serverURL S 0..1 Extension Binary
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "serverURL"
..... value[x] 1..1 string Value of extension
... url 1..1 uri "http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-associatedServers"

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Extension.extension:associatedServersType.​value[x] Base extensible Associated Servers Type Value Set 📦2.0.0-current This IG

Constraints

Id Grade Path(s) Description Expression
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()

Summary

Complex Extension: This extension is designed to store information about servers that may be associated with the current endpoint. It defines a set of servers that could be linked to this endpoint. If a server is associated, the server's type and URL will be included. For example, if your system features two types of endpoints: a standard endpoint and a proxy endpoint associated with the server. For example, the proxy endpoint can be configured to interface with AEGIS software, allowing the software to record transactions and ensure compliance with pertinent standards or regulations. Implementing such a configuration in a production environment would offer the flexibility to switch between standard and proxy modes (associated server) as necessary. Consequently, it is essential to have both standard and proxy endpoints readily available for seamless transitions as required.

  • associatedServersType: CodeableConcept: An Extension
  • serverURL: string: An Extension

Maturity: 4

 

Other representations of profile: CSV, Excel, Schematron