Différence entre « nom » et « intitulé » et règle de rédaction des noms

Nom et intitulé sont deux façons différentes de désigner des éléments comme le corpus, les thésaurus, les sphères ou les champs d’un corpus.

Le nom correspond au « nom technique » de l’élément, il est attribué à la création de l’élément et ne peut plus être changé par la suite ; c’est le nom qui est utilisé par le logiciel pour manipuler l’élément, il répond à un certain nombre de contraintes afin de faciliter son traitement par des programmes informatiques. Ce nom est également utilisé dans certaines interfaces d’administration pour manipuler l’élément (par exemple, dans les interfaces qui permettent de changer l’ordre des éléments).

L’intitulé désigne l’élément pour l’utilisateur normal, c’est lui qui apparaît dans les différentes interfaces du logiciel. Il est complètement libre et peut être modifié n’importe quand, même bien après la création de l’élément et sans risque pour la cohérence des données et dans le cas de bases multilingues, un intitulé doit être défini pour chaque langue de travail.

Pour résumer, l’utilisateur normal ne connaît que les intitulés, la machine, elle, ne connaît que les noms et l’administrateur d’une base manipule les deux.

Contrainte sur le nom

Afin de faciliter les traitements informatiques, les noms ne peuvent comprendre que les minuscules de a à z ainsi que les chiffres de 0 à 9 (un nom ne peut cependant pas commencer par un chiffre). Masjucules et caractères accentués sont interdits, idem pour l’espace et tous les symboles + , = , - , etc.

Le trait de soulignement « _ » est parfois autorisé, parfois interdit (il est de toute façon interdit en début du nom). Il est interdit pour :

Dans les autres cas (comme le nom de la base), il est autoriés.

Il y a interdiction lorsque les noms sont susceptibles d’être précédés d’un préfixe indiquant la nature de l’élément (par exemple, « corpus_ » pour les corpus, « thesaurus_ » pour les thésaurus). Le corpus « suivi » est ainsi souvent désigné par « corpus_suivi » . Ce préfixe permet de distinguer les homonymes. En effet, des éléments de nature différentes peuvent avoir le même nom : deux corpus ont des toujours des noms différents, alors qu’un corpus et un thésaurus peuvent avoir le même nom.

Un nom doit comporter plus d’un caractère et moins de trente.

Rappel : le nom est attributé à la création de l’élément et ne peut pas être modifié par la suite (sauf à plonger dans les fichiers de configuration).

Quelques règles de rédaction des noms

Les noms ne sont pas seulement utilisé par la machine, ils apparaissent tels quels dans de nombreuses interfaces d’administration et ce sont eux qui sont manipulés par le développeur XSLT (celui qui fait les modèles de passage des données à des pages HTML). Il est donc utile de suivre quelques règles dans la rédaction des noms qui faciliteront le travail par la suite :

Les points précédents sont de simples recommadations. Chacun est libre de fixer sa propre convention de nommage (de la même manière, que chaque développeur informatique suit ses propres règles pour les noms des variables). Il est simplement recommandé de maintenir une cohérence d’ensemble pour les différents noms des éléments d’une base de fiches afin d’en faciliter la maintenance.