[{"data":1,"prerenderedAt":476},["ShallowReactive",2],{"\u002Fv5\u002Fdodock\u002Fdeveloppeurs\u002Fpanneau-lateral-flow":3,"section:\u002Fv5\u002Fdodock\u002Fdeveloppeurs\u002Fpanneau-lateral-flow":475},{"id":4,"title":5,"body":6,"description":461,"extension":462,"meta":463,"navigation":467,"path":471,"seo":472,"stem":473,"__hash__":474},"docs\u002F1.v5\u002F3.dodock\u002F10.developpeurs\u002Fpanneau-lateral-flow.md","Panneau latéral Flow",{"type":7,"value":8,"toc":451},"minimark",[9,13,17,33,38,49,60,66,72,113,118,121,151,160,171,177,180,228,239,242,295,298,307,415,421,425,447],[10,11,5],"h1",{"id":12},"panneau-latéral-flow",[14,15,16],"p",{},"L'assistant Flow s'affiche sous la forme d'un panneau latéral ancré à droite de la fenêtre. La page se rétrécit pour rester visible à côté du panneau ; si la fenêtre est trop étroite, le panneau recouvre la page, et sur un écran de téléphone il occupe tout l'écran.",[14,18,19,20,24,25,28,29,32],{},"Cette page décrit les trois façons de piloter le panneau depuis votre code : l'attribut ",[21,22,23],"code",{},"data-flow-toggle",", la fonction ",[21,26,27],{},"window.flow.toggle()"," et la fonction ",[21,30,31],{},"window.flow.open({ session })",", qui ouvre le panneau sur une conversation précise.",[34,35,37],"h2",{"id":36},"où-le-panneau-est-disponible","Où le panneau est disponible",[14,39,40,41,44,45,48],{},"Le script du lanceur est ajouté aux pages HTML du Desk, de Studio et des applications de l'écran des applications, à l'exception de Raven, qui a sa propre intégration. Il n'est ajouté que pour un utilisateur qui a le droit de lire les sessions Flow (",[21,42,43],{},"Flow Session","). Il n'est pas ajouté sur le site web public ni sur la page ",[21,46,47],{},"\u002Fflow"," elle-même.",[14,50,51,52,55,56,59],{},"Le lanceur n'est pas chargé dans un cadre (",[21,53,54],{},"iframe",") : dans un cadre, ",[21,57,58],{},"window.flow"," n'est pas défini. Appelez les fonctions depuis la fenêtre principale.",[34,61,63,64],{"id":62},"basculer-le-panneau-avec-data-flow-toggle","Basculer le panneau avec ",[21,65,23],{},[14,67,68,69,71],{},"Ajoutez l'attribut ",[21,70,23],{}," à n'importe quel élément HTML. Un clic sur cet élément ouvre le panneau s'il est fermé, et le ferme s'il est ouvert. Les éléments ajoutés à la page après son chargement fonctionnent aussi.",[73,74,79],"pre",{"className":75,"code":76,"language":77,"meta":78,"style":78},"language-html shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","\u003Cbutton data-flow-toggle>Discuter avec Flow\u003C\u002Fbutton>\n","html","",[21,80,81],{"__ignoreMap":78},[82,83,86,90,94,98,101,105,108,110],"span",{"class":84,"line":85},"line",1,[82,87,89],{"class":88},"sMK4o","\u003C",[82,91,93],{"class":92},"swJcz","button",[82,95,97],{"class":96},"spNyl"," data-flow-toggle",[82,99,100],{"class":88},">",[82,102,104],{"class":103},"sTEyZ","Discuter avec Flow",[82,106,107],{"class":88},"\u003C\u002F",[82,109,93],{"class":92},[82,111,112],{"class":88},">\n",[34,114,63,116],{"id":115},"basculer-le-panneau-avec-windowflowtoggle",[21,117,27],{},[14,119,120],{},"La même bascule est exposée en JavaScript :",[73,122,126],{"className":123,"code":124,"language":125,"meta":78,"style":78},"language-js shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","window.flow.toggle();\n","js",[21,127,128],{"__ignoreMap":78},[82,129,130,133,136,139,141,145,148],{"class":84,"line":85},[82,131,132],{"class":103},"window",[82,134,135],{"class":88},".",[82,137,138],{"class":103},"flow",[82,140,135],{"class":88},[82,142,144],{"class":143},"s2Zo4","toggle",[82,146,147],{"class":103},"()",[82,149,150],{"class":88},";\n",[14,152,153,156,157,135],{},[21,154,155],{},"toggle()"," rouvre la conversation que le panneau montrait en dernier. Pour afficher une conversation que votre application vient de démarrer, utilisez ",[21,158,159],{},"window.flow.open()",[14,161,162,163,166,167,170],{},"Le panneau se ferme aussi avec le raccourci ",[21,164,165],{},"Ctrl + I"," (",[21,168,169],{},"⌘ + I"," sur macOS) et avec la croix de l'en-tête du chat.",[34,172,174,175],{"id":173},"ouvrir-le-panneau-sur-une-conversation-avec-windowflowopen","Ouvrir le panneau sur une conversation avec ",[21,176,159],{},[14,178,179],{},"Une application qui démarre une conversation Flow (par exemple depuis sa propre zone de saisie) peut ouvrir le panneau directement sur cette conversation :",[73,181,183],{"className":123,"code":182,"language":125,"meta":78,"style":78},"window.flow.open({ session: \"chat-one\" });\n",[21,184,185],{"__ignoreMap":78},[82,186,187,189,191,193,195,198,201,204,207,210,213,217,220,223,226],{"class":84,"line":85},[82,188,132],{"class":103},[82,190,135],{"class":88},[82,192,138],{"class":103},[82,194,135],{"class":88},[82,196,197],{"class":143},"open",[82,199,200],{"class":103},"(",[82,202,203],{"class":88},"{",[82,205,206],{"class":92}," session",[82,208,209],{"class":88},":",[82,211,212],{"class":88}," \"",[82,214,216],{"class":215},"sfazB","chat-one",[82,218,219],{"class":88},"\"",[82,221,222],{"class":88}," }",[82,224,225],{"class":103},")",[82,227,150],{"class":88},[14,229,230,231,234,235,238],{},"Le paramètre ",[21,232,233],{},"session"," est l'identifiant de la conversation, le même que dans l'adresse ",[21,236,237],{},"\u002Fflow\u002Fs\u002F\u003Cidentifiant>"," de la page Flow.",[14,240,241],{},"Comportement :",[243,244,245,253,266,272,286],"ul",{},[246,247,248,252],"li",{},[249,250,251],"strong",{},"Panneau fermé"," : il s'ouvre sur la conversation demandée.",[246,254,255,258,259,261,262,265],{},[249,256,257],{},"Panneau déjà ouvert sur une autre conversation"," : il passe à la conversation demandée et reste ouvert. Contrairement à ",[21,260,155],{},", ",[21,263,264],{},"open()"," ne ferme jamais le panneau.",[246,267,268,271],{},[249,269,270],{},"Panneau en cours de chargement"," (le chat n'est pas encore affiché) : la conversation demandée est conservée, et le chat s'affiche directement sur elle à la fin du chargement. Si le chargement échoue, le panneau affiche son message d'échec à la place du chat.",[246,273,274,166,279,281,282,285],{},[249,275,276,277],{},"Sans ",[21,278,233],{},[21,280,159],{}," ou ",[21,283,284],{},"window.flow.open({})",") : le panneau s'ouvre sur la dernière conversation qu'il montrait, ou reste ouvert s'il l'est déjà.",[246,287,288,291,292,294],{},[249,289,290],{},"Conversation qui ne peut pas s'ouvrir"," (identifiant inexistant, conversation supprimée, accès refusé) : le panneau affiche l'erreur, comme la page ",[21,293,47],{},", puis revient à une nouvelle conversation. Ce cas diffère de la réouverture automatique : quand le panneau rouvre de lui-même une conversation (la dernière qu'il montrait, ou celle d'un retour en arrière) et que celle-ci n'existe plus, il démarre une nouvelle conversation sans afficher d'erreur.",[14,296,297],{},"La conversation demandée devient aussi celle que le panneau rouvrira au chargement de la page suivante.",[14,299,300,301,303,304,306],{},"Exemple fictif : une application démarre une conversation côté serveur, reçoit l'identifiant ",[21,302,216],{},", puis l'affiche dans le panneau. Si ",[21,305,58],{}," n'est pas défini (lanceur non chargé, ou code exécuté dans un cadre), elle ouvre la page Flow en plein écran :",[73,308,310],{"className":123,"code":309,"language":125,"meta":78,"style":78},"function showChat(session) {\n    if (window.flow) window.flow.open({ session });\n    else window.location.assign(`\u002Fflow\u002Fs\u002F${session}`);\n}\n",[21,311,312,330,370,409],{"__ignoreMap":78},[82,313,314,317,320,322,325,327],{"class":84,"line":85},[82,315,316],{"class":96},"function",[82,318,319],{"class":143}," showChat",[82,321,200],{"class":88},[82,323,233],{"class":324},"sHdIc",[82,326,225],{"class":88},[82,328,329],{"class":88}," {\n",[82,331,333,337,339,341,343,345,348,350,352,354,356,358,360,362,364,366,368],{"class":84,"line":332},2,[82,334,336],{"class":335},"s7zQu","    if",[82,338,166],{"class":92},[82,340,132],{"class":103},[82,342,135],{"class":88},[82,344,138],{"class":103},[82,346,347],{"class":92},") ",[82,349,132],{"class":103},[82,351,135],{"class":88},[82,353,138],{"class":103},[82,355,135],{"class":88},[82,357,197],{"class":143},[82,359,200],{"class":92},[82,361,203],{"class":88},[82,363,206],{"class":103},[82,365,222],{"class":88},[82,367,225],{"class":92},[82,369,150],{"class":88},[82,371,373,376,379,381,384,386,389,391,394,397,400,402,405,407],{"class":84,"line":372},3,[82,374,375],{"class":335},"    else",[82,377,378],{"class":103}," window",[82,380,135],{"class":88},[82,382,383],{"class":103},"location",[82,385,135],{"class":88},[82,387,388],{"class":143},"assign",[82,390,200],{"class":92},[82,392,393],{"class":88},"`",[82,395,396],{"class":215},"\u002Fflow\u002Fs\u002F",[82,398,399],{"class":88},"${",[82,401,233],{"class":103},[82,403,404],{"class":88},"}`",[82,406,225],{"class":92},[82,408,150],{"class":88},[82,410,412],{"class":84,"line":411},4,[82,413,414],{"class":88},"}\n",[14,416,417,418,420],{},"La valeur de retour de ",[21,419,264],{}," n'est pas documentée : ne vous en servez pas.",[34,422,424],{"id":423},"points-dattention","Points d'attention",[243,426,427,430,438],{},[246,428,429],{},"Le panneau s'ancre à droite de la fenêtre et réduit la largeur de la page affichée : ce n'est pas une fenêtre flottante.",[246,431,432,433,435,436,135],{},"Le lanceur n'affiche pas de bouton flottant : c'est à votre application de placer son propre élément ",[21,434,23],{}," ou d'appeler ",[21,437,58],{},[246,439,440,441,443,444,446],{},"Si le lanceur n'est pas chargé pour l'utilisateur (droit de lecture sur ",[21,442,43],{}," manquant), un bouton ",[21,445,23],{}," ne fait rien.",[448,449,450],"style",{},"html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}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);}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sHdIc, html code.shiki .sHdIc{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#EEFFFF;--shiki-default-font-style:italic;--shiki-dark:#BABED8;--shiki-dark-font-style:italic}html pre.shiki code .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}",{"title":78,"searchDepth":85,"depth":332,"links":452},[453,454,456,458,460],{"id":36,"depth":332,"text":37},{"id":62,"depth":332,"text":455},"Basculer le panneau avec data-flow-toggle",{"id":115,"depth":332,"text":457},"Basculer le panneau avec window.flow.toggle()",{"id":173,"depth":332,"text":459},"Ouvrir le panneau sur une conversation avec window.flow.open()",{"id":423,"depth":332,"text":424},"Ouvrir et fermer le panneau latéral de l'assistant Flow depuis un élément HTML ou un script, et l'ouvrir sur une conversation précise avec window.flow.open.","md",{"sources":464,"generated":467,"generated_at":468,"source_mrs":469,"reviewed":467},[465,466],"dodock@v5:frappe\u002Fpublic\u002Fjs\u002Fflow_launcher.bundle.js","dodock@v5:frappe\u002Fflow\u002Flauncher.py",true,"2026-11-18",[470],"https:\u002F\u002Fgitlab.com\u002Fdokos\u002Fdodock\u002F-\u002Fmerge_requests\u002F13193","\u002Fv5\u002Fdodock\u002Fdeveloppeurs\u002Fpanneau-lateral-flow",{"title":5,"description":461},"1.v5\u002F3.dodock\u002F10.developpeurs\u002Fpanneau-lateral-flow","jzZyUaAeF6V31bGgeognNaggwMfRhciJQx10VGsGx5k",{},1795162125170]