Service documentation

Terminology Services 4 NFDI (TS4NFDI) aims to standardize and harmonize collaborative terminology management within the NFDI. TS4NFDI is a cross-domain basic service of the consortia Base4NFDI for the provision, curation, development, harmonization, and mapping of terminologies.


  1. Architecture
  2. Service Portal
  3. Terminology Service Suite (TSS)
  4. Mapping Service
  5. API Gateway

1. Architecture

The TS4NFDI architecture is centered around a flexible, service-based approach that enables seamless integration of external terminology services, offering a centralized and unified access point for all TS4NFDI users via dedicated applications.

The overall architecture is divided into four layers. The uppermost layer comprises the use cases of TS4NFDI. These use cases encompass independent (web)services with interfaces or (research) programs. The second layer from the top contains the TS4NFDI Service Portal, which comprises theTerminology Service Suite, theIncubator Dashboard, the frontend of the TS4NFDI Mapping Service and a Configuration Panel. The penultimate layer is constituted by theAPI Gateway, which comprises service wrappers and the associated service databases. The final layer provides details on the backend of the TS4NFDIMapping Service and multiple terminology services. These terminology services have the potential to be hosted by third parties or alternatively by the project institutions of TS4NFDI.


Service Architecture image

2. Service Portal

To facilitate the integration and customisation of the features of TS4NFDI into the services of the NFDI consortia, TS4NFDI will provide a central TS4NFDI Service Portal. The TS4NFDI Service Portal is designed to facilitate the creation and management of entity sets and terminology collections. This enables domain experts to configure the response of the centralized API Gateway or the Terminology Service Suite (TSS) following their specific requirements. To enable customisation, an administrator user interface will be provided within a configuration panel, utilising the widgets provided by the Terminology Service Suite. This will ensure simple access and enhance usability for administrators. The configuration panel will display a comprehensive list of all available terminologies from the various terminology services accessed by the API Gateway. Furthermore, it is possible to list terminologies that are subject to licence restrictions. Should a user meet the licence conditions, these terminologies can also be utilised via the widgets. Next to this, a Mapping Service will be also accessible via the TS4NFDI Service Portal. To implement these access-restricted areas or licenced terminologies the features of the basic service IAM4NFDI will be used.

3. Terminology Service Suite (TSS)

TS4NFDI will provide modular graphical user interface (GUI) widgets in the Terminology Service Suite (TSS) that facilitate the seamless integration of terminology functionalities into service interfaces. These widgets have been developed to facilitate the creation of service interfaces for terminology services by providing out-of-the-box components for tasks such as term search, ontology browsing and semantic annotation. The Terminology Service Suite (TSS) is thus defined as a collection of interactive, web-based widgets designed to facilitate the integration of terminology service functions into third-party applications. The widgets are built using React and TypeScript and can be used in both React and plain HTML applications. The functionality and arguments are the same for the React and plain HTML versions. By providing ready-to-use UI components, TS4NFDI reduces the complexity of integrating semantic information into NFDI platforms. This includes widgets for browsing ontologies, performing term lookups, and visualizing mappings between concepts. Furthur widget documentations and their storybook is available at:TSS widgets storybook

4. Mapping Service

A crucial component of the TS4NFDI system is the NFDI-wide Mapping Service, which facilitates cross-domain interoperability by enabling the alignment of terminologies from different disciplines. The mappings are based on the Simple Standard for Sharing Ontological Mappings (SSSOM), ensuring that mappings are shared and accessible in a standard format across the NFDI community. The Mapping Service allows users to create, manage, and retrieve mappings between terms from different vocabularies or ontologies. These mappings enable the discovery of semantic equivalences and relationships across disciplines, fostering a more integrated understanding of domain-specific knowledge. The software Cocoda was selected for the NFDI-wide mapping service. Cocoda is published under a MIT license on GitHub and is based on Vue.js.

5. API Gateway

The API Gateway serves as the principal interface between users and the connected (Web) interfaces, as well as the various central or federated terminology services. In this capacity, it functions as a unifying and centralized access point for all requests pertaining to terminology, providing a cohesive API for accessing and managing terminologies across diverse domains. This ensures a standardised and harmonised interface, facilitating streamlined operations. The functionalities offered by the API Gateway are as follows:

  • Standardized API Access: The API Gateway abstracts the complexity of the underlying terminology services, enabling users to access multiple service APIs through a common one without needing to understand the specificities of each service. This includes operations such as searching, suggesting, and retrieving information about terms, terminologies, or mappings.
  • Cross-Domain Support: The API Gateway will provide access to cross-domain terminologies and mappings, allowing users to explore and map concepts across multiple disciplines. This supports more effective inter-disciplinary collaboration and data interoperability within the NFDI community.
  • Routing and Load Balancing: The API Gateway manages the routing of incoming requests to the appropriate services, including load balancing to ensure efficient resource usage and optimal performance for high-traffic requests.
  • This is the link to our API Gateway documentation:https://ts4nfdi.github.io/api-gateway/