Différences entre versions de « Configuration du PNB Dilicom »

De WIKI-BOKEH
Aller à : navigation, rechercher
 
(53 versions intermédiaires par 8 utilisateurs non affichées)
Ligne 1 : Ligne 1 :
 +
== 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"]
 +
[[Fichier:Spiderman.png|gauche|DRM Adobe]]
 +
 +
<br>
 +
 +
 +
 +
 +
<br>
 +
 +
 +
 +
 +
 +
 +
<br>
 +
<br>
 +
 +
 +
 +
 
== Informations nécessaires pour activer le PNB ==
 
== Informations nécessaires pour activer le PNB ==
  
Ligne 14 : Ligne 55 :
  
 
=== Autres paramétrages ===
 
=== 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 :
 +
 +
[[Fichier:Dilicom choose device activate.png|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 ====
 
==== 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).<br>
+
Il faut renseigner le GLN de chaque bibliothèque du réseau dans la fiche bibliothèque (administration du portail -&gt; Bibliothèques).<br>
 
Dilicom peut fournir ces GLN.
 
Dilicom peut fournir ces GLN.
  
 
[[Fichier:Dilicom gln bib.png|500px]]
 
[[Fichier:Dilicom gln bib.png|500px]]
 +
 +
==== 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 &gt; fédération d'identité &gt; 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 ====
 
==== Batch ====
Le batch PNB Dilicom doit être activé (administration du portail > Système > Batchs).<br>
+
Le batch PNB Dilicom doit être activé (administration du portail &gt; Système &gt; Batchs).<br>
Il se charge  
+
Il se charge
 
* d'intégrer les métadonnées de fichiers d'acquisitions  
 
* 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 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 désindexer les notices / albums qui ne sont plus à disposition
 +
* de mettre à jour le rapport d'usage pour le [[PNB_Dilicom_tableau_de_bord|tableau de bord]]
  
 
== Déclaration des adresses IP pour la consultation in-situ ==
 
== Déclaration des adresses IP pour la consultation in-situ ==
Ligne 36 : Ligne 113 :
 
== Import des fichiers de métadonnées d'acquisitions ==
 
== Import des fichiers de métadonnées d'acquisitions ==
  
Les acquisitions peuvent être importées à partir du format de fichier Dilicom, soit manuellement soit automatiquement.<br />
+
L'import s'appuie sur la mécanique des [[Batchs, tâches planifiées|batchs Bokeh]].<br>
[https://pnb-dilicom.centprod.com/documentation/doku.php?id=pnb_diffusion_offre:start#metadonnees_mises_a_la_disposition_des_collectivites Voir la documentation Dilicom.]
+
Lorsque le PNB Dilicom est activé, un batch "Import Dilicom" apparait dans la liste des batchs disponibles dans l'interface d'administration.<br>
 
 
=== Import manuel ===
 
 
 
Une fois que le PNB Dilicom est activé, un menu "Bibliothèque Numérique > Import offres" Dilicom apparait dans l'interface d'administration.<br />
 
La page fait apparaître un formulaire simple permettant de transmettre un fichier d'offres.
 
 
 
=== Import automatique ===
 
 
 
L'import automatique s'appuie sur la mécanique des [[Batchs, tâches planifiées|batchs Bokeh]].<br />
 
Lorsque le PNB Dilicom est activé, un batch "Import Dilicom" apparait dans la liste des batchs disponibles dans l'interface d'administration.<br />
 
 
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
 
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_SERVER
Ligne 66 : Ligne 133 :
  
 
== Contrôler les limites de prêt ==
 
== Contrôler les limites de prêt ==
 
=== Visualisation des compteurs ===
 
 
Dans l'interface d'administration de Bokeh, une entrée de menu PNB Dilicom est disponible dans la section Bibliothèque numérique.
 
 
[[Fichier:Pnb dilicom menu.png|200px]]
 
 
Cet écran affiche un tableau récapitulatif des compteurs concernant les ressources PNB.
 
Une ligne correspond à un exemplaire d'un album PNB Dilicom.
 
 
[[Fichier:Pnb dilicom table.png|500px]]
 
 
==== Export CSV ====
 
 
Le lien '''Exporter le tableau en CSV''' permet de télécharger les compteurs dans un fichier exploitable par un tableur (LibreOffice, Excel, ...)
 
  
 
=== Durée des prêts ===
 
=== Durée des prêts ===
Ligne 106 : Ligne 158 :
 
== Emprunt d'un livre ==
 
== Emprunt d'un livre ==
  
Dans le menu de configuration de la page notice, le bloc '''Ressources numériques''' permet d'afficher la prévisualisation ainsi que les actions d'emprunt et de consultation du livre numérique.
+
[[PNB_Dilicom_emprunt_de_documents|Voir la documentation]]
 
 
[[Fichier:pnb_notice.png|500px]]
 
 
 
Pour emprunter le livre, l'abonné doit cliquer sur le bouton '''Emprunter le livre'''. De là une boite de confirmation s'ouvre pour confirmer l'emprunt.
 
 
 
'''Attention le pré-requis pour pouvoir consulter le contenu de ces fichiers, est d'installer sur vos supports des logiciels compatibles avec les DRM Adobe (Ex sous Windows : Adobe Digital Reader, Sous Android : BlueFire Reader)'''
 
 
 
* Si le livre est déjà en cours d'emprunt par l'abonné, le compteur de prêt n'est pas incrémenté (réutilisation du même fichier DRM)
 
* Au cas où l'abonné effectue un retour anticipé d'un livre emprunté (par exemple pour libérer un emprunt), des limites actuelles de la plateforme Dilicom nécessite un délai d'attente d'environ 15mn pour la prise en compte.
 
* Le prêt est bloqué si le nombre de jour restant sur la commande est inférieure au temps de prêt autorisé (voir [[Configuration_du_PNB_Dilicom#Dur.C3.A9e_des_pr.C3.AAts|Durée des pêts]] )
 
 
 
[[Fichier:pnb_hold.png|500px]]
 
 
 
=== Configuration message d'avertissement de la popup d'emprunts===
 
 
 
La variable DILICOM_PNB_LOAN_WARNING_MESSAGE indique le message à afficher en dessous des boutons.<br />
 
Elle est modifiable dans les variables d'administration. <br />
 
Par défaut le message est : "Votre compte sera mis à jour dans un délai de 15 minutes après le retour anticipé du document.".<br />
 
 
 
[[Fichier:Pnb loan warning message.png|500px]]
 
 
 
== Exemple de téléchargement Sur Android ==
 
 
 
A partir de la Notice, après avoir confirmé l'emprunt Android va demander avec quelle application ouvrir le fichier : choisir ici BlueFire Reader
 
 
 
[[Fichier:pnb_ouvrir_avec.png|300px]]
 
 
 
Le fichier vient ainsi compléter la collection de notre application
 
 
 
[[Fichier:pnb_biblio.png|300px]]
 
 
 
== Enregistrer un retour anticipé ==
 
  
Si le lecteur souhaite rendre son document par anticipation, le retour ne se fait pas sur Bokeh, mais à partir de l'application utilisée.
 
  
Par exemple sur BlueFire Reader, il suffit de supprimer le document.
+
== 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 :
 +
*<p>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)&nbsp;<br></p>
 +
*<p>DILICOM PNB FORWARD NOTIFICATION MAIL BODY : contenu du mail envoyé. Vocabulaire disponible :<br></p>
 +
**{user.prenom_complet}
 +
**{title}
 +
**{issue_date}
 +
**{return_date}
 +
*<p>DILICOM PNB FORWARD NOTIFICATION MAIL SUBJECT</p>
 +
== Réservation d'un livre ==
 +
[[PNB_Dilicom_reservation_de_documents|Voir la documentation]]
  
[[Fichier:pnb_suppression.png|300px]]
 
  
'''Attention, Sur la plateforme Dilicom ce retour n'est pas instantané. Il y a un délais de prise en compte pouvant aller jusqu'à une heure'''
+
== Tableau de bord ==
 +
[[PNB_Dilicom_tableau_de_bord|Voir la documentation]]
  
 
== Liens ==
 
== Liens ==
Ligne 152 : Ligne 181 :
 
* [https://pnb-dilicom.centprod.com/documentation/doku.php?id=start Documentation de la plateforme PNB Dilicom]
 
* [https://pnb-dilicom.centprod.com/documentation/doku.php?id=start Documentation de la plateforme PNB Dilicom]
  
== Réservations de documents ==
+
[[Catégorie:Doc]]
 
 
Vous pouvez activer la prise en charge des réservations de documents PNB via la variable '''DILICOM_PNB_ENABLE_HOLDS'''. Ceci fait, lorsqu'un document n'est pas disponible à l'emprunt, l'abonné peut alors réserver ce document.
 
 
 
[[File:pnb_hold_record.png]]
 
 
 
Comme toute réservation, l'abonné peut annuler cette réservation via son compte:
 
 
 
[[File:pnb_hold_list.png]]
 
 
 
Lorsqu'un retour a été effectué et qu'un nouveau prêt se libère, le batch quotidien allouera les réservations dans l'ordre de leurs rangs. Cela bloquera l'emprunt aux autres abonnés que ceux qui ont réservé le document, dans la limite du nombre de prêts disponibles.
 
 
 
Bokeh enverra une notification par courriel aux abonnés dont la réservation peut être retirée dans le délai prévu.
 
 
 
=== Configuration des réservations ===
 
 
 
Les variables suivantes permettent de contrôler le comportement de la gestion des réservations:
 
* '''DILICOM PNB ENABLE HOLDS''' : activation ou non du système de réservation
 
* '''DILICOM PNB HOLD MAX AVAILABILITY''': Nombre de jours de disponibilité de la réservation (par défaut 8)
 
* '''DILICOM PNB PATRON MAX HOLD COUNT''': Nombre maximum de réservations par utilisateur
 
* '''DILICOM PNB RECORD MAX HOLD COUNT''': Nombre maximum de réservations par document numérique
 
* '''DILICOM PNB HOLD AVAILABLE MAIL''' : Email de notification de disponibilité de reservation numérique
 
 
 
=== Démonstration en vidéo ===
 
 
 
{{#ev:youtube|https://youtu.be/vHZh4WF9jpc}}
 
 
 
 
 
 
[[Catégorie:PNB]]
 
[[Catégorie:PNB]]
 
+
[[Catégorie:Pages avec des liens de fichiers brisés]]
[[Catégorie:Ressources_numériques]]
 

Version actuelle datée du 11 mars 2024 à 16:53

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[ ]