FHIR Tooling Extensions IG
0.3.0 - Release 0.2.0 International flag

This page is part of the HL7 Tools Extension IG (v0.3.0: Releases - Informative) based on FHIR (HL7® FHIR® Standard) v5.0.0. This is the current published version in its permanent home (it will always be available at this URL). For a full list of available versions, see the Directory of published versions

Logical Model: CDSHooksServices - Detailed Descriptions

Draft as of 2024-10-27 Maturity Level: 2

Definitions for the CDSHooksServices logical model.

Guidance on how to interpret the contents of this table can be found here

0. CDSHooksServices
Definition

The response to the discovery endpoint

ShortThe response to the discovery endpoint
Logical ModelInstances of this logical model are not marked to be the target of a Reference
2. CDSHooksServices.services
Definition

A list of CDS services

ShortA list of CDS services
Comments

If the CDS server hosts no CDS services, the discovery endpoint should return a 200 HTTP response with an empty array of services

Control0..*
Typehttp://hl7.org/fhir/tools/StructureDefinition/CDSHooksElement
4. CDSHooksServices.services.hook
Definition

The hook this Services should be invoked on

ShortThe hook this Services should be invoked on
Control1..1
Typestring
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
6. CDSHooksServices.services.title
Definition

The human-friendly name of this Services (Recommended)

ShortThe human-friendly name of this Services (Recommended)
Control0..1
Typestring
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
8. CDSHooksServices.services.id
Definition

The {id} portion of the URL to this service which is available at {baseUrl}/cds-services/{id}

ShortThe URL to this service which is available at: {baseUrl}/cds-services/{id}
Control1..1
Typecode
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
10. CDSHooksServices.services.description
Definition

The description of this Services

ShortThe description of this Services
Control1..1
Typestring
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
12. CDSHooksServices.services.usageRequirements
Definition

Human-friendly description of any preconditions for the use of this CDS Services

ShortHuman-friendly description of any preconditions for the use of this CDS Services
Control0..1
Typestring
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
14. CDSHooksServices.services.prefetch
Definition

An object containing key/value pairs of FHIR queries that this Services is requesting the CDS Client to perform and provide on each Services call. The key is a string that describes the type of data being requested and the value is a string representing the FHIR query

ShortKey/value pairs of FHIR queries the CDS Client provides on each call
Control0..*
TypeBase
JSON FormatThis repeating object is represented as a single JSON object with named properties. The name of the property (key) is the value of thekey child
16. CDSHooksServices.services.prefetch.key
Definition

Key of FHIR query - name for client to use when sending to Services

ShortKey of FHIR query - name for client to use when sending to Services
Control1..1
Typecode
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
18. CDSHooksServices.services.prefetch.value
Definition

Value of FHIR query - FHIR Query for client to perform

ShortValue of FHIR query - FHIR Query for client to perform
Control1..1
Typestring
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension

Guidance on how to interpret the contents of this table can be found here

0. CDSHooksServices
Definition

The response to the discovery endpoint


Base definition for all types defined in FHIR type system.

ShortThe response to the discovery endpointBase for all types and resources
Control0..*
Is Modifierfalse
Logical ModelInstances of this logical model are not marked to be the target of a Reference
2. CDSHooksServices.services
Definition

A list of CDS services

ShortA list of CDS services
Comments

If the CDS server hosts no CDS services, the discovery endpoint should return a 200 HTTP response with an empty array of services

Control0..*
Typehttp://hl7.org/fhir/tools/StructureDefinition/CDSHooksElement
4. CDSHooksServices.services.hook
Definition

The hook this Services should be invoked on

ShortThe hook this Services should be invoked on
Control1..1
Typestring
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
6. CDSHooksServices.services.title
Definition

The human-friendly name of this Services (Recommended)

ShortThe human-friendly name of this Services (Recommended)
Control0..1
Typestring
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
8. CDSHooksServices.services.id
Definition

The {id} portion of the URL to this service which is available at {baseUrl}/cds-services/{id}

ShortThe URL to this service which is available at: {baseUrl}/cds-services/{id}
Control1..1
Typecode
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
10. CDSHooksServices.services.description
Definition

The description of this Services

ShortThe description of this Services
Control1..1
Typestring
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
12. CDSHooksServices.services.usageRequirements
Definition

Human-friendly description of any preconditions for the use of this CDS Services

ShortHuman-friendly description of any preconditions for the use of this CDS Services
Control0..1
Typestring
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
14. CDSHooksServices.services.prefetch
Definition

An object containing key/value pairs of FHIR queries that this Services is requesting the CDS Client to perform and provide on each Services call. The key is a string that describes the type of data being requested and the value is a string representing the FHIR query

ShortKey/value pairs of FHIR queries the CDS Client provides on each call
Control0..*
TypeBase
JSON FormatThis repeating object is represented as a single JSON object with named properties. The name of the property (key) is the value of thekey child
16. CDSHooksServices.services.prefetch.key
Definition

Key of FHIR query - name for client to use when sending to Services

ShortKey of FHIR query - name for client to use when sending to Services
Control1..1
Typecode
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
18. CDSHooksServices.services.prefetch.value
Definition

Value of FHIR query - FHIR Query for client to perform

ShortValue of FHIR query - FHIR Query for client to perform
Control1..1
Typestring
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension

Guidance on how to interpret the contents of this table can be found here

0. CDSHooksServices
Definition

The response to the discovery endpoint

ShortThe response to the discovery endpoint
Control0..*
Is Modifierfalse
Logical ModelInstances of this logical model are not marked to be the target of a Reference
2. CDSHooksServices.extension
Definition

A JSON object that has properties where the names are defined by the extension definitions

ShortObject that has Named Extension Properties
Comments

Extension structures SHOULD use a strategy for naming that ensures global uniqueness, such as reverse-domain-name notation, e.g. com.cds-hooks.sandbox.myextension-practitionerspecialty

Control0..1
Typehttp://hl7.org/fhir/tools/StructureDefinition/CDSHooksElement
Extension StyleThis element can be extended by named JSON elements
4. CDSHooksServices.services
Definition

A list of CDS services

ShortA list of CDS services
Comments

If the CDS server hosts no CDS services, the discovery endpoint should return a 200 HTTP response with an empty array of services

Control0..*
Typehttp://hl7.org/fhir/tools/StructureDefinition/CDSHooksElement
6. CDSHooksServices.services.extension
Definition

A JSON object that has properties where the names are defined by the extension definitions

ShortObject that has Named Extension Properties
Comments

Extension structures SHOULD use a strategy for naming that ensures global uniqueness, such as reverse-domain-name notation, e.g. com.cds-hooks.sandbox.myextension-practitionerspecialty

Control0..1
Typehttp://hl7.org/fhir/tools/StructureDefinition/CDSHooksElement
Extension StyleThis element can be extended by named JSON elements
8. CDSHooksServices.services.hook
Definition

The hook this Services should be invoked on

ShortThe hook this Services should be invoked on
Control1..1
Typestring
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
10. CDSHooksServices.services.title
Definition

The human-friendly name of this Services (Recommended)

ShortThe human-friendly name of this Services (Recommended)
Control0..1
Typestring
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
12. CDSHooksServices.services.id
Definition

The {id} portion of the URL to this service which is available at {baseUrl}/cds-services/{id}

ShortThe URL to this service which is available at: {baseUrl}/cds-services/{id}
Control1..1
Typecode
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
14. CDSHooksServices.services.description
Definition

The description of this Services

ShortThe description of this Services
Control1..1
Typestring
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
16. CDSHooksServices.services.usageRequirements
Definition

Human-friendly description of any preconditions for the use of this CDS Services

ShortHuman-friendly description of any preconditions for the use of this CDS Services
Control0..1
Typestring
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
18. CDSHooksServices.services.prefetch
Definition

An object containing key/value pairs of FHIR queries that this Services is requesting the CDS Client to perform and provide on each Services call. The key is a string that describes the type of data being requested and the value is a string representing the FHIR query

ShortKey/value pairs of FHIR queries the CDS Client provides on each call
Control0..*
TypeBase
JSON FormatThis repeating object is represented as a single JSON object with named properties. The name of the property (key) is the value of thekey child
20. CDSHooksServices.services.prefetch.key
Definition

Key of FHIR query - name for client to use when sending to Services

ShortKey of FHIR query - name for client to use when sending to Services
Control1..1
Typecode
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
22. CDSHooksServices.services.prefetch.value
Definition

Value of FHIR query - FHIR Query for client to perform

ShortValue of FHIR query - FHIR Query for client to perform
Control1..1
Typestring
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension