From 10ea84debf2f4ae2c8b79b04c54b94a4ec7faa31 Mon Sep 17 00:00:00 2001 From: "Gerlicher, Tim SZ/ZHZ-ZA" Date: Mon, 4 Sep 2023 08:49:39 +0200 Subject: [PATCH] docs(adr-5): adr for edc usage scenarios this adr describes recommendations of EDC usage scenarios within bpdm solution together with value-added-service --- docs/assets/edc_usage_1_1.drawio.svg | 4 + docs/assets/edc_usage_1_2.drawio.svg | 4 + docs/assets/edc_usage_2_1.drawio.svg | 4 + docs/assets/edc_usage_2_2.drawio.svg | 4 + .../005-edc-usage-for-third-party-services.md | 88 +++++++++++++++++++ 5 files changed, 104 insertions(+) create mode 100644 docs/assets/edc_usage_1_1.drawio.svg create mode 100644 docs/assets/edc_usage_1_2.drawio.svg create mode 100644 docs/assets/edc_usage_2_1.drawio.svg create mode 100644 docs/assets/edc_usage_2_2.drawio.svg create mode 100644 docs/decision-records/005-edc-usage-for-third-party-services.md diff --git a/docs/assets/edc_usage_1_1.drawio.svg b/docs/assets/edc_usage_1_1.drawio.svg new file mode 100644 index 000000000..ff46c8294 --- /dev/null +++ b/docs/assets/edc_usage_1_1.drawio.svg @@ -0,0 +1,4 @@ + + + +
Customer / CX Member
Customer / CX Member
Third Party Service Provider
Third Party Service Provider
Operating Environment
Operating Environment
EDC
EDC
<<Data Consumer>>
Web Application Backend-Service
<<Data Consumer>>...
BPDM Gate
BPDM Gate
BPDM Pool
BPDM Pool
EDC
EDC
Customer
Customer
Web Frontend
Web Frontend
Master Data Management System
Master Data Management Sy...
EDC
EDC
Accesses
Accesses
Data Flow
Data Flow
EDC
EDC
Text is not SVG - cannot display
\ No newline at end of file diff --git a/docs/assets/edc_usage_1_2.drawio.svg b/docs/assets/edc_usage_1_2.drawio.svg new file mode 100644 index 000000000..227c16b5a --- /dev/null +++ b/docs/assets/edc_usage_1_2.drawio.svg @@ -0,0 +1,4 @@ + + + +
Customer / CX Member
Customer / CX Member
Operating Environment
Operating Environment
Web Application Backend-Service
Web Application Backend-S...
BPDM Gate
BPDM Gate
BPDM Pool
BPDM Pool
Customer
Customer
Web Frontend
Web Frontend
Master Data Management System
Master Data Management Sy...
EDC
EDC
Accesses
Accesses
Data Flow
Data Flow
EDC
EDC
Text is not SVG - cannot display
\ No newline at end of file diff --git a/docs/assets/edc_usage_2_1.drawio.svg b/docs/assets/edc_usage_2_1.drawio.svg new file mode 100644 index 000000000..21ef91b1a --- /dev/null +++ b/docs/assets/edc_usage_2_1.drawio.svg @@ -0,0 +1,4 @@ + + + +
Customer / CX Member
Customer / CX Member
Third Party Service Provider
Third Party Service Provider
Operating Environment
Operating Environment
EDC
EDC
Web Application Backend-Service
Web Application Backend-S...
Accesses
Accesses
BPDM Gate
BPDM Gate
BPDM Pool
BPDM Pool
EDC
EDC
Customer
Customer
Data Flow
Data Flow
Master Data Management System
Master Data Management Sy...
EDC
EDC
EDC
EDC
Text is not SVG - cannot display
\ No newline at end of file diff --git a/docs/assets/edc_usage_2_2.drawio.svg b/docs/assets/edc_usage_2_2.drawio.svg new file mode 100644 index 000000000..fb9b1c6b5 --- /dev/null +++ b/docs/assets/edc_usage_2_2.drawio.svg @@ -0,0 +1,4 @@ + + + +
Customer / CX Member
Customer / CX Member
Operating Environment
Operating Environment
Web Application Backend-Service
Web Application Backend-S...
Accesses
Accesses
BPDM Gate
BPDM Gate
BPDM Pool
BPDM Pool
EDC
EDC
Customer
Customer
Data Flow
Data Flow
Master Data Management System
Master Data Management Sy...
EDC
EDC
EDC
EDC
Text is not SVG - cannot display
\ No newline at end of file diff --git a/docs/decision-records/005-edc-usage-for-third-party-services.md b/docs/decision-records/005-edc-usage-for-third-party-services.md new file mode 100644 index 000000000..32a6c43fb --- /dev/null +++ b/docs/decision-records/005-edc-usage-for-third-party-services.md @@ -0,0 +1,88 @@ + + + +* status: proposed +* date: 2023-09-04 +* deciders: catena-x bpdm team + + +--- + + +# Recommended usage scenarios of an EDC enabled communication in Business Partner Data Management Solution + +## Context and Problem Statement + +Again and again the discussion arises in which scenarios third party applications (also often called value-added-services (VAS)) must use EDC enabled communication and in which scenarios no EDC is needed. In this document we want to outpoint some scenarios and give guidance for it. + +> :warning: NOTE:

+> In the following diagrams the EDC component might be added multiple times within the same operating environment. This does not mean that multiple instances of EDC are used. It should only make more transparent when data or API calls takes place via EDC. It's on conceptual level, not on logical or physical. It's up to you how many instances of EDC you are operating. + +### TLDR; + +> EDC enabled communication must always be used when business data get exchanged between the systems of different legal entities! + +> For reference implementations you should always assume that the value-added-service will be operated by a different operating environment than the operating environment of the core Business Partner Data Management Solution! That means the reference implementation must support EDC enabled communication between itself and the Business Partner Data Management Solution! + +## Scenario 1.1: External web application/service that only visualizes data based on gate data and/or pool data + +### Description +In this scenario a third party service provider offers a value added services that implements a web dashboard to visualize processed data based on bpdm gate data and/or pool data and presenting it via this dashboard to the customer who owns the bpdm gate data. + +> EDC enabled communication is needed between the Master Data Management System of the Sharing Member and the bpdm gate operated by the Operating Environment. + +> EDC enabled communication is needed between the bpdm gate and the backend service that processes the data. + +> EDC enabled communication is needed between the bpdm pool and the backend service that processes the data. + +> No EDC is needed for presenting the visualization via a web frontend to the customer. + +![External web application that only visualizes data based on gate data](../assets/edc_usage_1_1.drawio.svg) + +## Scenario 1.2: Internal web application that only visualizes data based on gate data and/or pool data + +### Description +In this scenario the operating environment itself operates a web application that implements a web dashboard to visualize processed data based on bpdm gate data and/or pool data and presenting it via this dashboard to the customer who owns the bpdm gate data. + +> EDC enabled communication is needed between the Master Data Management System of the Sharing Member and the bpdm gate operated by the Operating Environment. + +> No EDC enabled communication is needed for the backend service, processing gate and/or pool data, since every component is operated by the same legal entity, the operating environment. + +> No EDC is needed for presenting the visualization via a web frontend to the customer. + + +![Internal web app that only visualizes data based on gate data](../assets/edc_usage_1_2.drawio.svg) + +## Scenario 2.1: External web application/service that provides enriched data based on gate data and/or pool data + +### Description +In this scenario a third party service provider offers a value added services that implements an interface for exchanging data between its own backend system and the system of the customer. This means that business data get exchanged between the systems of two different legal entities. + +> EDC enabled communication is needed between the Master Data Management System of the Sharing Member and the bpdm gate operated by the Operating Environment. + +> EDC enabled communication is needed between the bpdm gate and the backend service that processes the data. + +> EDC enabled communication is needed between the bpdm pool and the backend service that processes the data. + +> EDC enabled communication is needed between the value-added-service backend and the customer system. + +![External web application that only visualizes data based on gate data](../assets/edc_usage_2_1.drawio.svg) + +## Scenario 2.2: Internal web application/service that provides enriched data based on gate data and/or pool data + +### Description +In this scenario the operating environment itself operates a backend service or value added service that processes bpdm gate and/or pool data and implements an interface for exchanging data between its own backend system and the system of the customer. This means that business data get exchanged between the systems of two different legal entities. + +> EDC enabled communication is needed between the Master Data Management System of the Sharing Member and the bpdm gate operated by the Operating Environment. + +> EDC enabled communication is needed between the value-added-service backend and the customer system. + +> No EDC enabled communication is needed between the bpdm gate and the backend service that processes the data. + +> No EDC enabled communication is needed between the bpdm pool and the backend service that processes the data. + + +![Internal web application/service that provides enriched data based on gate data and/or pool data](../assets/edc_usage_2_2.drawio.svg) + + +## More Information