Document toolboxDocument toolbox

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:

  1. R&A levert schema's uit? Ja, deze zullen via de Registratie node uit worden geleverd. (Muv Catalogus)
    1. Toevoegen aan AS dat xml bestanden gevalideerd moeten worden tegen geldig schema voordat bestand verstuurd dan wel ingelezen mag worden.
    2. Voorbeeld xml bestanden in AS laten verwijzen naar schema.
  2. Schema's worden voorzien van MedMij signatuur? Neen, keuze voor signing wordt in aparte RFC (later) gemaakt
    1. Toevoegen aan AS wat te doen bij falen ophalen of vaststellen correct signatuur 
  3. Lijsten worden (ook) voorzien van MedMij signatuur??   Neen, keuze voor signing wordt in aparte RFC (later) gemaakt
    1. Toevoegen aan UCI's ophalen lijsten wat te doen bij falen vaststellen correct signatuur
    2. Voorbeeld xml bestanden voorzien van signatuur.
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)

Signing:  AF-694 - Getting issue details... STATUS AF-824 - Getting issue details... STATUS Locatie: MM-110 - Getting issue details... STATUS   MM-112 - Getting issue details... STATUS

Eigenaar
Implementatietermijn

1.3.0

Motivatie verkorte RFC procedure (patch)

1.3.0

Goedkeuring

BeoordelaarDatumToelichtingBeoordelaarDatumToelichting
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

Dienstverleners concurreren op de functionaliteiten

Neutraal

13 Ontwikkeling geschiedt in een half-open proces met verschillende stakeholders

Neutraal

Dienstverleners zijn aanspreekbaar door de gebruiker

Neutraal

14 Uitwisseling is een keuze

Positief

De persoon wisselt gegevens uit met de zorgaanbieder

Neutraal

15 Het MedMij-netwerk is gebruiksrechten-neutraal

Positief

MedMij spreekt alleen af wat nodig is

Neutraal

16 De burger regisseert zijn gezondheidsinformatie als uitgever

Positief

De persoon en de zorgaanbieder kiezen hun eigen dienstverlener

Neutraal

17 Aan de persoonlijke gezondheidsomgeving zelf worden eisen gesteld

Neutraal

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_OCL OAuthclientInterfaceversie” (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.

DreigingKansImpactDreigingsID (intern)Maatregelen
Fouten in schema's kunnen minder snel opgelost

H

L

Procedure rond opstellen van schema's verbeteren.

Bijlagen

  File Modified
No files shared here yet.