Circuit des données lecteurs

Dans Alma nous gérons deux typologies de comtes :

  • des comptes externes pour des individus membres de nos institutions
  • des comptes internes pour des individus extérieurs à nos bibliothèques ou des comptes relatifs aux bibliothèques emprunteuses du PEB.
Compte interne dans Alma
Compte externe dans Alma

A chaque type de compte correspond un circuit et un mode de gestion.

Compte externeCompte interne
« Cat. de poste » concernéePersonnel,Personnel hébergé,Étudiant, ProfessionnelLecteur extérieur, Bibliothèque PEB
Source des donnéesSystème d’information (SI) des établissements (SI RH, Annuaire LDAP et SI scolarité)Saisie dans le système par les bibliothécaires
Instance d’entrée des données Zone réseau (SIS loader)Zone institutionnel
Mode d’authentification du lecteur SAML (Système d’authentification des établissements)Service d’identité d’Exlibris
Le compte peut-il être modifié par les bibliothécairesNon. Les modifications doivent redescendre du SI de l’établissement.Oui.

Circuit des données de comptes externes

Les comptes externes sont chargés chaque nuit dans la zone réseau à partir d’extractions des données fournis par les DSI. Dès que le compte est créé dans la zone réseau il est automatiquement copié dans les institutions.

Circuit des données des lecteurs institutionnels

1. Extraction des données par la DSI

cf. Les imports de lecteurs

2. Serveur SFTP DSI UB

Le serveur est configuré dans la Zone réseau (NZ) sous Configuration>Général>Systèmes externes>Définitions S/FTP. Le nom du serveur est depot.u-bordeaux.fr. Déclarer le répertoire Dépôt comme le répertoire racine du serveur.

Attention ! : Si vous travaillez dans le bac à sable il est nécessaire d’autoriser le serveur dans Configuration>Général>Systèmes externes>Connexions S/FTP autorisées. Il est nécessaire de redéfinir ces autorisations après chaque mise à jour des bacs à sable.

3. Le chargeur des lecteurs : profil d’intégration Student information system ou SIS Loader

Le SIS Loader est configuré dans la NZ Configuration>Général>Systèmes externes>Profils d’intégration>Student information system

Configuration du SIS Loader

Seul la parie SYNCHRONISER est à configurer :

  • Active : Actif (Profil acctivé ou désactivé)
  • Type de notice : Public
  • Correspondance sur : Identifiant principale (clef de recouvrement. Chez nous l’EPPN)
  • Notice sans correspondance : Ajouter (Autoriser ou non le job à créer des comptes)
  • Planification : Tous les jours 5h

A noter ! : Dans la section IMPORTER vous pouvez générer un échantillon (1.) sur la base d’un compte lecteur existant. Ziper le fichier ainsi obtenu avant de le déposer sur le serveur FTP puis exécuter le profil de synchronisation (2.).

Générer un échantillon

https://knowledge.exlibrisgroup.com/Alma/Product_Documentation/Alma_Online_Help_(Francais)/130Intégrations_avec_des_systèmes_externes/050Gestion_des_utilisateurs/010Systèmes_d’Information_Étudiant

4. Envoi des informations lecteurs : configuration du webhook

Le webhook va permettre de déclencher une requête HTTPS vers le serveur web du SCOOP à chaque modification d’un compte lecteur Étudiant ou Personnel. Les données du lecteur accompagnent la requête POST.

Pour en savoir plus sur les webhooks

Le webhook est configuré via le profil d’intégration WEBHOOKS_UTILISATEURS situé dans la Zone réseau. Configuration>Général>Systèmes externes>Profils d’intégration>WEBHOOKS_UTILISATEURS

  • Url de l’interlocuteur : https://scoop.u-bordeaux.fr/lecteurs/
  • Secret : la clef est stocké dans une variable d’environnement Apache sur le serveur (/etc/apache2/envvars)
  • Abonnement : on n’écoute les modifications des seuls comptes utilisateurs. On filtre en plus les lecteurs sur les groupes utilisateurs relatifs aux comptes institutionnels

A noter : A partir de la liste des profils d’intégration. Vous pouvez accéder à la liste des logs en cliquant sur …>Consulter la trace

5. Distribution des comptes dans les institutions

cf. https://github.com/louxfaure/gestions_lecteurs

Circuit des données des comptes internes

Les comptes relatifs aux lecteurs extérieurs et aux bibliothèques emprunteuses du PEB sont créés ou modifiés manuellement par les bibliothécaires dans l’institution où ces derniers travaillent. Grâce au webhook et à un programme maison les créations ou modification sont immédiatement distribuées dans les institutions.

Configuration des webhook

Les webhooks sont définis au niveau au niveau de chaque institution. Ils portent tous le même nom, pointent vers la même url et utilisent la même clef.

Configuration>Général>Systèmes externes>Profils d’intégration>WEBHOOKS_UTILISATEURS

Les comptes lecteurs sont filtrés sur les groupes utilisateurs PEB et Lecteur extérieur.

Programme de distribution des comptes

cf. https://github.com/louxfaure/gestions_lecteurs