Version de développement
Cette documentation décrit la version « next » (develop), non encore publiée. Pour la version stable, basculez sur « v5 » dans l'en-tête.

Mises en page de formulaires (DocType Layout)

Définissez plusieurs mises en page conditionnelles pour un même formulaire Dokos — affichage automatique selon le contexte, réorganisation visuelle des champs et surcharges de propriétés.

Mises en page de formulaires

La fonctionnalité Mise en page de type de document (« DocType Layout ») permet de définir plusieurs présentations différentes pour un même type de document. Chaque mise en page peut s'activer automatiquement selon une condition évaluée sur le document ouvert : statut, type de client, montant, ou n'importe quel autre champ.

Exemple fictif — Maison Verte SARL L'équipe commerciale souhaite afficher un formulaire simplifié pour les devis inférieurs à 1 000 € et un formulaire complet avec les champs de validation réglementaire pour les devis supérieurs. Deux mises en page sont créées sur le même type de document Devis : la condition doc.grand_total < 1000 active la présentation simplifiée, la condition doc.grand_total >= 1000 active la présentation complète. Le changement est automatique — l'utilisateur n'a rien à faire.

Cas d'usage typiques

  • Afficher des champs différents selon le statut du document (brouillon, soumis, annulé)
  • Proposer une vue allégée aux utilisateurs occasionnels et une vue complète aux responsables
  • Adapter la mise en page selon le type de client (particulier / entreprise) ou le pays
  • Définir un format d'impression et un modèle d'e-mail par défaut selon le contexte

Fonctionnement général

À chaque actualisation du formulaire, Dodock évalue les conditions de toutes les mises en page associées au type de document. La première mise en page dont la condition est vraie est appliquée. S'il n'y en a aucune, la vue par défaut s'affiche. La sélection est entièrement automatique — il n'existe pas de sélecteur manuel.

Créer une mise en page

Seul le rôle Gestionnaire système peut créer ou modifier une mise en page. Les autres utilisateurs du bureau peuvent seulement les lire.

  1. Ouvrez la recherche (Ctrl+K), saisissez Mise en page de type de document et ouvrez la liste.
  2. Cliquez sur Créer.
  3. Dans l'onglet Détails, renseignez les champs principaux :
ChampDescription
TitreNom de la mise en page. Il sert aussi d'identifiant et s'affiche dans le fil d'Ariane.
Type de documentLe formulaire concerné (ex. Devis, Client, Facture de vente). Le choisir charge ses champs.
Basé surMise en page parente à hériter (optionnel).
Est une table enfantCochez pour une mise en page de table enfant. Les champs de condition, de format et de modèle d'email sont alors masqués.
Format d'impression par défautFormat proposé à l'impression quand la mise en page est active.
Modèle d'email par défautModèle proposé à l'envoi par email.
ConditionExpression JavaScript évaluée sur doc à chaque actualisation du formulaire (ex. doc.grand_total >= 1000).
  1. Dans l'onglet Mise en page parente, réorganisez les champs avec le constructeur de formulaire.
  2. Cliquez sur Synchroniser les champs pour ajouter les champs créés sur le type de document depuis la création de la mise en page. Dokos liste les champs ajoutés et retirés.
  3. Enregistrez.

Le bouton Aller à la liste {titre} ouvre la liste du type de document filtrée selon la condition de la mise en page.

Bon à savoir : une mise en page cochée Est standard est livrée avec une application. Elle est en lecture seule en dehors du mode développeur.

Constructeur visuel

Le formulaire d'une mise en page intègre directement le constructeur de formulaires habituel. Vous pouvez :

  • Réorganiser les champs par glisser-déposer
  • Modifier les propriétés d'un champ (libellé, masqué, obligatoire, lecture seule, valeur par défaut, condition d'affichage…) sans toucher au type de document d'origine
  • Gérer les tables enfants : chaque table peut référencer une mise en page de table enfant dans l'onglet Mises en page enfants

Le formulaire s'ouvre en pleine largeur pour maximiser l'espace disponible dans le constructeur.

Surcharges de propriétés par champ

Pour chaque champ inclus dans la mise en page, les propriétés suivantes (tableau Champs) peuvent être modifiées indépendamment du type de document d'origine :

PropriétéEffet
labelLibellé affiché dans cette mise en page
hiddenMasquer le champ
reqdRendre le champ obligatoire
read_onlyMettre le champ en lecture seule
boldMettre le libellé en gras
defaultValeur par défaut dans cette mise en page
descriptionTexte d'aide affiché sous le champ
depends_onCondition d'affichage du champ
mandatory_depends_onCondition pour rendre le champ obligatoire
read_only_depends_onCondition pour mettre le champ en lecture seule
in_list_viewAfficher dans la vue liste
in_standard_filterAjouter comme filtre standard
allow_in_quick_entryAutoriser dans la saisie rapide

Ces surcharges n'affectent que cette mise en page. Le type de document et les autres mises en page ne sont pas modifiés.

Héritage entre mises en page

Une mise en page peut hériter d'une autre mise en page du même type de document via le champ Basé sur. La mise en page enfant repart de l'ordre des champs et des propriétés de la mise en page parente, puis peut surcharger uniquement les champs qui diffèrent.

Ce mécanisme évite de dupliquer entièrement une mise en page quand seuls quelques champs diffèrent.

Fil d'Ariane

Lorsqu'une mise en page est active sur un formulaire :

  • Le fil d'Ariane affiche le nom de la mise en page entre le type de document et le nom du document. Un clic sur ce lien ouvre la liste filtrée selon la condition de la mise en page.
  • Sur cette liste filtrée, le nom de la mise en page s'affiche comme un fil d'Ariane désactivé (non cliquable).
  • Cliquer sur le lien du type de document dans le fil d'Ariane supprime tous les filtres et retire l'élément de la mise en page.

La mise en page active est reflétée dans l'URL sous la forme ?layout=<nom>. Ce paramètre est restauré lors d'un rechargement de page ou d'un accès direct par lien. La mise en page est automatiquement effacée lors de la navigation vers une vue standard (liste, arborescence, etc.).

Tables enfants

Une mise en page peut définir des présentations spécifiques pour ses tables enfants (lignes d'articles, plannings…).

  1. Créez une mise en page pour le type de document de la table (par exemple Article de devis) et cochez Est une table enfant.
  2. Dans la mise en page principale, ouvrez l'onglet Mises en page enfants.
  3. Ajoutez une ligne : choisissez le Champ de Table et la Mise en page enfant.

Exportation et synchronisation en mode développeur

Pour les développeurs

En mode développeur, les mises en page standard sont exportées et synchronisées à l'intérieur du répertoire du type de document concerné (doctype/<nom>/), au même titre que les fichiers JSON du DocType. Cette organisation permet de versionner les mises en page avec le code source de l'application.

La commande bench migrate importe automatiquement les mises en page présentes dans les répertoires des applications installées.

Données de boot

Toutes les mises en page sont incluses dans les données de démarrage (boot data) afin que l'évaluateur de conditions et le fil d'Ariane soient disponibles côté client sans requête supplémentaire.