Skip to content

Changes

Page history
Update Implementatie scenarios authored by Desy Kakiay's avatar Desy Kakiay
Show whitespace changes
Inline Side-by-side
Implementatie-scenarios.md
View page @ c5069d7b
......@@ -11,7 +11,16 @@ In onderstaande scenarios komen de volgende standaard rollen van de KIK-Starter
# Ik ben een gegevensaanbieder
Klik [hier](https://repository.istandaarden.nl/kik-v/starter/-/wikis/Implementatie-scenarios/Ik-ben-een-gegevensaanbieder) voor de scenarios die voor de gegevensaanbieder van toepassing kunnen zijn.
Als gegevensaanbieder wil ik beginnen met het:
1. laden van linked data (converteren optioneel). [Zie scenario 13](#scenario-13-aanbieder-maakt-linked-data-met-hulp-softwareleverancier-geen-datastation);
2. raadplegen van eigen gegevens. [Zie scenario 11](#scenario-11-aanbieder-raadpleegt-eigen-data-geen-datastation);
3. valideren van eigen gegevens. [Zie scenario 10.](#scenario-10-aanbieder-valideert-eigen-data-geen-datastation)
4. Uploaden eigen query resultaten naar KIK-Starter Centraal (datastation server). [Zie scenario 1.](#scenario-1-aanbieder-zonder-datastation-uploadt-indicatoren)
5. Raadplegen KIK-Starter Centraal als datastation server via KIK-Starter Decentraal (datastation client). [Zie scenario 6](#scenario-6-raadpleeg-kik-starter-centraal-als-datastation) en [zie scenario 7.](#scenario-7-lokale-datastation-nog-niet-verbonden)
6. KIK-Starter Decentraal als datastation server. [Zie scenario 8.](#scenario-8-kik-starter-decentraal-als-netwerk-datastation)
7. Lokale datastation nog niet verbonden met internet. [Zie scenario 7.](#scenario-7-lokale-datastation-nog-niet-verbonden)
8. Converteren eigen data. [Zie scenario 9.](#scenario-9-aanbieder-converteert-eigen-data-met-hulp-softwareleverancier-geen-datastation)
# Ik ben een gegevensafnemer
......@@ -31,24 +40,6 @@ De volgende scenarios kunnen zich in dat geval voordoen:
1. Testen eigen datastation. [Zie scenario 3](#scenario-3-developer-test-datastation) en [zie scenario 5.](#scenario-5-integrator-test-vanaf-internet)
2. Testen eigen datastation client. [Zie scenario 2](#scenario-2-developer-test-datastation-client) en [zie scenario 4.](#scenario-4-integrator-test-met-kik-starter-client)
# Scenario 1: Aanbieder zonder datastation uploadt indicatoren
_Situatie_: een aanbieder heeft (nog) geen (operationeel) datastation, maar wil wel graag indicatoren aanbieden via de KIK-Starter Centraal.
_Happy flow_: Voordat een raadpleging kan plaatsvinden bereid een medewerker van een zorgaanbiederorganisatie als aanbieder gegevens voor in de eigen lokale ICT-omgeving:
1. Eerst extraheert de medewerker gegevens uit een bronsysteem. De gegevens wordt vervolgens naar linked data formaat omgezet.
2. Vervolgens uploadt de medewerker de gegevens naar de KIK-Starter Decentraal.
3. Raadpleegt de gegevens ter controle middels een of meerdere standaard queries.
4. Uploadt de resultaten naar KIK-Starter Centraal.
![image](uploads/40251a1e95bf69ec6388d9d7716d07b4/image.png)
_Uitzonderlijke situaties_:
1. Authenticatie van aanbieder bij KIK-Starter Centraal mislukt: het is dan niet mogelijk gegevens te uploaden naar KIK-Starter Centraal.
2. De query is niet standaard: het is niet mogelijk de gegevens te uploaden.
3. Extractiedata is niet in linked data formaat en KIK-Starter Decentraal kan het niet laden.
# Scenario 2: Developer test datastation client
......@@ -140,103 +131,6 @@ _Uitzonderlijke situaties_:
1. Geen verbinding mogelijk met KIK-Starter Centraal: verkeerd technisch adres, is niet operationeel of beveiligingsmaatregel hindert een verbinding.
2. Geen verbinding mogelijk met KIK-Starter Decentraal als Datastation Client: verkeerd technisch adres, is niet operationeel of (optionele) interne netwerkbeveiliging hindert een verbinding.
# Scenario 7: Lokale datastation nog niet verbonden
_Situatie_: Aanbieder beschikt over een eigen lokale datastation dat niet bereikbaar is vanaf het internet, maar wil wel indicatoren aanbieden via de KIK-Starter Centraal.
_Happy flow_: De Medewerker Aanbieder wil eerst eigen gegevens controleren en na akkoord de query resultaten uploaden naar de KIK-Starter Centraal.
1. Medewerker Aanbieder start Browser applicatie en opent KIK-Starter Decentraal als Datastation Client.
2. Medewerker Aanbieder geeft aan dat de gegevens moet worden gevalideerd.
3. Datastation Client raadpleegt de gegevens bij het datastation als Datastation Server.
4. De Datastation Server geeft query resultaten terug.
5. De KIK-Starter Decentraal valideert de query resultaten op basis van vooraf vastgestelde validatiecriteria.
6. De KIK-Starter Decentraal geeft de validatieresultaten terug.
7. De Medewerker Aanbieder bestudeert de gevalideerde resultaten: die bestaat uit goedgekeurde en mogelijk afgekeurde resultaten.
8. De Medewerker Aanbieder geeft opdracht om de (goedgekeurde) gevalideerde resultaten te uploaden.
9. De Datastation Client maakt succesvol verbinding met de KIK-Starter Centraal als Datastation Server.
10. De Datatstation Client uploadt succesvol de gevalideerde resultaten naar de Datatstation Server.
![image](uploads/80df2b4c84d5abcc0c1f6c754e4a9bc2/image.png)
_Uitzonderlijke situaties_:
1. Geen verbinding mogelijk met KIK-Starter Centraal: verkeerd technisch adres, is niet operationeel of beveiligingsmaatregel hindert een verbinding.
2. Geen verbinding mogelijk met KIK-Starter Decentraal als Datastation Client: verkeerd technisch adres, is niet operationeel of (optionele) interne netwerkbeveiliging hindert een verbinding.
3. Geen verbinding mogelijk met Datastation als Datastation Server: verkeerd technisch adres, is niet operationeel of (optionele) interne netwerkbeveiliging hindert een verbinding.
# Scenario 8: KIK-Starter Decentraal als netwerk datastation
_Situatie_: Medewerker Afnemer (NZA) wil via de datastation client een Datastation Server bij een Aanbieder raadplegen.
_Happy flow_: Medewerker Afnemer wil gegevens raadplegen bij een Aanbieder.
1. Medewerker Afnemer start de Client Applicatie als Datastation Client.
2. Medewerker Afnemer geeft opdracht de KIK-Starter Decentraal als Datastation Server van een Aanbieder te raadplegen.
3. De Datastation Client maakt succesvol verbinding met Datastation Server.
4. De Datastation Client stuurt de standaard query en vraagt om de resultaten terug.
5. De Datastation Server stuurt de query resultaten terug naar de Datastation Client.
![image](uploads/07b69fea31a84cbb5d5c4f439a530d38/image.png)
_Uitzonderlijke situaties_:
1. Geen verbinding mogelijk met de Datastation Server bij de Aanbieder: verkeerd technische adres, is niet operationeel of netwerkbeveiliging staat verbinding niet toe.
2. Datastation Server geeft geen gegevens terug: er is geen gegevens aanwezig.
# Scenario 9: Aanbieder converteert eigen gegevens met hulp softwareleverancier (geen datastation)
_Situatie_: Aanbieder heeft KIK-Starter geinstalleerd en converteert eigen gegevens uit bronsysteem. De Aanbieder krijgt mogelijkerwijs hulp van eigen Software leverancier bij het exporteren van de data, maar is zelf in staat dit te organiseren. De Aanbieder kan de conversie van de gegevens naar linked data formaat zelf uitvoeren. Aanbieder ontvangt een conversie/vertaal-bestand en een lokale ontologie van eigen Softwareleverancier.
_Happy flow_: Medewerker Aanbieder wil eigen gegevens uit bronsysteem converteren naar gegevens die KIK-Starter begrijpt.
1. Medewerker Aanbieder haalt zelfstandig gegevens uit eigen bronsysteem
2. Medewerker Aanbieder selecteert eigen relationele data, het conversie/vertaal-bestand en de lokale ontologie die hij ontvangen heeft van zijn softwareleverancier.
3. Mederwerker Aanbieder geeft opdracht om te converteren
4. Systeem converteert de data
5. Medewerker Aanbieder raadpleegt de gegevens en stelt vast dat het in orde is.
![image](uploads/a1d0606fcb2dc735e60c88138f286a66/image.png)
_Uitzonderlijke situaties_:
1. conversie/vertaal-bestand en/of lokale ontologie komt niet overeen met nationale ontologie model.
# Scenario 10: Aanbieder valideert eigen gegevens (geen datastation)
_Situatie_: Aanbieder heeft eigen gegevens geconverteert en ingeladen en wil het nu valideren.
_Happy flow_: De Medewerker Aanbieder wil eigen gegevens controleren.
1. Medewerker Aanbieder start Browser applicatie en opent KIK-Starter Decentraal.
2. Medewerker Aanbieder kiest dataset
3. Medewerker Aanbieder geeft aan dat de gegevens moet worden gevalideerd.
4. Het Systeem valideert gegevens en geeft resultaten terug
5. Medewerker Aanbieder controleert het aantal controles, fouten en goede scores.
![image](uploads/d85e208b96c0662301ccae7c3648aa61/image.png)
_Uitzonderlijke situaties_:
1. er zijn geen validatiecriteria geprogrammeerd.
# Scenario 11: Aanbieder raadpleegt eigen gegevens (geen datastation)
_Situatie_: Aanbieder heeft nog geen gegevens geüpload en voert een query op eigen data. KIK-Starter Decentraal is zowel datastation client als server.
_Happy flow_: De Medewerker Aanbieder wil eigen gegevens raadplegen.
1. Medewerker Aanbieder start Browser applicatie en opent KIK-Starter Decentraal.
2. Medewerker Aanbieder kiest dataset
3. Medewerker Aanbieder voert eigen query uit of kiest een standaard query.
4. Het Systeem geeft resultaten terug
![image](uploads/1fa873f685d4d146dcdb0d3996e0dc02/image.png)
_Uitzonderlijke situaties_:
1. Er is geen gegevens beschikbaar.
2. Het is niet mogelijk een succesvolle verbinding te maken met KIK-Starter Decentraal.
# Scenario 12: Afnemer raadpleegt query resultaten op KIK-Starter centraal
......@@ -256,22 +150,6 @@ _Uitzonderlijke situaties_:
2. Het is niet mogelijk een succesvolle verbinding te maken met KIK-Starter Centraal.
3. Er is geen gegevens beschikbaar op KIK-Starter Centraal.
# Scenario 13: Aanbieder maakt linked data met hulp softwareleverancier (geen datastation)
_Situatie_: Aanbieder heeft KIK-Starter geinstalleerd en ontvangt hulp van softwareleverancier die de relationele gegevens uit het bronsysteem omzet naar linked data.
_Happy flow_: Medewerker Aanbieder wil eigen linked data uit bronsysteem inladen in KIK-Starter.
1. Medewerker Aanbieder selecteert de eigen linked data bestand en lokale ontologie.
2. Mederwerker Aanbieder geeft opdracht om de linked data te laden (upload)
3. Systeem stelt vast dat alles correct is en laadt de linked data succesvol
![image](uploads/fc3e2036dce63935a216f7d0fb42e94f/image.png)
_Uitzonderlijke situaties_:
1. linked data komt niet overeen met lokale ontologie.
2. Versieverschil tussen lokale en globale ontologie.
# Aanvullende scenarios (in hoofdlijnen)
......