Aller au contenu
Tamil

Suggestions d'achat

Synopsis

Les suggestions d'achat sont créées par les usagers via l'OPAC ou par les bibliothécaires en PRO. Les suggestions sont gérées en PRO et servent à alimenter le module Acquisitions. On peut toutefois gérer ses acquisitions en dehors de Koha et utiliser quand même les suggestions pour collecter auprès de ses lecteurs des suggestions d'achat.

Statut — Durant leur cycle de vie, les suggestions passent par six statuts prédéfinis, après quoi elles peuvent être archivées ou supprimées. On retrouve ces statuts dans le champ de la base de données suggestions.STATUS (entre crochets ci-dessous). En plus des six statuts prédéfinis, il est possible d'ajouter des statuts locaux au moyen de la liste de valeurs autorisées SUGGEST_STATUS.

  • En attente [ASKED] — La suggestion vient d'être faite, à l'OPAC ou en PRO. Elle est en attente d'une action d'un bibliothécaire. Si la préférence EmailPurchaseSuggestions est activée, un email est envoyé à un bibliothécaire avec la notification NEW_SUGGESTION, que la suggestion ait été faite à l'OPAC ou en PRO. Une alerte est affichée en bas de la page d'accueil PRO : elle donne le nombre de suggestions en attente non archivées du site courant, ainsi que le total pour tous les sites s'il est différent. Le script notice_unprocessed_suggestions.pl peut être programmé pour relancer les propriétaires des postes budgétaires associés à des suggestions restées en attente. La notification TO_PROCESS leur est envoyée.

  • Vérifiée [CHECKED] — La suggestion a été vérifiée par un bibliothécaire. Il n'est pas nécessaire d'utiliser ce statut, mais cela peut être un moyen de valider en deux temps les suggestions faites à l'OPAC par les usagers. On examine les suggestions En attente. Celles qui ne sont pas légitimes sont immédiatement rejetées. Celles qui sont légitimes sont marquées Vérifiée et elles sont associées à un poste budgétaire. Les suggestions vérifiées sont examinées ultérieurement. Un certain nombre sont rejetées, faute de budget par exemple. D'autres sont acceptées. Les suggestions vérifiées n'apparaissent plus sur la page d'accueil PRO. Koha ne fournit pas de notification CHECKED : aucun email n'est envoyé au lecteur pour ce statut, à moins de créer une notification portant ce code.

  • Rejetée [REJECTED] — La suggestion est rejetée. Un email est envoyé au lecteur avec la notification REJECTED.

  • Acceptée [ACCEPTED] — La suggestion est acceptée. Un email est envoyé au lecteur avec la notification ACCEPTED. Seules les suggestions acceptées peuvent être commandées.

  • Commandée [ORDERED] — La suggestion est commandée. Dans le module Acquisitions, un bibliothécaire a utilisé la suggestion pour créer une ligne de commande (option Depuis une suggestion d'achat du panier). Un email est envoyé au lecteur avec la notification ORDERED. Si la préférence PlaceHoldsOnOrdersFromSuggestions est activée, une réservation est automatiquement placée pour le lecteur sur la notice commandée. Si la ligne de commande est annulée, la suggestion repasse au statut Acceptée et le lecteur reçoit de nouveau la notification ACCEPTED. On ne passe manuellement une suggestion au statut Commandée que si les commandes ne sont pas faites dans Koha.

  • Disponible [AVAILABLE] — La suggestion, après avoir été commandée, a été reçue et a été intégrée au Catalogue de la bibliothèque. Ce statut est attribué automatiquement à la réception de la commande. Un email est envoyé au lecteur avec la notification AVAILABLE.

Raison — À chaque fois que le statut d'une suggestion est changé, on peut donner une raison à ce changement. Une liste de raisons par défaut est proposée (SUGGEST). Il est possible de spécifier une raison en dehors de cette liste. Par ailleurs un champ note bibliothécaire permet d'ajouter encore toute précision nécessaire à destination du bibliothécaire qui gérera effectivement l'acquisition.

E-mail — À chaque changement de statut, un email est envoyé à la personne ayant fait la suggestion. La notification utilisée par l'email porte le nom du statut, soit les codes prédéfinis (CHECKED, REJECTED, ACCEPTED, ORDERED, AVAILABLE) et les codes locaux (liste de valeurs autorisées SUGGEST_STATUS). L'email n'est envoyé que si une notification portant ce code existe : Koha fournit REJECTED, ACCEPTED, ORDERED et AVAILABLE, mais pas CHECKED. Si le lecteur n'a pas d'email, la notification peut lui être envoyée par SMS (préférence FallbackToSMSIfNoEmail).

Infos diverses — La suggestion contient différents champs qui aident les bibliothécaires à trouver et acquérir le document demandé. Des champs décrivant la ressource demandée : titre, auteur, date et lieu de publication, date de copyright, ISBN, éditeur, titre de collection, volume, type de document. Des champs précisent la nature de la demande : raison du lecteur, note, site. Des champs servent à l'acquisition : quantité, prix, devise, total, poste budgétaire. Les données bibliographiques de la suggestion alimentent la notice créée lors de la commande.

Doublons — À la création d'une suggestion, à l'OPAC comme en PRO, Koha recherche dans le catalogue une notice correspondant au titre, à l'auteur et à l'ISBN. S'il en trouve une, il la signale et demande confirmation avant d'enregistrer la suggestion.

Affichage, regroupement et filtrage — Les suggestions sont affichées dans un tableau dont les colonnes peuvent être paramétrées. Les suggestions sont regroupées dans des onglets organisés sur le critère de son choix : Statut, Site, Type de document, Gérée par, Acceptée par. Les suggestions peuvent être filtrées sur plusieurs critères afin de ne pas surcharger l'affichage. Par défaut, seules les suggestions du site courant sont affichées.

Actions par lot — Dans le tableau des suggestions, on peut sélectionner plusieurs suggestions puis changer leur statut (avec une raison), leur type de document ou leur gestionnaire, les archiver ou les supprimer.

Autres affichages — Les suggestions d'un lecteur sont visibles dans un onglet de sa fiche lecteur, en PRO, d'où l'on peut aussi créer une suggestion en son nom. Les suggestions liées à une notice sont affichées sur la page de détail de la notice en PRO. À l'OPAC, le lecteur retrouve ses suggestions dans son compte et peut les supprimer.

Archivage et suppression — Les suggestions, une fois complètement traitées, peuvent être archivées. Les suggestions archivées ne sont plus affichées par défaut, mais on peut si on le souhaite les faire réapparaître. Elles disparaissent aussi de la liste des suggestions du lecteur à l'OPAC. Depuis Koha 26.05, on peut désarchiver une suggestion. On peut également supprimer des suggestions. Deux scripts planifiés permettent d'automatiser l'archivage et la suppression des suggestions.

Diagramme de flux de gestion des suggestions

Script planifié,si poste budgétaireCommande depuisla suggestionAnnulationde la commandeRéceptionNotifier le gestionnaireLecteur OPACSuggestionEn attenteBibliothécaire PRONEW_SUGGESTIONTO_PROCESSSuggestionVérifiéeSuggestionRejetéeSuggestionAcceptéeREJECTEDACCEPTEDSuggestionCommandéeORDEREDSuggestionDisponibleAVAILABLECatalogue KohaModification d'unesuggestionNOTIFY_MANAGER

Configuration

Les suggestions d'achats sont paramétrées avec des préférences systèmes, des listes de valeurs autorisées, un tableau paramétré, des permissions, des notifications, un paramétrage HTML et trois scripts planifiés.

Préférences

  • suggestion : Activation des suggestions d'achat à l'OPAC.
  • suggestionPatronCategoryExceptions : les catégories de lecteur qui ne sont pas autorisées à faire des suggestions. Cette préférence n'est prise en compte que si AnonSuggestions est désactivée.
  • AnonSuggestions : Autorisation des suggestions anonymes (sans connexion à l'OPAC).
  • AnonymousPatron : Le numéro du lecteur (borrowernumber) du lecteur auquel les suggestions anonymes sont affectées.
  • OPACSuggestionUnwantedFields : Les champs des suggestions qui ne sont pas affichés à l'OPAC.
  • OPACSuggestionMandatoryFields : La liste des champs obligatoires d'une suggestion. Le titre est toujours obligatoire.
  • OPACSuggestionAutoFill : Remplir automatiquement les champs des suggestions en utilisant l'API de Google Books.
  • MaxOpenSuggestions : Nombre maximum de suggestions ouvertes qu'un lecteur peut faire.
  • MaxTotalSuggestions et NumberOfSuggestionDays : Nombre de suggestions qu'un lecteur peut faire sur un intervalle de temps de NumberOfSuggestionDays jours.
  • OPACViewOthersSuggestions : Voir les suggestions des autres lecteurs.
  • OpacSuggestionManagedBy : Montrer à l'OPAC le nom du bibliothécaire qui a géré la suggestion d'un lecteur.
  • FallbackToSMSIfNoEmail : Si le lecteur n'a pas d'email, lui envoyer par SMS les notifications de gestion des suggestions.
  • RenewSerialAddsSuggestion : Ajouter une suggestion pour la notice biblio à laquelle est attachée un abonnement de périodique qui est renouvelé.
  • EmailPurchaseSuggestions : Définit à qui envoyer un email (notification NEW_SUGGESTION) quand une nouvelle suggestion d'achat est faite, à l'OPAC ou en PRO. On peut choisir de ne pas envoyer d'email, ou bien d'en envoyer un à l'adresse du site de la suggestion, à celle contenue dans la préférence KohaAdminEmailAddress ou dans EmailAddressForSuggestions.
  • EmailAddressForSuggestions : L'adresse du destinataire de l'email de notification d'une nouvelle suggestion, quand EmailPurchaseSuggestions vaut EmailAddressForSuggestions.
  • PurgeSuggestionsOlderThan : Nombre de jours au-delà desquels les suggestions traitées sont automatiquement supprimées. Les suppressions sont faites par le script purge_suggestions.pl.
  • PlaceHoldsOnOrdersFromSuggestions : Placer automatiquement une réservation pour le lecteur quand on commande depuis sa suggestion.
  • SuggestionsLog : Journaliser la création, la modification et la suppression des suggestions.

Listes de valeurs autorisées

  • SUGGEST_STATUS : Statuts des suggestions en plus des valeurs proposées par défaut. Attention ! le code de la valeur autorisée ne doit pas faire plus de dix caractères (taille du champ suggestions.STATUS).
  • SUGGEST_FORMAT : La liste des types d'exemplaires proposés à l'OPAC aux lecteurs qui font des suggestions.
  • OPAC_SUG : Les raisons pour lesquelles l'usager demande l'achat.
  • SUGGEST : Les raisons pour lesquelles les suggestions sont acceptées ou rejetées.

Tableau paramétré

  • Le tableau qui affiche les suggestions en PRO est paramétrable en Administration > Configuration des tableaux > Acquisitions > suggestions.

Permission

  • suggestions_create : Autorisation de créer des suggestions d'achat en PRO.
  • suggestions_manage : Autorisation de gérer les suggestions d'achat. Seuls les bibliothécaires qui ont cette permission peuvent être désignés comme gestionnaires d'une suggestion.
  • suggestions_delete : Autorisation de supprimer des suggestions d'achat.

Notifications

  • NEW_SUGGESTION : Message envoyé à un bibliothécaire pour signaler une nouvelle suggestion.
  • TO_PROCESS : Message envoyé au propriétaire d'un poste budgétaire auquel des suggestions en attente ont été assignées. Script notice_unprocessed_suggestions.pl.
  • REJECTED : Le lecteur est prévenu que sa suggestion d'achat a été refusée.
  • ACCEPTED : Prévient le lecteur que sa suggestion est acceptée et qu'elle fera l'objet d'une commande.
  • ORDERED : Prévient le lecteur que sa suggestion qui avait été acceptée vient d'être commandée.
  • NOTIFY_MANAGER : Message envoyé au gestionnaire d'une suggestion pour lui signaler qu'elle lui a été assignée. Il est envoyé quand on coche la case Notifier le gestionnaire en modifiant une suggestion. Le changement de gestionnaire par lot n'envoie pas ce message.
  • AVAILABLE : Prévient le lecteur que sa suggestion a été reçue et est intégrée à la collection de la bibliothèque.
  • LOCAL_XX — Avec la liste de valeurs autorisées SUGGEST_STATUS, vous pouvez définir des statuts complémentaires. Quand il existe une notification portant le nom d'un de ces codes, un email est envoyé avec cette notification.

Personnalisation HTML

  • OpacSuggestionInstructions : Texte affiché à l'OPAC sur la page de gestion des suggestions d'achats.

Scripts

Trois scripts dans cronjobs réalisent certaines actions relativement aux suggestions :

  • notice_unprocessed_suggestions.pl : Envoi de la notification TO_PROCESS aux propriétaires des postes budgétaires pour lesquels il y a des suggestions au statut En attente (ASKED). Le paramètre --days N sélectionne les suggestions faites exactement N jours plus tôt. Il peut être répété pour relancer à plusieurs reprises : --days 7 --days 14. Sans --confirm, le script s'exécute à blanc.

  • archive_purchase_suggestions.pl : Passe automatiquement des suggestions à l'état archivée (ce qui les masque à l'interface PRO) sur la base de certains critères : le statut (--status) ; l'ancienneté (--age) d'un des champs de date (--age-date-field) : date de la suggestion, de la gestion, de l'acceptation, du rejet ou de la dernière modification. Sans --confirm, le script s'exécute à blanc.

  • purge_suggestions.pl : Supprime toutes les suggestions dont le statut n'est pas En attente (ASKED) et dont la date de gestion a plus d'un certain nombre de jours. Ce nombre est donné par le paramètre --days, sinon par la préférence PurgeSuggestionsOlderThan. Sans l'un ou l'autre, rien n'est supprimé. Le paramètre --confirm est obligatoire.

Table

Une seule table de la base de données permet de suivre les suggestions : suggestions.

Champ Type Null Clé Défaut Plus
suggestionid int NO PRI NULL auto_increment
suggestedby int YES MUL NULL
suggesteddate date NO NULL
managedby int YES MUL NULL
manageddate date YES NULL
acceptedby int YES MUL NULL
accepteddate date YES NULL
rejectedby int YES MUL NULL
rejecteddate date YES NULL
lastmodificationby int YES MUL NULL
lastmodificationdate date YES NULL
STATUS varchar(10) NO MUL
archived tinyint(1) NO 0
note longtext YES NULL
staff_note longtext YES NULL
author varchar(80) YES NULL
title varchar(255) YES NULL
copyrightdate smallint YES NULL
publishercode varchar(255) YES NULL
date timestamp NO CURRENT_TIMESTAMP DEFAULT_GENERATED on update CURRENT_TIMESTAMP
volumedesc varchar(255) YES NULL
publicationyear smallint YES 0
place varchar(255) YES NULL
isbn varchar(30) YES NULL
biblionumber int YES MUL NULL
reason mediumtext YES NULL
patronreason mediumtext YES NULL
budgetid int YES MUL NULL
branchcode varchar(10) YES MUL NULL
collectiontitle mediumtext YES NULL
itemtype varchar(30) YES NULL
quantity smallint YES NULL
currency varchar(10) YES NULL
price decimal(28,6) YES NULL
total decimal(28,6) YES NULL

Cette table est liée à d'autres tables :

  • borrowers : Les adhérents. Le lecteur/bibliothécaire qui a soumis la suggestion. Les bibliothécaires qui suivent la demande, celui qui gère la demande, celui qui l'accepte, qui la rejette.
  • branches : Les sites.
  • biblio : Notice biblio.
  • aqbudgets : Poste budgétaire.

suggestedby, managedby,acceptedby, rejectedby,lastmodificationbybudgetidbiblionumberbranchcodebudget_owner_idsuggestionsintsuggestionidPKintsuggestedbyFKintmanagedbyFKintacceptedbyFKintrejectedbyFKintlastmodificationbyFKintbudgetidFKintbiblionumberFKvarcharbranchcodeFKborrowersintborrowernumberPKvarcharcardnumberlongtextsurnamemediumtextfirstnamelongtextemailaqbudgetsintbudget_idPKintbudget_parent_idvarcharbudget_codevarcharbudget_branchcodeintbudget_owner_idFKbibliointbiblionumberPKlongtexttitlelongtextauthorbranchesvarcharbranchcodePKlongtextbranchname