RFC iWlz 24013 Toevoegen functioneel technische IDs Indicatieregister

rvanrest commented 9 months ago

eDocs volgnummer

2024006535

Korte probleem omschrijving

De huidige specificaties van Indicatieregister en Bemiddelingsregister wijken van elkaar af in de implementatie van ID’s.

In het kort:		ERD	GraphQL
Indicatieregister	- logische ID’s	- logische ID’s - technische ID’s
Bemiddelingsregister	- logische ID’s - technische ID’s	- logische ID’s - technische ID’s

Daardoor is de functionaliteit of het gedrag van de twee registers niet gelijk.

Korte omschrijving voorgestelde oplossing

Gelijk trekken ontwerp en implementatie specificaties over iWlz registers door het ontwerp en implementatie specificaties van het Indicatieregister gelijk te maken met de specificaties van het Bemiddelingsregister.

RFC gevolgen voor het onderdeel/de onderdelen

ERD (Register), Koppelvlak specificatie

Welk ander onderdeel?

No response

Betrokken partij RFC

CIZ, Zorgkantoor

Andere betrokken partij

No response

Indiener RFC

Zorginstituut

Andere organisatie / contactpersoon

No response

Rol referentiegroep (BRG)

Informeren

Analyse

Huidige situatie

Er zijn nu twee typen ID’s in gebruik.

Logische ID: 1 of meerdere elementen in een klasse, die samen bepalen wat een record uniek maakt.
Technische ID: specifiek element dat icm de logische ID’s een record uniek kenmerkt

Functionele betekenis krijgt een technische ID in het netwerkmodel wanneer:

De waarde noodzakelijk is voor een raadpleger van het register. Bijvoorbeeld WlzIndicatieID in het Indicatieregister. Dit is de blijvende, unieke identificatie van een specifieke Wlz Indicatie. Het ID leidt altijd tot dezelfde Wlz Indicatie en is nodig voor het opvragen van exact die Wlz Indicatie.
Voor het terugmelden van fouten op recordniveau. Bij de constatering van een fout in een record wordt een foutcode met ID van het record teruggemeld aan de bronhouder

De specificaties van het Bemiddelingsregister (ERD en GraphQL) bevatten voor elke klasse deze functioneel technische ID’s.

De specificaties van het Indicatieregister bevatten die niet voor elke klasse. Alleen de klasse WlzIndicatie heeft een functioneel technische ID. WlzIndicatieID staat zowel in ERD als in GraphQL specificatie. Het gebrek aan overige functioneel technische ID’s heeft een aantal bezwaren.

Bezwaren huidige situatie

Er is geen garantie dat het technische ID in de raadpleging van het bemiddelingsregister een vaste waarde is. Het kan bij een volgende raadpleging een andere waarde en resultaat geven.
Verschil in specificatie en daarmee implementatie in het Netwerkmodel.

Wijzigingsvoorstel

Voorstel aanpassing

Specificaties Indicatieregister aanvullen met ontbrekende functioneel technische IDs.

Voordelen

Specificaties universeel over registers netwerkmodel iWlz
Foutmeldingen kunnen worden teruggegeven op recordniveau
specificatie ERD en koppelvlak in lijn
technische ID in koppelvlak krijgt betekenis

Uitwerking wijzigingsvoorstel

ERD Aanvullen met functioneel technische ID’s	Entiteit	ERD
Adres	toevoegen adresID
Beperking	toevoegen beperkingID
BeperkingScore	toevoegen beperkingScoreID
Client	toevoegen clientID
ContactGegevens	id vervangen door contactgegevensID
ContactPersoon	toevoegen contactPersoonID
Email	toevoegen emailID
GeindiceerdZorgzwaartepakket	toevoegen geindiceerdZorgzwaartepakketID
Grondslag	toevoegen grondslagID
Stoornis	toevoegen stoornisID
StoornisScore	toevoegen stoornisScoreID
Telefoon	toevoegen telefoonID
WlzIndicatie	geen wijzigingen
Wzd	toevoegen wzdID

Regels
geen wijzigingen

Proces
geen wijzigingen

Gegevens
geen wijzigingen

GraphQL

koppelvlakspecificatie van het Indicatieregister aanvullen met functioneel technische ID’s.
ID’s deprecated markeren.

Entiteit	Koppelvlak toevoegen	Koppelvlak deprecated
Adres	adresID: UUID!	id: UUID @deprecated(reason: "vervangen door functioneel technisch ID gebruik adresID")
Beperking	beperkingID: UUID!	id: UUID @deprecated(reason: "vervangen door functioneel technisch ID gebruik beperkingID")
BeperkingScore	beperkingScoreID: UUID!	id: UUID @deprecated(reason: "vervangen door functioneel technisch ID gebruik beperkingScoreID")
Client	clientID: UUID!	id: UUID @deprecated(reason: "vervangen door functioneel technisch ID gebruik clientID")
ContactGegevens	contactGegevensID: UUID!	id: UUID @deprecated(reason: "vervangen door functioneel technisch ID gebruik contactGegevensID")
ContactPersoon	contactPersoonID: UUID!	id: UUID @deprecated(reason: "vervangen door functioneel technisch ID gebruik contactPersoonID")
Email	emailID: UUID!	geen wijzigingen
GeindiceerdZorgzwaartepakket	geindiceerdZorgzwaartepakketID: UUID!	id: UUID @deprecated(reason: "vervangen door functioneel technisch ID gebruik geindiceerdZorgzwaartepakketID")
Grondslag	grondslagID: UUID!	id: UUID @deprecated(reason: "vervangen door functioneel technisch ID gebruik grondslagID")
Stoornis	stoornisID: UUID!	id: UUID @deprecated(reason: "vervangen door functioneel technisch ID gebruik stoornisID")
StoornisScore	stoornisScoreID: UUID!	id: UUID @deprecated(reason: "vervangen door functioneel technisch ID gebruik stoornisScoreID")
Telefoon	telefoonID: UUID!	geen wijzigingen
WlzIndicatie	geen wijzigingen	geen wijzigingen
Wzd	wzdID: UUID!	geen wijzigingen

Autorisatiematrix Alle nieuwe elementen opnemen in de autorisatiematrix met leesrechten (R).

Oplossing

Oplossing	Voordeel / Nadeel	Overweging
1. ..	Voordeel: - specificaties gelijk over netwerk - foutmelding op recordniveau (volgens foutmelding specificatie)
	Nadeel: impact op huidige implementatie
2. Niets doen	Voordeel: geen wijziging nodig
	Nadeel: probleem blijft aanwezig

Conclusie

None

Gekozen oplossing

No response

Publicatiemoment

No response

Implementatiemoment

No response

rvanrest commented 8 months ago

Besproken in Technische Expertgroep d.d. 7 maart 2024. Advies is om de wijziging om wille van de Foutmeldingen en netwerkbrede systematiek door te voeren in Indicatieregister

rvanrest commented 7 months ago

Aangepast ERD met ID's: Nog niet volledig aangepast aan overige wijzigingen uit:

rvanrest commented 7 months ago

Vewerkt in versie 1.5.0: zie https://github.com/iStandaarden/iWlz-indicatie/tree/Indicatieregister-2

iStandaarden / iWlz_RequestForChange