Wiki source code of Gérer les flux

Last modified by Aurelie Bertrand on 2025/11/13 17:11

Show last authors
1 {{ddtoc/}}
2
3 ----
4
5 = Vue d'ensemble =
6
7 L'onglet **{{glossaryReference glossaryId="Glossary" entryId="Flux"}}Flux{{/glossaryReference}}** permet, en plus de créer un nouveau flux, de gérer les différents flux que vous avez créés.
8
9 [[image:Flow_manager_panel_FR.png]]
10
11 (% class="box infomessage" %)
12 (((
13 **ℹ **Dans le cas où un rôle est verrouillé, un cadenas est ajouté à la suite du nom du rôle et du portefeuille, et le bouton **Nouveau flux** est remplacé par le bouton **Déverrouiller le rôle**. Consultez le paragraphe [[Verrouiller un rôle>>doc:Digdash.deployment.configuration.administration.User_management.Role_management.WebHome||anchor="Lock"]] pour plus de détails.
14
15 [[image:1762421822150-509.png]]
16 )))
17
18
19 |=1 : Liste des flux|(((
20 La zone centrale liste les flux créés dans le rôle sélectionné, ici le rôle //Retail//.
21
22 (% class="box infomessage" %)
23 (((
24 Les flux peuvent être organisés dans des catégories et sous-catégories.
25 Consultez le paragraphe ci-dessous pour en savoir plus sur comment créer des catégories et y assigner les flux.
26 )))
27
28 Pour chaque flux sont affichées les informations suivantes (si disponibles) :
29
30 * Une icône de synchronisation des données
31 * Le **Modèle de données** utilisé pour créer le flux
32 * La **Programmation** de son rafraîchissement
33 * Les **Appareils de sortie **définis pour le flux : Dashboard, Email, Serveur de fichier, SMS...
34 * Les **Attributs** du flux représentés par des icônes :
35 [[image:1736781102350-460.png||height="25" width="23"]]: le flux est personnalisé (utilisation de variables liées aux utilisateurs)
36 [[image:1736781073509-833.png||height="23" width="23"]] : le flux possède un modèle de visualisation
37 [[image:1736781361835-476.png||height="23" width="23"]]: le flux possède une notification
38 [[image:1736785898549-126.png||height="24" width="23"]]: le flux possède un filtre
39 [[image:1736786096426-211.png||height="26" width="23"]]: le flux possède un appareil de sortie
40 )))
41 |=2 : Panneau latéral|(((
42 Le panneau latéral affiche les informations de l'élément (flux ou groupe de flux) couramment sélectionné regroupés sous 5 onglets :
43
44 * **Propriétés** : Permet d'afficher/éditer les propriétés de la sélection. Consultez le paragraphe ci-dessous [[Éditer les propriétés d'un flux>>doc:||anchor="Proprietes_flux"]] pour plus de détails.
45 * **Styles** : Permet d'afficher/éditer les thèmes disponibles et ceux utilisés pour la sélection. Consultez la page [[Gestionnaire de styles>>doc:Digdash.user_guide.studio.managers.Style_manager.WebHome]] pour plus de détails sur les styles.
46 * **Programmation** : Permet d'afficher/éditer la programmation de rafraîchissement de la sélection.
47 Par défaut, le flux est rafraîchi et synchronisé en même temps que le portefeuille d'information. Pour définir une programmation différente, décochez la case **Avec le portefeuille** puis cliquez sur le bouton **Ajouter**. Consultez la page [[Programmer les rafraîchissements>>doc:Digdash.user_guide.studio.Schedule_refresh.WebHome]] pour en savoir plus sur comment définir la programmation des rafraîchissements.
48 * **Appareils de sortie **: Permet de définir les appareils de sortie. Par défaut, les flux sont synchronisés pour le tableau de bord PC (dashboard). Si vous souhaitez synchroniser le flux pour un autre appareil, sélectionnez-le dans la liste. Vous pouvez ajouter de nouveaux appareils en cliquant sur le bouton **Gestionnaire d'appareils**. Consultez la page [[Gestionnaire d'appareils>>doc:Digdash.user_guide.studio.managers.devices.WebHome]] pour plus de détails.
49 * **Notifications** : Permet de configurer des notifications conditionnelles. Consultez la page [[Notification sur un flux de données>>doc:.notify_flow.WebHome]] pour plus de détails.
50 * **Révisions** : Permet d'afficher les révisions du flux comportant la date, l'utilisateur et le commentaire de modification ajouté. Consultez la page [[Révisions des modèles de données et des flux>>doc:Digdash.user_guide.studio.Create_datamodel.configure_data_model.Edit_data_model_properties.revisions.WebHome]] pour plus de détails.
51
52 Si vous effectuez des modifications, cliquez sur le bouton **Appliquer **en haut à droit du panneau pour les valider.
53 )))
54 |=3 : Barre d'outils|(((
55 La barre d'outils permet d'afficher l'aperçu d'un flux, de rafraîchir le rôle et d'accéder à l'analyse des dépendances.
56 Consultez la page [[Analyse des dépendances>>path:/xwiki/wiki/dev/view/Digdash/user_guide/studio/managers/dependencies/]] pour en savoir plus sur cet outil.
57
58 Il donne également accès à des options d'affichage et permet notamment d'afficher/masquer les catégories : cliquez sur le bouton  [[image:1736786406046-185.png||height="26" width="15"]] de la barre d'outils pour accéder au menu.
59
60 [[image:1736786377282-877.png||alt="Menu options"]]
61 )))
62 |=4 : Barre de recherche|(((
63 Dans le cas d'un grand nombre de flux, la barre de recherche permet de trouver le flux souhaité plus facilement.
64 Cliquez sur l'icône [[image:1753348277477-797.png||alt="Filtre"]] pour restreindre la recherche à un type de flux.
65
66 Activez le curseur [[image:1753348238501-967.png||alt="Curseur"]]pour effectuer une recherche par mot-clé dans tous les rôles.
67
68 Le menu hamburger donne accès à d'autres options de recherche et à l'historique de recherche.
69 [[image:1736841042539-500.png||alt="Options recherche"]]
70 )))
71
72 Un ensemble d'options sont également disponibles depuis le menu contextuel du flux disponible via un clic-droit sur celui-ci.
73
74 [[image:Manager_flow_menu_FR.png||alt="Menu contextuel"]]
75
76 = Rechercher un flux{{id name="Recherche"/}} =
77
78 Dans le cas d'un grand nombre de flux, la barre de recherche permet de trouver le(s) flux souhaité(s) plus facilement :
79
80 1. Entrez le mot à rechercher : les résultats sont alors automatiquement filtrés.
81 1. Activez le curseur [[image:1753348245427-966.png||alt="Curseur"]] si vous souhaitez effectuer la recherche dans tous les rôles.(((
82 (% id="cke_bm_436S" style="display:none" %) (%%)Dans ce cas, le nombre de résultats trouvés est indiqué entre parenthèses pour chaque rôle:
83 [[image:1755674356647-392.png]]
84 )))
85
86 Vous pouvez restreindre la recherche à un ou plusieurs types de flux:
87
88 1. Cliquez sur le bouton [[image:1753348287586-581.png||alt="Filtre"]]​pour afficher la liste des types de flux.
89 [[image:Filter_flow_type_FR.png]]
90 1. Cochez les types de flux à filtrer.
91 ➡ Les types de flux filtrés sont affichés sous forme de pastilles dans la barre de recherche.
92 [[image:Filtered_flow_type_FR.png||alt="Types filtrés"]]​[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Cliquer et glisser pour déplacer" width="15"]]
93
94 La recherche s’effectue dans les éléments suivants :
95
96 * identifiant du flux
97 * identifiant du modèle de données (sauf les fabriques)
98 * nom du flux et sa traduction (dans la langue de l’utilisateur connecté)
99 * catégorie et sa traduction (dans la langue de l’utilisateur connecté)
100 * description et sa traduction (dans la langue de l’utilisateur connecté)
101 * type du flux
102 * nom des appareils
103
104 == Recherches spéciales ==
105
106 Les recherches spéciales suivantes sont disponibles. Elles ne sont pas compatibles avec la recherche classique.
107
108 * Recherche de flux personnalisés:
109 **perso:X **
110 où X peut valoir yes, no ou error
111
112 * Recherche par attribut:
113 **attribute:X**
114 où X peut valoir :
115 ** f (filtre)
116 ** m (modèle de visualisation)
117 ** n (notification)
118 ** d (appareil)
119 ** p (personnalisé)
120 ou une combinaison de ces lettres
121
122 == Options supplémentaires ==
123
124 Le menu hamburger donne accès à d'autres options de recherche et à l'historique de recherche.
125 [[image:1736841042539-500.png||alt="Options recherche" height="148" width="470"]]
126
127 (% style="width:1010px" %)
128 |=(% style="width: 365px;" %)Option|=(% style="width: 643px;" %)Description
129 |=(% style="width: 365px;" %)Chercher dans le tableau de bord|(% style="width:643px" %)(((
130 Permet de rechercher un flux dans le tableau de bord affiché sous forme d'arborescence.
131
132 [[image:Saerch_flow_dashboard_FR.png||height="288" width="289"]]
133 )))
134 |=(% style="width: 365px;" %){{glossaryReference glossaryId="Glossary" entryId="Flux"}}Flux{{/glossaryReference}} non utilisés|(% style="width:643px" %)Ouvre l'analyse de dépendances et affiche la liste des flux non utilisés dans un tableau de bord.
135 |=(% style="width: 365px;" %)Astuces de recherche|(% style="width:643px" %)Affiche l'aide et les astuces de recherche sur les flux.
136 |=(% style="width: 365px;" %)//Hsitorique de recherche : coût//|(% style="width:643px" %)Liste des recherches précédemment effectuées.
137 |=(% style="width: 365px;" %)Vider l'historique|(% style="width:643px" %)Supprime la liste d'historique des recherches.
138
139 = Éditer les propriétés d'un flux{{id name="Proprietes_flux"/}} =
140
141 Vous pouvez éditer les propriétés d'un flux dans le panneau latéral.
142
143 **Renommer un flux**
144
145 Tapez le texte souhaité dans le champ **Nom**. Cliquez sur le bouton [[image:1749740050100-289.png]] si vous souhaitez traduire ce nom dans différentes langues.
146
147 **Entrer une description{{id name="Description"/}}**
148
149 Vous pouvez entrer une description du flux. Elle sera notamment utilisée dans le tableau de bord.
150 Cliquez sur le bouton [[image:1749740057209-701.png]]** **si vous souhaitez traduire cette description dans différentes langues.
151
152 (% class="wikigeneratedid" id="HAssignerunfluxE0unecatE9gorie" %)
153 **Assigner un flux à une catégorie**
154
155 1. Cliquez sur le bouton **Editer** à droite du champ **Catégorie**.
156 1. Dans la boite **Choisissez une catégorie**, sélectionnez une catégorie existante dans la liste déroulante ou créez-en une nouvelle en tapant le nom de la nouvelle catégorie.
157 Vous pouvez créer des sous-catégories (et ainsi une hiérarchie) en utilisant le caractère "/" sous la forme suivante :
158 //Ma catégorie/Ma-sous catégorie//
159 [[image:Flow_category_FR.png||height="125" width="296"]]
160 1. (((
161 Cliquez sur le bouton [[image:1749739937594-789.png]]** **si vous souhaitez renseigner l'édition multi-langue puis sur **OK.**
162 )))
163
164 (% class="box infomessage" %)
165 (((
166 Vous pouvez également assigner une catégorie depuis le menu contextuel du flux.
167 )))
168
169 **Définir le nom des exportations**
170
171 Le champ** Exportations **vous permet d'indiquer le nom des fichiers exportés (PPT, PDF,...) si vous souhaitez que le nom soit différent de celui du flux. Vous pourrez utiliser ici des mots-clés comme les filtres appliqués pour contextualiser votre exportation.
172
173 **Éditer le modèle de modèle de données ou le flux**
174
175 Cliquez sur le bouton à droite du champ **Modèle **ou du champ **Graphique** pour éditer respectivement le modèle de données utilisé pour le flux ou le flux lui-même.
176
177 = Gérer l'historique d'un flux =
178
179 **Actualiser l'historique d'un flux**
180
181 Cliquez-droit sur le(s) flux que vous souhaitez actualiser et sélectionnez **Actualiser l'historique**.
182
183 L'historique des flux est mis à jour. Une nouvelle entrée peut être créée dans l'historique si nécessaire (exemple: changement dans la source de données). Les nouveaux éléments générés lors de la programmation apparaissent également.
184
185 **Effacer l'historique d'un flux**
186
187 Cliquez-droit sur le(s) flux que vous souhaitez actualiser et sélectionnez **Effacer l'historique**. L'ensemble des éléments figurant dans l'historique des flux sélectionnés est supprimé. Si vous souhaitez également supprimer les cubes associés aux flux, cochez la case **Effacer aussi les cubes des données des flux sélectionnés. **Vous devez actualiser l'historique pour créer une nouvel élément.
188
189 = Synchroniser un flux =
190
191 Vous pouvez synchroniser un flux pour un utilisateur ou pour tous les utilisateurs d'un rôle.
192
193 **Synchroniser un flux**
194
195 Cliquez-droit sur le(s) flux que vous souhaitez synchroniser et sélectionnez **Synchroniser**. Les flux sont synchronisés pour l'utilisateur connecté et les appareils sélectionnés (seuls les éléments cochés dans l'historique des flux sont synchronisés).
196
197 Pour synchroniser l'ensemble des flux du portefeuille d'information, cliquez-droit sur le portefeuille et sélectionnez **Synchroniser**.
198
199 **Synchroniser un flux pour tous les utilisateurs**
200
201 Cette option est disponible pour les portefeuilles de rôles uniquement. Elle permet la synchronisation des flux du portefeuille pour l'ensemble des utilisateurs ayant ce rôle.
202
203 Cliquez-droit sur le(s) flux que vous souhaitez synchroniser et sélectionnez **Synchroniser pour tous les utilisateurs**. Les flux sont synchronisés pour les appareils sélectionnés.
204
205 = Copier un flux =
206
207 Cliquez-droit sur le(s) flux que vous souhaitez copier et sélectionnez **Copier**. Sélectionnez l'emplacement où vous voulez copier les flux (même rôle ou rôle différent) faites un clic droit et choisissez **Coller**.
208
209 Si vous copiez un flux d'un rôle vers un autre rôle ou la source de données n'existe pas, une boîte de dialogue s'affiche vous demandant si vous voulez également copier le modèle de données.
210
211 [[image:Manager_flow_copy_FR.png||alt="Copie flux" height="236" width="429"]]
212
213 Plusieurs options sont possibles :
214
215 * **Copier le modèle de données dans le rôle destination** : le modèle copié sera un nouveau modèle éditable dans le rôle destination.
216 * **Partager le modèle de données avec le rôle de destination **: le modèle ne sera pas modifiable depuis le rôle de destination. D'autre part, les modifications apportées au modèle d'origine seront automatiquement disponibles dans le modèle de destination.
217 * **Ne rien faire** : si vous ne souhaitez ni partager ni copier la source de données. Dans ce cas, le flux sera copié, mais n'aura pas de source de de données associée.
218
219 (% class="box infomessage" %)
220 (((
221 Si vous souhaitez créer une copie dans un même rôle, vous pouvez également cliquez sur **Dupliquer**. La fenêtre d'édition du flux s'affichera alors automatiquement.
222 )))
223
224 = Copier les paramètres de visualisation d'un flux =
225
226 Vous pouvez copier les paramètres de visualisation d'un flux (palettes de couleurs, styles,...).
227
228 1. Cliquez-droit sur le flux dont vous souhaitez copier les paramètres et sélectionnez **Copier**.
229 1. Sélectionnez les flux sur lesquels vous souhaitez appliquer les paramètres, faites un clic droit et choisissez **Coller les paramètres**.
230 ➡ La boîte **Appliquer les paramètres de visualisation** s'affiche.
231 1. Sélectionnez les paramètres du graphique que vous souhaitez appliquer :
232 [[image:Manager_flow_visu_parameters_FR.png||alt="Paramètres visualisation"]]
233 1. Cliquez sur le bouton **Coller les paramètres**.
234
235 = Copier l'URL du flux =
236
237 Vous pouvez visualiser un flux d'information dans votre navigateur ou l'intégrer dans des pages web.
238
239 Cliquez-droit sur le flux et sélectionnez **Copier l'URL du flux**. L'URL du flux est copiée dans le presse-papiers. Collez l'URL du flux dans votre navigateur ou document.
240
241 = Afficher l'aperçu d'un flux =
242
243 Il est possible d'afficher un aperçu du flux sélectionné en cliquant sur le bouton [[image:1736842351565-745.png||height="21" width="20"]] dans la barre d'outils ou depuis le menu contextuel du flux.
244 Une fenêtre s'ouvre et affiche le flux comme illustré ci-dessous. S'il existe une hiérarchie, il est possible de naviguer dans celle-ci.
245
246 (% class="box infomessage" %)
247 (((
248 L'aperçu affiche la version synchronisée du flux pour votre utilisateur. Si le flux n'est pas synchronisé et que la programmation est activée, la synchronisation sera exécutée.
249 )))
250
251 [[image:Manager_flow_preview_FR.png||height="376" width="409"]]
252
253 = Ouvrir le flux dans un navigateur{{id name="flux_navigateur"/}} =
254
255 (% class="box infomessage" %)
256 (((
257 ℹ La disponibilité des différentes options dépend des autorisations de l'utilisateur.
258 )))
259
260 Vous pouvez visualiser et interagir sur un flux directement dans votre navigateur :
261
262 * Cliquez-droit sur le flux et sélectionnez **Ouvrir l'aperçu du flux dans un navigateur**.
263 ➡ Un nouvel onglet s'ouvre avec le flux et des options disponibles dans le menu utilisateur.
264
265 [[image:Flow_in_browser_FR.png||alt="Flux navigateur" data-xwiki-image-style-border="true" height="354" width="634"]]
266
267 Pour filtrer les données du graphique: depuis le menu utilisateur, cliquez sur **Afficher les filtres**.
268 La barre de filtres s'affiche alors au-dessus du graphique.
269 Il est possible d'afficher le résumé des filtres en dessous du graphique en ajoutant le paramètre **&//filterSummary=true//** dans l'URL.
270
271 Pour exporter le graphique, cliquez sur **Sauvergarder... **au format souhaité.
272
273 (% class="box infomessage" %)
274 (((
275 💡 **Export Excel des tableaux**
276
277 * L'option **Sauvergarder en Excel Standard **conserve l'ensemble des styles.
278 * L'option **Sauvegarder en Excel Rapide** conserve seulement une partie de styles. Elle permet une génération plus rapide tout en conservant une mise en forme. Consultez la page [[Options d'export>>doc:Digdash.deployment.configuration.configuration_guide.export_options.WebHome]] pour plus de détails.
279 )))