Que permet de faire le connecteur NETSoins ?
Le connecteur NETSoins permet d'importer automatiquement la liste des utilisateurs disposant d'un accès à NETSoins. À chaque synchronisation, les comptes sont récupérés avec leurs informations détaillées, permettant de centraliser et de tenir à jour les identités dans Youzer.
Le connecteur prend en charge un ou plusieurs établissements NETSoins : en mode multi-établissements, les utilisateurs de chaque instance sont agrégés dans Youzer, avec identification de l'établissement d'origine.
Les attributs récupérés incluent :
- Informations d'identification : IdentifiantAdministratif, Login, RPPS, Adeli, IdentifiantNational
- Informations personnelles : Civilite, Genre, Nom, NomJeuneFille, NomReligion, Prenom, DateNaissance
- Coordonnées : Adresse, CodePostal, Ville, IdentifiantDepartement, IdentifiantPays, TelephoneFixe, AutreTelephoneFixe, TelephoneProfessionnel, TelephoneMobile, AutreTelephoneMobile, TelephoneVacances, Mail, MailMSSante, Fax
- Origine et naissance : VilleNaissance, CodePostalNaissance, IdentifiantDepartementNaissance, IdentifiantPaysNaissance
- Organisation : Organisme, CategorieProfessionnelle, PersonnelTypeAutorisations, AccesExterieur
- Suivi de l'accès : DateLimiteAcces, DerniereConnexion
- Multi-établissements : CodeEtablissement (nom de l'établissement NETSoins d'origine)
- Autres : Langue, Commentaire
Le statut d'un compte (Actif) est également récupéré, ce qui permet de gérer automatiquement les activations et suspensions dans Youzer.
Les listes de valeurs (Civilite, Genre, CategorieProfessionnelle, PersonnelTypeAutorisations, et CodeEtablissement en mode multi-établissements) sont alimentées automatiquement depuis NETSoins.
Comment fonctionne le connecteur NETSoins ?
Le connecteur utilise les API REST de NETSoins (/webservice.php/teranga) pour extraire les données utilisateurs et les données de référence (catégories professionnelles, types d'autorisation).
Mode mono-établissement
Pour un seul établissement, les informations suivantes doivent être renseignées dans Youzer, section Authentification :
- Uri : URL d'accès à l'instance NETSoins (ex. https://monetablissement.netsoin.fr)
- Clé API : jeton d'accès sécurisé fourni par NETSoins
- Type (optionnel) : type d'accès API NETSoins (valeur par défaut : isiapp)
Mode multi-établissements
Pour synchroniser plusieurs établissements NETSoins via un seul connecteur Youzer :
1/ Créer une table de correspondance contenant une ligne par établissement, avec les colonnes :
- nom_etablissement : nom lisible de l'établissement
- url : URL de l'instance NETSoins
- cle_api : clé API de l'établissement
- type (optionnel) : type d'accès API (défaut isiapp)
2/ Renseigner le nom de cette table dans les paramètres avancés du connecteur (section configuration au format json suivant :
{“codeTable“:”CODE DE LA TABLE DE CORRESPONDANCE”})
NB: ce Code de la table de correspondance est visible directement dans la table de correspondance, exemple “societeetservice”
À chaque synchronisation, le connecteur parcourt tous les établissements configurés, récupère le personnel de chacun, et associe à chaque utilisateur l'attribut CodeEtablissement correspondant. Les identifiants techniques sont préfixés par l'établissement pour garantir l'unicité entre instances.
Si le champ Organisation est vide, ou si la table est absente ou invalide, le connecteur bascule automatiquement en mode mono-établissement (Uri + Clé API du connecteur).
Synchronisation et provisioning
Une fois configuré, le connecteur peut être synchronisé manuellement ou automatiquement (selon la fréquence définie), et les données des utilisateurs sont récupérées et mises à jour dans Youzer.
La création de comptes vers NETSoins est automatisée.
En mode multi-établissements, l'établissement cible est déterminé via l'attribut CodeEtablissement de l'utilisateur.
Les autres actions (modification, suspension, activation, suppression, changement de mot de passe) déclenchent une notification au gestionnaire pour traitement manuel.