Aspects
Un aspect est un groupe nommé de métadonnées, que l'on attache à des contenus ou à des objets métiers. C'est la brique de base du modèle de données de Any : toute métadonnée appartient à un aspect, et se désigne partout dans la configuration par aspect.metadata : par exemple core.name ou standard.status.
Regrouper les métadonnées par aspect permet de les réutiliser : un même aspect « contrat » peut être porté par des documents de plusieurs applications, et un contenu porte autant d'aspects que nécessaire. C'est aussi ce qui rend le modèle extensible : ajouter un aspect ajoute des métadonnées sans toucher aux contenus existants.
Les aspects sont de deux types, contenu ou case (objets métiers). Un interrupteur dans la barre de navigation permet de basculer de l'un à l'autre.
Vous pouvez créer autant d'aspects que nécessaire.
Règles à connaître avant de créer un aspect
Les noms de métadonnées ne doivent utiliser que des caractères minuscules et le trait de soulignement, et aucun espace.
Une fois qu'un module d'aspect a été enregistré, les noms des métadonnées, leurs types et leurs types de filtres ne peuvent plus être modifiés. Il faut donc les arrêter avant l'enregistrement.
Les métadonnées de type « Système » ne peuvent pas être modifiées. Seule exception : l'aspect « User », auquel il est possible d'ajouter des métadonnées métiers, mais pas d'en supprimer. Ces métadonnées ajoutées sont visibles dans l'onglet « Métadonnées » de la fiche utilisateur, dans le module Utilisateurs de la partie administration.
Lier des contenus et des objets métiers
- Pour lier un contenu à un objet métier : lui attribuer une métadonnée de type « Data Object » et lui associer un data object. Sélectionner dans la colonne « Valeur affichée » la métadonnée qui identifie les objets.
- Pour lier un objet métier à un autre objet métier : lui attribuer une métadonnée de type « Data Object » et lui associer un objet métier.
- Pour lier des contenus à un objet métier : lui attribuer une métadonnée de type contenu, qui permettra de lui associer des contenus de la base documentaire.
Un objet métier peut également porter des pièces jointes. Contrairement aux contenus liés, celles-ci ne sont pas stockées dans la base documentaire : elles sont supprimées en même temps que l'objet.
Options d'une métadonnée
Nom : nom de la métadonnée
Type : Booléen, Data Object, Date, Date et heure, Nombre (décimal ou entier), Texte, URL, ou Utilisateur / Groupe
Data Object : data object visé, pour une métadonnée de type Data Object
Libellé : libellé dans les différentes langues, saisi en cliquant sur l'icône du globe
Valeur multiple : indique si la métadonnée accepte une ou plusieurs valeurs
Contrainte de valeur : voir Contrainte de valeur
Messages de validation : message affiché si la contrainte n'est pas respectée
Description : description de la métadonnée dans toutes les langues
Liste de données : liste de données utilisée pour proposer les valeurs de la métadonnée
Valeur stockée : valeur qui sera stockée lors de l'enregistrement
Valeur affichée : valeur qui sera affichée dans les listes et les boîtes de dialogue de propriétés
Contrainte de valeur
Une contrainte de valeur restreint ce que l'utilisateur peut saisir, au moyen d'une expression régulière (pattern) à laquelle la valeur doit correspondre. Si la valeur ne correspond pas, le message de validation est affiché.
Jetons utilisables :
| Jeton | Correspond à |
|---|---|
\d | Tout chiffre |
\D | Tout caractère qui n'est pas un chiffre |
\w | Tout caractère de mot (lettre, chiffre ou tiret bas) |
\W | Tout caractère qui n'est pas un caractère de mot |
\s | Tout caractère d'espacement |
\S | Tout caractère qui n'est pas un espacement |
[a-z] | Un caractère compris dans la plage a-z |
[^a-z] | Un caractère non compris dans la plage a-z |
b{4} | Exactement 4 caractères « b » |
b{3,} | 3 caractères « b » ou plus |
b{3,6} | Entre 3 et 6 caractères « b » |
. | Un caractère quelconque |
? | 0 ou 1 occurrence de l'élément précédent |
* | 0 occurrence ou plus de l'élément précédent |
+ | 1 occurrence ou plus de l'élément précédent |
^ | Début de chaîne |
$ | Fin de chaîne |
\\ | Échappe un caractère spécial |
Par exemple, \$\d{1,3} impose un montant en dollars compris entre 0 $ et 999 $.
Pour les combinaisons avancées, se reporter à une documentation d'expressions régulières JavaScript.
Données à caractère personnel
Pour désigner des utilisateurs ou des groupes, utiliser une métadonnée de type Utilisateur / Groupe : elle réduit l'exposition des données personnelles.
Une telle métadonnée ne conserve que le login de l'utilisateur, et n'indexe que ce login dans la recherche full-text : le nom complet n'est jamais indexé. En contrepartie, dans la configuration des formulaires, ces métadonnées sont prises en charge directement : il n'est pas possible de leur associer une liste de données, ni de choisir la métadonnée utilisateur qui sera stockée.
Le filtrage par facette reste possible : le nom de l'utilisateur est résolu à la volée lors de l'affichage.
Du point de vue de l'utilisateur, le login n'est jamais affiché : seul le nom complet apparaît, aussi bien dans les métadonnées que dans les créateurs des audits.