Chapitre 3. Détails de Tellico

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.

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é.

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 Tellico. 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.

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.

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.

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.

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.

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.

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 Tellico 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.

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.

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.