From 692478180faf0bde4592288325eccc57b2dbb52a Mon Sep 17 00:00:00 2001 From: Jan Peter Meyer Date: Wed, 6 Jul 2022 15:31:31 +0200 Subject: [PATCH 1/6] docs: Added all terms out of the spi topic area into the terminology --- docs/overview/terminology.md | 92 +++++++++++++++++++++++------------- 1 file changed, 60 insertions(+), 32 deletions(-) diff --git a/docs/overview/terminology.md b/docs/overview/terminology.md index bed813ca827..73fb0325427 100644 --- a/docs/overview/terminology.md +++ b/docs/overview/terminology.md @@ -1,34 +1,62 @@ # Terminology -| Name | Description | -|:--- |:--- | -| **Artifact** | -| **Asset** | **Assets**

* have one content type

* can be a finite as a (set of) file(s) or non finite as a service, stream
* are the _unit of sharing_

* can point to one or more (physical) asset elements -| **Asset Element** | -| **Asset Index** | **Asset Index**

* manages assets

* provided by an extension

* may support external catalogs

* can be queried -| **Broker** | see **IDS Broker** -| **Connector** | -| **Connector Directory** | -| **Contract** | -| **Contract Agreement** | **Contract Agreement**

* points to a **Contract Offer**

* results from a **Contract Negotiation Process**

* has a start date and may have a expiry date and a cancellation date -| **Contract Negotiation** | * MVP: only possible to accept already offered contracts. Counter offers are rejected automatically. -| **Contract Offer** | **Contract Offer**

* set of obligations and permissions

* generated on the fly on provider side (see **Contract Offer Framework**)

* are immutable

* persisted in **Contract Negotiation Process** once the negotiation has started

-| **Contract Offer Framework** | **Contract Offer Framework**

* generates **Contract Offer Templates**

* provided by **Extensions**

* may be implemented in custom extensions to created contract offers based on existing systems -| **Contract Offer Template** | Blueprint of a **Contract Offer** -| **Consumer** | -| **Data** | -| **Dataspace** | -| **EDC Extension** | -| **Element** | see **Asset Element** -| **Extension** | see **EDC Extension** -| **Framework** | see **Contract Offer Framework** -| **Identity Provider** | -| **IDS Broker** | IDS version of the **Connector Directory** -| **Offer** | see **Contract Offer** -| **Offer Framework** | see **Contract Offer Framework** -| **Policy** | logical collection of rules -| **Provider** | -| **Resource** | -| **Resource Manifest** | -| **Rule** | **Rules**

* bound to a **Contract Offer**, **Contract Agreement** or **Contract Offer Framework**

* exist independent from an **Asset** -| **Transfer Process** | **Transfer Process**

* based on a **Contract Agreement** +| Name | Description | +|:-----------------------------|:--- | +| **Agent** | +| **Artifact** | +| **Asset** | **Assets**

* have one content type

* can be a finite as a (set of) file(s) or non finite as a service, stream
* are the _unit of sharing_

* can point to one or more (physical) asset elements +| **Asset Element** | +| **Asset Index** | **Asset Index**

* manages assets

* provided by an extension

* may support external catalogs

* can be queried +| **Broker** | see **IDS Broker** +| **Catalog** | +| **Configuration** | +| **Connector** | +| **Connector Directory** | +| **Contract** | +| **Contract Agreement** | **Contract Agreement**

* points to a **Contract Offer**

* results from a **Contract Negotiation Process**

* has a start date and may have a expiry date and a cancellation date +| **Contract Negotiation** | * MVP: only possible to accept already offered contracts. Counter offers are rejected automatically. +| **Contract Offer** | **Contract Offer**

* set of obligations and permissions

* generated on the fly on provider side (see **Contract Offer Framework**)

* are immutable

* persisted in **Contract Negotiation Process** once the negotiation has started

+| **Contract Offer Framework** | **Contract Offer Framework**

* generates **Contract Offer Templates**

* provided by **Extensions**

* may be implemented in custom extensions to created contract offers based on existing systems +| **Contract Offer Template** | Blueprint of a **Contract Offer** +| **Consumer** | +| **Data** | +| **DataAddress** | +| **DataFlow** | +| **DataFlowRequest** | +| **Dataspace** | +| **EDC Extension** | +| **Element** | see **Asset Element** +| **EndpointDataReference** | +| **Event** | +| **Event Framework** | +| **Event Router** | +| **Extension** | see **EDC Extension** +| **Framework** | see **Contract Offer Framework** +| **Health** | +| **HTTPDataAddress** | +| **Identity Provider** | +| **IDS Broker** | IDS version of the **Connector Directory** +| **Injection** | +| **Offer** | see **Contract Offer** +| **Offer Framework** | see **Contract Offer Framework** +| **Monitor** | +| **Policy** | logical collection of rules +| **PolicyArchive** | +| **PolicyContext** | +| **PolicyDefinitionStore** | +| **PolicyEngine** | +| **PolicyScope** | +| **Provider** | +| **Provision** | +| **Resource** | +| **Resource Manifest** | +| **Rule** | **Rules**

* bound to a **Contract Offer**, **Contract Agreement** or **Contract Offer Framework**

* exist independent from an **Asset** +| **Transaction** | +| **TransactionContext** | +| **TransactionResource** | +| **Transfer Process** | **Transfer Process**

* based on a **Contract Agreement** +| **Transfer Process Store** | +| **TransformerContext** | +| **TypeManager** | +| **TypeTransformer** | +| **Vault** | \ No newline at end of file From 4f1e3caf8e2f08f18b354aa71505d6523651de45 Mon Sep 17 00:00:00 2001 From: Jan Peter Meyer Date: Wed, 6 Jul 2022 15:50:24 +0200 Subject: [PATCH 2/6] docs: Added all terms out of the discussion area on GitHub into the terminology --- docs/overview/terminology.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/overview/terminology.md b/docs/overview/terminology.md index 73fb0325427..246824aefdd 100644 --- a/docs/overview/terminology.md +++ b/docs/overview/terminology.md @@ -19,6 +19,7 @@ | **Contract Offer Framework** | **Contract Offer Framework**

* generates **Contract Offer Templates**

* provided by **Extensions**

* may be implemented in custom extensions to created contract offers based on existing systems | **Contract Offer Template** | Blueprint of a **Contract Offer** | **Consumer** | +| **Consumer Pull** | | **Data** | | **DataAddress** | | **DataFlow** | @@ -41,6 +42,8 @@ | **Offer Framework** | see **Contract Offer Framework** | **Monitor** | | **Policy** | logical collection of rules +| **Policy Requirements** | +| **Policy Points** | | **PolicyArchive** | | **PolicyContext** | | **PolicyDefinitionStore** | @@ -51,6 +54,7 @@ | **Resource** | | **Resource Manifest** | | **Rule** | **Rules**

* bound to a **Contract Offer**, **Contract Agreement** or **Contract Offer Framework**

* exist independent from an **Asset** +| **State Machine** | | **Transaction** | | **TransactionContext** | | **TransactionResource** | @@ -59,4 +63,5 @@ | **TransformerContext** | | **TypeManager** | | **TypeTransformer** | +| **UsageControl** | | **Vault** | \ No newline at end of file From a7ce2e2e1e61ef4083f1d1fce37cb406028e1d8d Mon Sep 17 00:00:00 2001 From: Jan Peter Meyer Date: Fri, 8 Jul 2022 12:26:47 +0200 Subject: [PATCH 3/6] docs: add information to the entries --- docs/overview/terminology.md | 85 +++++++++++++++--------------------- 1 file changed, 36 insertions(+), 49 deletions(-) diff --git a/docs/overview/terminology.md b/docs/overview/terminology.md index 246824aefdd..9241306f95f 100644 --- a/docs/overview/terminology.md +++ b/docs/overview/terminology.md @@ -2,66 +2,53 @@ | Name | Description | |:-----------------------------|:--- | -| **Agent** | -| **Artifact** | -| **Asset** | **Assets**

* have one content type

* can be a finite as a (set of) file(s) or non finite as a service, stream
* are the _unit of sharing_

* can point to one or more (physical) asset elements -| **Asset Element** | +| **Artifact** | The instance of code which can be modulized used by the EDC +| **Asset** | An **asset** describes **data** that can add value to a **dataspace** and contains the **DataAddress** | **Asset Index** | **Asset Index**

* manages assets

* provided by an extension

* may support external catalogs

* can be queried | **Broker** | see **IDS Broker** -| **Catalog** | -| **Configuration** | -| **Connector** | -| **Connector Directory** | -| **Contract** | +| **Catalog** | **Catalog** is a directory about all meta-information about the assets a **data consumer** can reach in the **dataspace** +| **Configuration** | The EDC allows using a configuration file which will be loaded at every startup of an EDC instance +| **Connector** | Component to realize the communication between two participants within a **dataspace** +| **Contract** | **Contract** is the finalized meta-information for a data transfer after a **contract negotiation** including the policies who have to be followed +| **Contract Managment** | Includes all parts of **Contract Offer**, **Contract Agreement** and **Contract Negotiation** | **Contract Agreement** | **Contract Agreement**

* points to a **Contract Offer**

* results from a **Contract Negotiation Process**

* has a start date and may have a expiry date and a cancellation date | **Contract Negotiation** | * MVP: only possible to accept already offered contracts. Counter offers are rejected automatically. | **Contract Offer** | **Contract Offer**

* set of obligations and permissions

* generated on the fly on provider side (see **Contract Offer Framework**)

* are immutable

* persisted in **Contract Negotiation Process** once the negotiation has started

| **Contract Offer Framework** | **Contract Offer Framework**

* generates **Contract Offer Templates**

* provided by **Extensions**

* may be implemented in custom extensions to created contract offers based on existing systems | **Contract Offer Template** | Blueprint of a **Contract Offer** -| **Consumer** | -| **Consumer Pull** | -| **Data** | -| **DataAddress** | -| **DataFlow** | -| **DataFlowRequest** | -| **Dataspace** | -| **EDC Extension** | -| **Element** | see **Asset Element** -| **EndpointDataReference** | -| **Event** | -| **Event Framework** | -| **Event Router** | +| **Consumer** | see **Data Consumer** +| **Consumer Pull** | The data exchange of data is initilazied by the Consumer +| **Data** | **Data** describes the properties of business objects +| **Data Consumer** | **Data Consumer** are receiver of data in a data transfer. +| **Data Provider** | **Data Providers** produce data and are the source for data in a data transfer +| **DataAddress** | Reference to the physical Address of an **Asset** +| **DataFlow** | Transfer of **data** from **Data Producer** to **Data Consumer**. +| **Dataspace** | A **dataspace** is a space where different participants exchange **data** to get an benifit of this +| **EDC Extension** | A Module piece of the EDC which can be customized used for the EDC +| **EndpointDataReference** | Describes an endpoint at which one receives data +| **Event** | An **Event** is a action which is be observed in the EDC and published by the **Event Framework** +| **Event Framework** | **The Event Framework** is a way to react to actions in the EDC and can also be extended +| **Event Router** | **Event Router** is the central part of the **Event Framework**, which collects all published **Events** | **Extension** | see **EDC Extension** +| **Federated Catalog** | A decentralized **catalog** | **Framework** | see **Contract Offer Framework** -| **Health** | -| **HTTPDataAddress** | -| **Identity Provider** | -| **IDS Broker** | IDS version of the **Connector Directory** -| **Injection** | +| **Health** | Infrastructure Status of the EDC +| **HTTPDataAddress** | Specific type of **DataAddress** in context of HTTP-endpoints +| **Identity Provider** | Management of the correct identification of all participants in the **dataspace**. +| **Injection** | **Artifacts**/**EDC Extensions** can be injected in different parts of the EDC to be used | **Offer** | see **Contract Offer** | **Offer Framework** | see **Contract Offer Framework** -| **Monitor** | +| **Monitor** | The **Monitor** is an interface to realise different ways to put out logs and debug information | **Policy** | logical collection of rules -| **Policy Requirements** | -| **Policy Points** | -| **PolicyArchive** | -| **PolicyContext** | -| **PolicyDefinitionStore** | -| **PolicyEngine** | -| **PolicyScope** | -| **Provider** | -| **Provision** | -| **Resource** | -| **Resource Manifest** | +| **PolicyArchive** | Location to get **Policies** by their ID +| **PolicyDefinitionStore** | Storing all **Policy Definitions** in the EDC +| **PolicyEngine** | Enforcing of Policies in the EDC +| **Provider** | The participant in an dataspace who is producing and publish sth. See **Data Provider** +| **Resource** | Infrastructure Component for data transmission +| **Resource Manifest** | Collection of **Resources** | **Rule** | **Rules**

* bound to a **Contract Offer**, **Contract Agreement** or **Contract Offer Framework**

* exist independent from an **Asset** -| **State Machine** | -| **Transaction** | -| **TransactionContext** | -| **TransactionResource** | | **Transfer Process** | **Transfer Process**

* based on a **Contract Agreement** -| **Transfer Process Store** | -| **TransformerContext** | -| **TypeManager** | -| **TypeTransformer** | -| **UsageControl** | -| **Vault** | \ No newline at end of file +| **Transfer Process Store** | Storing all informations about handled **Transfer Processes** +| **TypeManager** | Way to make serialization possible in different contexts for the EDC +| **UsageControl** | **Usage Control** is the part of the EDC that is responsible for ensuring that the **policies** for the **data** specified in the **contract** are adhered to. +| **Vault** | Providing secrets \ No newline at end of file From 0eabb6ff0d22043577ea05a7ce9b7196a8301294 Mon Sep 17 00:00:00 2001 From: Jan Peter Meyer Date: Tue, 12 Jul 2022 14:26:24 +0200 Subject: [PATCH 4/6] docs: improved writing style and changed text for connector and typemanager --- docs/overview/terminology.md | 68 ++++++++++++++++++------------------ 1 file changed, 34 insertions(+), 34 deletions(-) diff --git a/docs/overview/terminology.md b/docs/overview/terminology.md index 9241306f95f..9a42d74d700 100644 --- a/docs/overview/terminology.md +++ b/docs/overview/terminology.md @@ -3,52 +3,52 @@ | Name | Description | |:-----------------------------|:--- | | **Artifact** | The instance of code which can be modulized used by the EDC -| **Asset** | An **asset** describes **data** that can add value to a **dataspace** and contains the **DataAddress** +| **Asset** | An **asset** describes **data** that can add value to a **dataspace** and contains the **dataAddress** | **Asset Index** | **Asset Index**

* manages assets

* provided by an extension

* may support external catalogs

* can be queried | **Broker** | see **IDS Broker** -| **Catalog** | **Catalog** is a directory about all meta-information about the assets a **data consumer** can reach in the **dataspace** +| **Catalog** | **Catalog** is a directory about all meta-information about the **assets** a **data consumer** can reach in the **dataspace** | **Configuration** | The EDC allows using a configuration file which will be loaded at every startup of an EDC instance -| **Connector** | Component to realize the communication between two participants within a **dataspace** -| **Contract** | **Contract** is the finalized meta-information for a data transfer after a **contract negotiation** including the policies who have to be followed -| **Contract Managment** | Includes all parts of **Contract Offer**, **Contract Agreement** and **Contract Negotiation** +| **Connector** | **Connector** is the central instance for a participant to join a **dataspace**. The **connector** is the gateway from the user to the **dataspace**. +| **Contract** | **Contract** is the finalized meta-information for a data transfer after a **contract negotiation** including the **policies** who have to be followed +| **Contract Managment** | Includes all parts of **contract offer**, **contract agreement** and **contract negotiation** | **Contract Agreement** | **Contract Agreement**

* points to a **Contract Offer**

* results from a **Contract Negotiation Process**

* has a start date and may have a expiry date and a cancellation date | **Contract Negotiation** | * MVP: only possible to accept already offered contracts. Counter offers are rejected automatically. -| **Contract Offer** | **Contract Offer**

* set of obligations and permissions

* generated on the fly on provider side (see **Contract Offer Framework**)

* are immutable

* persisted in **Contract Negotiation Process** once the negotiation has started

-| **Contract Offer Framework** | **Contract Offer Framework**

* generates **Contract Offer Templates**

* provided by **Extensions**

* may be implemented in custom extensions to created contract offers based on existing systems -| **Contract Offer Template** | Blueprint of a **Contract Offer** -| **Consumer** | see **Data Consumer** -| **Consumer Pull** | The data exchange of data is initilazied by the Consumer +| **Contract Offer** | **Contract offer**

* set of obligations and permissions

* generated on the fly on provider side (see **Contract Offer Framework**)

* are immutable

* persisted in **contract negotiation process** once the negotiation has started

+| **Contract Offer Framework** | **Contract offer framework**

* generates **contract offer templates**

* provided by **extensions**

* may be implemented in custom **extensions** to created **contract offers** based on existing systems +| **Contract Offer Template** | Blueprint of a **contract offer** +| **Consumer** | see **data consumer** +| **Consumer Pull** | The data transfer is initilazied by the Consumer | **Data** | **Data** describes the properties of business objects -| **Data Consumer** | **Data Consumer** are receiver of data in a data transfer. -| **Data Provider** | **Data Providers** produce data and are the source for data in a data transfer -| **DataAddress** | Reference to the physical Address of an **Asset** -| **DataFlow** | Transfer of **data** from **Data Producer** to **Data Consumer**. +| **Data Consumer** | **Data consumer** are receiver of data in a data transfer +| **Data Provider** | **Data providers** produce data and are the source for data in a data transfer +| **DataAddress** | Reference to the physical Address of an **asset** +| **DataFlow** | Transfer of **data** from **data producer** to **data consumer**. | **Dataspace** | A **dataspace** is a space where different participants exchange **data** to get an benifit of this -| **EDC Extension** | A Module piece of the EDC which can be customized used for the EDC -| **EndpointDataReference** | Describes an endpoint at which one receives data -| **Event** | An **Event** is a action which is be observed in the EDC and published by the **Event Framework** -| **Event Framework** | **The Event Framework** is a way to react to actions in the EDC and can also be extended -| **Event Router** | **Event Router** is the central part of the **Event Framework**, which collects all published **Events** +| **EDC Extension** | A module piece of the EDC which can be customized used for the EDC +| **EndpointDataReference** | **EndpointDataReference** describes an endpoint at which one receives data +| **Event** | An **event** is a action which is be observed in the EDC and published by the **Event Framework** +| **Event Framework** | **The event framework** is a way to react to actions in the EDC and can also be extended +| **Event Router** | **Event router** is the central part of the **event framework**, which collects all published **events** | **Extension** | see **EDC Extension** | **Federated Catalog** | A decentralized **catalog** -| **Framework** | see **Contract Offer Framework** -| **Health** | Infrastructure Status of the EDC -| **HTTPDataAddress** | Specific type of **DataAddress** in context of HTTP-endpoints +| **Framework** | see **contract offer framework** +| **Health** | Infrastructure status of the EDC +| **HTTPDataAddress** | Specific type of **dataaddress** in context of HTTP-endpoints | **Identity Provider** | Management of the correct identification of all participants in the **dataspace**. | **Injection** | **Artifacts**/**EDC Extensions** can be injected in different parts of the EDC to be used -| **Offer** | see **Contract Offer** -| **Offer Framework** | see **Contract Offer Framework** -| **Monitor** | The **Monitor** is an interface to realise different ways to put out logs and debug information +| **Offer** | see **contract offer** +| **Offer Framework** | see **contract offer framework** +| **Monitor** | The **monitor** is an interface to realise different ways to put out logs and debug information | **Policy** | logical collection of rules -| **PolicyArchive** | Location to get **Policies** by their ID -| **PolicyDefinitionStore** | Storing all **Policy Definitions** in the EDC -| **PolicyEngine** | Enforcing of Policies in the EDC +| **PolicyArchive** | Location to get **policies** by their ID +| **PolicyDefinitionStore** | Storing all **policy definitions** in the EDC +| **PolicyEngine** | Enforcing of **policies** in the EDC | **Provider** | The participant in an dataspace who is producing and publish sth. See **Data Provider** -| **Resource** | Infrastructure Component for data transmission -| **Resource Manifest** | Collection of **Resources** -| **Rule** | **Rules**

* bound to a **Contract Offer**, **Contract Agreement** or **Contract Offer Framework**

* exist independent from an **Asset** -| **Transfer Process** | **Transfer Process**

* based on a **Contract Agreement** -| **Transfer Process Store** | Storing all informations about handled **Transfer Processes** -| **TypeManager** | Way to make serialization possible in different contexts for the EDC +| **Resource** | Infrastructure component for data transmission +| **Resource Manifest** | Collection of **resources** +| **Rule** | **Rules**

* bound to a **contract offer**, **contract agreement** or **contract offer framework**

* exist independent from an **asset** +| **Transfer Process** | **Transfer process**

* based on a **contract agreement** +| **Transfer Process Store** | Storing all informations about handled **transfer processes** +| **TypeManager** | **TypeManager** manages system types and is used to deserialize polymorphic types | **UsageControl** | **Usage Control** is the part of the EDC that is responsible for ensuring that the **policies** for the **data** specified in the **contract** are adhered to. | **Vault** | Providing secrets \ No newline at end of file From cda989b091165e4087d9a83d1887646762aa0179 Mon Sep 17 00:00:00 2001 From: Jan Peter Meyer Date: Tue, 12 Jul 2022 14:47:35 +0200 Subject: [PATCH 5/6] docs: update changelog --- CHANGELOG.md | 1 + 1 file changed, 1 insertion(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index 6d760aa9a85..584c38bd1f6 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -42,6 +42,7 @@ in the detailed section referring to by linking pull requests or issues. * Bump `failsafe` library to version 3.2.4 (#1559) * Harmonize logics of `HttpDataSource` and `HttpDataSink` (#1475) * Log correct type in contract-definition API (#1584) +* Extended and updated terminology.md (##1306) #### Removed From 7c5ceca541c48411d27830476cf576d160904254 Mon Sep 17 00:00:00 2001 From: Jan Peter Meyer Date: Tue, 12 Jul 2022 17:21:16 +0200 Subject: [PATCH 6/6] docs: updated and deleted entries in cause of suggestion in the pull request --- docs/overview/terminology.md | 91 ++++++++++++++++-------------------- 1 file changed, 39 insertions(+), 52 deletions(-) diff --git a/docs/overview/terminology.md b/docs/overview/terminology.md index 9a42d74d700..fbdb8f564dd 100644 --- a/docs/overview/terminology.md +++ b/docs/overview/terminology.md @@ -1,54 +1,41 @@ # Terminology -| Name | Description | -|:-----------------------------|:--- | -| **Artifact** | The instance of code which can be modulized used by the EDC -| **Asset** | An **asset** describes **data** that can add value to a **dataspace** and contains the **dataAddress** -| **Asset Index** | **Asset Index**

* manages assets

* provided by an extension

* may support external catalogs

* can be queried -| **Broker** | see **IDS Broker** -| **Catalog** | **Catalog** is a directory about all meta-information about the **assets** a **data consumer** can reach in the **dataspace** -| **Configuration** | The EDC allows using a configuration file which will be loaded at every startup of an EDC instance -| **Connector** | **Connector** is the central instance for a participant to join a **dataspace**. The **connector** is the gateway from the user to the **dataspace**. -| **Contract** | **Contract** is the finalized meta-information for a data transfer after a **contract negotiation** including the **policies** who have to be followed -| **Contract Managment** | Includes all parts of **contract offer**, **contract agreement** and **contract negotiation** -| **Contract Agreement** | **Contract Agreement**

* points to a **Contract Offer**

* results from a **Contract Negotiation Process**

* has a start date and may have a expiry date and a cancellation date -| **Contract Negotiation** | * MVP: only possible to accept already offered contracts. Counter offers are rejected automatically. -| **Contract Offer** | **Contract offer**

* set of obligations and permissions

* generated on the fly on provider side (see **Contract Offer Framework**)

* are immutable

* persisted in **contract negotiation process** once the negotiation has started

-| **Contract Offer Framework** | **Contract offer framework**

* generates **contract offer templates**

* provided by **extensions**

* may be implemented in custom **extensions** to created **contract offers** based on existing systems -| **Contract Offer Template** | Blueprint of a **contract offer** -| **Consumer** | see **data consumer** -| **Consumer Pull** | The data transfer is initilazied by the Consumer -| **Data** | **Data** describes the properties of business objects -| **Data Consumer** | **Data consumer** are receiver of data in a data transfer -| **Data Provider** | **Data providers** produce data and are the source for data in a data transfer -| **DataAddress** | Reference to the physical Address of an **asset** -| **DataFlow** | Transfer of **data** from **data producer** to **data consumer**. -| **Dataspace** | A **dataspace** is a space where different participants exchange **data** to get an benifit of this -| **EDC Extension** | A module piece of the EDC which can be customized used for the EDC -| **EndpointDataReference** | **EndpointDataReference** describes an endpoint at which one receives data -| **Event** | An **event** is a action which is be observed in the EDC and published by the **Event Framework** -| **Event Framework** | **The event framework** is a way to react to actions in the EDC and can also be extended -| **Event Router** | **Event router** is the central part of the **event framework**, which collects all published **events** -| **Extension** | see **EDC Extension** -| **Federated Catalog** | A decentralized **catalog** -| **Framework** | see **contract offer framework** -| **Health** | Infrastructure status of the EDC -| **HTTPDataAddress** | Specific type of **dataaddress** in context of HTTP-endpoints -| **Identity Provider** | Management of the correct identification of all participants in the **dataspace**. -| **Injection** | **Artifacts**/**EDC Extensions** can be injected in different parts of the EDC to be used -| **Offer** | see **contract offer** -| **Offer Framework** | see **contract offer framework** -| **Monitor** | The **monitor** is an interface to realise different ways to put out logs and debug information -| **Policy** | logical collection of rules -| **PolicyArchive** | Location to get **policies** by their ID -| **PolicyDefinitionStore** | Storing all **policy definitions** in the EDC -| **PolicyEngine** | Enforcing of **policies** in the EDC -| **Provider** | The participant in an dataspace who is producing and publish sth. See **Data Provider** -| **Resource** | Infrastructure component for data transmission -| **Resource Manifest** | Collection of **resources** -| **Rule** | **Rules**

* bound to a **contract offer**, **contract agreement** or **contract offer framework**

* exist independent from an **asset** -| **Transfer Process** | **Transfer process**

* based on a **contract agreement** -| **Transfer Process Store** | Storing all informations about handled **transfer processes** -| **TypeManager** | **TypeManager** manages system types and is used to deserialize polymorphic types -| **UsageControl** | **Usage Control** is the part of the EDC that is responsible for ensuring that the **policies** for the **data** specified in the **contract** are adhered to. -| **Vault** | Providing secrets \ No newline at end of file +| Name | Description | +|:----------------------------|:--- | +| **Artifact** | The instance of code which can be modulized used by the EDC +| **Asset** | An **asset** describes **data** that can add value to a **dataspace** and contains the **dataAddress** +| **Asset Index** | **Asset Index**

* manages assets

* provided by an extension

* may support external catalogs

* can be queried +| **Broker** | see **IDS Broker** +| **Catalog** | The **catalog** is a standalone component of a **dataspace** that stores all meta-information of all **assets** of all **connectors** within a **dataspace** and makes it available to requesting **connectors**. +| **Connector** | **Connector** is the central instance for a participant to join a **dataspace**. The **connector** is the gateway from the user to the **dataspace**. +| **Contract** | **Contract** is the finalized meta-information for a data transfer after a **contract negotiation** including the **policies** who have to be followed +| **Contract Managment** | Includes all parts of **contract offer**, **contract agreement** and **contract negotiation** +| **Contract Agreement** | **Contract Agreement**

* points to a **Contract Offer**

* results from a **Contract Negotiation Process**

* has a start date and may have a expiry date and a cancellation date +| **Contract Negotiation** | * MVP: only possible to accept already offered contracts. Counter offers are rejected automatically. +| **Contract Offer** | **Contract offer**

* set of obligations and permissions

* generated on the fly on provider side (see **Contract Offer Framework**)

* are immutable

* persisted in **contract negotiation process** once the negotiation has started

+| **Consumer** | see **data consumer** +| **Consumer Pull** | Data transfer is initilazied by the Consumer +| **Data** | **Data** is the representation of information (in particular information about business objects) that can be used for further processing in the field of information technology +| **Data Consumer** | **Data consumer** are receiver of data in a data transfer +| **Data Provider** | **Data providers** produce data and are the source for data in a data transfer +| **DataFlow** | Transfer of **data** from **data producer** to **data consumer**. +| **Dataspace** | A **dataspace** is a space where different participants exchange **data** to get an benifit of this +| **EDC Extension** | A module piece of the EDC which can be customized used for the EDC +| **Event** | An **event** is a action which is be observed in the EDC and published by the **Event Framework** +| **Event Framework** | **The event framework** is a way to react to actions in the EDC and can also be extended +| **Event Router** | **Event router** is the central part of the **event framework**, which collects all published **events** +| **Extension** | see **EDC Extension** +| **Federated Catalog** | The **Federated Catalog** is a decentralized approach implemented directly within the **connectors** to make all meta-information of all **assets** within a **dataspace** available to the **connectors** +| **Health** | Infrastructure status of the EDC +| **Identity Provider** | Management of the correct identification of all participants in the **dataspace**. +| **Offer** | see **contract offer** +| **Policy** | logical collection of rules +| **PolicyDefinition** | **PolicyDefinition** links a policy to 1 ..n assets via logical operations +| **PolicyEngine** | Enforcing of **policies** in the EDC +| **Provider** | The participant in an dataspace who is producing and publish sth. See **Data Provider** +| **Resource** | Infrastructure component for data transmission +| **Resource Manifest** | Collection of **resources** +| **Rule** | **Rules**

* bound to a **contract offer**, **contract agreement** or **contract offer framework**

* exist independent from an **asset** +| **Transfer Process** | **Transfer process**

* based on a **contract agreement** +| **UsageControl** | **Usage Control** is the part of the EDC that is responsible for ensuring that the **policies** for the **data** specified in the **contract** are adhered to. +| **Vault** | Providing secrets \ No newline at end of file