Context Navigation

zorgdomein

Timestamp:: Jan 17, 2017 3:15:41 PM (9 years ago)
Author:: adriaan
Comment:: --

Legend:

: Unmodified
: Added
: Removed
: Modified

Documentatie/Beheerder/Modules/zorgdomein

-                      v7
+                      v8
 == Zorgdomein Koppeling ==
 Er is een gemeenschappelijke server ingericht met de nodige server applicatie die door FENAC wordt gehost en beheerd. Deze server zal met de ZorgDomein-server worden verbonden om berichten te kunnen uitwisselen. De lokale OpenAC instanties halen de verwijzingen vanuit de FENAC-server. Verbinding tussen de FENAC-server en de ZorgDomein zal door een VPN verbinding tot stand komen. De ZorgDomein-server maakt de verwijzingen in HL7-forrmaat. FENAC-server moet die verwijzingen omzetten in een door de OpenAC herkend bericht-formaat. De verbinding tussen de FENAC-server en de lokale servercomponenten OpenAC zal via de door Fenac uitgegeven SSL-certificaten gerealiseerd worden. Hieronder een schema van de koppeling:
+Er is een gemeenschappelijke server ingericht met de nodige server applicatie die door FENAC wordt gehost en beheerd. Deze server zal met de !ZorgDomein-server worden verbonden om berichten te kunnen uitwisselen. De lokale OpenAC instanties halen de verwijzingen vanuit de FENAC-server. Verbinding tussen de FENAC-server en de !ZorgDomein zal door een VPN verbinding tot stand komen. De !ZorgDomein-server maakt de verwijzingen in HL7-formaat. FENAC-server moet die verwijzingen omzetten in een door de OpenAC herkend bericht-formaat. De verbinding tussen de FENAC-server en de lokale servercomponenten OpenAC zal via de door Fenac uitgegeven SSL-certificaten gerealiseerd worden. Hieronder een schema van de koppeling:
 [[Image(zorgdomein_diagram.png)]]
 …
 == FENAC-server ==
 De FENAC-server is een soort tussen station waar de elektronische verwijzingen vanuit de ZorgDomein-server tijdelijk worden opgeslagen, zodat de lokale OpenAC instanties via een AGB-identificatie die gebaseerd is op een certificaat  de verwijzingen die voor hun bestemd zijn kunnen ophalen.
 De FENAC-server luistert naar een van te voren bepaald poort. Het is de bedoeling dat de ZorgDomein-server applicatie de verwijzingsberichten via dat poort aan FENAC-server overdracht. Als er een verwijzingsbericht is aangeboden door de ZorgDomein-server, slaat FENAC-server dat bericht in de postbusmap van de gerelateerde AC.
+De FENAC-server is een soort tussen station waar de elektronische verwijzingen vanuit de !ZorgDomein-server tijdelijk worden opgeslagen, zodat de lokale OpenAC instanties via een AGB-identificatie die gebaseerd is op een certificaat  de verwijzingen die voor hun bestemd zijn kunnen ophalen.
+De FENAC-server luistert naar een van te voren bepaald poort. Het is de bedoeling dat de !ZorgDomein-server applicatie de verwijzingsberichten via dat poort aan FENAC-server overdracht. Als er een verwijzingsbericht is aangeboden door de !ZorgDomein-server, slaat FENAC-server dat bericht in de postbusmap van de gerelateerde AC.
 De FENAC-server zal een API beschikbaar stellen voor de lokale OpenAC instanties om de AC gerelateerde verwijzingen op te halen.
 …
 - Als dat een bestaande patiënt betreft dan wordt gekeken of een open zorgtraject is anders wordt een nieuw zorgtraject aangemaakt.
 - De nieuwe verwijzing met het bijgevoegd document wordt toegevoegd aan het zorgtraject.
 - Er wordt een actie gemaakt met thema ‘ZorgDomein verwijzing’. Die actie wordt gekoppeld aan een default gebruiker zodat de nieuwe verwijzingen in planlijst overzicht ‘Acties van medewerkers’ terecht komt en daarmee zichtbaar wordt.
+- Er wordt een actie gemaakt met thema ‘!ZorgDomein verwijzing’. Die actie wordt gekoppeld aan een default gebruiker zodat de nieuwe verwijzingen in planlijst overzicht ‘Acties van medewerkers’ terecht komt en daarmee zichtbaar wordt.
 == Inrichting lokale servercomponent OpenAC ==
 …
 Om de Zorgdomein koppeling in te richten moet eerst de lokale OpenAC-server geïnstalleerd worden. Zie [wiki:Documentatie/Beheerder/Modules/Agendаserver Installatie Server] voor de installatiehandleiding. De lokale servercomponent van OpenAC die als een Windows service is geïnstalleerd op het systeem van de AC haalt via de beschikbare API van de FENAC-server de verwijzingen binnen.
+De volgende instellingen van de Zorgdomein koppeling moeten via '''appsettings.json''' bestand worden geconfigureerd:
+- AGB-code
+- AGB-locatienaam
+- Locatieletter
+- Zorgdomein actief (veld 'InGebruik')
+- Interval van de controles of er nieuwe verwijzingen zijn
+- Default medewerker waarmee de acties gekoppeld worden
+De volgende instellingen van de locaties van het AC moeten via het `appsettings.json` bestand worden geconfigureerd:
+ - AGB-code (8 cijfers),
+ - AGB-locatienaam,
+ - Locatieletter (de combinatie van letter en AGB-code moet geldig zijn ook in de OpenAC 2 Desktop installatie),
+ - Bestandsmap (aanbevolen wordt om dit per AGB/locatie gescheiden te houden; dat is in het voorbeeld hieronder niet zo).
+Hieronder een voorbeeld van de appsettings.json gedeelte:
+Hieronder een voorbeeld van de AGB/locaties instellingen in `appsettings.json`:
 {{{
   "Agb": {
 …
+      }
+    ]
+  },
+  }
+}}}
+Ook eigenschappen van de !ZorgDomein koppeling moeten via het `appsettings.json` bestand worden geconfigureerd:
+ - Zorgdomein actief (veld '!InGebruik'),
+ - Interval van de controles of er nieuwe verwijzingen zijn,
+ - Default medewerker waarmee de acties gekoppeld worden,
+ - SSL instellingen (certificaat)
+Hieronder een voorbeeld van de !ZorgDomein instellingen in `appsettings.json`:
+{{{
   "Zorgdomein": {
     "InGebruik": true,
 …
+  }
 }}}
+De SSL instellingen zijn binnen de !ZorgDomein instellingen te regelen en gelden alleen voor de verbinding met de FENAC Server ten behoeve van de !ZorgDomein koppeling. De FENAC verstrekt client-certificaten, getekend door de FENAC-!ZorgDomein-Koppeling; deze certificaten zijn alleen te gebruiken voor de communicatie met de FENAC server voor deze koppeling. De procedure voor het verstrekken van de certificaten wordt elders beschreven.
+De instellingen voor SSL zijn:
+ - Of SSL gebruikt wordt (voor test-doeleinden kan SSL worden uitgeschakeld; bij de AC's zal dat nooit het geval zijn),
+ - Bestandsnaam van het certificaat,
+ - Wachtwoord voor het certificaat.
+Omdat het wachtwoord voor het certificaat in "plain text" in het configuratiebestand staat, wordt sterk aangeraden om het goed afgeschermd op de server op te slaan (wat sowieso een goed idee is voor de configuratie van de OpenAC 3 Server). Zowel het certificaat als het wachtwoord hoeven maar op een plek -- bij de OpenAC 3 Server -- opgeslagen te worden; ze zijn niet bedoeld voor gebruik door de werkplek-machines.
+{{{
+  "Zorgdomein": {
+    "SSL": {
+      "Enabled": true,
+      "CertificateFile": "C:\\Users\\Ugur\\certificaten\\ac_utrecht.pfx",
+      "CertificatePassword": "geheim!"
+    }
+  }
+}}}