Introduction

Ce plugin vous permet d’importer des adhérents depuis un fichier CSV ou un serveur LDAP. Vous pouvez définir de multiples correspondances sur la manière de traiter les informations entrantes pour importer les données.

La création d’add-ons est possible afin d’étendre les capacités du plugin durant le processus d’import.

Avant de commencer

Avant de configurer le plugin, vous trouverez ici les éléments de bases (et importants) que vous aurez besoin de préparer.

Depuis quelle source ?

CSV ou LDAP

Idéalement les colonnes du csv doivent être encodées en utf8. La première ligne devraient contenir les en-têtes.

Pour un import LDAP, vous aurez besoin de ces informations additionnelles:

  • l’hôte et le port du serveur LDAP à requêter (adresse IP ou URL)

  • un compte autorisé et un mot de passe afin de lire le répertoire LDAP si les demandes anonymes ne sont pas autorisées.

  • une base de recherche qui est une sorte de sous-répertoire où se trouve les comptes à importer

  • un filtre de recherche vous autorisant à effectuer une recherche LDAP pour sélectionner seulement les entrées souhaitées. (optionnel)

Correspondances des champs

Créer une table de correspondances entre les champs sources et les champs Koha.

Champ source

Champ Koha

name

surname

type

categorycode

mail

email

Si un champ source est nommé exactement de la même manière que le champ Koha correspondant, la correspondance est implicite et vous n’avez pas besoin de le définir dans la configuration. Sauf si vous y appliquer des correspondances de valeur ou des transformations.

Correspondances de valeur

Définissez les valeurs ayant besoin d’être transformées avant d’être importées dans Koha, et ajouter une transformation si le champ le nécessite. Particulièrement si les valeurs doivent correspondrent à des valeurs autorisées dans Koha (exemple: categorycode, branchcode).

Le processus de transformation vous autorise à utiliser des expressions régulières comme “strictement égal”, “commence par”, “contient”. Pour chaque autre traitement spécifique, un add-on doit être écrit.

Point de dédoublonnage

Un ou plusieurs champs sont utilisés pour dédoublonner les adhérents. Il est préférable d’utiliser un champ unique (userid, cardnumber). Les attributs étendus ne peuvent être utilisés »

Automatisation

L’automatisation implique d’ajouter un cronjob. Ceci est important pour son fonctionnement:

  • fréquence (chaque heure/jour/semaine/mois ?)

  • moment important afin d’éviter les imports durant les heures d’utilisation

  • où le fichier CSV sera envoyé sur le serveur (pas nécessaire pour le LDAP)

  • nommage du fichier CSV qui pourrait contenir une partie dynamique pour la date

Note

Prêtez attention à l’heure d’import. Un fichier peut être envoyé à 23h50 et importé à 00h30 le jour d’après.

Contenus