[{"data":1,"prerenderedAt":600},["ShallowReactive",2],{"\u002Fnext\u002Fdodock\u002Ffonctionnalites\u002Fdoctype-layout":3,"section:\u002Fnext\u002Fdodock\u002Ffonctionnalites\u002Fdoctype-layout":599},{"id":4,"title":5,"body":6,"description":582,"extension":583,"meta":584,"navigation":585,"path":595,"seo":596,"stem":597,"__hash__":598},"docs\u002F2.next\u002F3.dodock\u002F04.fonctionnalites\u002F10.doctype-layout\u002Findex.md","Mises en page de formulaires (DocType Layout)",{"type":7,"value":8,"toc":567},"minimark",[9,14,23,46,51,67,71,75,82,86,89,112,219,237,244,256,260,263,286,289,293,300,444,447,451,457,460,463,467,470,485,489,496,500,503,529,533],[10,11,13],"h1",{"id":12},"mises-en-page-de-formulaires","Mises en page de formulaires",[15,16,17,18,22],"p",{},"La fonctionnalité ",[19,20,21],"strong",{},"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.",[24,25,26],"blockquote",{},[15,27,28,31,32,36,37,41,42,45],{},[19,29,30],{},"Exemple fictif — Maison Verte SARL","\nL'é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 ",[33,34,35],"em",{},"Devis"," : la condition ",[38,39,40],"code",{},"doc.grand_total \u003C 1000"," active la présentation simplifiée, la condition ",[38,43,44],{},"doc.grand_total >= 1000"," active la présentation complète. Le changement est automatique — l'utilisateur n'a rien à faire.",[47,48,50],"h2",{"id":49},"cas-dusage-typiques","Cas d'usage typiques",[52,53,54,58,61,64],"ul",{},[55,56,57],"li",{},"Afficher des champs différents selon le statut du document (brouillon, soumis, annulé)",[55,59,60],{},"Proposer une vue allégée aux utilisateurs occasionnels et une vue complète aux responsables",[55,62,63],{},"Adapter la mise en page selon le type de client (particulier \u002F entreprise) ou le pays",[55,65,66],{},"Définir un format d'impression et un modèle d'e-mail par défaut selon le contexte",[47,68,70],{"id":69},"fonctionnement-général","Fonctionnement général",[72,73,74],"mermaid",{},"\nflowchart TD\n    A[Ouverture d'un formulaire] --> B[Évaluation des conditions\\nde toutes les mises en page\\ndu type de document]\n    B --> C{Une condition\\ncorrespond ?}\n    C -- Oui --> D[Application automatique\\nde la mise en page]\n    C -- Non --> E[Affichage de la vue\\npar défaut]\n    D --> G[Fil d'Ariane enrichi\\navec le nom de la mise en page]\n",[15,76,77,78,81],{},"À chaque actualisation du formulaire, Dodock évalue les conditions de toutes les mises en page associées au type de document. La ",[19,79,80],{},"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.",[47,83,85],{"id":84},"créer-une-mise-en-page","Créer une mise en page",[15,87,88],{},"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.",[90,91,92,98,105],"ol",{},[55,93,94,95,97],{},"Ouvrez la recherche (Ctrl+K), saisissez ",[19,96,21],{}," et ouvrez la liste.",[55,99,100,101,104],{},"Cliquez sur ",[19,102,103],{},"Créer",".",[55,106,107,108,111],{},"Dans l'onglet ",[19,109,110],{},"Détails",", renseignez les champs principaux :",[113,114,115,128],"table",{},[116,117,118],"thead",{},[119,120,121,125],"tr",{},[122,123,124],"th",{},"Champ",[122,126,127],{},"Description",[129,130,131,142,162,172,182,192,202],"tbody",{},[119,132,133,139],{},[134,135,136],"td",{},[19,137,138],{},"Titre",[134,140,141],{},"Nom de la mise en page. Il sert aussi d'identifiant et s'affiche dans le fil d'Ariane.",[119,143,144,149],{},[134,145,146],{},[19,147,148],{},"Type de document",[134,150,151,152,154,155,154,158,161],{},"Le formulaire concerné (ex. ",[33,153,35],{},", ",[33,156,157],{},"Client",[33,159,160],{},"Facture de vente","). Le choisir charge ses champs.",[119,163,164,169],{},[134,165,166],{},[19,167,168],{},"Basé sur",[134,170,171],{},"Mise en page parente à hériter (optionnel).",[119,173,174,179],{},[134,175,176],{},[19,177,178],{},"Est une table enfant",[134,180,181],{},"Cochez pour une mise en page de table enfant. Les champs de condition, de format et de modèle d'email sont alors masqués.",[119,183,184,189],{},[134,185,186],{},[19,187,188],{},"Format d'impression par défaut",[134,190,191],{},"Format proposé à l'impression quand la mise en page est active.",[119,193,194,199],{},[134,195,196],{},[19,197,198],{},"Modèle d'email par défaut",[134,200,201],{},"Modèle proposé à l'envoi par email.",[119,203,204,209],{},[134,205,206],{},[19,207,208],{},"Condition",[134,210,211,212,215,216,218],{},"Expression JavaScript évaluée sur ",[38,213,214],{},"doc"," à chaque actualisation du formulaire (ex. ",[38,217,44],{},").",[90,220,222,228,234],{"start":221},4,[55,223,107,224,227],{},[19,225,226],{},"Mise en page parente",", réorganisez les champs avec le constructeur de formulaire.",[55,229,100,230,233],{},[19,231,232],{},"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.",[55,235,236],{},"Enregistrez.",[15,238,239,240,243],{},"Le bouton ",[19,241,242],{},"Aller à la liste {titre}"," ouvre la liste du type de document filtrée selon la condition de la mise en page.",[24,245,246],{},[15,247,248,251,252,255],{},[19,249,250],{},"Bon à savoir"," : une mise en page cochée ",[19,253,254],{},"Est standard"," est livrée avec une application. Elle est en lecture seule en dehors du mode développeur.",[47,257,259],{"id":258},"constructeur-visuel","Constructeur visuel",[15,261,262],{},"Le formulaire d'une mise en page intègre directement le constructeur de formulaires habituel. Vous pouvez :",[52,264,265,271,277],{},[55,266,267,270],{},[19,268,269],{},"Réorganiser les champs"," par glisser-déposer",[55,272,273,276],{},[19,274,275],{},"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",[55,278,279,282,283],{},[19,280,281],{},"Gérer les tables enfants"," : chaque table peut référencer une mise en page de table enfant dans l'onglet ",[19,284,285],{},"Mises en page enfants",[15,287,288],{},"Le formulaire s'ouvre en pleine largeur pour maximiser l'espace disponible dans le constructeur.",[47,290,292],{"id":291},"surcharges-de-propriétés-par-champ","Surcharges de propriétés par champ",[15,294,295,296,299],{},"Pour chaque champ inclus dans la mise en page, les propriétés suivantes (tableau ",[19,297,298],{},"Champs",") peuvent être modifiées indépendamment du type de document d'origine :",[113,301,302,312],{},[116,303,304],{},[119,305,306,309],{},[122,307,308],{},"Propriété",[122,310,311],{},"Effet",[129,313,314,324,334,344,354,364,374,384,394,404,414,424,434],{},[119,315,316,321],{},[134,317,318],{},[38,319,320],{},"label",[134,322,323],{},"Libellé affiché dans cette mise en page",[119,325,326,331],{},[134,327,328],{},[38,329,330],{},"hidden",[134,332,333],{},"Masquer le champ",[119,335,336,341],{},[134,337,338],{},[38,339,340],{},"reqd",[134,342,343],{},"Rendre le champ obligatoire",[119,345,346,351],{},[134,347,348],{},[38,349,350],{},"read_only",[134,352,353],{},"Mettre le champ en lecture seule",[119,355,356,361],{},[134,357,358],{},[38,359,360],{},"bold",[134,362,363],{},"Mettre le libellé en gras",[119,365,366,371],{},[134,367,368],{},[38,369,370],{},"default",[134,372,373],{},"Valeur par défaut dans cette mise en page",[119,375,376,381],{},[134,377,378],{},[38,379,380],{},"description",[134,382,383],{},"Texte d'aide affiché sous le champ",[119,385,386,391],{},[134,387,388],{},[38,389,390],{},"depends_on",[134,392,393],{},"Condition d'affichage du champ",[119,395,396,401],{},[134,397,398],{},[38,399,400],{},"mandatory_depends_on",[134,402,403],{},"Condition pour rendre le champ obligatoire",[119,405,406,411],{},[134,407,408],{},[38,409,410],{},"read_only_depends_on",[134,412,413],{},"Condition pour mettre le champ en lecture seule",[119,415,416,421],{},[134,417,418],{},[38,419,420],{},"in_list_view",[134,422,423],{},"Afficher dans la vue liste",[119,425,426,431],{},[134,427,428],{},[38,429,430],{},"in_standard_filter",[134,432,433],{},"Ajouter comme filtre standard",[119,435,436,441],{},[134,437,438],{},[38,439,440],{},"allow_in_quick_entry",[134,442,443],{},"Autoriser dans la saisie rapide",[15,445,446],{},"Ces surcharges n'affectent que cette mise en page. Le type de document et les autres mises en page ne sont pas modifiés.",[47,448,450],{"id":449},"héritage-entre-mises-en-page","Héritage entre mises en page",[15,452,453,454,456],{},"Une mise en page peut hériter d'une autre mise en page du même type de document via le champ ",[19,455,168],{},". 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.",[72,458,459],{},"\nflowchart LR\n    A[Mise en page parente\\nDevis Standard] -->|héritée par| B[Mise en page enfant\\nDevis Export]\n    B -->|surcharge| C[Champ pays : obligatoire\\nChamp incoterms : visible]\n",[15,461,462],{},"Ce mécanisme évite de dupliquer entièrement une mise en page quand seuls quelques champs diffèrent.",[47,464,466],{"id":465},"fil-dariane","Fil d'Ariane",[15,468,469],{},"Lorsqu'une mise en page est active sur un formulaire :",[52,471,472,479,482],{},[55,473,474,475,478],{},"Le ",[19,476,477],{},"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.",[55,480,481],{},"Sur cette liste filtrée, le nom de la mise en page s'affiche comme un fil d'Ariane désactivé (non cliquable).",[55,483,484],{},"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.",[47,486,488],{"id":487},"navigation-et-url","Navigation et URL",[15,490,491,492,495],{},"La mise en page active est reflétée dans l'URL sous la forme ",[38,493,494],{},"?layout=\u003Cnom>",". 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.).",[47,497,499],{"id":498},"tables-enfants","Tables enfants",[15,501,502],{},"Une mise en page peut définir des présentations spécifiques pour ses tables enfants (lignes d'articles, plannings…).",[90,504,505,514,519],{},[55,506,507,508,511,512,104],{},"Créez une mise en page pour le type de document de la table (par exemple ",[33,509,510],{},"Article de devis",") et cochez ",[19,513,178],{},[55,515,516,517,104],{},"Dans la mise en page principale, ouvrez l'onglet ",[19,518,285],{},[55,520,521,522,525,526,104],{},"Ajoutez une ligne : choisissez le ",[19,523,524],{},"Champ de Table"," et la ",[19,527,528],{},"Mise en page enfant",[47,530,532],{"id":531},"exportation-et-synchronisation-en-mode-développeur","Exportation et synchronisation en mode développeur",[534,535,536,541,548,555,560],"dokos",{},[15,537,538],{},[19,539,540],{},"Pour les développeurs",[15,542,543,544,547],{},"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é (",[38,545,546],{},"doctype\u002F\u003Cnom>\u002F","), 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.",[15,549,550,551,554],{},"La commande ",[38,552,553],{},"bench migrate"," importe automatiquement les mises en page présentes dans les répertoires des applications installées.",[15,556,557],{},[19,558,559],{},"Données de boot",[15,561,562,563,566],{},"Toutes les mises en page sont incluses dans les données de démarrage (",[33,564,565],{},"boot data",") afin que l'évaluateur de conditions et le fil d'Ariane soient disponibles côté client sans requête supplémentaire.",{"title":568,"searchDepth":569,"depth":570,"links":571},"",1,2,[572,573,574,575,576,577,578,579,580,581],{"id":49,"depth":570,"text":50},{"id":69,"depth":570,"text":70},{"id":84,"depth":570,"text":85},{"id":258,"depth":570,"text":259},{"id":291,"depth":570,"text":292},{"id":449,"depth":570,"text":450},{"id":465,"depth":570,"text":466},{"id":487,"depth":570,"text":488},{"id":498,"depth":570,"text":499},{"id":531,"depth":570,"text":532},"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.","md",{"reviewed":585,"last_verified":586,"sources":587},true,"2026-11-03",[588,589,590,591,592,593,594],"frappe\u002Fcore\u002Fdoctype\u002Fdoctype_layout\u002Fdoctype_layout.json","frappe\u002Fcore\u002Fdoctype\u002Fdoctype_layout\u002Fdoctype_layout.js","frappe\u002Fcore\u002Fdoctype\u002Fdoctype_layout\u002Fdoctype_layout.py","frappe\u002Fcore\u002Fdoctype\u002Fdoctype_layout_field\u002Fdoctype_layout_field.json","frappe\u002Fpublic\u002Fjs\u002Ffrappe\u002Fform\u002Fform.js","frappe\u002Fboot.py","frappe\u002Flocale\u002Ffr.po","\u002Fnext\u002Fdodock\u002Ffonctionnalites\u002Fdoctype-layout",{"title":5,"description":582},"2.next\u002F3.dodock\u002F04.fonctionnalites\u002F10.doctype-layout\u002Findex","GLtIbBK5sGbyIEILDZNMVzxAnd0f-IO7Xv0tmrVXqWQ",{},1795018325131]