Formulaires de saisie
Un formulaire de saisie est une version simplifiée de l'éditeur de facture : pour chaque section et chaque champ, il décide si le champ est affiché, en lecture seule ou masqué, lui donne une valeur par défaut et peut le rendre obligatoire. Les formulaires s'accordent par rôle : un service client saisit ses factures sur un formulaire court tandis que la comptabilité garde l'éditeur complet.
Accès : Paramètres → Add entry form ; les formulaires figurent sous Views & UI en Entry form: nom. L'éditeur reste en anglais, à l'exception des noms de sections et de champs, qui suivent la langue de l'éditeur de facture.
Vue d'ensemble
Création d'un formulaire
Add entry form demande un nom et une description ; le formulaire est enregistré sous entry-form-<nom>. Un nouveau formulaire reprend l'éditeur entier — toutes les sections et tous les champs affichés — et Copy duplique un formulaire existant.
| Champ | Description |
|---|---|
| Label (English) · Label (French) | Nom affiché dans le sélecteur de l'éditeur, dans la langue de l'utilisateur (anglais à défaut de libellé français). |
| Preview | Ouvre l'éditeur de facture sur le formulaire en l'état, avec l'enregistrement désactivé. |
Sections et champs
Une carte par section de l'éditeur de facture : en-tête, client, livraison, paiement, lignes… Chaque carte indique champs affichés/total, une case Shown pour masquer toute la section, Folded when the editor opens, et Show all / Hide all. Clés du Document et Lignes de Facture sont Always shown ; Récapitulatif TVA et Totaux sont calculés.
| Colonne | Description |
|---|---|
| In the form | Shown (affiché), Read-only (grisé, sans saisie) ou Hidden (masqué). Un champ masqué garde sa valeur et s'enregistre avec la facture : un formulaire simple ne fait jamais perdre les données d'une facture riche. |
| Required | L'enregistrement est refusé tant que le champ est vide — Obligatoire : … — pour les champs à valeur unique ; un champ de ligne est obligatoire sur chaque ligne. |
| Default value | Valeur d'une nouvelle facture (et de chaque nouvelle ligne pour les champs de ligne). Un champ de liste prend une valeur de sa liste ; une date accepte today, today+N, today-N ou une date. |
Une section ou un champ ajouté à l'éditeur après l'enregistrement du formulaire porte l'étiquette new ; tant que le formulaire n'est pas enregistré de nouveau, il est considéré comme masqué.
Alertes
- Sous un champ : Required, but the user cannot fill it and it has no default. — obligatoire, non affiché, sans valeur par défaut.
- En haut : Required by the rule set …, but not editable in this form and without a value: Section › Champ, … Show the field or give it a default, or the invoice fails validation. Le contrôle s'appuie sur le jeu de règles par défaut : chaque terme métier qu'il exige doit être affiché ou avoir une valeur.
Dans l'éditeur de facture
- L'éditeur s'ouvre sur le formulaire par défaut du rôle. Avec plusieurs formulaires accordés, un sélecteur dans son en-tête change de formulaire ; la saisie en cours est conservée et seuls les champs vides prennent les valeurs par défaut du nouveau formulaire.
- Les valeurs par défaut s'appliquent à une nouvelle facture et à chaque nouvelle ligne. L'ouverture d'une facture existante (modification, copie) conserve ses valeurs.
- Le contrôle des champs obligatoires s'ajoute à la validation XSD et Schematron, sans la remplacer. Un formulaire est une commodité de l'éditeur, pas une règle de sécurité : le serveur enregistre les champs masqués comme les autres.
Accès
Dans l'éditeur de rôles, onglet Actions, le bloc Formulaires de saisie des factures liste Complet (l'éditeur entier) et chaque formulaire. Cocher les formulaires que le rôle peut utiliser ; s'il y en a plusieurs, S'ouvre sur choisit celui sur lequel l'éditeur s'ouvre. Un rôle sans formulaire coché garde l'éditeur complet.
Les formulaires passent d'un environnement à l'autre par promotion (type Formulaire de saisie) ; les droits des rôles restent propres à chaque environnement.
Conseils & bonnes pratiques
- Partir des champs que l'équipe saisit réellement. Masquer le reste plutôt que le supprimer : les valeurs masquées restent sur la facture.
- Donner une valeur par défaut aux valeurs constantes et les verrouiller. Une devise, un moyen de paiement ou un profil en lecture seule avec une valeur par défaut évite les erreurs de saisie.
- Lever chaque alerte du jeu de règles avant d'accorder le formulaire. Un terme obligatoire que l'utilisateur ne peut pas renseigner produit des factures en échec de validation.
- Passer par Preview après chaque modification. L'aperçu montre l'éditeur tel que le rôle le verra.