Configuration du PNB Dilicom

De WIKI-BOKEH
Aller à : navigation, rechercher

Contraintes techniques liées à l'utilisation du PNB[ ]

Le téléchargement de livres numériques via PNB est soumis à l'utilisation d'une DRM (verrou numérique) qui permet de limiter la durée des prêts, le nombre de prêts, etc... 2 types de DRM existent.

DRM Adobe[ ]

  • Création de compte Adobe ID obligatoire : La base du codage se fait avec un compte Adobe ID, qui est relié à votre adresse e-mail enregistrée.
  • Téléchargement d'un logiciel de lecture compatible avec les DRM Adobe (par exemple Adobe Digital Editions, Aldiko ou Bluefire Reader). La liste du matériel compatible : https://www.adobe.com/solutions/ebook/digital-editions/tech-specs.html (note : aucun support Gnu/Linux)
  • Association du compte Adobe ID dans le logiciel de lecture

DRM LCP[ ]

  • Pas de création de compte obligatoire, votre numéro de carte abonné vous sera demandé à la première ouverture du fichier, ou si vous n'en avez pas votre identifiant de connexion

NB : pour les abonnés Orphée, le code-barres n'est pas le même que l'identifiant Bokeh. C'est le code-barres de la carte qui est demandé pour la DRM LCP

  • Téléchargement d'un logiciel de lecture compatible avec les DRM LCP (par exemple Baobab sur tablette/smartphone ; Thorium reader sur PC)

NB : MAJ avril 2022 : seuls les liseuses Bookeen Aura et Vivlio TouchLux sont compatibles avec la DRM LCP

Si l'erreur suivante se présente cela indique que l'EAN se réfère à une ressource (notice) qui n’est pas compatible avec LCP

[Emprunt impossible. Le service "loanBook" a renvoyé une erreur : "Invalid DRM technology"]
DRM Adobe












Informations nécessaires pour activer le PNB[ ]

Variables[ ]

L'URL de la plateforme de production de Dilicom doit se renseigner dans la variable DILICOM_PNB_SERVER_URL: https://pnb-dilicom.centprod.com

Vous devez déclarer dans Bokeh les informations suivantes fournies par Dilicom ( contact: Technique@dilicom.fr / 01 43 25 43 35 ):

  • Identifiant de la collectivité: DILICOM_PNB_GLN_COLLECTIVITE
  • Identifiant du prestataire: DILICOM_PNB_GLN_CONTRACTOR
  • Mot de passe d'accès aux web services: DILICOM_PNB_PWD_COLLECTIVITE
  • Serveur FTP pour la récupération des fichiers de commande: DILICOM_PNB_FTP_SERVER
  • Identifiant FTP: DILICOM_PNB_FTP_USER
  • Mot de passe FTP: DILICOM_PNB_FTP_PASS

Autres paramétrages[ ]

DRM LCP / DRM Adobe[ ]

Si vous souhaitez proposer à vos abonnés le choix de la DRM, vous devez activer la sélection de la liseuse pour proposer à l'abonné de sélectionner le fichier correspondant à sa liseuse. Selon le choix de liseuse effectué par l'abonné, le fichier reçu aura une extension .acsm pour une DRM Adobe ou .lcpl pour une DRM LCP.

  • Activer la variable DILICOM PNB CHOOSE DEVICES ACTIVATE :

500px - Désactiver la sélection de la liseuse : la sélection de la liseuse ne sera pas proposé et la DRM Adobe sera automatiquement téléchargée

- Afficher les liseuses LCP uniquement : la sélection sera proposée pour les liseuses LCP. Si l'abonné choisit "Mon application n'est pas dans la liste" c'est automatiquement une DRM Adobe qui sera proposée

- Afficher toutes les liseuses : la sélection sera proposée avec toutes les liseuses existantes (attention, la liste est longue ^^).


  • Activer la sélection de la liseuse par défaut : "DILICOM_PNB_CHOOSE_DEVICES" - Sélectionner "Adobe Digital Edition" pour proposer le DRM Adobe par défaut ou "Baobab" pour proposer le DRM LCP par défaut.



Fiche Bibliothèque[ ]

Il faut renseigner le GLN de chaque bibliothèque du réseau dans la fiche bibliothèque (administration du portail -> Bibliothèques).
Dilicom peut fournir ces GLN.

Dilicom gln bib.png

Autoriser la connexion depuis Baobab[ ]

La variable Communication API-APP : clé HMAC (DILICOM_PNB_HMAC_KEY) doit être renseignée ( à demander à AFI ou Dilicom )

Il faut demander l'activation auprès de Dilicom en indiquant le GLN de la bibliothèque ainsi que l'URL de discover : https://[URL_de_votre_portail]/api/catalog/discover

Les GLN doivent être déclarés en tant que client d'identité.

Le client d'identité doit être activé.

Administration du portail > fédération d'identité > voir les clients d'identité

Puis ajouter un nouveau client d'identité avec les paramètres suivant :

  • Type : Dilicom Baobab OAuth
  • client_id = GLN
  • Active coché

Batch[ ]

Le batch PNB Dilicom doit être activé (administration du portail > Système > Batchs).
Il se charge

  • d'intégrer les métadonnées de fichiers d'acquisitions
  • de mettre à jour des dates de retour des prêts rendus de manière anticipée
  • de désindexer les notices / albums qui ne sont plus à disposition
  • de mettre à jour le rapport d'usage pour le tableau de bord

Déclaration des adresses IP pour la consultation in-situ[ ]

Les documents ne sont consultables que sur site. Dilicom se base sur les adresses IP publiques des médiathèques pour autoriser la consultation. Vous devez déclarer ces adressess IP via la variable DILICOM_PNB_IP_ADRESSES.

Pnb dilicom declare ip.png

Import des fichiers de métadonnées d'acquisitions[ ]

L'import s'appuie sur la mécanique des batchs Bokeh.
Lorsque le PNB Dilicom est activé, un batch "Import Dilicom" apparait dans la liste des batchs disponibles dans l'interface d'administration.
Ce batch télécharge les fichiers d'offres à partir d'un serveur FTP dont les paramètres d'accès fournis par Dilicom doivent être saisi dans les variables

  • DILICOM_PNB_FTP_SERVER
  • DILICOM_PNB_FTP_USER
  • DILICOM_PNB_FTP_PASS

Tout comme les autres batchs de ressources numériques, ce batch peut être lancé manuellement et est aussi lancé lors des intégrations automatiques cosmogrammes.

Visualisation et modification des albums PNB[ ]

Bokeh importe les livres PNB dans la bibliothèque numérique, dans la collection Livre numérique (PNB).

Pnb admin albums.png

Les contraintes d'usages sont spécifiées dans la section Utilisation d'un album. Si plusieurs commandes concernent le même livre, Bokeh les rattache toutes au même album et concatène la liste des droits:

Pnb admin albums rights.png

Contrôler les limites de prêt[ ]

Durée des prêts[ ]

Par défaut, lors d'un prêt, la réponse des webservices contient la durée (en jours) de celui-ci. Il est possible de limiter cette durée au niveau de votre portail Bokeh en renseignant la variable DILICOM_PNB_MAX_LOAN_DURATION.

Var dilicom pnb max loan duration.png

Nombre de prêts simultanés pour un livre[ ]

La variable DILICOM_PNB_LOAN_COUNT_LIMIT indique le nombre de prêts simultanés maximum sur un livre. Si la limite de prêts simultanés sur une commande Dilicom est inférieure à cette valeur, c'est la plus petite des limites qui est prise en compte.

Si DILICOM_PNB_LOAN_COUNT_LIMIT vaut 0 ou n'est pas renseigné, alors Bokeh ne prends en compte que la limite Dilicom.

La limite de nombre de prêts simultanés possible s'affiche dans l'administration de Bokeh dans le menu PNB Dilicom

Nombre de prêts simultanés pour un abonné[ ]

La variable DILICOM_PNB_MAX_LOAN_PER_USER permet de définir le nombre de prêts simultanés possibles pour un abonné (par défaut 3). L'abonné ne pourra pas emprunter plus de livres PNB que cette valeur et devra retourner un livre avant de pouvoir en emprunter un autre.


Gestion des prêts avec plusieurs commandes sur un même livre[ ]

Lorsque plusieurs commandes PNB concernent le même livre, lorsque une commande est expirée ou la quantité de prêts épuisée, Bokeh bascule automatiquement sur la commande suivante pour décompter les prêts.

Emprunt d'un livre[ ]

Voir la documentation


Notification d'échéance de prêt[ ]

Il est possible d'alerter les emprunteurs par mail lorsqu'un prêt PNB arrive à échéance. Pour ce faire, 3 variables sont disponibles :

  • DILICOM PNB FORWARD NOTIFICATION DELAY : Délai d'envoi en nombre de jours, pour la notification avant expiration du prêt (0 : pas de notification) 

  • DILICOM PNB FORWARD NOTIFICATION MAIL BODY : contenu du mail envoyé. Vocabulaire disponible :

    • {user.prenom_complet}
    • {title}
    • {issue_date}
    • {return_date}
  • DILICOM PNB FORWARD NOTIFICATION MAIL SUBJECT

Réservation d'un livre[ ]

Voir la documentation


Tableau de bord[ ]

Voir la documentation

Liens[ ]