ManuelUtilisateur
Sommaire |
Fonctionnalités
- Gestion des ouvrages (titre, sous titre, ISBN, genre, auteur, nombre de pages, année, résumé, etc...)
- Recherche simple et avancée sur les livres,
- Gestion des auteurs (nom, prénom, date de naissance, commentaires),
- Gestion des genres (compatible avec la classification de Dewey),
- Gestion simple des formats,
- Gestion simple des états (état physique de l'ouvrage),
- Gestion simple des éditeurs,
- Impression de la liste des ouvrages,
- Gestion des emprunteurs,
- Gestion des prêts. Pour chaque livre il est possible de spécifier un nombre d'ouvrages acquis. Une case "en rayon" sera non cochée si le nombre de prêts de ce titre est égal au nombre d'exemplaires possédés. De même, lors de l'enregistrement d'un prêt, le nombre d'exemplaires disponibles au prêt sera calculé selon le titre sélectionné.
Pré-requis
Base de données
Par défaut BibliothèK fonctionne sur une base de données MySQL. Les modes PostgreSLQ et hsqldb sont prévus mais pas encore implémentés. Les tables MySQL sont des tables InnoDB (afin de profiter de l'intégrité référentielle) ; qui ne sont disponibles qu'à partir de la version 4.0 de MySQL. Les tests ont été menés sur la version 4.1 et 5.0 mais les versions 4.0.x devraient fonctionner également.
Le connecteur MySQL pour ces versions est dispensé par l'installateur. Les connecteurs Postgres et Hsql ne sont pas (pour l'heure) fournis.
Chiffrement
Si vous souhaitez bénéficier du mode de chiffrement de l'API BouncyCastle (pour le stockage du mot de passe de votre base de données dans le fichier de configuration de BibliothèK), vous devez installer le JCE (Java Cryptography Extension) unrestricted. L'api !BouncyCastle est distribuée avec l'installateur, le JCE doit être téléchargé pour votre version de Java depuis le site de sun.
Alternativement, un module développé par M. Selva Thierry est également disponible, qui ne requiert aucune bibliothèque supplémentaire sur votre système.
Machine Virtuelle Java
Afin de fonctionner correctement, BibliothèK nécessite une JRE 1.5 de Sun. Toute autre machine virtuelle est susceptible de ne pas fonctionner ou d'apporter des résultats inattendus.
La JRE et le JCE correspondants sont disponibles sur le site de Sun Microsystems.
BibliothèK, manuel de l'utilisateur
Gestion des livres
Liste des ouvrages
La liste des livres est accessible via le menu « BibliothèK > Livres > Liste »... ou par le bouton correspondant dans la barre de menus.
Par défaut la liste sera ordonnée par auteur puis titre dans l'ordre croissant. Il est possible de redéfinir l'ordre de tri en cliquant sur les en-têtes de colonnes. Le premier clic produira un ordre croissant, un second un ordre décroissant. Il est possible de spécifier plusieurs colonnes de tri. Pour cela, cliquez sur le première colonne de tri, puis sur la seconde en maintenant la touche [Ctrl] enfoncée.
Un clic droit sur un ouvrage listé affichera un menu contextuel vous permettant d'effectuer les opérations suivantes :
- nouveau : ajout d'un nouvel ouvrage
- modifier : modifier l'ouvrage sélectionné. L'ouvrage sélectionné est celui en surbrillance
- chercher : accès au mode recherche
- supprimer : supprimer l'ouvrage sélectionné.
La liste affiche le titre de l'ouvrage, son auteur, son genre, son année, ainsi qu'une case définissant s'il est en rayon.
En utilisant le champ titre et les liste déroulantes auteur et genre, il vous est possible ici d'effectuer une recherche simple, le bouton « réinitialiser » quant à lui remet à zéro les champs de recherche et recharge la liste originale (y compris l'ordre de tri).
Ajout et modification d'ouvrages
Le mode ajout est accessible depuis le menu BibliothèK/livres/Ajouter, par le raccourci clavier Ctrl+N ou encore par le menu popup en modes liste et recherche. Le mode modification n'est accessible quant à lui que sur un clic droit sur un ouvrage en mode liste ou recherche.
- Titre : entrez ici le titre de l'ouvrage. Ce champ est obligatoire pour l'enregistrement de la fiche,
- Sous titre : l'éventuel sous titre de l'ouvrage, optionnel,
- Auteur : sélectionnez l'auteur dans la liste. Si l'auteur n'existe pas dans la liste, cliquer sur le bouton de côté vous donnera accès à la liste des auteurs, d'où vous pourrez gérer les auteurs. Une fois votre auteur ajouté, un double click sur ce dernier fermera la liste des auteurs et le sélectionnera automatiquement dans la fenêtre de l'ouvrage. Ce champ est obligatoire pour l'enregistrement de la fiche,
- Code genre : entrez directement le code correspondant au genre de l'ouvrage, ou cliquez sur le bouton (...) afin d'afficher la liste. Lorsque vous accédez à la liste, il vous est possible d'ajouter/modifier les genres ; un double click sur le genre de votre choix sélectionnera le genre pour l'ouvrage en cours d'édition et fermera la liste. Ce champ est obligatoire pour l'enregistrement de la fiche,
- ISBN : entrez ici le code ISBN de l'ouvrage. Le numéro ISBN (identifiant unique d'un ouvrage) est composé d'une série de 10 (dix) chiffres formatés de cette façon : 1-123-12345-1. L'interface formatera de la sorte les chiffres que vous entrerez dans le champ adéquat, et affichera un message en cas d'erreur (oubli d'un chiffre). Actuellement, la normalisation de l'isbn n'est pas tout à fait respectée. En effet, les trois premiers groupes de caractères sont selon cette norme de longueur variable, le logiciel ne vous les proposera qu'en longueur fixe. Ce comportement sera modifié dans une version ultérieure,
- Année de parution : entrez ici l'année de parution de l'ouvrage ou utilisez les flèches de côté pour in/de-crémenter sa valeur,
- Nombre de pages : entrez ici le nombre de pages de l'ouvrage ou utilisez les flèches de côté pour in/de-crémenter sa valeur,
- Série : entrez la série à laquelle l'ouvrage appartient,
- État : sélectionnez l'état physique de l'ouvrage. Si l'état désiré n'existe pas, le bouton de côté vous donnera accès à la gestion des états,
- Format : sélectionnez dans la liste le format d'édition de l'ouvrage. Si le format désiré n'existe pas, le bouton de côté vous donnera accès à la gestion des formats,
- Éditeur : sélectionnez dans la liste l'éditeur de l'ouvrage. Si l'éditeur désiré n'existe pas, le bouton de côté vous donnera accès à la gestion des éditeurs,
- Résumé : entrez ici le résumé de l'ouvrage,
- Mots clés : entrez ici une liste de mots clés séparés entre eux par un espace afin de faciliter vos recherches futures,
- Commentaires : éditez vos commentaires personnels sur l'ouvrage,
- Appréciation : niveau d'appréciation personnel de l'ouvrage,
- Exemplaires : nombre d'exemplaires en votre possession. Entrez directement une valeur ou utiliser les flèches de côté. Toute valeur incorrecte sera affichée en rouge. Le nombre d'exemplaires est en relation directe avec la case à cocher acquis. Si cette dernière est cochée, la valeur minimale pour les exemplaires sera fixée à 1 (un), si elle est décochée, les valeurs minimale et maximale pour le nombre d'exemplaires sera de 0 (zéro),
- En rayon : cette valeur n'est pas éditable. L'ouvrage sera considéré en rayon seulement si la différence entre le nombre d'exemplaires total et le nombre d'ouvrages déjà prêtés est supérieure à 0 (zéro),
- Acquis : spécifie si l'ouvrage est déjà en votre possession,
- Lu : avez-vous déjà lu cet ouvrage ?
- Conserver : désirez-vous conserver cet ouvrage ?
Le bouton « Okay » enregistre les données et ferme la fenêtre. Le bouton annuler (ou la touche [Echap]) ferme la fenêtre sans enregistrer les modifications.
Les champs incrémentiels (année de parution, nombre de pages et nombre d'exemplaires) n'acceptent que des nombres en entrée. Notez que toute valeur entrée invalide sera colorée en rouge. Néanmoins, en cas d'entrée invalide, la valeur par défaut serait enregistrée automatiquement, aucun message d'erreur ne sera produit. Si vous entrez directement une valeur au clavier, celle-ci sera affichée de couleur verte tant que vous n'aurez pas validé par la touche entrée.
Suppression d'un ouvrage
La suppression d'un ouvrage n'est possible que depuis le mode liste. Effectuez un clic droit sur l'ouvrage à supprimer et sélectionnez l'entrée du menu popup correspondante. Le logiciel vous demandera confirmation, puis affichera un message de résultat de l'opération.
Gestion des auteurs
Liste des auteurs
Ajout et modifications d'auteurs
Gestion des genres
Le module des genres de BibliothèK est constitué de deux valeurs : un code pouvant contenir jusque 7 caractères, et le nom du genre. Ce module est prévu pour être compatible avec la classification Dewey (et dérivés) dans la limite des 7 caractères autorisés pour le code (000.000 pour la classification Dewey, 7 caractères alphanumériques pour votre système de classement personnel). Néanmoins, la classification de Dewey est une marque déposée, elle ne peut donc être intégrée à l'application. Un module d'import sera greffé lorsque j'aurais pu obtenir de plus amples informations sur sa version informatisée.
Liste des genres
Les genres sont ici listés par code. Il vous est possible d'indiquer un code alphabétique, dans la mesure ou chaque code demeure unique. Il est possible de modifier le classement en cliquant sur l'en-tête de colonne approprié.
Vous pouvez également utiliser les champs code et genre du haut de la fenêtre pour effectuer une recherche rapide.
Ajout et modification de genres
Le mode ajout est accessible depuis le menu « BibliothèK > Genres > Ajouter ». Le mode modification est accessible depuis le menu popup du mode liste.
- code : le code qui identifiera le genre dans les ouvrages. Il est composé de 7 caractères alphanumériques au maximum. Chaque code doit être unique.
- genre : le descriptif du genre, composé au maximum de 100 caractères.
Tous les champs de ces fenêtres sont requis.
Gestion des formats
Liste des formats
Ajout et modification de formats
Gestion des états
Liste des états
Ajout et modification d'états
Gestion des éditeurs
Liste des éditeurs
Ajout et modification d'éditeurs
Prêts et emprunteurs
BibliothèK vous permet de gérer les prêts de vos livres. Ce module est composé de deux parties distinctes : la gestion des fiches emprunteurs et la gestion des ouvrages empruntés.
Gestion des emprunteurs
Selon le même modèle que les autres parties de l'application, la gestion des emprunteurs possède les modes liste, modification, ajout et suppression.
Il s'agit de simple fiches de renseignements qui pourront vous permettre de contacter les personnes qui vous empruntent des ouvrages.
- nom : nom de l'emprunteur
- prénom : prénom de l'emprunteur
- adresse : adresse postale
- code postal : code postal de résidence
- ville : ville de résidence
- téléphone : numéro de téléphone. L'entrée se fait sans espaces, l'application se chargera du formatage lors de l'affichage. Si le numéro de téléphone est incomplet, l'application produira un message
- GSM : téléphone portable. L'entrée se fait sans espaces, l'application se chargera du formatage lors de l'affichage. Si le numéro de gsm est incomplet, l'application produira un message
- E-Mail : adresse mail. Une adresse invalide (sans @ par exemple) produira un message
Les données obligatoires sont les nom, prénom et téléphone de l'emprunteur.
Gestion des prêts
Dans cette partie, vous pourrez gérer les ouvrages prêtés.
- titre emprunté : sélectionnez dans la liste le titre emprunté. Vous pouvez également utiliser le bouton où apparait un livre pour accéder à la gestion des livres, un double clic sur un titre le sélectionnera automatiquement dans la liste
- emprunteur : sélectionnez dans la liste le nom de l'emprunteur, ou utiliser le bouton où apparait une tête pour accéder à la gestion des emprunteurs, un double clic dans la liste sélectionnera automatiquement l'emprunteur
- exemplaires : nombre d'exemplaires empruntés. La valeur maximale de ce champ correspond au nombre d'exemplaires en rayon de l'ouvrage sélectionné.
La valeur entrée sera mise à jour si besoin est lorsque vous sélectionnerez un titre différent. Par exemple, si vous possédez 10 exemplaires d'un ouvrage A et 2 d'un ouvrage B ; que vous sélectionnez d'abord l'ouvrage A et attribuez la valeur 5 aux exemplaires à prêter, puis que vous sélectionnez l'ouvrage B dans la liste, la valeur du nombre d'exemplaires sera ré-attribuée à 2 (le maximum).
Dans le cas où plus aucun exemplaire du livre ne serait disponible, le champ exemplaires sera désactivé (grisé) et vous ne pourrez enregistrer le prêt. Si vous éditez manuellement le champ exemplaires (c'est-à-dire sans utiliser les flèches de côté), le texte se colore en rouge en cas d'entrée invalide (lettre, valeur supérieure au maximum, ...). Notez que dans ce cas l'application enregistrera la valeur par défaut (1) si vous validez le prêt, aucun message d'erreur ne sera affiché. - date d'emprunt : date à laquelle l'emprunt débute. Cette valeur est initialisée par défaut à la date du jour
- date de retour : date de retour programmée. Cette valeur est initialisée à 7 jours à compter de la date courante.
Utilisez le sélecteur de dates pour les dates de sortie et de retour :
Tous les champs sont obligatoires.
Notez que seuls les ouvrages marqués 'acquis' dans la gestion des livres sont présents dans la liste.
Le retour d'un livre sera affecté par la suppression de l'entrée correspondante à son prêt dans la liste.
Impressions
Bibliothèques et logiciels utilisés
Pour plus d'informations reportez-vous au code source fourni avec le logiciel et au répertoire libs pour les librairies externes.
Design
Basé sur le framework JGoodies Forms, apparence (look and feel) JGoodies Looks.
Création des différentes fenêtre à l'aide d'AbeilleForms.
Système d'aide
Basé sur JavaHelp, rédigé avec HelpSetMaker.
Relue et corrigée autant que possible ! Merci de me faire part d'éventuelles corrections qui nous auraient échappé ;-)
Fichiers XML
L'accès aux fichiers XML est basé sur la bibliothèque JDom.
Chiffrement
Les données sensibles (mots de passe) stockés dans les fichiers XML sont cryptés. Deux choix sont offerts :
- l'API de Bouncy Castle (sous réserve de l'installation de la JCE)
- le chiffrement « simple » développé par M. Thierry Selva
Stockage des données
Dans cette version, les données sont stockées dans une base de données MySQL. Un portage vers PostgreSQL et HSQLDB est prévu dans le futur.
Impressions
Les impressions sont assurées par JasperReports.
Les modèles d'impression sont générés (et peuvent être modifiés le plus simplement du monde) avec l'excellent logiciel iReport.
