Last modified by Aurelie Bertrand on 2025/02/07 10:14
Show last authors
1 (% class="box infomessage" %)
2 (((
3 🙋 Ce tutoriel est à destination des **utilisateurs avancés**.
4
5 ⏱ Il est prévu pour être suivi de manière autonome en **1 heure**.
6 )))
7
8 ----
9
10 {{ddtoc/}}
11
12 ----
13
14 = Introduction =
15
16 Dans ce tutoriel, nous allons décourvrir comme créer et appliquer un Alerteur (ou format alerteur) , et ce, à travers deux exemples.
17
18 Le format Alerteur est utilisé pour modifier l'affichage des données selon leur valeur grâce à l'utilisation de texte, couleurs ou icônes spécifiques. Il permet ainsi d’identifier facilement et rapidement les données nécessitant une attention spécifique.
19
20 Le jeu de données Retail.xls utilisé dans le tutoriel correspond à des données fictives d'une entreprise de vente au détail contenant des informations sur les produits et des données de type prix, chiffre d'affaires, marge, etc.
21
22 Ce tutoriel se déroule dans le Studio.
23 Les différentes étapes de ce tutoriel sont les suivantes :
24
25 * Création du modèle de données basé sur le fichier retailfr.xls
26 * Création de graphiques tableau présentant des données de chiffres d'affaire et marge
27 * Création de nouveaux formats Alerteur
28 * Application des alerteurs et visualisation du résultat
29
30 = Pré-requis =
31
32 Afin de pouvoir effectuer ce tutoriel, il est requis de :
33
34 * disposer d'une installation de DigDash Enterprise d'une version 2024R2 ou plus récente ;
35 * faire partie en tant qu'utilisateur du groupe d'autorisation "**Concepteur de modèles de données**";
36 * télécharger le fichier Excel [[retailfr.xls>>attach:retailfr.xls]].
37
38 (% class="box" %)
39 (((
40 ℹ Les copies d'écran de ce tutoriel ont été réalisées avec le navigateur Chrome. Il peut y avoir de légères différences selon le navigateur.
41 )))
42
43 = Étape 1 : Créer et configurer le modèle de données =
44
45 == Importer la source de données retailfr.xls ==
46
47 Nous allons ici importer les données du fichier Excel retailfr.xls téléchargé précédemment. Pour cela :
48
49 1. Lancez le Studio.
50 1. Cliquez sur l'onglet **Modèles**.
51 1. Cliquez sur le bouton **Nouveau modèle**.
52 1. Dans la boîte **Création d'un nouveau modèle de données**, sélectionnez **Tous types **dans la rubrique **Fichiers **puis ajoutez et sélectionnezle fichier //retailfr.xls.//
53 1. //C//liquez sur **OK**.
54
55 La fenêtre **Fichier Excel **s’affiche. Elle propose des options de sélection de données et une prévisualisation de celles-ci. Nous allons y configurer le modèle de données.
56
57 == Configurer le modèle de données ==
58
59 Les éléments de la première ligne du tableau correspondent à l'intitulé des données de chaque colonne. Nous allons donc les utiliser comme en-têtes de colonnes. Pour cela, dans la section **Sélection des données**, cochez la case **Première ligne en tant qu’entête**.
60
61 === Filtrer les familles de produits ===
62
63 Nous allons ici nous concentrer sur les familles de produits :
64
65 * Bricolage
66 * Charcuterie
67 * Dessert
68 * Telecom
69
70 Nous allons donc filtrer les lignes pour lesquelles le champ **Famille **est égal aux valeurs ci-dessus. Pour cela, dans la section **Sélection des données** :
71
72 1. Cliquez sur le bouton **Ajouter…**
73 1. Dans la boîte **Edition d’une règle de filtre**, sélectionnez** Famille** puis **répond à l’expression régulière **puis renseignez **Bricolage|Charcuterie|Dessert|Telecom**.
74 [[image:Add_rule_FR.png||alt="Ajout règle"]]
75 1. Cliquez sur** OK**.
76 ➡ Les autres membres de la dimension **Famille **sont grisés.
77 1. Cliquez sur le bouton **Suivant** en bas à droite pour ouvrir la fenêtre de configuration du modèle de données.
78
79 === Créer les mesures CA (Année - 1) et CA ~(% Progression) ===
80
81 Nous allons maintenant créer 2 nouvelles mesures calculées avec l’assistant : CA (Année - 1) et CA ~(% Progression) afin d'obtenir l'évolution du chiffre d'affaires d'une année sur l'autre. Pour cela :
82
83 1. Dans l'onglet **Colonnes**, cliquez sur le bouton **Nouvelle mesure**.
84 1. Cliquez sur **Mesure calculée** :
85 1*. Pour la mesure **CA (Année - 1)**, glissez-déposez la fonction **Année - 1** de l’onglet **Transformateur **sur la mesure** CA**.
86 [[image:Measure_revenue_N-1_FR.png||alt="CA Année N-1"]]
87
88 1*. Pour la mesure **CA ~(% Progression):**
89 1**. Glissez-déposez la fonction **% Progression** de l’onglet **Général **sur la mesure** CA**.
90 1**. Définissez la progression entre la **Première mesure** : //CA (Année-1) //et la **Deuxième mesure** : //CA.//
91 1**. Sélectionnez le **Format **: //Pourcentage //et cliquez sur **OK**.
92 [[image:Measure_revenue_progression_FR.png||alt="Mesure CA progression"]]
93 ➡ Les mesures calculées sont ajoutées à la liste des colonnes.
94 1. Dans l'onglet** Propriétés**, nommez le modèle de données **Retail** puis cliquez sur **Terminer **en bas à droite pour l’enregistrer.
95
96 Maintenant que le modèle de données retail est configuré, nous allons pouvoir créer les graphiques basés sur ce modèle.
97
98 = Étape 2 : Créer les graphiques =
99
100 Nous allons à présent créer les graphiques que nous insérerons dans notre fabrique PDF.
101 Tous les graphiques créés dans ce tutoriel se baseront sur le modèle de données retail.
102
103 Pour créer un graphique (flux), dans l'onglet **{{glossaryReference glossaryId="Glossary" entryId="Flux"}}Flux{{/glossaryReference}}**, cliquez sur le bouton **Nouveau flux** puis sélectionnez le flux souhaité.
104
105 [[image:New_flow_FR.png]]
106
107 (% style="line-height: 1.2; text-align: justify;" %)
108 == Tableau de synthèse du CA par famille de produit ==
109
110 1. Créez un nouveau flux de type **{{glossaryReference glossaryId="Glossary" entryId="Tableau croisé"}}Tableau croisé{{/glossaryReference}}**.
111 1. Sélectionnez le modèle de données et entrez le nom **Synthèse du CA par famille de produit**.
112 1. Déposez la dimension **Famille **sur l’axe **Colonne 1**.
113 1. Déposez les mesures  **CA**, **CA (Année - 1)** et **CA ~(% Progression)** sur l’axe **Ligne 1**.
114 [[image:Crosstable_revenuebyfamilyproduct_FR.png||alt="Tableau croisé"]]
115
116 1. Cliquez sur le bouton de tri de l’axe **Colonne 1** et appliquez un tri décroissant sur la mesure CA.
117 [[image:Crosstable_sort_FR.png||alt="Tri décroissant"]]
118 1. Cliquez sur **OK **pour enregistrer.
119
120 (% style="line-height: 1.2; text-align: justify;" %)
121 == Tableau de synthèse du CA et de la marge pour les produits de bricolage ==
122
123 1. Créez un nouveau flux de type **Tableau**.
124 1. Sélectionnez le modèle de données et entrez le nom **Synthèse CA et marge Bricolage**.
125 1. Déposez la dimension **Produit **sur l’axe **Colonne 1**.
126 1. Déposez les mesures  **CA **et **Marge **sur les axes** Colonnes 2 **et **3.**
127 1. Filtrez la** Famille **sur le membre** Bricolage.**
128 [[image:Crosstable_revenue_margin_brico_FR.png||alt="Synthèse CA et marge Bricolage"]]
129
130 1. Cliquez sur **OK** pour enregistrer et confirmez la sauvegarde du filtre.​
131 ​​​​​​[[image:1737537540097-270.png||alt="Sauvegarde filtres" height="120" width="467"]]
132
133 = Étape 3 : Créer les alerteurs =
134
135 Nous allons à présent créer les alerteurs que nous utiliserons dans les tableaux que nous avons créés précédemment.
136
137 Pour créer un nouvel alerteur :
138
139 1. Allez dans l'onglet **Gestionnaires **du Studio puis sélectionnez **Formats** pour ouvrir le Gestionnaire de formats.
140 [[image:Select_manager_FR.png||alt="Gestionnaires" height="466" width="1027"]](((
141 ➡ L'**Editeur de format** s'ouvre et liste les types et formats disponibles.
142 )))
143 1. Sélectionnez le type de format **Alerteur** et cliquez sur le bouton **+** .
144 [[image:Format_editor_alerter_FR.png||alt="Editeur de format" height="518" width="861"]]
145
146 == Création de l'alerteur _tutoriel_progression ==
147
148 Nous allons créer un premier alerteur permettant de mettre en évidence le pourcentage de progression du chiffre d'affaires pour le tableau Synthèse du CA par famille de produit :
149
150 * Une flèche rouge vers le bas pour une progression négative
151 * Un signe égal gris pour une progression nulle
152 * Une flèche verte vers le haut pour une progression positive
153
154 1. Créez un nouveau format alerteur avec le nom **_tutoriel_progression **et le rôle **(Aucun)** (pas de restriction du rôle).
155 [[image:Format_name_alerter_FR.png||alt="Nom format" height="154" width="342"]]
156 ➡ Le nouvel alerteur est ajouté dans liste à gauche.
157 1. Dans le champ **Langue **de la partie de droite, laissez **Défaut** : l'alerteur s'appliquera par défaut à toutes les langues.
158
159 (% class="box infomessage" %)
160 (((
161 💡 Il est possible de sélectionner la langue pour laquelle l’alerteur sera effectif. Ainsi, nous pouvons dissocier un comportement du format alerteur en fonction de la langue de l’utilisateur.
162 )))
163
164 (% start="3" %)
165 1. Cliquez sur le bouton **+** dans la section **Edition du format**  à droite pour créer les différentes mises en forme :
166 1*. **Progression nulle :**
167 1*1. Pour le **Type en entrée**, sélectionnez //Valeur //** **et entrez //0//.
168 1*1. Pour le **Type en sortie**, sélectionnez //Couleur + icône// au **Format** //Pourcentage.//
169 1*1. Sélectionnez**// //**ensuite(% style="font-weight:bold" %)//** **//(%%)le signe égal gris comme **//Image//**.
170 [[image:Alerter_no_progression_FR.png||alt="Progression nulle"]]
171 1*1. Cliquez sur **OK**.
172
173 1*. **Progression négative :**
174 1*1. Pour le **Type en entrée**, sélectionnez //Intervalle//.
175 1*1. Sélectionnez**// //**ensuite**// //**//-infini// pour le **Minimum **et entrez //0// pour le **Maximum**.
176 1*1. Pour le **Type en sortie**, sélectionnez //Couleur + icône// au **Format** //Pourcentage.//
177 1*1. Sélectionnez**// //**ensuite(% style="font-weight:bold" %)//** **//(%%)la flèche rouge vers le bas comme **//Image//**.
178 [[image:Alerter_negative_progression_FR.png||alt="Negative progression"]]
179 1*1. Cliquez sur **OK**.
180
181 1*. **Progression positive :**
182 1*1. Pour le **Type en entrée**, sélectionnez //Intervalle//.
183 1*1. Entrez ensuite 0 pour le **Minimum **et sélectionnez //+infini// pour le **Maximum**.
184 1*1. Pour le **Type en sortie**, sélectionnez //Couleur + icône// au **Format** //Pourcentage.//
185 1*1. Sélectionnez**// //**ensuite(% style="font-weight:bold" %)//** **//(%%)la flèche verte vers le haut comme **//Image//**.
186 [[image:Alerter_positive_progression_FR.png||alt="Progression positive"]]
187
188 1*1. Cliquez sur **OK**.
189 ➡ Les éléments de l'alerteur sont listés.
190 [[image:Format_alerter_progression_FR.png||alt="Alerteur progression"]]
191
192 (% class="box infomessage" %)
193 (((
194 💡Vous pouvez créer plusieurs mises en forme pour votre alerteur.
195 À noter également que la mise en forme définie comme **Défaut **sera utilisée si aucune autre mise en forme ne s'applique aux données et que l’ordre de priorité des mises en forme se fait de haut en bas.
196 )))
197
198 == Création de l'alerteur _tutoriel_marge ==
199
200 Nous allons créer un second alerteur permettant de mettre en évidence  la valeur de marge pour le tableau Synthèse CA et marge Bricolage.
201 Ici, nous allons remplir le fond de la donnée en vert pour toute valeur numérique supérieure ou égale à 500. Nous ajoutons également une mise en forme afin d'afficher en rouge, les données inférieure à la valeur numérique 450 :
202
203 1. Créez un nouveau format alerteur avec le nom **_tutoriel_marge **et le rôle **(Aucun)** (pas de restriction du rôle).
204 ➡ Le nouvel alerteur est ajouté dans liste à gauche.
205 1. Dans le champ **Langue **de la partie de droite, laissez **Défaut** : l'alerteur s'appliquera par défaut à toutes les langues.
206 1. Cliquez sur le bouton **+** dans la section **Edition du format**  à droite pour créer les différentes mises en forme :
207 1*. **Marge supérieure à 480 :**
208 1*1. Pour le **Type en entrée**, sélectionnez //Valeur//.
209 1*1. Entrez ensuite //480// pour le **Minimum **et sélectionnez //+infini// pour le **Maximum**.
210 1*1. Pour le **Type en sortie**, sélectionnez //Couleur// au **Format** //Nombre.//
211 1*1. Sélectionnez**// //**ensuite(% style="font-weight:bold" %)//** **//(%%)la couleur de remplissage (vert : #71c31f).
212 [[image:Alerter_margin+_FR.png||alt="Marge supérieure"]]
213 1*1. Cliquez sur **OK**.
214
215 1*. **Marge inférieure à 480 :**
216 1*1. Pour le **Type en entrée**, sélectionnez.
217 1*1. Sélectionnez**// //**ensuite**// //**//-infini// pour le **Minimum **et entrez //450// pour le **Maximum**.
218 1*1. Pour le **Type en sortie**, sélectionnez //Couleur// au **Format** //Nombre.//
219 1*1. Sélectionnez**// //**ensuite(% style="font-weight:bold" %)//** **//(%%)la couleur de remplissage (rouge : #d95858).
220 [[image:Alerter_margin-_FR.png||alt="Marge inférieure"]]
221 1*1. Cliquez sur **OK**.
222 ➡ Les éléments de l'alerteur sont listés.
223 [[image:Alerter_margin_FR.png||alt="Alerteur marge"]]
224
225 (% class="box infomessage" %)
226 (((
227 💡L’utilisation d’un alerteur pour la modification de la couleur de fond est une application classique de format.
228 Vous pouvez également, grâce aux alerteurs, modifier le format de sortie en fonction de la donnée en entrée (par exemple, Pourcentage à la pace de Nombre).
229 )))
230
231 La création des alerteurs est terminée : cliquez sur **OK** en bas à droite pour valider et fermer l'**Editeur de format**.
232 Nous allons à présent affecter les alerteurs aux données.
233
234 = Étape 4 : Appliquer l'alerteur aux données =
235
236 Il est possible d’appliquer un format de type alerteur au niveau d'un flux ou d'un modèle données.
237 Il est généralement recommandé d’appliquer un format de type alerteur sur le flux servant à restituer les informations souhaitées.
238 En effet, en appliquant un format sur le modèle de données, vous affecterez l’ensemble des flux utilisant ce modèle. De la même manière, si vous éditez un modèle existant en affectant un format de type alerteur ou autre, alors lorsque le flux sera de nouveau synchronisé, les données affichées seront modifiées.
239
240 Nous allons ici appliquer les formats alerteur au niveau des flux.
241
242 == Alerteur progression du chiffre d'affaires ==
243
244 1. Ouvrez le tableau Synthèse du CA par famille de produit depuis l'onglet **{{glossaryReference glossaryId="Glossary" entryId="Flux"}}Flux{{/glossaryReference}} **du Studio.
245 1. Cliquez-droit sur la mesure **CA ~(% Progression)**.
246 1. Dans le menu contextuel qui s'affiche, cliquez sur **Appliquer un format** > **Alerteur** > **_tutoriel_progression (Alerteur)**.
247 **[[image:Apply_alerter_progression_FR.png||alt="Appliquer alerteur progression"]]**
248 \\➡ L'affichage de la mesure //CA ~(% Progression)// est modifié.
249 [[image:1737541188480-117.png||alt="CA progression avec alerteur"]]
250
251 1. Sélectionnez une année dans le filtre **Date**, par exemple 2019, afin de visualiser le cas de progression positive ou négative.
252 [[image:1737541274823-424.png||alt="CA progression avec alerteur Filtre"]]
253
254 == Alerteur marge ==
255
256 1. Ouvrez le tableau //Synthèse CA et marge Bricolage// depuis l'onglet **{{glossaryReference glossaryId="Glossary" entryId="Flux"}}Flux{{/glossaryReference}} **du Studio.
257 1. Cliquez-droit sur la mesure **Marge**.
258 1. Dans le menu contextuel qui s'affiche, cliquez sur **Appliquer un format** > **Alerteur** > **_tutoriel_marge (Alerteur)**.[[image:Apply_alerter_margin_FR.png]](((
259 ➡ L'affichage de la mesure //Marge// est modifié en conséquence.
260 ​​​​​​​[[image:1737542143072-293.png||alt="Affichage marge modifié"]]
261
262 = Félicitations ! =
263
264 Vous avez réussi à créer et appliquer vos premiers formats Alerteur.
265
266 Les alerteurs permettent une mise en forme plus poussée qu’un simple format ou une combinaison de couleurs et formats. Vous pouvez afficher du texte selon la langue de l’utilisateur ou bien afficher des icônes. Il est possible de combiner plusieurs alerteurs comme évoqué plus haut.
267 De plus, les alerteurs sont applicables à de nombreux types de graphiques, pas uniquement aux tableaux.
268
269
270
271 Les possibilités sont multiples et il ne tient qu'à vous d’en découvrir toutes les facettes !
272
273
274
275 )))