Hauptseite: Unterschied zwischen den Versionen

Aus CTS2-LE
Zur Navigation springen Zur Suche springen
(→‎Navigator)
K (→‎Core Web Services)
 
(25 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
 
{{DISPLAYTITLE:CTS2 Linked Data Edition Terminology Server}}
 
{{DISPLAYTITLE:CTS2 Linked Data Edition Terminology Server}}
  
−
Controlled vocabularies (also known as code systems or terminologies) are common information artefacts in healthcare. They allow for univocally and precisely referencing of concepts and are core foundation of any semantic processing of health data. In particular all electronic communication in healthcare relies on coded concepts for semantic interoperability and automated data processing. The Object Management Group's [[OMG/HL7 CTS2 Standard|Common Terminology Services Version 2 (CTS2) standard]] defines an accepted industry standard representation to share, query and maintain value sets and other terminology artifacts. One method to achieve compliance with the structural profiles of CTS2 is to use semantic web technologies that are widely used for vocabularies. In this way, CTS2 artifacts such as code systems, code system elements (i.e., codes and their designations), associations and value sets (i.e., sets of code system elements) can be processed with semantic technologies.
+
Controlled vocabularies (also known as code systems or terminologies) are common information artefacts in healthcare. They allow for univocally and precisely referencing of concepts and are core foundation of any semantic processing of health data. In particular all electronic communication in healthcare relies on coded concepts for semantic interoperability and automated data processing. The Object Management Group's [[OMG/HL7 CTS2 Standard|Common Terminology Services Version 2 (CTS2) standard]] defines an accepted industry standard representation to share, query and maintain value sets and other terminology artifacts. '''CTS2 was the conceptual background/blueprint for the development of the terminology resource structure of FHIR'''. Therefore CTS2-LE is FHIR-enabled in order to support this standard that will be the main standard in electronic healthcare.
 +
 
 +
One method to achieve compliance with the structural profiles of FHIR terminologies and value sets is to use semantic web technologies that are widely used for vocabularies. In this way, artifacts such as code systems, code system elements (i.e., codes and their designations), associations and value sets (i.e., sets of code system elements) can be processed with semantic technologies. The '''CTS2 Linked Data Edition (CTS2-LE)''' terminology server provided by Fraunhofer FOKUS follows that foundation. It relies on the the [http://www.w3.org/standards/techs/rdf#w3c_all Resource Description Framework (RDF)] in conjunction with a [http://www.w3.org/TR/2014/REC-rdf-schema-20140225/ RDFS]-based schema vocabulary oriented towards the Frame Logic. So-called RDF signatures, based on this schema vocabulary, describe structural constraints according to the information model. Likewise, arbitrary object graphs can be processed and stored with these RDF signatures.
  
−
The '''CTS2 Linked Data Edition (CTS2-LE)''' terminology server provided by Fraunhofer FOKUS follows that foundation. It relies on the the [http://www.w3.org/standards/techs/rdf#w3c_all Resource Description Framework (RDF)] in conjunction with a [http://www.w3.org/TR/2014/REC-rdf-schema-20140225/ RDFS]-based schema vocabulary oriented towards the Frame Logic. So-called RDF signatures, based on this schema vocabulary, describe structural constraints according to the CTS2 information model. Likewise, arbitrary object graphs can be processed and stored with these RDF signatures.
 
  
 
== Overview ==
 
== Overview ==
−
This section provides an overview about CTS2-LE. It introduces the CTS2-LE building blocks and summarizes the most important functional features provided by CTS2-LE.
+
This section provides an overview about CTS2-LE. It introduces the building blocks and summarizes the most important functional features.
 
;[[CTS2-LE Fact Sheet]] (German)
 
;[[CTS2-LE Fact Sheet]] (German)
−
:The CTS2-LE Fact Sheet provides an overview of CTS2-LE considering the implemented CTS2 functionalities and additional usability related features.
+
:The Fact Sheet provides an overview considering the implemented functionalities and additional usability related features.
 
;[[CTS2-LE Building Blocks]]
 
;[[CTS2-LE Building Blocks]]
−
:The foundation of CTS2-LE features a structural compliance to the OMG CTS2 Information Model, is linked-data ready by the means of W3C RDF, and is accessible through a HL7 FHIR and REST API as well as supporting the definition, composition and import of value sets. The knowledge base functionality is implemented with RDF as the representation language providing linkage capabilities for terminological entities. This section describes the architecture and internal design of CTS2-LE.
+
:Building blocks feature a structural compliance to the Information Model, is linked-data ready by the means of W3C RDF, and is accessible through a HL7 FHIR and REST API as well as supporting the definition, composition and import of value sets. The knowledge base functionality is implemented with RDF as the representation language providing linkage capabilities for terminological entities. This section describes the architecture and internal design.  
−
;[[CTS2-LE Supported Terminologies]]
 
−
:CTS2-LE is highly suitable for representing netlike vocabularies of varying complexity. Thus, it facilitates the integration of several healthcare relevant terminologies. This section gives an overview of the vocabularies that can be loaded so far.
 
 
;[[CTS2-LE Interoperability]]  
 
;[[CTS2-LE Interoperability]]  
−
:CTS2-LE is build upon international standards and provides multiple standard interfaces for connecting to external services. This section gives an overview on the standards supported by CTS2-LE and how these can be utilized for integrating CTS2-LE with third party products.
+
:The system is build upon international standards and provides multiple standard interfaces for connecting to external services. This section gives an overview on the standards supported and how these can be utilized for integrating with third party products.
 
;[[Further Information Sources for CTS2-LE]]
 
;[[Further Information Sources for CTS2-LE]]
−
:Fraunhofer FOKUS has published various papers and brochures about CTS2-LE in particular and terminology services in general. This section provides links to online resources related to CTS2 and CTS2-LE.
+
:Fraunhofer FOKUS has published various papers and brochures about CTS2-LE in particular and terminology services in general.  
  
 
== Installation, Deployment, and Setup ==
 
== Installation, Deployment, and Setup ==
−
This section covers the installation and initial setup of CTS-LE within an organization.  
+
This section covers the installation and initial setup of CTS-LE within an organization. The installation is performed via a deployment to a Kubernetes system. 
 +
<!--
 
;[[Prerequisites V2|Prerequisites]]
 
;[[Prerequisites V2|Prerequisites]]
−
:This section describes the hardware, OS and network requirements for installing CTS2-LE as a stand-alone-system on a server.
+
:This section describes the hardware, OS and network requirements for installing CTS2-LE.
 +
-->
  
 
;[[Installation and Setup V3|Installation, Deployment, and Setup V3]]
 
;[[Installation and Setup V3|Installation, Deployment, and Setup V3]]
Zeile 27: Zeile 28:
  
 
;[[Installation and Setup V3 (2020 versions)|Installation, Deployment, and Setup V3 (2020 versions)]]
 
;[[Installation and Setup V3 (2020 versions)|Installation, Deployment, and Setup V3 (2020 versions)]]
−
:V3 is designed to run in embedded mode (jena TDB quadstore, Lucene) and in distributed mode (Fuseki, Solr).
+
<!-- :V3 is designed to run in embedded mode (jena TDB quadstore, Lucene) and in distributed mode (Fuseki, Solr). -->
 +
: '''DEPRECATED'''
 +
 
 +
;[[Installation and Setup V3 (2021 versions)|Installation, Deployment, and Setup V3 (2021 versions)]]
 +
: '''DEPRECATED'''
 +
 
 +
;[[Installation and Setup V4 (2025)|Installation, Deployment, and Setup V4 (2025)]]
 +
:V4 (version >= 4.0.0) with full HELM and BfArM support.
 +
 
 +
;[[CTS2-LE Supported Terminologies|Supported Terminologies]]
 +
:Overview of the '''main''' standard vocabularies/versions.
  
 
<!--
 
<!--
 +
;[[BfArM Terminologies|BfArM Terminologies]]
 +
:Terminologies of BfArM (Bundesinstitut für Arzneimittel und Medizinprodukte).
 +
 +
 
== Navigator ==
 
== Navigator ==
 
The CTS2-LE Navigator provides a graphical user interface for online browsing. This sections describes the functionalites of the CTS2-LE Navigator and how to use these.
 
The CTS2-LE Navigator provides a graphical user interface for online browsing. This sections describes the functionalites of the CTS2-LE Navigator and how to use these.
Zeile 48: Zeile 63:
  
 
== Core Web Services ==  
 
== Core Web Services ==  
−
CTS2-LE provides a simple REST interface for integrating CTS2-LE terminology services with custom and third-party applications. This section provides the technical specification of the CTS2-LE REST Application Programming Interface.
+
CTS2-LE provides a REST interface for integrating terminology services with custom and third-party applications. This section provides the technical specification of the REST Application Programming Interface.
  
  
Zeile 56: Zeile 71:
 
: The suggester '''has to be updated''' whenever a code system is loaded. The suggester is used for searches within the navigation frontend.  
 
: The suggester '''has to be updated''' whenever a code system is loaded. The suggester is used for searches within the navigation frontend.  
 
* [[CTS2-LE REST API: General#GET_service.2Fmanage.2Findex.2Fupdate|Search index update]]
 
* [[CTS2-LE REST API: General#GET_service.2Fmanage.2Findex.2Fupdate|Search index update]]
−
: Update only has to be invoked for RDF triple loading or if elements of a resource are modified via editing. The search index '''is automatically updated''' whenever a code system is loaded (exclusive bulk loading).  
+
: Update only has to be invoked for RDF triple loading or if elements of a resource are modified via editing. The search index '''is automatically updated''' whenever a code system is loaded.
 +
* [[CTS2-LE REST API: General#GET_service.2Fcrud.2Fcts2.2Fresources|List resources]]
 +
: List all rersources (code systems, value sets, concept maps).
 
* [[CTS2-LE REST API: General#DELETE_service.2Fcrud.2Fcts2.2Fresource|Delete resource]] by uri and version
 
* [[CTS2-LE REST API: General#DELETE_service.2Fcrud.2Fcts2.2Fresource|Delete resource]] by uri and version
  
Zeile 65: Zeile 82:
 
* [https://www.hl7.org/fhir/valueset.html value sets] and
 
* [https://www.hl7.org/fhir/valueset.html value sets] and
 
* [https://www.hl7.org/fhir/conceptmap.html concept maps]
 
* [https://www.hl7.org/fhir/conceptmap.html concept maps]
−
that will deprecate most of the [[#FHIR-oriented_.28deprecated.2C_use_FHIR_R4_instead.29|API below]]. Not all parameters are supported, but in the context of customization for a project it will be enhanced. The following operations are supported:
+
<!-- that will deprecate most of the [[#FHIR-oriented_.28deprecated.2C_use_FHIR_R4_instead.29|API below]]. -->
 +
 
 +
Not all parameters are supported, but in the context of customization for a project it will be enhanced. The following operations are supported.
 +
 
 +
The fhir base path is <code><host>/WebCts2LE/hapi-fhir</code>.
  
 
==== Resource-type-independent ====
 
==== Resource-type-independent ====
  
−
* [https://www.hl7.org/fhir/http.html#read read] (currently, only for code systems and value sets)
+
* [https://www.hl7.org/fhir/http.html#read read]
 
* [https://www.hl7.org/fhir/http.html#update update]  
 
* [https://www.hl7.org/fhir/http.html#update update]  
 
* [https://www.hl7.org/fhir/http.html#delete delete] by resource id (unconditional)
 
* [https://www.hl7.org/fhir/http.html#delete delete] by resource id (unconditional)
Zeile 93: Zeile 114:
 
* [https://www.hl7.org/fhir/conceptmap-operation-translate.html translate]
 
* [https://www.hl7.org/fhir/conceptmap-operation-translate.html translate]
 
: supported parameters: ''url'', ''code'', ''system'', ''version'', ''coding'', ''codeableConcept'', ''targetsystem''
 
: supported parameters: ''url'', ''code'', ''system'', ''version'', ''coding'', ''codeableConcept'', ''targetsystem''
−
 
  
 
=== OWL ===
 
=== OWL ===
Zeile 101: Zeile 121:
  
  
 +
<!--
 
=== FHIR-oriented ''(deprecated, use [[#FHIR_R4|FHIR R4]] instead)'' ===
 
=== FHIR-oriented ''(deprecated, use [[#FHIR_R4|FHIR R4]] instead)'' ===
  
Zeile 117: Zeile 138:
 
;[[CTS2-LE REST API: Delete Value Set / Code System|Delete Value Set / Code System]]
 
;[[CTS2-LE REST API: Delete Value Set / Code System|Delete Value Set / Code System]]
 
:allows to delete a FHIR coded value set (or code system).
 
:allows to delete a FHIR coded value set (or code system).
 +
 +
-->
  
 
=== SPARQL ===
 
=== SPARQL ===
Zeile 123: Zeile 146:
 
:Due to the full RDF-encoding of all terminology artifacts, CTS2-LE allows for arbitrary queries within and across terminologies, value sets, concepts, and concept relationships. This API provides means to transmit a standard [http://www.w3.org/TR/2008/REC-rdf-sparql-query-20080115/ SPARQL query] to CTS2-LE. The query result is provided in standard [http://www.w3.org/TR/rdf-sparql-XMLres/ SPARQL Query Results XML Format].  
 
:Due to the full RDF-encoding of all terminology artifacts, CTS2-LE allows for arbitrary queries within and across terminologies, value sets, concepts, and concept relationships. This API provides means to transmit a standard [http://www.w3.org/TR/2008/REC-rdf-sparql-query-20080115/ SPARQL query] to CTS2-LE. The query result is provided in standard [http://www.w3.org/TR/rdf-sparql-XMLres/ SPARQL Query Results XML Format].  
  
 +
<!--
 
=== CTS2 REST-API ''(deprecated, use [[#FHIR_R4|FHIR R4]] instead)'' ===
 
=== CTS2 REST-API ''(deprecated, use [[#FHIR_R4|FHIR R4]] instead)'' ===
  
Zeile 138: Zeile 162:
 
;[[CTS2-LE ClaML API: Update|Update Codesystem]]
 
;[[CTS2-LE ClaML API: Update|Update Codesystem]]
 
;[[CTS2-LE ClaML API: Retrieve Codesystem|Retrieve Codesystem]]
 
;[[CTS2-LE ClaML API: Retrieve Codesystem|Retrieve Codesystem]]
 +
-->
  
 
<!--
 
<!--
Zeile 211: Zeile 236:
 
:Grouping of terminologies in the navigator
 
:Grouping of terminologies in the navigator
  
 +
<!--
 
== Solution Management ==
 
== Solution Management ==
 
;[[Licence and Availability Notes|CTS2-LE Licensing]]  
 
;[[Licence and Availability Notes|CTS2-LE Licensing]]  
Zeile 217: Zeile 243:
 
;[[CTS2-LE Release Management]]
 
;[[CTS2-LE Release Management]]
 
:Fraunhofer FOKUS is continuosly maintaining and further developing CTS2-LE. This section gives insight into the CTS2-LE development roadmap by sketching CTS2-LE add-ons and improvements which are under development at Fraunhofer FOKUS.
 
:Fraunhofer FOKUS is continuosly maintaining and further developing CTS2-LE. This section gives insight into the CTS2-LE development roadmap by sketching CTS2-LE add-ons and improvements which are under development at Fraunhofer FOKUS.
 +
-->
  
 
<!--
 
<!--

Aktuelle Version vom 8. Januar 2026, 14:31 Uhr


Controlled vocabularies (also known as code systems or terminologies) are common information artefacts in healthcare. They allow for univocally and precisely referencing of concepts and are core foundation of any semantic processing of health data. In particular all electronic communication in healthcare relies on coded concepts for semantic interoperability and automated data processing. The Object Management Group's Common Terminology Services Version 2 (CTS2) standard defines an accepted industry standard representation to share, query and maintain value sets and other terminology artifacts. CTS2 was the conceptual background/blueprint for the development of the terminology resource structure of FHIR. Therefore CTS2-LE is FHIR-enabled in order to support this standard that will be the main standard in electronic healthcare.

One method to achieve compliance with the structural profiles of FHIR terminologies and value sets is to use semantic web technologies that are widely used for vocabularies. In this way, artifacts such as code systems, code system elements (i.e., codes and their designations), associations and value sets (i.e., sets of code system elements) can be processed with semantic technologies. The CTS2 Linked Data Edition (CTS2-LE) terminology server provided by Fraunhofer FOKUS follows that foundation. It relies on the the Resource Description Framework (RDF) in conjunction with a RDFS-based schema vocabulary oriented towards the Frame Logic. So-called RDF signatures, based on this schema vocabulary, describe structural constraints according to the information model. Likewise, arbitrary object graphs can be processed and stored with these RDF signatures.


Overview

This section provides an overview about CTS2-LE. It introduces the building blocks and summarizes the most important functional features.

CTS2-LE Fact Sheet (German)
The Fact Sheet provides an overview considering the implemented functionalities and additional usability related features.
CTS2-LE Building Blocks
Building blocks feature a structural compliance to the Information Model, is linked-data ready by the means of W3C RDF, and is accessible through a HL7 FHIR and REST API as well as supporting the definition, composition and import of value sets. The knowledge base functionality is implemented with RDF as the representation language providing linkage capabilities for terminological entities. This section describes the architecture and internal design.
CTS2-LE Interoperability
The system is build upon international standards and provides multiple standard interfaces for connecting to external services. This section gives an overview on the standards supported and how these can be utilized for integrating with third party products.
Further Information Sources for CTS2-LE
Fraunhofer FOKUS has published various papers and brochures about CTS2-LE in particular and terminology services in general.

Installation, Deployment, and Setup

This section covers the installation and initial setup of CTS-LE within an organization. The installation is performed via a deployment to a Kubernetes system.

Installation, Deployment, and Setup V3
DEPRECATED
Installation, Deployment, and Setup V3 (2020 versions)
DEPRECATED
Installation, Deployment, and Setup V3 (2021 versions)
DEPRECATED
Installation, Deployment, and Setup V4 (2025)
V4 (version >= 4.0.0) with full HELM and BfArM support.
Supported Terminologies
Overview of the main standard vocabularies/versions.


Core Web Services

CTS2-LE provides a REST interface for integrating terminology services with custom and third-party applications. This section provides the technical specification of the REST Application Programming Interface.


General

The suggester has to be updated whenever a code system is loaded. The suggester is used for searches within the navigation frontend.
Update only has to be invoked for RDF triple loading or if elements of a resource are modified via editing. The search index is automatically updated whenever a code system is loaded.
List all rersources (code systems, value sets, concept maps).

FHIR R4

CTS2-LE supports essential parts of the FHIR REST API for

Not all parameters are supported, but in the context of customization for a project it will be enhanced. The following operations are supported.

The fhir base path is <host>/WebCts2LE/hapi-fhir.

Resource-type-independent

Code Systems

supported parameters: code, system, version, coding, displayLanguage
supported parameters: url, code, version, display, coding, codeableConcept, displayLanguage
supported parameters: codeA, codeB, system, version, codingA, codingB

Value Sets

supported parameters: url, valueSetVersion, includeDesignations
supported parameters: url, valueSetVersion, code, system, systemVersion, display, coding, codeableConcept, displayLanguage

Concept Maps

supported parameters: url, code, system, version, coding, codeableConcept, targetsystem

OWL

For index updating and deletion see General


SPARQL

SPARQL Query
Due to the full RDF-encoding of all terminology artifacts, CTS2-LE allows for arbitrary queries within and across terminologies, value sets, concepts, and concept relationships. This API provides means to transmit a standard SPARQL query to CTS2-LE. The query result is provided in standard SPARQL Query Results XML Format.


Futher Services

Concept Suggestion
retrieve results from suggestion (plain, restricted)
Concept Search
perform search operations (plain, restricted, similar)


Navigator

Grouping
Grouping of terminologies in the navigator


Abgerufen von „https://websites.fraunhofer.de/CTS2-LE/index.php?title=Hauptseite&oldid=1387“