Intégration de fichiers d'abonnés

De WIKI-BOKEH
Aller à : navigation, rechercher

Bokeh peut importer les fichiers d'abonnés fournis par votre SIGB.
Le format d'import peut être configuré à travers un profil de données de type "Abonnés".

Pour accéder à la configuration du profil de donnée, connectez vous à Cosmogramme.

Vous trouverez alors dans le menu de gauche, dans la partie "Configuration" un lien vers la page de configuration des profils de données (sous le lien "Annexes").

Cosmo dataprofile patrons general.png

Généralités[ ]

Format du fichier[ ]

XML[ ]

Ce format accepte tout fichier XML présentant une balise par abonné contenant des balises contenant à leur tour les valeurs à importer.
Exemple de fichier valide :

<?xml version="1.0" encoding="utf-8"?>
<Items>
  <Item>
    <TYPE_ABONNE>I</TYPE_ABONNE>
    <LECTNUM>00003090</LECTNUM>
    <LASTNAME>Pirly</LASTNAME>
    <FIRSTNAME>Coco</FIRSTNAME>
    <FULLNAME>Pirly, Coco</FULLNAME>
    <DATEBIRTH>12/31/1982</DATEBIRTH>
    <MOT_DE_PASSE>zoom</MOT_DE_PASSE>
  </Item>
</Items>

La balise contenant les informations d'un abonné, ainsi que la correspondance des autres balises sont configurable dans l'onglet "Configuration des champs pour le fichier d'abonnés".

CSV avec séparateur[ ]

Le format CSV correspond à un fichier texte contenant une ligne par abonné. A l'intérieur de chaque ligne les informations sont séparées par un séparateur qui peut être:

  • la virgule
  • la tabulation (caractère ascii 9)
  • le point-virgule
  • la barre verticale (caracère ascii 124)

Exemple de fichier valide, séparateur barre verticale :

26219|MXXXXX|Gabriel|2001-03-28|2002-10-26|2017-08-02||26219|IUT
25998|BXXXX|Nicolas|1970-08-27|2013-02-28|2016-10-13||25998|BLV
34663|WXXXX|Mathilde|1980-03-12|2013-02-28|2016-09-17||34663|BLV
31384|LXXXX|Elias|2000-01-30|2013-02-28|2017-08-12||31384|BLV

La correspondance des champs contenus dans la ligne est configurable dans l'onglet "Configuration des champs pour le fichier d'abonnés".

Avenio[ ]

Ce nom de format est conservé pour rétrocompatibilité, il s'agit d'un format CSV avec séparateur tabulation.

Encodage des caractères[ ]

Seuls les encodage UTF-8, Windows et DOS ASCII sont supportés pour les fichiers d'abonnés.

Configuration des champs pour le fichier d'abonnés[ ]

Cosmo dataprofile patrons conf csv.png

Les champs configurables sont :

Champ Utilisation dans Bokeh
id abonné (n° de carte) login de l'abonné et aussi numéro de carte si le champ "Numéro de carte" n'est pas utilisé
n° d'ordre dans la famille permet de distinguer les personnes lorsque le SIGB fournit une carte unique par famille
nom nom de l'abonné
prénom prénom de l'abonné
date de naissance date de naissance
mot de passe mot de passe
adresse e-mail adresse e-mail
date début abonnement date de début d'abonnement
date fin abonnement date de fin d'abonnement, la notion d'abonnement valide s'appuie sur cette date
Identifiant interne dans le SIGB identifiant unique de l'abonné dans le SIGB, utilisé dans la mécanique de dédoublonnage des abonnés
Numéro de carte (si différent id abonné) numéro de carte, à n'utiliser que si le login doit être différent du numéro de carte
Code de la bibliothèque / annexe de rattachement par défaut l'abonné est rattaché à la bibliothèque pour laquelle le fichier est reçu, si le sigb exporte un code d'annexe et que vous configurez des annexes correspondantes à ces codes, Bokeh rattachera l'abonné à la bibliothèque de l'annexe spécifiée. La notion de bibliothèque de rattachement est notamment utilisé dans la gestion des droits
Liste des tarifs souscrits par l'utilisateur disponible uniquement pour Nanook : permet de récupérer l'information sur le type d'abonnement saisi dans nanook pour l'abonné. Nanook envoie un identifiant d'abonnement. Le libellé sera récupéré via l'étalon Tarifs.txt Ce champ est utilisé comme critère de recherche dans la liste des utilisateurs ou dans les groupes dynamiques.
ignorer ce champ permet d'ignorer une colonne du fichier CSV

Spécificités XML[ ]

Cosmo dataprofile patrons conf xml.png

Pour ce format, la configuration ne se fait plus par la position du champ dans une ligne mais par les balises contenant les valeurs de chaque champ.

La signification des champs reste inchangée mais le champ "Balise abonné" est ajouté permettant de spécifier quelle balise XML contient les champs abonnés.


Règles de dédoublonnage[ ]

Lors de la réception d'un fichier, pour chaque abonné Bokeh extrait ses informations et tente de retrouver un abonné déjà existant dans sa base pour la même bibliothèque d'intégration pour le mettre à jour.
S'il n'en trouve pas il crée un nouvel abonné.

Les différentes étapes de recherche d'un abonné existant sont:

  • même login et même ordre dans la famille
  • même login et même identifiant interne dans le SIGB
  • même login et même bibliothèque de rattachement
  • même identifiant interne dans le SIGB

NB : La recherche se limite toujours strictement aux abonnés importés par la même intégration programmée.

On peut constater que si le SIGB exporte l'identifiant interne de ses abonnés le dédoublonnage est garanti même si l'abonné a changé de login entre deux intégrations.

Cette mécanique de dédoublonnage est aussi utilisée lors de la connexion d'un abonné sur le portail lorsque l'abonné est correctement identifié par un webservice.

Bokeh sait alors soit mettre à jour le compte abonné soit en créer un à la volée pour les SIGB qui le permettent.

Correspondance entre identifiant interne reçu dans le fichier et identifiant reçu par webservice:

SIGB Donnée du webservice reconnue comme identifiant interne SIGB
Nanook PatronId
Koha BorrowerNumber
Biblix PatronId
Dynix UserId
Orphee No
PMB id
VSmart OriginalBarcode
Waterbear PatronId