🔗 Source article (Salesforce): Click here
De RRN-Module is als functionaliteit geïntegreerd binnen Unified Messaging (versie 7.14 of hoger) en maakt het mogelijk opzoekingen te doen in het Rijksregister, gebruik makend van de basisdienst “ConsultRN” van Ehealth.
Deze diensten zijn toegankelijk voor de instellingen en de beroepsbeoefenaars in de gezondheidzorg ( erkend in het KB 78) die hiertoe op voorhand werden gemachtigd door het Informatieveiligheidscomité.
Volledige context:
(https://www.ehealth.fgov.be/ehealthplatform/nl/service-webservices-consultrr)
Voor gebruik van de RRN-module in Unified Messaging dient u over een licentie te beschikken.
Met Unified Messaging kunt u op 3 manieren een RR-bevraging doen:
via Webservices
via Batch (csv)
via Mybox webinterface (individuele bevraging ad hoc)
1. Configuratie en activatie
Om de RRN-Modulemodule te bevragen moet u éénmalig de RRN-configuratie toevoegen.
Dit moet door een gebruiker met een admin-profiel gebeuren:
Log in met een admin-profiel op Unified Messaging (http://[serverUM]:[port])
Ga naar Instellingen->RRN-Module->Wijzigen
Voeg een nieuwe configuratie toe en vul de velden aan:
[ IMAGE: image.png ]
Hoedanigheid: Kies het correcte Ehealth-certificaat dat de bevragingen zal uitvoeren
Map: kies een rootmap (vb. c:\consultRN). De Batch-bevragingen zullen via deze rootmap verlopen.
Opgelet: bij een migratie van de oude RRN-connector kiest u een andere root-map dan de bestaande.
ApplicationId: uw uniek nummer toegekend door eHealth voor de diensten van ConsultRN
Standaard taal: kies de taal van de velden in de antwoorden. De taal kan ook per lijn in de input-file worden aangegeven. Deze waarde heeft dan voorrang op de standaard-taal.
4. Herstart Unified Messaging
Na herstart maakt Unified Messaging automatisch de nodige submappen aan in de gekozen Batch-rootmap:
[ IMAGE: image.png ]
Opgelet:
het is niet toegestaan om in deze mapstructuur mappen of bestanden te wijzigen (verplaatsen, verwijderen, toevoegen).
2. Opvraging via Webservices
We ondersteunen volgende Qualities:
HOSPITAL
LABO
U hebt een Integrator-Account nodig voor de Basic Authorization van de endpoints.
Deze kunt u bekomen via support@healhtconnect.be
Unified Messaging biedt volgende webservices aan:
Search Phonetically | Rn-Consult provides the ability to search for a citizen by name and birthdate |
Fetch by SSIN | Rn-Consult provides the ability to fetch a citizen provided their SSIN. |
Fetch person history by SSIN | Rn-Consult provides the ability to fetch a citizen’s history provided their SSIN matching the desired criteria. |
Add or remove subscription | Based on a unique identifier SSIN, users will have the opportunity to subscribe to or unsubscribe from the notifications following from changes on a person’s data. |
Get notification | Based on the subscriptions someone has added, that person can fetch all notifications related to all the people someone is subscribed to. |
Ack notification | Send an acknowledgement based on the acknowledgement id accompanied by the notifications that are fetched. |
Get current ssin history | Based on a unique identifier SSIN, users will have the opportunity to obtain the history of the unique identifier related to this person and to identify the current active identifier |
Get related ssins history | Based on a unique identifier SSIN, users will have the opportunity to obtain the history of the unique identifier related to this person and to identify the current active identifier. Includes a list of identifiers related to the given person ssin. |
Gedetailleerde documentatie is beschikbaar op
http://[serverUM]:[port]/docs/overview.html#_v4_rn_consult
3. Opvraging via Batch
U kunt de RRN-Modulemodule bevragen door CSV-bestanden aan te leveren met 1 of meerdere lijnen.
Elke lijn bevat het SSIN-nummer en eventueel de gewenste taal, gescheiden met puntkomma.
Indien u een taal opgeeft, heeft deze waarde voorrang op de gekozen standaard-taal bij de configuratie.
Indien u geen taal opgeeft, mag er geen puntkomma staan.
Voor elk SSIN wordt er automatisch een abonnement opgestart voor 180 dagen.
De verwerking gebeurt in de gedefinieerde rootmap als volgt:
\NEW: hier plaatst u achtereenvolgens een input-bestand (.csv) en een gelijknamig leeg .csv.ok-bestand
\PROCESSING: deze map bevat het bestand tijdens zijn verwerking
\ERROR:deze map bevat het bestand met de lijnen die niet verwerkt konden worden (bvb ongeldig SSIN)
\OUT: deze map bevat het bestand met het resultaat van de lijnen die verwerkt konden worden.
Header van dit bestand:
STATUS_MESSAGE;SSIN;LAST_NAME;FIRST_NAME;BIRTH_DATE;BIRTH_MUNICIPALITY;DECEASE_DATE;STREET;HOUSENUMBER;BOX;POSTAL_CODE;MUNICIPALITY;COUNTRY;ADDRESS_MODIFICATION_DATE;GENDER
\ARCHIVE: deze map bevat het bestand met de combinatie van de lijnen met resultaat en de lijnen die een fout geven, met opgave van de fout:
Header van dit bestand:
STATUS_MESSAGE;SSIN;LAST_NAME;FIRST_NAME;BIRTH_DATE;BIRTH_MUNICIPALITY;DECEASE_DATE;STREET;HOUSENUMBER;BOX;POSTAL_CODE;MUNICIPALITY;COUNTRY;ADDRESS_MODIFICATION_DATE;GENDER;ERROR_CODE;ERROR_MESSAGE
Belangrijk:
de naam van het input-bestand moet uniek zijn (ten opzichte van eerdere bestanden die in de DB weggeschreven zijn)
de enige restrictie op de naamgeving van het input-bestand is de extensie: .csv
tijdens het schrijven van het resultaat (\OUT, \ARCHIVE en \ERROR) draagt het bestand de extensie .tmp
de lijnen van het inputbestand moeten voldoen aan de volgende reguliere expressie:
^(\d{11})(;(FR|NL))?$omwille van de continue polling door Unified Messaging, moet u het input-bestand (.csv) en het gelijknamige .ok-bestand sequentieel plaatsen in \NEW: het csv-bestand moet volledig geschreven zijn alvorens u het .ok-bestand mag plaatsen.
lijnen die beginnen met # worden beschouwd als commentaar-lijnen, en worden als dusdanig gereproduceerd in de output-bestanden
het is NIET toegestaan eigen submappen en bestanden in de rootfolder of zijn submappen aan te maken.
4. Opvraging via Mybox webinterface:
Elke gebruiker die toegang heeft tot Mybox, en voor wie de optie 'Kan het rijksregister consulteren' aangevinkt is, kan opzoeking doen via de Mybox-interface van Unified Messaging.
Het is de verantwoordelijkheid van de gebruikers om deze mogelijkeid te activeren volgens de geldende machtigingen.
Hier vindt u meer info over gebruikersbeheer in Unified Messaging en over koppeling met Active Directory
De gebruiker kan vervolgens een fonetische opzoeking doen:
[ IMAGE: image.png ]
Minimaal familienaam en geboortejaar zijn vereist.
of een opzoeking op SSIN :
[ IMAGE: image.png ]
Let er op dat de gebruiker het juiste eHealth-certificaat aanduidt (in geval van meerdere certificaten)