[{"data":1,"prerenderedAt":641},["ShallowReactive",2],{"\u002Fnext\u002Fdodock\u002Finterface\u002Fvue-rapport-groupement":3,"section:\u002Fnext\u002Fdodock\u002Finterface\u002Fvue-rapport-groupement":640},{"id":4,"title":5,"body":6,"description":627,"extension":628,"meta":629,"navigation":630,"path":636,"seo":637,"stem":638,"__hash__":639},"docs\u002F2.next\u002F3.dodock\u002F02.interface\u002Fvue-rapport-groupement.md","Grouper et agréger dans la vue Rapport",{"type":7,"value":8,"toc":616},"minimark",[9,13,18,21,67,74,81,100,104,204,213,217,254,258,265,270,422,468,472,475,542,545,549,552,567,571,578,612],[10,11,12],"p",{},"La vue Rapport permet de grouper les résultats par un ou plusieurs champs et d'afficher plusieurs colonnes d'agrégation. Vous pouvez ainsi analyser vos données selon plusieurs critères simultanément, par exemple le nombre de documents par statut et par priorité.",[14,15,17],"h2",{"id":16},"grouper-et-agréger-les-données","Grouper et agréger les données",[10,19,20],{},"Pour configurer le regroupement dans la vue Rapport d'une liste :",[22,23,24,28,36,43,50,60],"ol",{},[25,26,27],"li",{},"Ouvrez la vue Rapport du type de document.",[25,29,30,31,35],{},"Cliquez sur ",[32,33,34],"strong",{},"Regrouper par…"," dans la barre des filtres.",[25,37,38,39,42],{},"Dans la section ",[32,40,41],{},"Grouper",", choisissez le premier champ de regroupement.",[25,44,45,46,49],{},"Pour grouper par un autre champ, cliquez sur ",[32,47,48],{},"Ajouter un regroupement",", puis choisissez le champ.",[25,51,38,52,55,56,59],{},[32,53,54],{},"Agréger",", choisissez la fonction d'agrégation. Pour une fonction autre que ",[32,57,58],{},"Décompte",", choisissez aussi le champ.",[25,61,62,63,66],{},"Pour ajouter une colonne d'agrégation, cliquez sur ",[32,64,65],{},"Ajouter un agrégat",".",[10,68,69,70,73],{},"Chaque changement complet s'applique tout de suite à la vue. Le bouton ",[32,71,72],{},"Appliquer"," ferme seulement la fenêtre. La croix à droite d'une ligne supprime ce regroupement ou cette agrégation.",[10,75,76,77,80],{},"Quand un regroupement est actif, le bouton affiche « Groupé par … ». La croix à côté du bouton, ou ",[32,78,79],{},"Supprimer le regroupement"," dans la fenêtre, supprime tout le regroupement.",[82,83,86],"callout",{"color":84,"icon":85},"info","i-lucide-info",[10,87,88,89,91,92,91,94,96,97,99],{},"Les libellés ",[32,90,48],{},", ",[32,93,54],{},[32,95,65],{}," et ",[32,98,79],{}," ne sont pas encore traduits.",[14,101,103],{"id":102},"fonctions-dagrégation","Fonctions d'agrégation",[105,106,107,123],"table",{},[108,109,110],"thead",{},[111,112,113,117,120],"tr",{},[114,115,116],"th",{},"Fonction",[114,118,119],{},"Description",[114,121,122],{},"Champs acceptés",[124,125,126,140,154,167,187],"tbody",{},[111,127,128,134,137],{},[129,130,131,133],"td",{},[32,132,58],{}," (Count)",[129,135,136],{},"Compte le nombre de documents dans chaque groupe.",[129,138,139],{},"Aucun champ requis.",[111,141,142,148,151],{},[129,143,144,147],{},[32,145,146],{},"Somme"," (Sum)",[129,149,150],{},"Additionne les valeurs du champ sélectionné.",[129,152,153],{},"Champs numériques (Entier, Décimal, Devise).",[111,155,156,162,165],{},[129,157,158,161],{},[32,159,160],{},"Moyenne"," (Average)",[129,163,164],{},"Calcule la moyenne des valeurs du champ sélectionné.",[129,166,153],{},[111,168,169,175,178],{},[129,170,171,174],{},[32,172,173],{},"Minimum"," (Min)",[129,176,177],{},"Affiche la plus petite valeur du champ sélectionné dans chaque groupe.",[129,179,180,181,96,184,66],{},"Champs numériques, Date, Date et heure, Heure, ainsi que les champs standards ",[32,182,183],{},"Créé le",[32,185,186],{},"Dernière modification",[111,188,189,195,198],{},[129,190,191,194],{},[32,192,193],{},"Maximum"," (Max)",[129,196,197],{},"Affiche la plus grande valeur du champ sélectionné dans chaque groupe.",[129,199,180,200,96,202,66],{},[32,201,183],{},[32,203,186],{},[10,205,206,207,209,210,212],{},"Par exemple, l'agrégation ",[32,208,193],{}," appliquée au champ ",[32,211,183],{}," affiche le document le plus récent de chaque groupe.",[14,214,216],{"id":215},"comportement-des-résultats","Comportement des résultats",[218,219,220,226,236],"ul",{},[25,221,222,225],{},[32,223,224],{},"Tri"," : Les résultats sont triés par la première colonne d'agrégation, par ordre décroissant.",[25,227,228,231,232,235],{},[32,229,230],{},"Ligne de total"," : Si l'option ",[32,233,234],{},"Ajouter une Ligne Totale"," est activée dans les paramètres du rapport, la ligne de total affiche la somme des valeurs pour les agrégations Somme et Moyenne. Pour les agrégations Minimum et Maximum, le total affiche le minimum ou le maximum de l'ensemble des groupes (et non la somme des groupes).",[25,237,238,241,242,246,247,91,250,253],{},[32,239,240],{},"Nommage des colonnes"," : La première colonne d'agrégation est nommée ",[243,244,245],"code",{},"_aggregate_column",", les suivantes ",[243,248,249],{},"_aggregate_column_1",[243,251,252],{},"_aggregate_column_2",", etc.",[14,255,257],{"id":256},"configuration-avancée-rapports-enregistrés","Configuration avancée (rapports enregistrés)",[10,259,260,261,264],{},"Pour les rapports créés avec le ",[32,262,263],{},"Report Builder"," ou les rapports enregistrés, la configuration du regroupement se fait dans le champ JSON du rapport.",[266,267,269],"h3",{"id":268},"format-actuel","Format actuel",[271,272,277],"pre",{"className":273,"code":274,"language":275,"meta":276,"style":276},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n    \"group_by\": [\"`tabToDo`.`status`\", \"`tabToDo`.`priority`\"],\n    \"aggregates\": [\n        {\"aggregate_function\": \"count\"},\n        {\"aggregate_function\": \"sum\", \"aggregate_on\": \"`tabToDo`.`estimated_cost`\"}\n    ]\n}\n","json","",[243,278,279,288,329,344,370,411,417],{"__ignoreMap":276},[280,281,284],"span",{"class":282,"line":283},"line",1,[280,285,287],{"class":286},"sMK4o","{\n",[280,289,291,294,298,301,304,307,309,313,315,318,321,324,326],{"class":282,"line":290},2,[280,292,293],{"class":286},"    \"",[280,295,297],{"class":296},"spNyl","group_by",[280,299,300],{"class":286},"\"",[280,302,303],{"class":286},":",[280,305,306],{"class":286}," [",[280,308,300],{"class":286},[280,310,312],{"class":311},"sfazB","`tabToDo`.`status`",[280,314,300],{"class":286},[280,316,317],{"class":286},",",[280,319,320],{"class":286}," \"",[280,322,323],{"class":311},"`tabToDo`.`priority`",[280,325,300],{"class":286},[280,327,328],{"class":286},"],\n",[280,330,332,334,337,339,341],{"class":282,"line":331},3,[280,333,293],{"class":286},[280,335,336],{"class":296},"aggregates",[280,338,300],{"class":286},[280,340,303],{"class":286},[280,342,343],{"class":286}," [\n",[280,345,347,350,352,356,358,360,362,365,367],{"class":282,"line":346},4,[280,348,349],{"class":286},"        {",[280,351,300],{"class":286},[280,353,355],{"class":354},"sBMFI","aggregate_function",[280,357,300],{"class":286},[280,359,303],{"class":286},[280,361,320],{"class":286},[280,363,364],{"class":311},"count",[280,366,300],{"class":286},[280,368,369],{"class":286},"},\n",[280,371,373,375,377,379,381,383,385,388,390,392,394,397,399,401,403,406,408],{"class":282,"line":372},5,[280,374,349],{"class":286},[280,376,300],{"class":286},[280,378,355],{"class":354},[280,380,300],{"class":286},[280,382,303],{"class":286},[280,384,320],{"class":286},[280,386,387],{"class":311},"sum",[280,389,300],{"class":286},[280,391,317],{"class":286},[280,393,320],{"class":286},[280,395,396],{"class":354},"aggregate_on",[280,398,300],{"class":286},[280,400,303],{"class":286},[280,402,320],{"class":286},[280,404,405],{"class":311},"`tabToDo`.`estimated_cost`",[280,407,300],{"class":286},[280,409,410],{"class":286},"}\n",[280,412,414],{"class":282,"line":413},6,[280,415,416],{"class":286},"    ]\n",[280,418,420],{"class":282,"line":419},7,[280,421,410],{"class":286},[218,423,424,432],{},[25,425,426,428,429,66],{},[243,427,297],{}," : liste des champs de regroupement au format ",[243,430,431],{},"`tabDoctype`.`champ`",[25,433,434,436,437],{},[243,435,336],{}," : liste des agrégations. Chaque agrégation contient :\n",[218,438,439,458],{},[25,440,441,443,444,91,446,91,448,91,451,454,455,66],{},[243,442,355],{}," : ",[243,445,364],{},[243,447,387],{},[243,449,450],{},"avg",[243,452,453],{},"min"," ou ",[243,456,457],{},"max",[25,459,460,462,463,465,466,66],{},[243,461,396],{}," : champ concerné (obligatoire sauf pour ",[243,464,364],{},"), au format ",[243,467,431],{},[266,469,471],{"id":470},"format-à-un-seul-regroupement","Format à un seul regroupement",[10,473,474],{},"Le format à un seul champ de regroupement et une seule agrégation reste accepté :",[271,476,478],{"className":273,"code":477,"language":275,"meta":276,"style":276},"{\n    \"group_by\": \"`tabToDo`.`status`\",\n    \"aggregate_function\": \"sum\",\n    \"aggregate_on\": \"`tabToDo`.`estimated_cost`\"\n}\n",[243,479,480,484,503,521,538],{"__ignoreMap":276},[280,481,482],{"class":282,"line":283},[280,483,287],{"class":286},[280,485,486,488,490,492,494,496,498,500],{"class":282,"line":290},[280,487,293],{"class":286},[280,489,297],{"class":296},[280,491,300],{"class":286},[280,493,303],{"class":286},[280,495,320],{"class":286},[280,497,312],{"class":311},[280,499,300],{"class":286},[280,501,502],{"class":286},",\n",[280,504,505,507,509,511,513,515,517,519],{"class":282,"line":331},[280,506,293],{"class":286},[280,508,355],{"class":296},[280,510,300],{"class":286},[280,512,303],{"class":286},[280,514,320],{"class":286},[280,516,387],{"class":311},[280,518,300],{"class":286},[280,520,502],{"class":286},[280,522,523,525,527,529,531,533,535],{"class":282,"line":346},[280,524,293],{"class":286},[280,526,396],{"class":296},[280,528,300],{"class":286},[280,530,303],{"class":286},[280,532,320],{"class":286},[280,534,405],{"class":311},[280,536,537],{"class":286},"\"\n",[280,539,540],{"class":282,"line":372},[280,541,410],{"class":286},[10,543,544],{},"Ce format est automatiquement converti au nouveau format lors de l'enregistrement ou de l'exécution du rapport.",[14,546,548],{"id":547},"règles-de-validation","Règles de validation",[10,550,551],{},"Lors de l'enregistrement d'un rapport ou de l'exécution d'une requête groupée, les règles suivantes s'appliquent :",[218,553,554,557,564],{},[25,555,556],{},"Tous les champs de regroupement et d'agrégation doivent exister dans le doctype concerné.",[25,558,559,560,563],{},"Les champs provenant d'un ",[32,561,562],{},"tableau enfant"," (child table) ne peuvent pas être mélangés avec des champs d'un autre tableau enfant, car une jointure sur deux tableaux enfants produirait des totaux incorrects.",[25,565,566],{},"Si un champ d'agrégation provient d'un tableau enfant, au moins un champ de regroupement doit provenir du même tableau enfant.",[14,568,570],{"id":569},"paramètre-durl","Paramètre d'URL",[10,572,573,574,577],{},"Le regroupement peut également être transmis via l'URL avec le paramètre ",[243,575,576],{},"_group_by"," :",[218,579,580,594],{},[25,581,582,443,584,587,588,590,591],{},[32,583,269],{},[243,585,586],{},"_group_by={\"group_by\":[\"","tabToDo",[243,589,66],{},"status",[243,592,593],{},"\"],\"aggregates\":[{\"aggregate_function\":\"count\"}]}",[25,595,596,443,598,587,601,590,603,587,606,608,609],{},[32,597,471],{},[243,599,600],{},"_group_by=[\"",[243,602,66],{},[243,604,605],{},"\",\"",[243,607,66],{},"estimated_cost",[243,610,611],{},"\",\"sum\"]",[613,614,615],"style",{},"html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":276,"searchDepth":283,"depth":290,"links":617},[618,619,620,621,625,626],{"id":16,"depth":290,"text":17},{"id":102,"depth":290,"text":103},{"id":215,"depth":290,"text":216},{"id":256,"depth":290,"text":257,"children":622},[623,624],{"id":268,"depth":331,"text":269},{"id":470,"depth":331,"text":471},{"id":547,"depth":290,"text":548},{"id":569,"depth":290,"text":570},"Grouper les résultats d'un rapport par plusieurs champs et afficher plusieurs colonnes d'agrégation (décompte, somme, moyenne, minimum, maximum).","md",{"reviewed":630,"last_verified":631,"sources":632},true,"2026-11-04",[633,634,635],"frappe\u002Fpublic\u002Fjs\u002Ffrappe\u002Fui\u002Fgroup_by\u002Fgroup_by.js","frappe\u002Fpublic\u002Fjs\u002Ffrappe\u002Fui\u002Fgroup_by\u002Fgroup_by.html","frappe\u002Fpublic\u002Fjs\u002Ffrappe\u002Fviews\u002Freports\u002Freport_view.js","\u002Fnext\u002Fdodock\u002Finterface\u002Fvue-rapport-groupement",{"title":5,"description":627},"2.next\u002F3.dodock\u002F02.interface\u002Fvue-rapport-groupement","ZE0auNNfcHnBR24ciJJgvAXeNw04CQID_FnU9ZqAV8I",{},1793871794196]