Dit
artikel beschrijft de werking van de Madenco NAW-koppeling en hoe een
functioneel applicatiebeheerder de koppeling beheerd in Medimo.
Omschrijving
Een NAW (Naam, Adres, Woonplaats) koppeling is een koppeling tussen
verschillende systemen waarbij persoonsgegevens zoals de naam, adres en
woonplaats van een persoon worden uitgewisseld. Dergelijke koppelingen
worden vaak gebruikt om de juistheid en consistentie van
persoonsgegevens te waarborgen tussen verschillende systemen,
bijvoorbeeld tussen systemen van verschillende organisaties die dezelfde
persoonsgegevens beheren. Hierdoor wordt voorkomen dat verschillende
systemen inconsistenties bevatten en kan er beter worden gewerkt met
accurate en up-to-date persoonsgegevens.
Proces
Dit hoofdstuk legt uit welk proces de koppeling doorloopt en wanneer Medimo een mutatie doorvoert.
Medimo
doorloopt een aantal stappen om te bepalen of er een mutatie moet
worden doorgevoerd. Deze stappen zijn gevisualiseerd in onderstaande
afbeelding.
Hieronder per stap een korte toelichting.
- Ontvangen van nieuwe cliëntgegevens
Madenco stuurt na elke relevante mutatie* de cliëntgegevens inclusief de
historie naar Medimo. Hiervoor wordt een klantspecifieke URL gebruikt.
Hierdoor weet Medimo naar welk koppelvlak er gebruik wordt voor het
verwerken van de cliëntgegevens. Bij ontvangst van de gegevens wordt het volgende gecontroleerd: - Het certificaat - Deze
is uitgewisseld met Madenco. Komt het certificaat niet overeen met wat
er in het koppelvlak is ingericht, dan weigert Medimo de toegang en
genereert de foutmelding 'Acces denied'.
- IP-adres - In het koppelvlak wordt opgegeven vanaf welke IP-adressen Medimo
gegevens accepteert. Komt het IP-adres niet overeen met wat er in het
koppelvlak is ingericht, dan weigert Medimo de toegang en genereert de
foutmelding 'Acces denied'. Meer informatie over het koppelvlak leest u
in het hoofdstuk 'Koppelvlak'.
- Madenco toewijzingen nagaan
Als
Medimo de gegevens accepteert, dan wordt er nagegaan welke toewijzingen
de cliënt heeft in Madenco. Medimo gebruikt de volgende data uit de Madenco toewijzing: - AfdelingId
- LocatieId
- Kamernummer
- Begindatum
- Einddatum
- elvLocation
- Matchen Madenco toewijzingen in koppeltabel
De
volgende stap is de betreffende Madenco toewijzingen nagaan in de
'Koppelvlaktabel webservices'. Medimo gebruikt hiervoor het locationId
en afdelingId uit Madenco. Hierbij kan het volgende gebeuren: - Er is een match - Medimo gaat na hoe de regel is
gekoppeld om te bepalen hoe de cliëntgegevens moeten worden verwerkt.
- Er is geen match - Medimo stopt direct
met het verwerken van de cliëntgegevens en voert geen mutatie uit. Als
er geen match is gaat Medimo er vanuit dat het een nieuw Madenco
'Planeenheid' betreft en voegt deze automatisch toe aan de
'Koppelvlaktabel
webservices'. De nieuwe regel dient u te koppelen voordat Medimo de
cliëntgegevens kan verwerken.
- Verschillen nagaan en muteren
De
laatste stap is de cliëntgegevens uit Medimo vergelijken met de
cliëntgegevens uit Madenco aan de hand van de 'Koppelvlaktabel webvervices'.
Zijn er verschillen, dan worden de cliëntgegevens in Medimo aangepast.
Dit leidt dan bijvoorbeeld tot een opname, ontslag of verhuizing.
Toewijzen apotheek en arts
Het
is mogelijk om vanuit Madenco de apotheek en de arts toe te wijzen
aan de cliënt in Medimo. Dit biedt een uitkomst voor afdelingen waar
cliënten verblijven met verschillende apotheken van inschrijving. In Madenco moet de beheerder een speciale setting (ofwel een
'Variatiepunt') aanzetten om de apotheek mee te sturen tijdens de
'Export Persoonsgegevens'.
Ontslag cliënt
Er zijn 2 situaties die in Medimo leiden tot een ontslag van een cliënt:
- Alle
toewijzingen in Madenco hebben een einddatum - Hierdoor krijgen alle
locatietoewijzingen in Medimo ook een einddatum wat een ontslag is.
- De
toewijzingen in Madenco ZONDER einddatum zijn in Medimo gekoppeld met
het koppeltype 'Negeer deze locatie'. - Medimo negeert deze actieve
toewijzingen en kijkt alleen naar de toewijzingen met een einddatum.
Hierdoor krijgen alle locatietoewijzingen in Medimo ook een einddatum
wat een ontslag is.
Koppelvlaktabel webservices
Medimo
gebruikt de 'Koppelvlaktabel webservices' om te bepalen of er vanuit de
koppeling een wijziging moet worden doorgevoerd. In de 'Koppelvlaktabel
webservices' worden de Madenco toewijzingen gekoppeld aan een
corresponderende Medimo afdeling. Alle
regels in deze tabel moeten zijn gekoppeld ook de regels die Medimo
moet negeren. Het is in Madenco Windows mogelijk om bij teams de
export persoonsgegevens niet aan te zetten. Hierdoor worden er geen
teams en de planeenheden die daaronder vallen meegenomen in de koppeling. U kunt er dus voor kiezen om afdelingen die genegeerd moeten worden niet te exporteren naar Medimo.
De 'Koppelvlaktabel webservices' vindt u via het 'Zoeken
in alles'-veld of vanuit het hoofdmenu via Beheer > Koppelvlak beheer > Koppelvlaktabel webservices. Onderstaande afbeelding is een voorbeeld van een gevulde 'Koppelvlaktabel webservices'.
Inrichting Koppelvlaktabel webservices
Het
inrichten van de 'Koppelvlaktabel webservices' bestaat uit het koppelen
van Madenco toewijzingen aan Medimo afdelingen. Bovenstaande
afbeelding is een voorbeeld van een gevulde
'Koppelvlaktabel webservices'. Medimo voegt automatisch regels toe aan
deze tabel wanneer er 'nieuwe' Id's in de cliëntgegevens staan. Deze
'nieuwe' regels zijn in de 'Koppelvlaktabel webservices' te herkennen
aan de kolom 'Medimo afdeling'. Bij nieuw toegevoegde regels staat daar
de waarde 'Onbekend'.
Volg onderstaande instructies om een regel te koppelen.
- Klik op een regel
Medimo toont de details van de regel, dit ziet eruit zoals onderstaande afbeelding.
Externe
locatie, locatienaam, afdeling en afdelingnaam zijn gegevens die uit Madenco komen. Dit zijn de namen en ID's van de locaties in Madenco.
Bij een mutatie gaat Medimo na op welke Madenco locatie/ID de cliënt
verblijft en in hoeverre deze is gekoppeld in de 'Koppelvlaktabel
webservices'. Medimo gebruikt hiervoor de velden Externe locatie en
Externe afdeling. Medimo raadt aan deze velden NIET aan te passen.
- Selecteer de Medimo afdeling
Klik
in het veld achter Medimo afdeling om te zoeken naar de afdeling. Klik
vervolgens op de afdeling om deze te selecteren. Bovenstaande afbeelding
is een voorbeeld van een regel waarbij een Medimo afdeling is
geselecteerd. Ook regels die Medimo moet negeren dient u te koppelen.
Vaak is hiervoor een afdeling 'Overig' aangemaakt die u daarvoor kunt
gebruiken.
- Selecteer het 'Koppeltype'
Dit bepaald wat Medimo met de gekoppelde regel doet. U heeft keuze uit de volgende opties: - Iedereen - Medimo gebruikt de regel voor het verwerken van cliëntgegevens
- Negeer - Medimo negeert de regel waardoor die niet wordt gebruikt voor het verwerken van cliëntgegevens.
- Klik op de knop 'Opslaan'
Hiermee koppelt u de regel en Medimo toont de 'Koppelvlaktabel webservices.
Niet-gekoppelde regels
Wanneer
de cliënt een Madenco toewijzing heeft die niet is gekoppeld in de
'Koppelvlaktabel webservices', dan kan Medimo niet bepalen hoe de Madenco
toewijzing verwerkt moet worden. Medimo stopt daardoor met het
verwerken van de cliëntgegevens en Medimo logt een
foutmelding die u kunt nagaan in de 'Log patient-koppeling (naw)'. Anders
gezegd voert Medimo bijvoorbeeld geen verhuizing, ontslag of overlijden
door als een toewijzing niet is gekoppeld. Ook regels die Medimo
moet negeren dient u te koppelen. Voor deze regels geldt het volgende:
- Koppel de regel aan een Medimo afdeling - Vaak is hiervoor een fictieve
afdeling 'Overig' aangemaakt die u hiervoor kunt gebruiken.
- Gebruik het koppeltype 'Negeer deze locatie'
Nadat de nieuwe regel is gekoppeld dient Madenco opnieuw de gegevens aan te bieden bij Medimo.
Koppelvlak
Voor
de NAW-koppeling wordt in Medimo een koppelvlak ingericht. In het
koppelvlak worden onder andere de certificaten, IP-adressen en
'Koppelvlak-opties' opgegeven. Medimo gebruikt het koppelvlak om de
toegang te valideren en om te bepalen in welke cluster(s) de mutaties
vanuit Madenco kunnen worden verwerkt.
U kunt geen aanpassingen
doen aan het koppelvlak, maar het koppelvlak is wel inzichtelijk voor u.
Gebruik het 'Zoeken in alles'-veld of klik va uit het hoofdmenu op Beheer > Koppelvlak beheer > Koppelvlak.