Table des matières[ Show ]
Dernière mise à jour de la documentation : 25/04/2019
Mise en ligne sur le blog : 21/05/2021
Le SCOOP a réalisé un seul export de l’ensemble des lecteurs pour l’ensemble des institutions. Ce fichier sera versé dans chacune des institution Alma.
Méthode d’exportation
L’EPPN (edupersonPrincipalname) a été défini comme identifiant principal des lecteurs dans Alma. Cet identifiant en provenance des LDAP des établissements correspond au login utilisé par les personnels et les étudiants pour se connecter au SI de leur établissement. Ce login est suffixé par le nom de domaine de l’établissement pour donner l’eppn. 1) . Il permet ainsi d’avoir un identifiant unique sur l’ensemble du réseau pour chaque individu versé dans Alma. Cette donnée n’est actuellement pas présente dans Horizon. Il a donc était nécessaire de demander à chaque DSI d’associer au compte lecteur d’horizon un eppn. Ainsi, la préparation du fichier d’import des lecteurs s’est déroulé de la manière suivante :
- Identification de la liste des lecteurs concernés par la migration dans Horizon
- Transmission des fichiers aux DSI de chaque établissement.
- Fourniture des EPPN au SCOOP
- Ajout dans Horizon des eppn
- Export des données lecteurs :
- Export des comptes lecteurs 2)
- Export des adresses liées aux comptes exportés 3)
- Export des codes-barres liés aux comptes exportés 4)
- Export des codes statistiques liés aux comptes exportés5)
- Export des blocages liés aux comptes exportés6)
- Export des numéros de téléphones liés aux comptes exportés7)
Dans certains cas, le scoop n’a pas pu obtenir l’eppn des lecteurs. L’adresse email de ces dernier a été utilisé pour la constitution de l’établissement.
| Etablissement | Population | Donnée utilisée comme identifiant principal |
|---|---|---|
| IEP | Etudiants | eppn |
| IEP | Personnels | |
| INP | Etudiants | |
| INP | Personnels | |
| UB | Etudiants | eppn |
| UB | Personnels | eppn |
| UBM | Etudiants | eppn |
| UBM | Personnels | epnn |
| Bibliothèques pour le PEB | ||
| Lecteurs autorisés |
Périmètre des données exportées
Pour les comptes lecteurs
Seuls les comptes valides au moment de l’exportation8) ) et disposant d’un eppn ont été exportés
Au moment de l’enrichissement de la base horizon avec les eppn fournis par la DSI, le SCOOP a identifié de nombreux doublons de comptes. Afin de ne pas perturbé l’importation de test des données lecteurs, le SCOOP a décidé de ne pas migrer les comptes en doublon. Ces derniers seront dédoublonnées avant la migration finale et fournis lors de l’exportation finale
Pour les blocages et les notes
Seuls les blocages suivants liés aux comptes lecteurs exportés ont été migrés :
| Code du blocage | Libellé du blocage | Migré comme |
|---|---|---|
| msg | Message à l’usager | Note |
| avert | Suivi de contentieux UB : Avertissement | Note |
| bloc | Suivi de contentieux : suspension du prêt | Blocage |
Pour les autres données (adresses, téléphones,codes-barres,…)
Toutes les données liés aux comptes lecteurs exportés.
Liste des champs exportés
Correspondance des champs d’Horizon avec les champs de destination dans Alma
Informations lecteurs
| Fichier d’export | Nom du champ Horizon en base de données | Libellé Horizon | Champ Alma de destination | Table de correspondance ou traitement particulier lors de l’export | Emplacement du champ dans Alma |
|---|---|---|---|---|---|
| 33PUDB_Borrower.csv | borrower# | No Usager | Sert à lier le lecteur aux transactions et autres données lecteurs | ||
| creation_date | Date de création | Créé le | a1 | ||
| last_update_date | Dernière modif. | Dernière mise à jour le | a2 | ||
| name_reconstructed | Nom + Prénom | Le champ d’origine est splité au niveau du premier espace rencontré | a3 | ||
| borr_ldap_dn | EPPN | Identifinat principal | a4 | ||
| btype | * T.Usager | Groupe d’utilistaeurs | User Group map | a5 | |
| location | * Division | Campus | User Campus map | a6 | |
| language | Langue | Langue préférée | a7 | ||
| birth_date | Date naissance | Date de naissance | a8 | ||
| expiration_date | * Fin Abt | Date d’expiration | a9 | ||
| second_id | * No | Identifiant de type Institution ID | e1+e2 | ||
| num_source | Source (identifiant ldap, mangue ou apogée) | Identifiant de type Institution ID | e1+e2 | ||
| 33PUDB_borrower_address.csv | borrower# | No Usager | Sert à lier l’adresse au compte du lecteur | ||
| ord | Ordre d’affichage si plusieurs adresses du même type | ||||
| address_type | Type adresse | Types d’adresses + Adresse préférée | si = ‘temporiare’ alors ‘domicile et adresse préférée. Sinon adresse alternative | b1+b10 | |
| address1 | Ligne 1 | Ligne d’adresse 1 | b2 | ||
| address2 | Ligne 2 | Ligne d’adresse 2 | b3 | ||
| address4 | Ligne 3 | Ligne d’adresse 3 | b4 | ||
| address3 | Ligne 4 | Ligne d’adresse 4 | b5 | ||
| city_st | nd | Ville | b6 | ||
| postal_code | nd | Code postal | b7 | ||
| valid_from_date | Début | Date de début | b8 | ||
| valid_to_date | Fin | Date de fin | b9 | ||
| email_address | Adresse | Adresse électronique | c1 | ||
| email_name | E-Mail:Nom | Description | Rarement rempli dans Horizon | c2 | |
| 33PUDB_borrower_phone.csv | borrower# | No Usager | Sert à lier le téléphone au compte du lecteur | ||
| ord | Ordre d’affichage si plusieurs adresses du même type | ||||
| phone_no | * Tél. | Numéro de téléphone | d2 | ||
| phone_type | * Type | Types de téléphone + Numéro de téléphone préféré | cf._table_de_correspondance. Si Type = portable alors téléphone préféré. | d1+d3 | |
| 33PUDB_borrower_barcode.csv | borrower# | No Usager | Sert à lier le code à barres au compte du lecteur | ||
| ord | Ordre d’affichage si plusieurs codes-barres renseignés | ||||
| bbarcode | Code barres | Identifiant de type Barcode | e1+e2 | ||
| 33PUDB_borrower_bstat.csv | borrower# | No Usager | Sert à lier lebstat au compte du lecteur | ||
| bstat | * Catég. stat. | Note de type Autre | f1+f2 | ||
| 33PUDB_borrower_burb.csv | block.borrower# | No Usager | Sert à lier le blocage au compte du lecteur | ||
| block.reference# | Référence No | Identifiant du blocage | |||
| block.item# | Ex. No | Sert à lier le blocage à l’exemplaire | |||
| block.date | Date du blocage | Date de création du blocage | g3 | ||
| block.block | Type blocage | Type de note ou Description du blocage | f2 + g1 | ||
| block.comment | * Commentaire | Note ou Note du blocage | f1 + g2 | ||
La ville et le code postal n’ont pas été fournis lors de cette livraison de test. Pour la migration finale ils devront être extraits des lignes 2,3 ou 4 de l’adresse.
Table de correspondance Horizon/Alma pour le type de numéro de téléphone
| Code Horizon | Libellé Horizon | Code Alma | Libellé Alma |
|---|---|---|---|
| por | Portable | mobile | Téléphone portable |
| par | Parents | home | Domicile |
| h | Maison | home | Domicile |
| w | Travail | office | Bureau |
Localisation des champs dans Alma
Onglet Information générale (A)
details_usager_a.png
Onglet Informations de contact
Adresses (B)
details_usager_b.png
Adresses email (C)
details_usager_c.png
Numéros de téléphone (D)
details_usager_d.png
Onglet Identifiants (E)
details_usager_e.png
Onglet Notes (F)
details_usager_f.png
Onglet Blocages (G)
details_usager_g.png
Résultats de la migration de test
| Anomalie | Explication | Correctif |
|---|---|---|
| Absence du champs civilité | Nous ne l’avons pas migré pour rester en cohérence avec les données transmises ensuite par les scolarités. | Aucun |
| Les chmaps date d’expiration et date d’éliminations sont identiques | En effet, la date de fin de validité Horizon a été migrée à la fois dans le champ fin de validité et dans le champ date d’élimination. | Ex Libris : ticket ouvert |
| Les dates de statut des usagers ne sont pas en cohérence avec l’année d’inscription Horizon. | C’est normal : c’est une donnée que nous n’avons pas migrée. Le statut correspond généralement à la date de migration ou à la date du dernier traitement qui a modifié le lecteur. | Aucun |
| La note du lecteur n’a pas été reprise | C’est normal, nous ne l’avons pas fournie. Certaines valeurs de ce champ contrevienne en l’état à la législation sur les données personnelles, pour éviter tout risque, nous avons décidé de ne pas migrer ce champ. | Aucun |
| Dans les adresses, le champ pays n’est pas à sa place. | L’ordre des lignes n’a pas été correctement respecté lors de notre export de données. | SCOOP : modifier l’ordre d’export pour les lignes d’adresse des lecteurs – fait |
| Les adresses mails comportent des caractères parasites (_SCRUBED) | C’est une précaution prise par Ex Libris à la migration pour éviter les envois de mail à des usagers réels pendant la phase de test. | Aucun, ce traitement ne sera pas appliqué à la migration finale ; il est spécifique à la migration de test. |
| Le lecteur à un code campus erroné (1000100000 – ex lecteur 356938) | C’est une anomalie de mapping des campus. | SCOOP + Ex-Libris : ticket en cours |
| Les transactions n’ont pas été migrées (UB – lecteur 1502037705) | Les cas signalés de ce type-là correspondent malheureusement aux transactions non-reprises à cause des exemplaires manquant dans le fichier fourni. | Aucun, la fourniture du fichier complet des exemplaires résoudra ce problème. |
| Le lecteur n’a pas été migré (UB- lecteur 3581029) | Nous n’avons pas pu attribuer d’identifiant eppn pour ce lecteur. Pour la migration de test, ces comptes n’ont pas été transmis. | SCOOP + DSI : travail en cours d’identification des eppn – il peut parfois aussi être nécessaire de corriger certains comptes extérieur utilisant d’ancien compte étudiant dans le système. |
| Le contenu de la note de blocage a été doublé (UB – lecteur 383105) | Nous avions fourni une information de configuration erronée, indiquant une reprise en double de l’information. | SCOOP : corriger le fichier de mapping. |
1) ex:fdahenne@u-bordeaux.fr
2) Script perl “/home/scoopadmin/Workspace/Migrations/Migration_Horizon/Lecteurs/Migration_lecteurs.pl”
3) Script perl “/home/scoopadmin/Workspace/Migrations/Migration_Horizon/Lecteurs/Adresses.pl”
4) Script perl “/home/scoopadmin/Workspace/Migrations/Migration_Horizon/Lecteurs/barcode.pl”
5) Script perl “/home/scoopadmin/Workspace/Migrations/Migration_Horizon/Lecteurs/bstat.pl”
6) Script perl “/home/scoopadmin/Workspace/Migrations/Migration_Horizon/Lecteurs/burb.pl”
7) Script perl “/home/scoopadmin/Workspace/Migrations/Migration_Horizon/Lecteurs/Phone_number.pl”
8) Date de fin de validité >= à la date de l’export