🔗 Source article (Salesforce): Click here
Le module RRN est intégré en tant que fonctionnalité dans Unified Messaging (version 7.14 ou supérieure) et permet d'effectuer des recherches dans le Registre national, en utilisant le service de base "ConsultRN" de Ehealth.
Ces services sont accessibles aux institutions et aux professionnels de santé (reconnus dans la RD 78) qui y ont été préalablement autorisés par le Comité de sécurité de l'information.
Contexte complet :
(https://www.ehealth.fgov.be/ehealthplatform/fr/service-webservices-consultrn)
Pour utiliser le module RRN dans Unified Messaging, vous devez disposer d'une licence.
Avec Unified Messaging, vous pouvez effectuer une demande de RR de 3 façons :
Via Webservices
par Batch (csv)
via l'interface web Mybox (requête individuelle ad hoc)
1. Configuration et activation
Pour interroger le module RRN, vous devez ajouter la configuration RRN une fois.
Cette opération doit être effectuée par un utilisateur ayant un profil d'administrateur :
Connectez-vous à Unified Messaging (http:// [serverUM] : [port]) avec un profil d'administrateur.
Allez dans Paramètres->RRN-Module->Modifier
Ajoutez une nouvelle configuration et remplissez les champs :
[ IMAGE: image.png ]
Certificat Ehealth: choisissez le certificat Ehealth correct qui effectuera les requêtes.
Chemin de répertoire : choisissez un dossier racine (par exemple, c:\ConsultRN). Les requêtes Batch passeront par ce dossier racine.
Attention : en cas de migration de l'ancien connecteur RRN, choisissez un autre dossier racine que celui existant.
ApplicationId : votre numéro unique attribué par eHealth pour les services ConsultRN.
Langue défaute : choisissez la langue des champs dans les réponses. La langue peut également être spécifiée par ligne dans le input-file. Cette valeur aura alors la priorité sur la langue par défaut.
Cliquez 'Créer configuration'
Redémarrer Unified Messaging
Après le redémarrage, Unified Messaging crée automatiquement les sous-dossiers nécessaires dans le dossier racine du lot sélectionné :
[ IMAGE: image.png ]
Veuillez noter :
il n'est pas permis de modifier (déplacer, supprimer, ajouter) des dossiers ou des fichiers dans cette structure de dossiers.
2. Récupération via les services Web
Nous soutenons les qualités suivantes :
HOSPITAL
LABO
Vous avez besoin d'un Integrator-Account pour l'autorisation de base des endpoints.
On peut l'obtenir via support@healhtconnect.be
Unified Messaging offre les services Web suivants :
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. |
Une documentation détaillée est disponible à l'adresse suivante
http:// [serverUM] :[port]/docs/overview.html#_v4_rn_consult
3. Récupération par Batch
Vous pouvez interroger le module RRN en fournissant des fichiers CSV contenant une ou plusieurs lignes.
Chaque ligne contient le numéro SSIN et éventuellement la langue souhaitée, séparés par des points-virgules.
Si vous spécifiez une langue, cette valeur a la priorité sur la langue par défaut sélectionnée dans la configuration.
Si vous ne spécifiez pas de langue, il ne doit pas y avoir de point-virgule.
Pour chaque SSIN, un abonnement est automatiquement lancé pour 180 jours.
Le traitement a lieu dans le dossier racine défini, comme suit :
\NEW : vous placez ici un input-file (.csv) et un fichier vide .csv.ok du même nom, l'un après l'autre.
\PROCESSING : ce dossier contient le fichier en cours de traitement
\ERROR : ce dossier contient le fichier avec les lignes qui n'ont pas pu être traitées (par exemple, SSIN invalide).
\OUT : ce dossier contient le fichier avec le résultat des lignes qui ont pu être traitées.
En-tête de ce fichier :
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 : ce répertoire contient le fichier avec la combinaison des lignes avec résultat et des lignes qui donnent une erreur, avec la spécification de l'erreur.
En-tête de ce fichier :
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
Important :
le nom du fichier d'entrée doit être unique (par rapport aux fichiers précédents écrits dans la BD)
la seule restriction sur le nom du fichier d'entrée est l'extension : .csv
pendant l'écriture du résultat (Erreur, Erreur, et Erreurs) le fichier a l'extension .tmp
les lignes du fichier d'entrée doivent respecter l'expression régulière suivante :
^(\{11})( ;(FR|NL)):$
en raison de l'interrogation continue par Unified Messaging, vous devez placer le fichier d'entrée (.csv) et le fichier éponyme .ok séquentiellement dans \NEW : le fichier csv doit être complètement écrit avant que vous puissiez placer le fichier .ok.
les lignes commençant par # sont considérées comme des lignes de commentaires, et sont reproduites comme telles dans les fichiers output.
il n'est PAS permis de créer ses propres sous-dossiers et fichiers dans le dossier racine ou ses sous-dossiers.
4. Récupération via l'interface web Mybox :
Chaque utilisateur qui a accès à Mybox, et pour lequel l'option "Peut consulter le registre national" a été cochée, peut effectuer une requête via l'interface Mybox de Unified Messaging.
Il est de la responsabilité des utilisateurs d'activer cette option en fonction des permissions applicables.
Apprenez-en davantage sur la gestion des utilisateurs dans Unified Messaging et sur la façon d'établir un lien avec Active Directory.
L'utilisateur peut alors effectuer une recherche phonétique :
[ IMAGE: image.png ]
Au moins le nom de famille et l'année de naissance sont requis.
ou une recherche sur SSIN :
[ IMAGE: image.png ]
S'assurer que l'utilisateur indique le bon certificat eHealth (en cas de certificats multiples)