# Détails de &appname;

## Types de champs

Chaque collection peut avoir un nombre illimité de champs. &appname; en gère onze types permettant une large gamme de données différentes.

### Texte simple

Le type de champ le plus basique est appelé Texte simple. Aucune restriction n'est placée sur les valeurs du champ et le composant graphique de saisie des données sert à saisir une ligne standard. Ce type est adapté aux champs ne nécessitant pas de valeurs longues, tel que l'auteur ou le genre.

### Nombre

Le type Nombre est identique au Texte simple, excepté que les données doivent être numérique. Les entrées seront triées numériquement dans la vue en colonne si une colonne de champ Nombre est sélectionnée. Un champ texte standard, avec de petits boutons en forme de flèches pour augmenter ou diminuer la valeur, est utilisé pour la saisie des données. Aucun formatage n'est appliqué.

### &URL;

Le type &URL; permet de lier vers d'autres documents, en utilisant les associations de type de fichiers standard de &kde; pour ouvrir ces documents. Aucune validation n'est faite sur la valeur d'un champ &URL; mais les liens non valables ne seront pas ouverts. La saisie de donnée se fait dans un champ texte possédant un bouton pour afficher une boîte de dialogue d'ouverture de fichiers standard mais n'importe quels &URL; peuvent être utilisés. Les &URL; relatifs sont interprétés par rapport à l'emplacement du fichier de données, une fois qu'il a été enregistré.

Dans l'éditeur d'entrée, la légende devient le lien, tandis que dans la Vue des entrées, un lien hypertexte réel est utilisé. Ce type de champ est pratique pour lier les fichiers PDF des entrées bibliographiques ou pour des critiques de films par exemple. Aucun formatage n'est appliqué.

Les &URL; relatifs peuvent aussi être utilisés. Ils sont interprétés relativement à l'emplacement du fichier de données de &appname;. Dans L'éditeur d'entrée, le champ de saisi dispose d'un complètement automatique pour les emplacements de fichiers locaux. Si vous souhaitez que l'&URL; de la boîte de dialogue du sélecteur de fichiers de &kde; soit interprété relativement à l'emplacement du document, alors une propriété du champ d'&URL; doit être définie comme relatif : true.

### Paragraphe

Pour les longs champs de texte, le type Paragraphe offre une zone texte large, toujours dans sa propre catégorie. Un champ Paragraphe ne peut pas avoir de valeurs multiples, ni être automatiquement formaté. Il ne peut pas être utilisé pour grouper. Il est conseillé de saisir les résumés, intrigues ou critiques dans ce type de champ.

### Choix

Quand un champ doit être limité à quelques valeurs prédéfinies, le type Choix est utilisé. Les valeurs acceptables sont présentées à l'aide d'un menu déroulant. Évidemment, plusieurs valeurs ne sont pas acceptées. Les champs tels que le type bibliographique ou note personnelle sont des champs de type Choix.

Les points-virgules doivent être utilisés pour séparer les valeurs autorisées.

### Case à cocher

Pour les champs qui indiquent une valeur « oui » ou « non », le type Case à cocher est disponible. Par défaut, la case n'est pas cochée. Les champs Case à cocher ne sont pas formatés et sont limités à des valeurs uniques. En interne, les valeurs de champ interprétées comme `true` (vrai) ou `false` (faux). Exemples : les champs cadeau ou prêt.

### Date

Un champ Date peut inclure un jour, un mois et une année. La date est affichée au format standard AAAA-MM-JJ, facilitant le tri. Le sélecteur de date standard de &kde; peut être utilisé pour choisir la date avec la souris ou saisie directement. Le champ ne requière une date complète ; seule l'année peut être saisie, par exemple. Les valeurs multiples ne sont pas permises.

### Tableau

Les champs Tableau contiennent une ou plusieurs colonnes de valeurs. Dans L'éditeur d'entrée, le champ est présenté en utilisant une vue en cascade, avec des lignes numérotées. Quand la dernière ligne est sélectionnée, une ligne additionnelle est ajoutée. Le complètement automatique n'est pas disponible. Ce champ est utile pour lister les chapitres d'un livre, les scènes dans un film ou les morceaux d'un album. Les champs Tableau sont toujours dans une catégorie à part.

Le nombre de colonnes, au maximum de dix, est défini en ajoutant une propriété nommée columns (colonnes) à la définition du champ. Les colonnes peuvent être intitulées par un clic-droit sur l'en-tête ou en définissant des propriétés de champ appelées columns1 (colonnes1), etc.

Quand vous utilisez L'éditeur d'entrée pour les champs Tableau, les lignes peuvent être réarrangées en glissant la souris tout en maintenant appuyée la touche &Ctrl;. Un menu contextuel permettant d'insérer ou supprimer des lignes est également disponible par un clic-droit sur le tableau.

### Image

Les champs Image contiennent une image, de n'importe quel format géré par &kde; ; plus couramment aux formats PNG ou JPEG. L'image peut être enregistrée directement dans le fichier de données de &appname; ou dans le dossier de données de l'application. Le sélecteur de fichier standard de &kde; est utilisé pour permettre la saisie d'un &URL; ou la sélection d'un fichier disponible localement. Les images peuvent être glissées depuis un gestionnaire de fichiers ou un navigateur.

### Note

Les champs Note affichent un nombre d'étoiles représentant la note numérique d'une entrée. Par défaut, la note maximum est de cinq. Les minimum et maximum peuvent être modifiée par les propriétés de définition du champ dans la boîte de dialogue des Champs de la collection, intitulée minimum et maximum, respectivement.

### Champs de valeur dérivée

Les champs utilisant des valeurs dérivées sont un cas à part. Le type de champ correspond au type de valeur habituellement renseignée dans le champ, sauf que cette valeur est construite à partir d'autres champs en utilisant un format de chaîne dans la description du champ. Par exemple, si un champ à comme valeur modèle `%{title} %{year}` (titre et année), alors la valeur de ce champ deviendra le titre, suivi de l'année. Ce type de champ est principalement utilisé pour le champ de titre des collections de pièces, timbres, cartes à échanger et vins. Le nom du champ interne ou le titre du champ peut être utilisé dans la description pour le formatage.

Pour sélectionner une seule valeur d'un champ en contenant plusieurs, ajoutez un index de position au modèle, tel que `%{author:1}` pour le premier auteur. La position peut être négative, décomptée à partir de la fin : `%{author:-1}` serait alors le dernier auteur. Des valeurs de majuscule ou minuscule peuvent être employé dans la définition du modèle, tels que `%{author:1/l}` affiche le premier auteur en minuscule ou `%{author:1/u}` en majuscule.

## Types de collection

&appname; gère douze types de collections spécifiques par défaut : livres, entrées bibliographiques, bandes dessinées, films, musiques, jeux, cartes, pièces, timbres, vins, jeux de plateau et catalogue de fichiers. En plus, un modèle de collection générique vide est disponible pour toute autre collection. Les collections par défaut intègre un ensemble générique de champs. Vous pourrez en ajouter, modifier ou supprimer pour correspondre à vos besoins. La seule condition nécessaire est qu'une collection doit toujours avoir un champ Titre pour que la Vue par groupe fonctionne correctement. Pour certains types de collection, il s'agira simplement d'un champ à valeur dérivée combinant au moins deux autres champs.

En général, il n'y pas de différences fonctionnelles entre les types de collection. Vous pouvez créer une collection personnalisée pour vos livres aussi simplement qu'en utilisant la collection de livres par défaut. Mais &appname; choisit des icônes en fonction du type de collection et il peut y avoir des fonctionnalités spécialisées propres à un type de collection. Donc, si vous le pouvez, utiliser les collections par défaut. Si vous souhaitez créer une collection de vins, mais que vous n'aimez pas les champs par défaut, créez une collection de vins par défaut et supprimez ensuite tous les champs par défaut. De cette façon, &appname; identifiera quand même une collection de vins.

Par défaut, tous les types de collection inclus un champ ID affichant le numéro d'indexation de l'entrée. En plus, à l'exception des catalogues de fichiers, chaque collection inclut des champs affichant la date à laquelle l'entrée a été créée dans la collection ainsi que la date de la dernière modification.

### Collection de livres

Les collections de livres ont vingt-six champs par défaut : Titre, Sous-titre, Auteur, Format, Date d'achat, Prix d'achat, Éditeur, Édition, Année du copyright, Année de publication, ISBN#, LCCN#, Pages, Langue, Genre, Mots clés, Série, N° dans la série, Condition, Signé, Lu, Cadeau, Prêté, Note, Couverture et Commentaires.

Le champ ISBN# est spécial puisque les numéros ISBN sont automatiquement formatés et qu'une vérification est appliquée. &appname; reconnaît le champ ISBN si son nom de champ interne est isbn. Si vous l'avez supprimé ou si vous avez besoin de l'ajouter à un autre type de collection, créez le champ avec le titre ISBN et appliquez la modification, vous pourrez ensuite revenir et modifier le titre comme bon vous semble. &appname; créé un nom interne à partir du titre initial mais ne le modifie jamais si le titre est plus tard mis à jour.

### Bibliographies

Les bibliographies ont vingt-cinq champs par défaut : Titre, Type d'entrée, Auteur, Clé BibTeX, Titre du livre, Éditeur, Organisation, Maison d'édition, ISBN#, Adresse, Édition, Pages, Année, Journal, Mois, Nombre, Mode de publication, Chapitre, Série, N° dans la série, Volume, Référence croisée, Mots clés, Résumé et Notes.

Bien que les collections bibliographiques ne soient pas liées spécifiquement à BibTeX, les champs par défauts sont ceux habituellement utilisés par BibTeX. À l'exportation en BibTeX, une propriété étendue appelée bibtex est utilisée pour chaque champ afin de définir le champ BibTeX correspondant. Si vous ajoutez un champ à une bibliographie et que vous l'exportez au format BibTeX, n'oubliez pas de définir la propriété étendue bibtex.

&appname; a des fonctionnalités spécialisées pour les bibliographies. Les macros de saisie BibTeX peuvent être ajoutées, modifiées ou supprimées depuis &appname; et l'exportation BibTeX vous donne l'option d'étendre les macros. Les citations BibTeX peuvent être envoyées vers une application externe tel que LyX ou Kile en utilisant l'option dénommée lyxpipe.

Les collections de livres peuvent être converties en bibliographies. Les champs BibTeX par défaut sont ajoutés et les propriétés étendues définies. Cette fonctionnalité existe surtout pour convertir d'anciennes collections ; avant que le type bibliographie ai été séparé des collections de livres.

### Collections de bandes dessinées

Les collections de bandes dessinées ont vingt-deux champs par défaut : Titre, Sous-titre, Scénariste, Artiste, Série, Numéro, Maison d'édition, Édition, Année de publication, Pages, Pays, Langue, Genre, Mots clés, Condition, Date d'achat, Prix d'achat, Signé, Cadeau, Prêté, Couverture et Commentaires.

### Collection de vidéos

Les collections de vidéos ont trente champs par défaut : Titre, Médium, Année de production, Certification, Genre, Région, Nationalité, Format, Distribution, Réalisateur, Producteur, Scénariste, Compositeur, Studio, Langues disponibles, Langues des sous-titres, Plages audio, Durée, Format d'image, Écran large, Format couleur, Version du réalisateur, Résumé de l'action, Note personnelle, Date d'achat, Prix d'achat, Cadeau, Prêté, Couverture et Commentaires.

Le champ Distribution est un tableau à deux colonnes et les noms des acteurs sont prévus pour être dans la première colonne, avec leurs rôles dans la deuxième. La Durée est affichée en minutes, bien que vous puissiez modifier cela.

### Collections musicales

Les collections musicales ont quinze champs par défaut : Titre, Médium, Artiste, Label, Année, Genre, Pistes, Note, Date d'achat, Prix d'achat, Cadeau, Prêté, Mots clés, Couverture et Commentaires.

### Collection de jeux

Les collections de jeux ont seize champs par défaut : Titre, Plate-forme, Genre, Année de parution, Éditeur, Développeur, Classement ESRB, Description, Note personnelle, Terminé, Date d'achat, Prix d'achat, Cadeau, Prêté, Couverture et Commentaires.

### Collection de cartes

Les collections de cartes ont dix-sept champs par défaut : Titre, Joueur, Équipe, Marque, Numéro de carte, Année, Série, Type de carte, Date d'achat, Prix d'achat, Lieu, Cadeau, Mots clés, Quantité, Image recto, Image verso et Commentaires.

### Collection de pièces

Les collections de pièces ont seize champs par défaut : Titre, Type, Dénomination, Année, Monnaie, Pays, Pièce, État de conservation, Service d'évaluation, Date d'achat, Prix d'achat, Lieu, Cadeau, Observation, Verso et Commentaires.

### Collection de timbres

Les collections de timbres ont dix-huit champs par défaut : Titre, Description, Dénomination, Pays, Année, Couleur, Scott#, État de conservation, Annulé, Articulé, Centrée, Gommé, Date d'achat, Prix d'achat, Lieu, Cadeau, Image et Commentaires.

### Collection de vins

Les collections de vins ont quinze entrées par défaut : Titre, Producteur, Appellation, Variété, Type, Pays, Date d'achat, Prix d'achat, Lieu, Quantité, Bu par, Note, Cadeau, Étiquette et Commentaires.

### Collection de jeux de plateau

Les collections de jeux de plateau ont quinze champs par défaut : Titre, Genre, Mécanisme, Année de parution, Maison d'édition, Concepteur, Nombre de joueurs, Description, Note, Date d'achat, Prix d'achat, Cadeau, Prêté, Couverture et Commentaires.

### Catalogues de fichiers

Les catalogues de fichiers ont quatorze champs par défaut : Nom, &URL;, Description, Volume, Dossier, Type MIME, Taille, Permissions, Propriétaire, Groupe, Créé le, Modifié le, Informations additionnelles et Icône.

### Collections personnalisées

Les collections personnalisées ont un champ par défaut, le Titre. Elles devraient être utilisées lorsqu'un objet à collectionner n'est pas proposé parmi les types par défaut.