RFC0016 Fysieke locatie van lijsten consistent met schema locatie
Samenvatting
Waarom is deze RFC nodig? | De voorbeeld xml bestanden van de lijsten verwijzen naar een schema (xsd) locatie die niet werkt. Door de MedMij schema's op een bereikbare plek te publiceren, worden fouten (en irritatie) bij deelnemers en Acceptatie voorkomen . |
---|---|
Oplossingsrichting | De schema's van Lijsten, Managementinformatie ea worden als XSD uitgeleverd in het Afsprakenstelsel: /wiki/spaces/MedMijAfsprakenstelsel120/pages/135105137. Dit zijn nu Confluence attachments en zijn via hun url niet rechtstreeks te benaderen (maar via de download functionaliteit van Confluence). Dit betekent dat het niet mogelijk is om in xml-bestanden deze schema's volgen, de schema locatie te specificeren (xsi:schemaLocation). Deelnemers (en ook Acceptatie) moeten eigen kopieën van de schema bestanden toepassen die op afwijkende locaties staan; voordat een xml bestand tegen het schema gevalideerd kan worden, moet het xml bestand eerst aangepast door de verwijzing naar de lokale kopie van het schema bestand toe te voegen. Door de schema bestanden voortaan op een eigen vaste 'egte' url te publiceren, wordt deze controle wel mogelijk. Voordeel van deze aanpak is dat het eenvoudiger wordt om xml bestanden te valideren en fouten bij validatie (want altijd correcte versie) en importeren (want gevalideerd) te voorkomen. Nadeel (en voordeel) is dat binnen de Beheerorganisatie het publiceren (en corrigeren..) van schema's via een proces moet gaan verlopen. Keuzen:
|
Aanpassing van | Schema's in AS (worden links naar vaste locatie), voorbeeld XML bestanden in AS. |
Impact op rollen | DVP, DVZA |
Impact op beheer | Aanpassingen in het publicatie proces van schema's |
Impact op RnA | Ja, gaat schema's uitserveren |
Impact op Acceptatie | Minimaal, schema's toepassen vanaf locatie ipv AS. |
Gerelateerd aan (Andere RFCs, PIM issues) | |
Eigenaar | |
Implementatietermijn | 1.3.0 |
Motivatie verkorte RFC procedure (patch) | 1.3.0 |
Goedkeuring
Beoordelaar | Datum | Toelichting | Beoordelaar | Datum | Toelichting |
---|---|---|---|---|---|
Productmanager Stichting MedMij | Productmanager Beheerorganisatie | ||||
Leadarchitect Stichting MedMij | Leadarchitect Beheerorganisatie | ||||
Ontwerpteam | |||||
Deelnemersraad | Eigenaarsraad |
Principe's
Principe | Principe | ||
---|---|---|---|
1 Het MedMij-netwerk is zoveel mogelijk gegevensneutraal | Positief | 11 Stelselfuncties worden vanaf de start ingevuld | Neutraal |
2 Dienstverleners zijn transparant over de gegevensdiensten | Neutraal | 12 Het afsprakenstelsel is een groeimodel | Neutraal |
3 Dienstverleners concurreren op de functionaliteiten | Neutraal | 13 Ontwikkeling geschiedt in een half-open proces met verschillende stakeholders | Neutraal |
4 Dienstverleners zijn aanspreekbaar door de gebruiker | Neutraal | 14 Uitwisseling is een keuze | Positief |
5 De persoon wisselt gegevens uit met de zorgaanbieder | Neutraal | 15 Het MedMij-netwerk is gebruiksrechten-neutraal | Positief |
6 MedMij spreekt alleen af wat nodig is | Neutraal | 16 De burger regisseert zijn gezondheidsinformatie als uitgever | Positief |
7 De persoon en de zorgaanbieder kiezen hun eigen dienstverlener | Neutraal | 17 Aan de persoonlijke gezondheidsomgeving zelf worden eisen gesteld | Neutraal |
9 De dienstverleners zijn deelnemers van het afsprakenstelsel | Positief | 18 Afspraken worden aantoonbaar nageleefd en gehandhaafd | Positief |
10 Alleen de dienstverleners oefenen macht uit over persoonsgegevens bij de uitwisseling | Neutraal | 19 Het afsprakenstelsel snijdt het gebruik van normen en standaarden op eigen maat | Positief |
Uitwerking
Op pagina /wiki/spaces/MedMijAfsprakenstelsel120/pages/135105137 de volgende zaken aanpassen:
- Alle verwijzingen naar schema's in de tabel aanpassen naar de nieuwe locatie op de Registratie node
- Alle xml voorbeeldbestanden aanpassen met verwijzing naar schema
NB: De schema's zullen door diverse andere RFC's geraakt worden!
Op pagina /wiki/spaces/MedMijAfsprakenstelsel120/pages/135105137 toevoegen (onder kopje Schema's, boven tabel):
De schema's worden door MedMij beheer aan deelnemer geleverd via een webservice. De webservice hanteert hierbij de parameter 'api' waar het huidige versienummer van het Afsprakenversie opgevoerd moet worden om de correcte versie van het desbetreffende schema te verkrijgen.
Op pagina /wiki/spaces/MedMijAfsprakenstelsel120/pages/135105608 toevoegen:
5. De beheerorganisatie stelt de XML bestanden ter beschikking aan deelnemers via een gepubliceerde webservice. De webservice hanteert hierbij de parameter 'api' waar het huidige versienummer van het Afsprakenversie opgevoerd moet worden om de correcte versie van de desbetreffende Lijst te verkrijgen.
In het /wiki/spaces/MedMijAfsprakenstelsel130/pages/135629422 aanpassen:
- de invariant die hangt aan de klasse “OAuthclientGegevensdienst” te wijzigen. (*)
In de /wiki/spaces/MedMijAfsprakenstelsel130/pages/135629215 aanpassen:
In tabel 'Verband met metamodel' aanpassen:
Interfaceversie_OCLOAuthclientInterfaceversie” (metamodel)Interfaceversie
Risico's
Omschrijf de (privacy)risico's die kunnen ontstaan als deze RFC wordt aangenomen. In het onwaarschijnlijke geval dat deze RFC's geen risico's introduceert, geef dat dan wel aan.
Dreiging | Kans | Impact | DreigingsID (intern) | Maatregelen |
---|---|---|---|---|
Fouten in schema's kunnen minder snel opgelost | H | L | Procedure rond opstellen van schema's verbeteren. |
Bijlagen