Intégration de fichiers paniers

De WIKI-BOKEH
Aller à : navigation, rechercher

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.

Panier profil donnees.png

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é.


Panier integration.png


Note Importante : La synchronisation automatique des paniers et des contenus de paniers avec votre SIGB nécessite l'utilisation des exports totaux.


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.

C'est aussi uniquement lors des exports totaux que les paniers vides après import et non liés à des domaines sont supprimés.

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:

Panier integration log erreur.png

A la fin de l'intégration, Bokeh affiche le nombre total de notices associées aux paniers et le temps de traitement:

Panier integration log fin.png