Aller au contenu principal
Version: Any 26

Formulaires

Ce module permet de concevoir les formulaires par lesquels l'utilisateur voit et saisit les métadonnées : boîtes de dialogue de métadonnées, formulaires de recherche, pages de signature.

Un formulaire décide quelles métadonnées sont présentées, dans quel ordre, sous quelle forme de saisie, et à quelles conditions chacune est obligatoire, grisée ou masquée. Le même jeu de métadonnées peut donc être présenté différemment selon le moment : un formulaire de création court, un formulaire de consultation complet, un formulaire de recherche.

Les formulaires s'appliquent aux contenus comme aux objets métiers (Case) : un interrupteur dans la barre de navigation permet de passer de l'un à l'autre. Plusieurs formulaires peuvent être créés.

Il se conçoit par glisser-déposer d'éléments, chaque élément ayant sa propre configuration.

Usages​

Les formulaires sont classés par usage. L'usage définit dans quel cas le formulaire est utilisé :

Métadonnées : formulaire standard, utilisé pour afficher les métadonnées d'un contenu ou d'un objet métier
Recherche : formulaire de recherche, affiché à l'entrée dans une room ou pour rechercher un objet métier
Mise à jour multiple (contenu uniquement) : utilisé pour la mise à jour en masse de contenus
Signature : utilisé comme page de signature
Extensions : formulaire mis à disposition des extensions

Composants de disposition​

Les composants de disposition définissent la structure du formulaire.

Rubrique : rassemble des métadonnées dans une page en masquant celles des autres rubriques, à la manière d'un système d'onglets. Elles permettent de n'afficher qu'un petit nombre de métadonnées dans un formulaire qui en comprend beaucoup, pour un affichage plus rapide. L'affichage d'une nouvelle rubrique déclenche le chargement de ses métadonnées. En raison de cette nature asynchrone, les rubriques ne sont pas utilisables en mode hors ligne.

Section : regroupe des éléments sous un libellé affiché en haut de la section. Une fois créée, il est possible d'y glisser-déposer des éléments.

Grille : affiche des propriétés répétitives dans une grille.
Espace réservé : insère un élément vide pour réserver l'espace.
Information : affiche un texte d'information ou d'aide.
Séparateur : insère un séparateur.

Composants réservés au formulaire de recherche​

Ces trois composants ne sont disponibles que pour les formulaires dont l'usage est Recherche.

En-tête : paramètres de l'en-tête
Pied de page : paramètres du pied de page
Arrière-plan : paramètres de l'arrière-plan

Champs​

Les champs affichent soit des métadonnées, stockées dans le document, soit des clés, qui ne le sont pas.

Une clé n'est pas rattachée à un aspect et n'est pas sauvegardée dans les métadonnées du document : elle ne vit que le temps du formulaire, ce qui convient à une saisie de travail comme un mot de passe de signature ou une intention. Elle est automatiquement préfixée par key..

Options d'affichage​

Tous les composants de saisie comportent un encadré « Options d'affichage » qui met en forme le texte affiché : taille de police, couleur et épaisseur (light, normal, bold). Par défaut, la zone est en 14 px, sans couleur (ou noir), en normal.

Ces styles sont gérés par chaque composant lui-même. Ils s'appliquent donc dans tous les formulaires (création, import, métadonnées, signature) et aussi bien en visualisation qu'en édition.

Les listes doubles disposent d'un paramètre supplémentaire, qui définit la taille de la boîte de dialogue affichée (petite, moyenne ou grande).

Types de champs​

Libellé :

Affiche une métadonnée sous forme de libellé, non modifiable.

Saisie :

Affiche une métadonnée sous forme de texte d'entrée. Trois options sont disponibles :

  • Ligne unique (qui peut être définie comme entrée de mot de passe)
  • Zone de texte (dont le nombre de lignes peut être défini)
  • URL

Mot de passe : masque les caractères saisis.
Toujours afficher en mode lecture : affiche le champ en lecture seule. Sans cette option, un champ dont la valeur est vide n'est pas affiché.
Longueur minimale et longueur maximale du texte saisi.
Contrainte de valeur : voir Contrainte de valeur.

Liste :

Multiple : autorise la sélection de plusieurs valeurs.
Mode d'affichage :

  • Liste synchrone : toutes les valeurs sont affichées dans une liste déroulante
  • Liste asynchrone : toutes les valeurs sont affichées en mode asynchrone dans une liste déroulante
  • Double liste : toutes les valeurs sont affichées dans une liste et peuvent être sélectionnées dans une autre
  • Liste des cases à cocher : toutes les valeurs sont affichées dans une liste et sélectionnées par des cases à cocher

Contrainte de valeur : voir Contrainte de valeur.
Toujours afficher en mode lecture : la métadonnée n'est pas modifiable.

Sélecteur de date :

Affiche un sélecteur de dates. Cocher la case « inclure l'heure » pour définir également l'heure. Une date minimale et une date maximale peuvent être fixées.

Case à cocher :

Affiche les valeurs sous forme de cases à cocher ou de commutateurs.

Sélecteur de Data Object :

Lie un contenu à un objet métier. Un clic sur cet objet métier ouvre la page correspondante.

URL :

Affiche une URL. Un clic ouvre le lien correspondant. Ce composant n'accepte que des métadonnées de type URL (définies dans le module Aspects) et n'est disponible que pour les formulaires de métadonnées, de contenu ou de Case : les autres usages, comme la mise à jour multiple, ne le proposent pas. Il peut être placé dans une grille.

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 validité est affiché et le formulaire ne peut pas être enregistré.

Jetons utilisables :

JetonCorrespond à
\dTout chiffre
\DTout caractère qui n'est pas un chiffre
\wTout caractère de mot (lettre, chiffre ou tiret bas)
\WTout caractère qui n'est pas un caractère de mot
\sTout caractère d'espacement
\STout 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.

Message de validité : message affiché lorsque la contrainte n'est pas respectée.

Contrôle des données​

Le contrôle des données définit les valeurs proposées par le champ.

Remplacer les valeurs : écrase la liste de données configurée dans l'aspect
Type de source : liste de données, ou liste d'utilisateurs et de groupes
Liste de données : liste de données créée dans le module Listes de données
Valeur stockée : valeur de ligne qui sera stockée
Valeur d'affichage : valeur de ligne qui sera affichée dans l'interface
Utilisateurs / groupes : indique si le champ proposera les utilisateurs, les groupes, ou les deux
Restreindre les membres à un groupe : limite la liste aux membres du groupe saisi
Filtrer les données : filtre la liste par un ou plusieurs prédicats listés dans le tableau

  • Colonne : colonne utilisée pour filtrer la liste.
  • Valeur : prédicat de filtrage. Si une colonne contient un nom de groupe, saisir ${user.groups} dans la colonne « valeur » ne proposera les valeurs qu'aux utilisateurs membres de ce groupe : ce joker récupère la liste des groupes de l'utilisateur.

Autoriser une nouvelle valeur : permet à l'utilisateur de saisir une valeur absente de la liste.
Métadonnées suivantes : métadonnées suivantes de la taxonomie.
Réinitialiser les champs lors de la modification : réinitialise les champs sélectionnés lorsque le champ courant est modifié.
Valeur par défaut : valeur appliquée uniquement lorsque le modèle utilisé pour la création ou l'importation ne définit aucune valeur.

Contrôle grille​

Cette section n'est disponible que si le champ est placé dans une grille. Elle définit la largeur de la cellule.

Conditions avancées​

Chaque champ peut être soumis à des conditions, pour trois comportements :

Requis : champ obligatoire : le formulaire ne peut pas être enregistré avec une valeur vide.
Désactivé : champ en lecture seule.
Caché : champ masqué.

Pour chacun, deux options sont disponibles :

Mode boîte de dialogue :

  • Créer : appliqué dans le processus de création
  • Modifier : appliqué en mode d'édition des métadonnées
  • Importer : appliqué dans le processus d'importation

Condition de script Java : condition exprimée dans un script Java.

Flux​

Ce module peut être utilisé dans les flux suivants :