Création de modèles personnalisés

Si aucuns des types de collections présents dans GCstar ne répond à vos besoins, vous pouvez créer un type personnel avec les informations dont vous avez besoin. Cette page explique comment cela doit être fait.

La première action est de créer une nouvelle collection en utilisant l’élément Nouveau du menu Fichier. Une fenêtre comme-ceci s’affichera alors :

On y trouve tous les types qui ont été créés précédemment (comme expliqué plus bas) et ceux par défaut qui sont fournis avec GCstar. Ce qui est important pour l’instant est le premier élément : Nouveau type de collection. Il faut le sélectionner pour commencer la création de la collection d’un type personnel. Cela provoquera l’affichage d’une fenêtre permettant de contrôler comment sera la collection (son modèle). Les fonctionnalités présentes dans cette fenêtre sont détaillées dans les sections suivantes. Elle aura cet aspect :

Le premier des champs dans la fenêtre précédente est utilisé pour donner un nom au type de collection. Il y a deux possibilités selon ce que vous comptez faire par la suite.

Si vous voulez utiliser tous les réglages effectués ici pour une seule collection, il n’y a pas besoin d’entrer un nom. Alors tout ce qui aura été fait ici (comme la liste des champs à utiliser et les diverses options) sera enregistré dans la collection elle-même.

Si en revanche vous pensez créer plusieurs collections basées sur la même définition, vous devez entrer quelque chose ici. C’est ce nom qui apparaîtra plus tard dans la fenêtre de selection du type de collection vue en début de page. Il sera placé dans la rubrique Types personnels.

Sur des systèmes Unix (ce qui inclut GNU/Linux) le modèle qui a été ainsi créé dans le deuxième cas sera enregistré dans un fichier .gcm qui sera dans ce répertoire : ${XDG_DATA_HOME}/gcstar/GCModels/. La valeur par défaut pour XDG_DATA_HOME est ~/.local/share. Le nom de fichier est généré à partir du nom indiqué (avec certains caractères remplacés pour éviter des problèmes).

Sur les systèmes Win32, le répertoire où il est enregistré sera de cette forme : \\Répertoire_d_installation\\data\\GCModels.

Le premier onglet de la fenêtre des réglages a cet aspect :

Sur la gauche se trouve la liste des champs qui doivent être dans la collection. Vous pouvez en ajouter ou supprimer à l’aide des boutons se trouvant sous la liste. Les flèches à droite permettent de changer leur ordre. Cet ordre a son importance car il change la manière dont ils seront affichés. Cliquer sur un champs dans la liste affiche ses informations dans la partie droite de l’onglet. Voici une description des différents réglages disponible pour chaque champs.

En premier vient le Nom. Il sera affiché dans GCstar tel qu’indiqué ici. Juste après on trouve l’information sur le type de champ à utiliser. Selon ce type d’autre réglages seront disponibles ou non (auquel cas ils seront grisés). Le type peut être un de ceux-ci :

Texte court

Une ligne de texte simple.

Texte long

Un texte sur plusieurs lignes.

Oui/Non

Une valeur à 2 choix représentée par une case à cocher.

Nombre

Une valeur numérique. Si le minimum et le maximum sont spécifiés il y aura des boutons fléchés pour changer la valeur.

Date

Un champ pour une date avec un bouton pour la sélectionner au moyen d’un calendrier.

Liste de valeurs prédéfinies

Une liste contenant des valeurs définies plus bas dans cette même boîte de dialogue.

Image

Une image qui peut être changée au moyen d’un explorateur de fichiers ou affichée en taille réelle.

Liste simple

Une liste de valeurs qui pourront être changées lors de l’utilisation.

Fichier

Un ficher qui peut être changé grâce à un explorateur de fichiers. Selon son type (indiqué plus bas), il aura un bouton Lecture associé qui lancera le logiciel adéquat.

Dépendant d'autres champs

Champ texte court dont certaines parties seront remplacées par le contenu d’autres champs. Utiliser le format %Nom d’un champ% dans la valeur par défaut.

On trouve après le type, le groupe. Cela permet de regrouper les champs par catégories. Visuellement, cela se traduira par plusieurs onglets, chacun contenant tous les champs qui sont dans ce groupe. La valeur entrée ici sera utilisée pour le titre de l’onglet. Un groupe par défaut est créé pour tous les champs qui n’en ont pas. Si tous les champs sont dans le même groupe, il n’y aura pas d’utilisation d’onglets.

Les sections suivantes de cet onglet concernent certains réglages pour les champs. Ils peuvent ne s’appliquer qu’à certains types de champs.

Garder un historique

Cela s’applique aux types Texte court et Liste simple. Si la case est cochée, une liste de toutes les valeurs utilisées pour ce champ dans la collection sera disponible.

Format du fichier

Cela s’applique au type Fichier. Comme vu précédemment, cela détermine l’action pour le bouton Lecture associé au champ. Si la valeur ici est Simple fichier, il n’y aura pas de bouton Lecture.

Défaut

Cela s’applique à tous les types de champ. C’est la valeur à utiliser par défaut quand un nouvel élément est créé.

Minimum et Maximum

Cela s’applique au type Nombre. S’il n’y a pas de valeurs ici, le nombre sera représenté comme un texte court dans lequel uniquement des chiffres pourront être saisis.

Valeur d'incrément

Cela s’applique au type Nombre. Quand des valeurs minimale et maximale (voir ci-dessus) sont utilisées, des boutons vont être présents pour incrémenter ou décrémenter la valeur. La valeur entrée ici détermine le pas pour chaque appui sur un bouton (la valeur par défaut est 1).

Liste des valeurs

Cela s’applique au type Liste de valeurs prédéfinies. Il devrait y avoir là la liste des valeur à utiliser dans la liste, séparées par des virgules.

L’onglet contenant les options a cet aspect :

Le premier groupe d’options est pour choisir lesquels des champs précédents seront utilisés pour certaines fonctionnalités. Il est possibile de mettre la valeur spéciale Automatique à chaque fois. Dans ce cas, GCstar essayera de trouver un champ adéquat pour cette utilisation, cela sera détaillé pour chaque cas.

En tant que titre

C’est le champ à utiliser pour représenter le membre d’une collection dans la liste en mode texte. Si la valeur ici est Automatique, GCstar utilisera le premier champ disponible.

En tant que couverture

C’est le champ à utiliser pour représenter le membre d’une collection dans la liste en mode image. Si la valeur ici est Automatique, GCstar utilisera le premier champ disponible de type image.

En tant qu'identifiant

Le champ indiqué ici doit permettre d’indentifier de manière unique un élément d’une collection. Si la valeur ici est Automatique, GCstar ajoutera un champ caché dans la collection dans ce but. Il sera gérée de manière interne.

Il y a aussi une case à cocher dans cet onglet. Si elle est activée, GCstar ajoutera des champs à votre modèle. Ils permettront de gérer les emprunts des éléments. Consulter Gestion des emprunts pour plus d’informations.

Pour chaque champ défini, il est possible d’avoir un filtre. Un tel filtre sera présent dans la fenêtre de recherche et sera utilisé pour trouver les éléments qui correspondent à certains critères.

Pour chaque champ la première case à cocher détermine si le filtre doit être présent ou non dans la fenêtre de recherche. Ensuite vient une liste de valeurs pour déterminer comment les comparaisons doivent être réalisées. Pour certains champs il est aussi possible de préciser si la comparaison doit être faite en mode numérique au moyen d’une case à cocher. Le comportement par défaut est de faire les comparaisons selon l’ordre lexicographique.

La dernière option de cet onglet est pour la création d’un filtre rapide. Si elle est cochée, il y aura un nouveau sous-menu dans le menu Filtres. C’est utile pour appliquer rapidement un filtre sans lancer une recherche.