From 63755beddac7fb43886af9691762e3e93d5fcc7c Mon Sep 17 00:00:00 2001
From: Hauschel Fred <naturzukunft@hauschel.de>
Date: Sun, 20 Dec 2020 20:10:13 +0100
Subject: [PATCH] Integration Scenarios added

---
 specification/tmp/domain_ISA2.md | 44 ++++++++++++++++++++++++--------
 1 file changed, 33 insertions(+), 11 deletions(-)

diff --git a/specification/tmp/domain_ISA2.md b/specification/tmp/domain_ISA2.md
index 831f5e7..3b2bc87 100644
--- a/specification/tmp/domain_ISA2.md
+++ b/specification/tmp/domain_ISA2.md
@@ -1,31 +1,30 @@
 [[_TOC_]]
 
 # Einleitung
-Neben den Interessen der Wirtschaft etabliert sich eine verteilte Gemeinschaft von Menschen, die nicht an ein endloses Wachstum glaubt und versucht durch ein anderes Handeln einen sozialökologischen Wandel der Gesellschaft zu gestalten. Siehe auch [Memorandum of Understanding des Wandelbündnis](https://wandelbuendnis.org/mou/memorandum-of-understanding).
+Neben der Interessen der Wirtschaft etabliert sich eine verteilte Gemeinschaft von Menschen, die nicht an ein endloses Wachstum glaubt und versucht durch ein anderes Handeln einen sozialökologischen Wandel der Gesellschaft zu gestalten. Siehe auch [Memorandum of Understanding des Wandelbündnis](https://wandelbuendnis.org/mou/memorandum-of-understanding).
 
-Um diesen Wandel gut sichtbar zu machen, ist es nötig die Organisationen des sozialökologischen Wandel zu vernetzen. Dazu werden Technologien verwendet wie das [Resource Description Framework](https://de.wikipedia.org/wiki/Resource_Description_Framework) welche den Ansatz der [Linked_Open_Data](https://wikipedia.org/wiki/Linked_Open_Data) (**LOD**) ermöglichen.
-
-Das hier verwendete Vokabular der Datenrepräsentation orientiert sich am [ISA2 core vocabularies](https://ec.europa.eu/isa2/sites/isa/files/corevocabularies-poster.pdf). Es wird jedoch Abweichungen geben müssen. Z.B. gibt es im [ISA2 core vocabularies](https://ec.europa.eu/isa2/sites/isa/files/corevocabularies-poster.pdf) als Agent nur eine Person oder eine rechtliche Organisation. Im sozialökologischen Wandel gibt es Gruppierungen die eher der Definition einer [FOAF:Group](http://xmlns.com/foaf/spec/#term_Group) entsprechen.
+Um diesen Wandel sichtbar zu machen, ist es nötig die Organisationen des sozialökologischen Wandel zu vernetzen. Dazu werden Technologien verwendet wie das [Resource Description Framework](https://de.wikipedia.org/wiki/Resource_Description_Framework) welche den Ansatz der [Linked_Open_Data](https://wikipedia.org/wiki/Linked_Open_Data) (**LOD**) ermöglichen.
 
+Das hier werwendete Vokabular orientiert sich am [ISA2 core vocabularies](https://ec.europa.eu/isa2/sites/isa/files/corevocabularies-poster.pdf). Es wird jedoch Abweichungen geben müssen. Z.B. gibt es im [ISA2 core vocabularies](https://ec.europa.eu/isa2/sites/isa/files/corevocabularies-poster.pdf) als Agent nur eine Person oder eine rechtliche Organisation. Im sozialökologischen Wandel gibt es Gruppierungen die eher der Definitiuon einer [FOAF:Group](http://xmlns.com/foaf/spec/#term_Group) entsprechen.
 
 > Die Klasse "Gruppe" repräsentiert eine Sammlung von einzelnen Agenten (und kann selbst die Rolle eines Agenten spielen, d. h. etwas, das Aktionen ausführen kann).
 > 
-> Dieses Konzept ist absichtlich recht weit gefasst und umfasst informelle und ad-hoc-Gruppen, langlebige Gemeinschaften, organisatorische Gruppen innerhalb eines Arbeitsplatzes usw. Einige solcher Gruppen können zugehörige Eigenschaften haben, die in RDF erfasst werden können (vielleicht eine Homepage, ein Name, eine Mailingliste usw.). 
+> Dieses Konzept ist absichtlich recht weit gefasst und umfasst informelle und Ad-hoc-Gruppen, langlebige Gemeinschaften, organisatorische Gruppen innerhalb eines Arbeitsplatzes usw. Einige solcher Gruppen können zugehörige Eigenschaften haben, die in RDF erfasst werden können (vielleicht eine Homepage, ein Name, eine Mailingliste usw.). 
 > 
 
 Bekannte Datenquellen des LOD sind [DBpedia](https://de.wikipedia.org/wiki/DBpedia) und [Wikidata](https://de.wikipedia.org/wiki/Wikidata). Es werden jedoch immer mehr, z.B. im öffentlichen Bereich [GOVDATA](https://www.govdata.de).
 
 Es soll kein weiterer zentraler Datenspeicher entstehen, sondern ein Standard der beschreibt wie Daten von Agenten (Personen, Gruppen und Organisationen) des sozialökologischen Wandel präsentiert, gespeichert und ausgetauscht werden können.
 
-Ein weiteres Hauptaugenmerk sind sogenannte Duplikate. Dabei handelt es sich um Agenten, die durch die Verteilung von Daten an mehreren Stellen gespeichert wurden und ggf. voneinander abweichen. Diese Daten technisch abzugleichen ist ein eher komplexes Thema, deshalb begnügen wir uns damit diese Duplikate zu markieren, so das man ihnen 'folgen' und nach ihnen suchen kann. Ein 'Datenbesitzer' hat dann die Möglichkeit, diese Duplikate automatisch oder manuell aufzulösen.
+Ein weiteres Hauptaugenmerk sind sogenannte Duplikate. Dabei handelt es sich um Agenten, die durch die Verteilung von Daten an mehreren Stellen gespeichert wurden und ggf. voneinander abweichen. Diese Daten technisch abzugleichen ist ein eher komplexes Thema, deshalb begnügen wir uns damit diese Duplikate zu markieren, so das man ihnen 'folgen' kann und nach ihnen suchen kann. Ein 'Datenbesitzer' hat dann die Möglichkeit diese Duplikate automatisch oder manuel aufzulösen.
 
 Da sich der sozialökologische Wandel nicht auf den deutschsprachichen Raum begrenzt, wird die Spezifikation in Englisch verfasst. 
 Zur Ãœbersetzung von Texten wird [DeepL](https://www.deepl.com) empfohlen.
 
 # Introduction
-A distributed community of people who do not believe in endless economic growth is organising socio-ecological change in society by acting differently.  See also [Memorandum of Understanding of Wandelbündnis](https://wandelbuendnis.org/mou/memorandum-of-understanding).
+A distributed community of people who do not believe in endless growth try to bring about socio-ecological change in society by acting differently.  See also [Memorandum of Understanding of Wandelbündnis](https://wandelbuendnis.org/mou/memorandum-of-understanding).
 
-In order to make this change visible, it is necessary to link organisations of socio-ecological change. For this purpose, technologies such as the [Resource Description Framework](https://de.wikipedia.org/wiki/Resource_Description_Framework) are used which enable the [Linked_Open_Data](https://wikipedia.org/wiki/Linked_Open_Data) (**LOD**) approach.
+In order to make this change visible, it is necessary to link the organisations of socio-ecological change. For this purpose, technologies such as the [Resource Description Framework](https://de.wikipedia.org/wiki/Resource_Description_Framework) are used which enable the [Linked_Open_Data](https://wikipedia.org/wiki/Linked_Open_Data) (**LOD**) approach.
 
 The vocabulary used here is based on the [ISA2 core vocabularies](https://ec.europa.eu/isa2/sites/isa/files/corevocabularies-poster.pdf). However, there will have to be changes. For example, in [ISA2 core vocabularies](https://ec.europa.eu/isa2/sites/isa/files/corevocabularies-poster.pdf), an agent is only a person or a legal organisation. In socio-ecological change, there are groupings that correspond more to the definition of a [FOAF:Group](http://xmlns.com/foaf/spec/#term_Group).
 
@@ -47,7 +46,8 @@ Another main focus is on so-called duplicates. These are agents that have been s
 
 ## Expert version
 - [Knowledge Graphs Prof. Dr. Harald Sack, Dr. Mehwish Alam](https://open.hpi.de/courses/knowledgegraphs2020)
-
+- [Eclipse RDF4J - Working with RDF in Java](https://www.youtube.com/watch?v=OOgXDUf8Cps&t=6s)
+- [About RDF4J](https://rdf4j.org/about) we will use [RDF4J Server and Workbench](https://rdf4j.org/documentation/tools/server-workbench/) as Triple Store and SPARQL Endpoint.
 
 # Class Diagram
 The colours represent different vocabularies.  
@@ -225,6 +225,28 @@ Bei KVM steckt semantik hinter manchen tags, diese sollte man auflösen!
 ### License
 https://schema.org/license
 
-## misc
-Note Fredy: Kann sameAS auch auf eine html repräsentatuion verwendet werden? wie gehen wir mit https://de.wikipedia.org/wiki/Content_Negotiation um wenn html und turtle an versch. orten liegen? geht das ?
+# Integrating Karte von morgen
+## OpenFairDB adapting
+![Adapter 1](domain_diagrams/adapter1.png "Adapter 1")
+
+- OpenFairDb has to provide an endpoint for each Resource responding with text/turtle.
+- OpenFairDb has to implement a single load of all data to the RDF4J Server (using REST API)
+- OpenFairDb has to take care, that the data iin the RDF4J Server is upToDate (using REST API)
+- To be clarified: Are there some restrictions for Using SPARQL with that Adapter?
+- Sure, it's not possible to use manipulating SPARQL queries. Attention: Can we be sure, that nobody is using it?
+
+## Exteral adapter
+![Adapter 2](domain_diagrams/Adapter2.png "Adapter 2")
+
+- external service has to provide an endpoint for each Resource responding with text/turtle.
+- external service has to implement a single load of all data to the RDF4J Server (using REST API)
+- external service has to take care, that the data iin the RDF4J Server is upToDate (using REST API)
+- external service has to communicate with openFairDB to keep syncronized (listening/polling)
+- To be clarified: Are there some restrictions for Using SPARQL with that Adapter?
+- Sure, it's not possible to use manipulating SPARQL queries. Attention: Can we be sure, that nobody is using it?
+
+## Database replacement
+![Database replacement](domain_diagrams/newKvmBackend.png "Database replacement")
 
+- OpenFairDb has to replace it's database with a RDF4J Server (or another SPARQL supporting triple store) 
+- Self hosted or RDF4J as a service
-- 
GitLab