Sauf pour les simples items, une donnée est toujours composée de plusieurs éléments. Par exemple, ce qu’on appelle dans le logiciel « mot-clé » est en fait l’association d’un identifiant numérique, de libellés dans les différentes langues d’un thésaurus et, éventuellement, d’un identifiant alphanumérique. Autre exemple, un pays peut être représenté par son code ISO ou par son libellé dans n’importe quelle langue.
Lorsque l’on formate une donnée, on ne veut souvent n’en retenir que certains éléments, en fonction de la destination finale l’exportation. Si l’exportation va subir par la suite des traitements informatiques, on va privilégier les codes (code ISO d’un pays, identifiant alphanumérique d’un mot-clé. Si, en revanche, la donnée est destinée à un affichage pour un lecteur humain, on va privilégier les libelles compréhensibles par tous.
La sélection des éléments que l’on veut conserver pour une donnée précise se fait à l’aide de variables. Les variables disponibles diffèrent évidemment suivant le type de données ; elles sont décrites ci-après.
Certains types de données proposent également des variables spéciales qui correspondent à des formatages particuliers. Ainsi le type de données personne propose-t-il des formatages qui mettent le nom automatiquement en majuscules, fait précéder ou non le nom devant le prénom, etc.
Enfin, il est indiqué pour chaque type de donnée la règle appliquée par défaut quand aucune règle n’est précisée.
Variables pour les items de fiches
Variable pour un simple item (type item)
{value} : valeur du simple item
Règle par défaut :
{value}
Variables pour une personne (type personne)
{nom} : Nom de la personne
{prenom} : Prénom de la personne
{original} : Nom en version originale
{nomavant} : valeur 1 si le nom doit être placé avant le prénom, 0 sinon.
{organisme} : Organisme de la personne
{idsphere} : identifiant de la personne
{sphere} : sphère de la personne
Variables spéciales :
{normal} : le prénom est suivi du nom séparé par espace (ou l’inverse si le nom est placé avant), si le nom en version originale existe, le nom et le prénom en caractères latins sont mis entre parenthèses
{annu} : Nom suivi du prénom, le nom en version originale en parenthèse
{annu_up} : Nom en majuscule suivi du prénom, le nom en version originale en parenthèse
{biblio} : Nom suivi du prénom séparé par une virgule le nom en version originale en parenthèse
{biblio_up} : Nom en majuscule suivi du prénom séparé par une virgule le nom en version originale en parenthèse
{nom_up} : Nom de la personne en majuscule
{code} : L’identifiant de la personne si elle est dans une sphère, son nom normal sinon
Règle par défaut :
{normal}
Variables pour une langue (type langue)
{code} : code ISO de la langue
{lib=code de langue} : libellé de la langue dans la langue indiquée ; si la langue n’est pas indiquée, c’est le libellé dans la langue de l’utilisateur ou, à défaut, dans celle du système
Règle par défaut :
{code}
Variables pour un pays (type pays)
{code} : code ISO du pays
{lib=code de langue} : libellé du pays dans la langue indiquée ; si la langue n’est pas indiquée, c’est le libellé dans la langue de l’utilisateur ou, à défaut, dans celle du système
Règle par défaut :
{code}
Variables pour une datation (type datation)
{a} : année de la datation sur quatre chiffres
{code} : code de la datation
{lib=code de langue} : libellé de la datation dans la langue indiquée ; si la langue n’est pas indiquée, c’est le libellé dans la langue de l’utilisateur ou, à défaut, dans celle du système
Variables spéciales :
{a-m} : année sur quatre chiffres suivi du mois sur deux chiffres, lorsque la datation couvre une période supérieure à un mois (une année, un trimestre, un semestre), c’est le premier mois de la période qui est pris comme valeur,
{a-m_last} : identique au précédent, sauf que lorsque la période est supérieur à un mois, c’est le dernier mois de la période qui est pris en compte
{iso} : datation au format ISO : année (sur quatre chiffres)-mois (sur deux chiffres) - jour ; lorsqu’une datation ne comprend pas le jour (datation au mois, au trimestre, à l’année), le jour est fixé au premier de la période considérée ; pour transformer une datation en date, il est nécessaire de la mettre au format ISO.
{iso_last} : identique au précédent sauf que si la datation ne comprend pas le jour, c’est le dernier jour de la période considérée qui est prise en compte
{libèm=code de langue} : libellé de la datation limitée au mois (la date du jour n’est pas incluse) dans la langue indiquée ; si la langue n’est pas indiquée, c’est le libellé dans la langue de l’utilisateur ou, à défaut, dans celle du système
Règle par défaut :
{code}
Variables pour une adresse de courriel (type courriel)
{value} : adresse complète (Toto <toto@exemple.com>
{addr} : adresse brut (toto@exemple.com)
{name} : nom d’envoi (Toto)
Règle par défaut :
{addr}
Variables pour des données textuelles (type para)
{raw} : texte brut sans mise en forme
Règle par défaut :
{raw}
Variables pour une image (type image)
{src} : Source de l’image
{alt} : texte alternatif si l’image ne peut être affichée
{title} : titre de l’image
Règle par défaut :
{src}
Variables pour un lien (type link)
{href} : URL du lien
{title} : titre du lien
{comment} : commentaire sur le lien
Règle par défaut :
{href}
Variables pour un nombre (type nombre)
{code} : le nombre au format informatique (tous les chiffres collés, le point comme séparateur des décimales)
{lib=code de langue} : libellé du nombre dans la langue indiquée (c’est à dire en utilisant le séparateur des décimales et le séparateur des milliers utilisés dans la langue); si la langue n’est pas indiquée, c’est le libellé dans la langue de l’utilisateur ou, à défaut, dans celle du système
Règle par défaut :
{value}
Variables pour un montant (type montant)
{code} : le montant au format informatique (tous les chiffres collés, le point comme séparateur des décimales, le code ISO qui suit séparé par un espace)
{lib=code de langue} : libellé du montant dans la langue indiquée (c’est à dire en utilisant le séparateur des décimales et le séparateur des milliers utilisés dans la langue) ; dans la mesure du possible, le code ISO sera remplacé par le symbole de la monnaire; si la langue n’est pas indiquée, c’est le libellé dans la langue de l’utilisateur ou, à défaut, dans celle du système
{value} : valeur du montant sans indication de la monnaie
{cur} : code ISO de la monnaie
Règle par défaut :
{code}
Autres types de données
Variables pour la langue d’une fiche
La langue d’une fiche (champ lang) est traité exactement comme un item de fiche de type langue.
Variables pour un mot-clé
{idths} : identifiant numérique du mot-clé
{idalpha} : identifiant alphanumérique du mot-clé (une chaine vide si le mot-clé n’en possède pas)
{lib=code de langue} : libellé du mot-clé dans la langue indiquée ; si la langue n’est pas indiquée, c’est le libellé dans la langue de l’utilisateur ou le libellé par défaut
{thesaurus} : nom technique du thésaurus
{poids} : poids du mot-clé, n’est pertinent que si le mot-clé est utilisé dans le cadre d’une indexation
{pos_loc} : position locale du mot-clé, c’est à dire position du mot-clé dans la liste des enfants de son parent (ou dans la liste des mots-clés de niveau 1 si le mot-clé n’a pas de parent) ; commence à partir de 1
{pos_glob} : position globale du mot-clé dans le thésaurus, cette position est exprimée sous la forme d’une chaine concaténant les positions des ancêtres du mot-clé
{parent_idths} : identifiant numérique du parent du mot-clé (une chaine vide s’il n’y a pas de parent)
{parent_idalpha} : identifiant alphanumérique du parent du mot-clé (une chaine vide s’il n’y a pas de parent)
Variables spéciales :
{plus_poids} : poids présenté sous la forme de saisie avec des + : chaine vide si le poids est égal à 1, signe plus suivi du poids moins 1 sinon (exemple : +1 pour un poids 2) ;
{saisie_poids} : poids présenté sous la forme de saisie avec des chevrons : chaine vide si le poids est égal à 1, espace, chevron gauche, poids, chevron droit sinon (exemple : <2>)
Règle par défaut :
si le thésaurus est avec identifiant alphanumérique :
{idalpha} – {lib}
sinon :
{lib}
Variables pour une fiche liée
{idcorpus} : identifiant numérique de la fiche
{titre} : titre de la fiche
{corpus} : nom technique du corpus de la fiche
{poids} : poids de la fiche, n’est pertinent que si la fiche est utilisée dans le cadre d’un liage
Variables spéciales :
{plus_poids} : chaine vide si le poids est égal à 1, signe plus suivi du poids moins 1 sinon (exemple : +1 pour un poids 2) ; c’est sous cette forme qu’est exprimé le poids dans l’interface de saisie du logiciel
Règle par défaut :
{titre}
Variables pour un document associé
{basename} : nom de base du document (i.e. nom du document sans les extensions)
{extensions} : extensions disponibles pour le document, chaque extension est précédée d’un point, s’il y a plusieurs extensions, elles sont entre crochets (exemple : rapport[.odt][.pdf])
Règle par défaut :
{basename}{extension}
Variables pour les éléments de chronologie
Les éléments de chronologie (date de création (date_creation), date de dernière modification (date_modification) sont traités exactement comme des items de fiche de type datation.
Données sans possibilité de formatage
Les champs idcorpus,titre et soustitre ainsi que tous les champs de texte n’ont pas de variables de formatage. Leurs valeurs sont toutes transmises telles quelles.