Intégration de fichiers paniers
Bokeh (via Cosmogramme) peut intégrer des paniers de notices provenant du SIGB exportés au format CSV.
Format du fichier d'export[ ]
Les paniers doivent être exportés en CSV:
- séparateur de champs: virgule, tabulation, point-virgule ou barre verticale
- une ligne par notice
- colonnes:
- ID_SIGB (entier): identifiant du panier dans le SIGB. Il sert à retrouver le panier à mettre à jour lors d'un import incrémentiel
- LIBELLE (alphanum): libellé du panier
- IDABON (alphanum)(optionnel*): numéro de carte abonné du détenteur du panier
- MAIL (alphanum)(optionnel*): courriel du détenteur du panier
- ROLE (entier)(optionnel): 0 pour un abonné, 1 pour un-e administrateur-trice. Lorsqu'un usager possède à la fois un compte abonné et administrateur, cela permet de spécifier sur quel compte rattacher le panier. Si le rôle n'est pas précisé, Bokeh rattachera le panier au premier compte trouvé en fonction du courriel MAIL ou du numéro de carte IDABON
- NOTICE_SIGB (entier): identifiant de la notice dans le SIGB
* au moins une colonne MAIL ou IDABON doit être présente
Exemple de fichier:
1,"ciné-romans",0006,,0,39925 1,"ciné-romans",0006,,0,58265 6,"froid litterature",2345,leila@mabib.fr,1,67220 6,"froid litterature",2345,leila@mabib.fr,1,72490
Deux paniers sont exportés:
- ciné-romans a l'id 1 dans le SIGB, appartient à l'abonné (rôle=0) qui a pour numéro de carte 0006. Le panier contient deux notices identifiées dans le SIGB comme 39925 et 58265
- froid litterature, d'id 6 et appartenant à l'administratrice (rôle=1) qui a pour numéro de carte 2345 et courriel leila@mabib.fr. Ce panier contient aussi deux notices.
Configuration du profil de données Cosmogramme[ ]
Créer un nouveau profil de données avec la configuration suivante:
- Type de fichier: paniers
- Format de fichier: CSV ou un des formats ASCII séparés par ;, | ou tabulé.
- Champs: les colonnes présentent dans le fichier.
Configuration des intégrations programmées Cosmogramme[ ]
Ajouter une nouvelle intégration avec la configuration suivante:
- Type d'opération:
- import total: tous les paniers liés à cette intégration seront vidés avant d'importer le fichier. Si un utilisateur a manuellement ajouté des notices à l'un de ces paniers depuis Bokeh, cela sera perdu. A la fin de l'import total, les paniers importés du SIGB seront synchrones avec le SIGB. L'import total supprime aussi les paniers sans notices.
- import incrémentiel: les paniers liés au SIGB ne sont pas vidés avant import. Cela permet à des utilisateurs de compléter les paniers avec des notices disponibles seulement côté Bokeh (par exemple des notices provenant de la bibliothèque numérique ou d'un autre SIGB). Par contre les notices retirées du panier côté SIGB apparaîtront toujours dans le panier côté Bokeh.
Quel que soit le type d'import, les paniers contenant au moins une notice ne sont pas détruits. Ils peuvent donc être rattachés à des domaines, kiosques, ...
- Profil de données: sélectionner le profil de données créé précédemment
- Forcer un type de document: non applicable
- Taille mini pour un import total de notices: en cas de problème d'export côté SIGB ou de transfert, le fichier peut se retrouver incomplet. Ce champ permet de saisir une taille minimale attendu. Si le poids du fichier est inférieur à la valeur précisée, l'import ne sera pas lancé.
En particulier, ce n'est que lors des exports totaux que le contenu des paniers (les notices qu'il contient) est vidé avant de réimporter tout le contenu.
Import du fichier[ ]
Bokeh importe le fichier lors d'un traitement manuel ou automatique. Lorsque le panier ne peut être associé à un compte, celui-ci n'est pas importé et indiqué comme orphelin dans le journal des intégrations:
A la fin de l'intégration, Bokeh affiche le nombre total de notices associées aux paniers et le temps de traitement: