Skip to content
This repository was archived by the owner on Jun 13, 2025. It is now read-only.

Commit 8567d16

Browse files
ssteinbusstom-rm-meyer-ISSTjuliapampus
authored
241 combine editrial and minor changes into a single merge for 42 (#242)
* Added paragraph to explain what's included in a Self-Description (#216) * Added paragraph to explain what's included in a Self-Description: - Self-Description of the component - Self-Description of the offered endpoints - Self-Description of the offered data * incorporated review by sebbader-sap * Forgot one review comment * Update 3_5_4_Metadata_Broker.md Fixing typo and remving HTML tags --------- Co-authored-by: Sebastian Steinbuss <23654606+ssteinbuss@users.noreply.github.com> * chore: update functional view of connector (#217) * chore: update functional view of connector * chore: apply feedback * Update figure 18 (#237) * fixing wrong labels to broker * Fixing missing text in Figure 1.3.1 (#239) * adding missing label to figure 1.3.1 * adding picture source * Update Changelog Summarizing changes * Update README.md Updating version string * Update README.md fixing release history --------- Co-authored-by: tom-rm-meyer-ISST <116013795+tom-rm-meyer-ISST@users.noreply.github.com> Co-authored-by: Julia Pampus <72392527+juliapampus@users.noreply.github.com>
1 parent 49e6c90 commit 8567d16

File tree

9 files changed

+41
-10
lines changed

9 files changed

+41
-10
lines changed

CHANGELOG.md

Lines changed: 25 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,30 @@ All notable changes to this project will be documented in this file.
55
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
66
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
77

8+
## 4.2.0 ##
9+
10+
### Added ###
11+
12+
- Adding a detailled description for Self Descriptions at the IDS Metadata Broker
13+
14+
### Changed ###
15+
16+
- Updating figure 3.5.2.2 according to the text to improve readability and put it in line with the Dataspace Protocol
17+
18+
19+
### Removed ###
20+
21+
- none
22+
23+
### Deprecated ###
24+
25+
- none
26+
27+
### Fixed ###
28+
29+
- Adding missing label in figure 1.3.1
30+
-
31+
832
## 4.1.2 ##
933

1034
### Added ###
@@ -26,7 +50,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
2650

2751
### Fixed ###
2852

29-
- Misspelling of Metadata Broker in the RAM. Is now harmonized.
53+
- Misspelling of Metadata Broker in the RAM. Is now harmonized.
3054

3155
## 4.1.1 ##
3256

README.md

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# IDS RAM 4 #
22

3-
Welcome to the IDS RAM 4 repository of the [IDSA](../../../idsa).
3+
Welcome to the IDS RAM 4 repository of the [IDSA](../../../idsa).
44

55
## Overview ##
66

@@ -11,15 +11,15 @@ Please consider the following information:
1111
- [License](./LICENSE.md),
1212
- [Changelog](./CHANGELOG.md),
1313

14-
and check the open [issues](https://github.com/International-Data-Spaces-Association/IDS-RAM_4_0/issues)
14+
and check the open [issues](https://github.com/International-Data-Spaces-Association/IDS-RAM_4_0/issues)
1515
and [pull requests](https://github.com/International-Data-Spaces-Association/IDS-RAM_4_0/pulls).
1616

17-
The [IDS-G](https://github.com/International-Data-Spaces-Association/IDS-G) provides additional
17+
The [IDS-G](https://github.com/International-Data-Spaces-Association/IDS-G) provides additional
1818
information to the IDS RAM.
1919

2020
## Scope ##
2121

22-
The IDS RAM is complemented with additional documents and repositories. Most relevant in this
22+
The IDS RAM is complemented with additional documents and repositories. Most relevant in this
2323
context is the [IDS-G](https://github.com/International-Data-Spaces-Association/IDS-G).
2424

2525
In general, the IDS RAM contains the conceptual level including technology-agnostic specifications.
@@ -50,7 +50,8 @@ The IDS-G contains specific details on specifications, e.g. APIs and their descr
5050

5151
## Previous Versions ##
5252

53-
- [IDS-RAM 4.1 - current -](https://github.com/International-Data-Spaces-Association/IDS-RAM_4_0/)
53+
- [IDS-RAM 4.2 - current -](https://github.com/International-Data-Spaces-Association/IDS-RAM_4_0/)
54+
- [IDS-RAM 4.1](https://github.com/International-Data-Spaces-Association/IDS-RAM_4_0/releases/tag/v.4.1.2)
5455
- [IDS-RAM 4.0](https://github.com/International-Data-Spaces-Association/IDS-RAM_4_0/releases/tag/v.4.0.0)
5556
- [IDS RAM 3.0](https://internationaldataspaces.org/download/16630/)
5657
- [IDS RAM 2.0](https://internationaldataspaces.org/download/16641/)
-505 Bytes
Loading
Binary file not shown.
64 KB
Loading

documentation/3_Layers_of_the_Reference_Architecture_Model/3_5_System_Layer/3_5_4_Metadata_Broker.md

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,18 @@
11
### Metadata Broker ###
22

3-
The IDS Metadata Broker consists of an IDS Connector (see Section [3.5.2](./3_5_2_IDS_Connector.md#ids-connector)), an endpoint for the registration, publication, maintenance, and query of Self-Descriptions. Therefore, for any interaction with the IDS Metadata Broker, the processes defined on the Process Layer, the descriptions defined on the Information Layer, and descriptions defined on the System Layer can be applied. The Information Layer describes the message types for registration and query. An IDS Metadata Broker may provide additional services that in term must be described by using terms from the IDS Information Model in the respective Metadata Broker's Self-Description document.
3+
The IDS Metadata Broker is an IDS Connector (see Section [3.5.2](./3_5_2_IDS_Connector.md#ids-connector)), which contains an endpoint for the registration, publication, maintenance, and query of Self-Descriptions.
4+
5+
A Self-Description encapsulates information about IDS Connector itself and its capabilities and characteristics. This Self-Description contains information about the offered interfaces, the owner of the component and the metadata of the data offered by the component. A Self-Description is provided by the operator of the Connector. The Self-Description in total can be seen as metadata.
6+
7+
An IDS Connector providing a service or data can send its Self-Description to a IDS Metadata Broker so that every participant is able to find it within the dataspace. The IDS Metadata Broker can be understood as a phone book. Within a dataspace, there can be multiple IDS Metadata Brokers allowing to distribute the IDS Metadata Broker functionality. It is up to the dataspace authority to decide if there is a leading IDS Metadata Broker or if the different instances operate independently.
8+
9+
A participant can interact with an IDS Metadata Broker by using the processes defined on the Process Layer, the descriptions defined on the Information Layer, and descriptions defined on the System Layer. The Information Layer describes the message types for registration and query as well as their content. An IDS Metadata Broker may provide additional services that in term must be described by using terms from the IDS Information Model in the respective Metadata Broker's Self-Description document.
410

511
**Note: Even though the name might indicate a different purpose, an IDS Metadata Broker is *not* a message broker or provides any similar functions to distribute data assets actively by itself.**
612

713
As a direct consequence of the IDS Connector-nature of the Metadata Broker, each instance must be compliant to the Connector Certification criteria and in particular provide the functionalities and endpoints of general Connectors. For instance, a Metadata Broker must provide a Self-Description that provides further information about itself for other IDS components. A Metadata Broker must also have a valid IDS Identity and use a valid DAT in its communication.
814

9-
In addition to these requirements for each IDS Connector, the Metadata Broker provides further functionalities for a data space. Its main purpose is the persistence and storing of Self-Description documents and offering efficient access and search functions on their content. It therefore requires a reliable and scalable internal database. As the Self-Description documents are encoded in RDF, usually JSON-LD, a graph-oriented database like a triple store or a property graph database might be used. Nevertheless also traditional SQL or NoSQL databases may be applied, which may not have the same native query support but still can be sufficient. In any case, the internal architecture of a Metadata Broker must be flexible enough to cope with extensions of the data scheme. The IDS Information Model can always be enriched with further attributes, so a Metadata Broker must also allow the persistence and querying of information which was not yet known at its deployment time. Furthermore, Metadata Brokers operated for certain domains or dedicated data spaces might also enforce the existence of attributes that are not covered by the core IDS Information Model or part of the IDS namespace. That implies that a certain Metadata Broker instances require Self-Descriptions which information content goes beyond the IDS Information Model. In such cases, the additional requirements are outlined in the Metadata Broker Self-Description as well as in the content of the return messages, in case a Connector has not set such attributes yet.
15+
In addition to these requirements for each IDS Connector, the Metadata Broker provides further functionalities for a data space. Its main purpose is the persistence and storing of Self-Description documents and offering efficient access and search functions on their content. It therefore requires a reliable and scalable internal database. As the Self-Description documents are encoded in RDF, usually JSON-LD, a graph-oriented database like a triple store or a property graph database might be used. Nevertheless also traditional SQL or NoSQL databases may be applied, which may not have the same native query support but still can be sufficient. In any case, the internal architecture of a Metadata Broker must be flexible enough to cope with extensions of the data scheme. The IDS Information Model can always be enriched with further attributes, so a Metadata Broker must also allow the persistence and querying of information which was not yet known at its deployment time. Furthermore, Metadata Brokers operated for certain domains or dedicated data spaces might also enforce the existence of attributes that are not covered by the core IDS Information Model or part of the IDS namespace. That implies that a certain Metadata Broker instance requires Self-Descriptions containing information content that uses extensions of the IDS Information Model. In such cases, the additional requirements are outlined in the Metadata Broker Self-Description as well as in the content of the return messages, in case a Connector has not set such attributes yet.
1016

1117
Furthermore, a Metadata Broker implementation might add indexing or caching modules to reduce the query evaluation time. It can be generally expected that the amount of READ requests is significantly higher than the overall number of remote WRITE activities so a READ-optimized architecture can lead to better user experiences. Such design decisions however are in the responsibility of the operator.
1218

documentation/3_Layers_of_the_Reference_Architecture_Model/3_5_System_Layer/media/3.5.2.2_connector_functional_view.drawio

Lines changed: 1 addition & 1 deletion
Large diffs are not rendered by default.
Loading

documentation/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# IDS-RAM 4.1.2 #
1+
# IDS-RAM 4.2.0 #
22

33
## Table of Content ##
44

0 commit comments

Comments
 (0)