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 2 heures.**
6 )))
7
8 ----
9
10 {{ddtoc/}}
11
12 ----
13
14 = Introduction =
15
16 Dans ce tutoriel, nous allons découvrir comment créer une {{glossaryReference glossaryId="Glossary" entryId="fabrique de documents"}}fabrique de documents{{/glossaryReference}} PDF.
17
18 Pour cela, nous allons réaliser un rapport PDF sur le chiffre d'affaires (CA) réalisé pour différentes familles de produits d'une entreprise. Il s'appuie sur le jeu de données retailfr.xls qui 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.
19
20 Les différentes étapes de ce tutoriel sont les suivantes:
21
22 * Création du modèle de données basé sur le fichier retailfr.xls
23 * Création des 6 graphiques à utiliser pour le rapport : 
24 ** Tableau de synthèse du CA par famille de produit
25 ** Tableau de détail du CA par produit
26 ** Courbe d’évolution du CA par mois
27 ** Carte de répartition du CA par région
28 ** Comparaison du CA par produit
29 ** Tableau listant les familles de produit pour les sections
30 * Création de la fabrique PDF
31 * Création de la page de tableau de bord permettant de générer le rapport PDF
32
33 = Prérequis =
34
35 Afin de pouvoir effectuer ce tutoriel, il est requis de :
36
37 * disposer d'une installation de DigDash Enterprise d'une version 2024R2 ou plus récente ;
38 * faire partie en tant qu'utilisateur des groupes d'autorisation "**Concepteur de modèles de données**" et "**Concepteur de tableaux de bord**";
39 * télécharger l’archive des ressources [[tutoriel_fabrique_pdf_ressources.zip>>attach:tutoriel_fabrique_pdf_ressources.zip]] contenant le fichier retailfr.xls et les images utilisées.
40
41 (% class="box" %)
42 (((
43 ℹ 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.
44 )))
45
46 = Étape 1 : Créer et configurer le modèle de données =
47
48 (% class="box infomessage" %)
49 (((
50 La totalité de cette partie du tutoriel se déroule dans le Studio.
51 )))
52
53 == Importer la source de données retailfr.xls ==
54
55 Nous allons ici importer les données du fichier Excel retailfr.xls téléchargé précédemment. Pour cela :
56
57 1. Lancez le Studio.
58 1. Cliquez sur l'onglet **Modèles**.
59 1. Cliquez sur le bouton **Nouveau modèle**.
60 [[image:New_model_all_files_FR.png||alt="Nouveau modèle Fichiers"]]
61
62 1. Dans la boîte **Création d'un nouveau modèle de données**, sélectionnez **Tous types **dans la rubrique **Fichiers.**
63 1. Dans la boîte **Recherche de fichiers distants**, sélectionnez “**Common Datasources**” dans la liste déroulante **Serveur** puis cliquez sur le bouton **Ajouter un fichier au serveur…**
64 [[image:Search_remote_files_FR.png]]
65
66 1. Dans la boîte **Sélection d’un fichier**, sélectionnez **Depuis votre ordinateur**, cliquez sur le bouton **Parcourir… **puis recherchez le fichier //retailfr.xls//
67 1. Cliquez sur **OK**.
68 ➡ Le fichier est maintenant enregistré sur le serveur DigDash Common Datasources et accessible à tous les utilisateurs.
69
70 (% start="5" %)
71 1. Dans la boîte **Recherche de fichiers distants**, sélectionnez le fichier //retailfr.xls //puis cliquez sur **OK**.
72
73 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.
74
75 == Configurer le modèle de données ==
76
77 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**.
78
79 === Filtrer les familles de produits ===
80
81 Nous allons ici nous concentrer sur les familles de produits :
82
83 * Charcuterie
84 * Dessert
85 * Sport & loisir
86 * Telecom
87
88 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** :
89
90 1. Cliquez sur le bouton **Ajouter…**
91 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 **Charcuterie|Dessert|Sport & loisir|Telecom**.
92 [[image:Rule_filter_family_FR.png]]
93 1. (% style="color:#36525b; font-size:14.6667px; white-space-collapse:preserve" %)Cli(%%)quez sur** OK**.
94 ➡ Les autres membres de la dimension **Famille **sont grisés.
95 1. Cliquez sur le bouton **Suivant** en bas à droite pour ouvrir la fenêtre de configuration du modèle de données.
96
97 === Créer les mesures CA (Année - 1) et CA ~(% Progression) ===
98
99 Nous allons maintenant créer 2 nouvelles mesures calculées avec l’assistant : CA (Année - 1) et CA ~(% Progression). Pour cela :
100
101 1. Dans l'onglet **Colonnes**, cliquez sur le bouton **Nouvelle mesure**.
102 1. Cliquez sur **Mesure calculée** :
103 1*. Pour la mesure **CA (Année - 1)**, glissez-déposez la fonction **Année - 1** de l’onglet **Transformateur **sur la mesure** CA**.
104 [[image:New_calculated_measure_revenue_FR.png||alt="Nouvelle mesure CA N-1"]]
105
106 1*. Pour la mesure **CA ~(% Progression):**
107 1**. Glissez-déposez la fonction **% Progression** de l’onglet **Général **sur la mesure** CA**.
108 1**. Définissez la progression entre la **Première mesure** : //CA (Année-1) //et la **Deuxième mesure** : //CA.//
109 1**. Sélectionnez le **Format **: //Pourcentage //et cliquez sur **OK**.
110 [[image:New_measure_revenue_progression_FR.png||alt="Progression CA"]]
111 ➡ Les mesures calculées sont ajoutées à la liste des colonnes.
112 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.
113
114 Maintenant que le modèle de données retail est configuré, nous allons pouvoir créer les graphiques basés sur ce modèle.
115
116 = Étape 2 : Créer les graphiques =
117
118 (% class="box infomessage" style="line-height: 1.2; text-align: justify;" %)
119 (((
120 ℹ La totalité de cette partie du tutoriel se déroule dans le Studio.
121 )))
122
123 Nous allons à présent créer les graphiques que nous insérerons dans notre fabrique PDF.
124 Tous les graphiques créés dans ce tutoriel se baseront sur le modèle de données retail.
125
126 Pour créer un graphique (flux), cliquez sur le bouton **Nouveau flux** puis sélectionnez le flux souhaité.
127
128 [[image:New_flow_FR.png]]
129
130 (% style="line-height: 1.2; text-align: justify;" %)
131 == Tableau de synthèse du CA par famille de produit ==
132
133 1. Créez un nouveau flux de type **{{glossaryReference glossaryId="Glossary" entryId="Tableau croisé"}}Tableau croisé{{/glossaryReference}}**.
134 1. Sélectionnez le modèle de données et entrez le nom **Synthèse du CA par famille de produit**.
135 1. Déposez la dimension **Famille **sur l’axe **Colonne 1**.
136 1. Déposez les mesures  **CA**, **CA (Année - 1)** et **CA ~(% Progression)** sur l’axe **Ligne 1**.
137 [[image:Flow_revenue_synthesis_FR.png||alt="Synthèse du CA par famille"]]
138
139 1. Cliquez sur le bouton de tri de l’axe **Colonne 1** et appliquez un tri décroissant sur la mesure CA.
140 [[image:Family_sort_measure_FR.png||alt="Tri sur la mesure"]]
141
142 Nous allons à présent ajouter un format alerteur à la mesure **CA ~(% Progression) **:
143
144 1. Cliquez-droit sur la mesure **CA ~(% Progression) **puis cliquez sur **Appliquer un format -> Gestionnaire des formats... **
145 [[image:1738318144425-934.png||alt="Format CA progression"]]
146
147 1. Dans l'**Éditeur de formats**, sélectionnez **Alerteur** puis cliquez sur le bouton **+** pour créer un nouveau format alerteur **_tutoriel_progression.
148 [[image:New_format_tuto_progression_FR.png]]**
149
150 1. Cliquez sur le bouton **+** dans la section **Edition du format**  à droite pour créer les alerteurs suivants avec en **Type de sortie** //Couleur + icône// au **Format** //Pourcentage ~://
151 1*. Valeur **0** : signe égal
152 [[image:New_alerter_tuto_progression_FR.png||alt="Nouvel alerteur ="]]
153
154 1*. Intervalle **-infini à 0 **: flèche rouge descendante
155 [[image:New_alerter_tuto_progression_neg_FR.png||alt="Nouvel alerteur négatif"]]
156
157 1*. Intervalle **0 à +infini** : flèche verte montante
158 [[image:New_alerter_tuto_progression_pos_FR.png||alt="Nouvel alerteur +"]]
159
160 (% class="box warningmessage" %)
161 (((
162 ℹ L'ordre de création des alerteurs doit être respecté.
163 )))
164
165 (% start="4" %)
166 1. Cliquez sur **OK** et sélectionnez le format alerteur** _tutoriel_progression** pour la mesure.[[image:1738319323337-417.png||alt="Format _tutoriel_progression"]](((
167 ➡ Nous obtenons l'affichage suivant dans le tableau :
168 [[image:1738319397544-607.png||alt="Tableau avec alerteur"]]
169 )))
170 1. Cliquez sur **OK **en bas à droite de la fenêtre d'édition pour enregistrer le flux.
171
172 == Tableau de détail du CA par mois ==
173
174 (% start="1" %)
175 1. Créez un nouveau flux de type **{{glossaryReference glossaryId="Glossary" entryId="Tableau croisé"}}Tableau croisé{{/glossaryReference}}**.
176 1. Sélectionnez le modèle de données et entrez le nom **Détail du CA par mois**.
177 1. Déposez la dimension **Date** sur l’axe **Colonne 1 **(au niveau Mois de la hiérarchie Date).
178 [[image:Date_hierarchy_selection_FR.png||alt="Hiérarchie date"]]
179
180 1. Déposez les mesures **CA**, **CA (Année - 1)** et **CA ~(% Progression)** sur l’axe **Ligne 1**.
181 1. Appliquez le format alerteur **_tutoriel_progression** créé précédemment à la mesure **CA ~(% Progression)**(((
182 [[image:Apply_format_alerter_revenue_date_FR.png||alt="Appliquer le format alerteur _tutoriel_progression"]]
183 )))
184 1. Cliquez sur le bouton de tri [[image:Sort_button_FR.png||alt="Bouton Tri"]] de l’axe **Colonne 1** et appliquez le **Tri du modèle de données **afin de trier les mois par ordre chronologique.
185 [[image:Sort_date_DM_FR.png||alt="Tri modèle de données"]]
186 1. Cliquez sur **OK **en bas à droite de la fenêtre d'édition pour enregistrer le flux.
187
188 == Courbe d’évolution du CA par mois ==
189
190 (% start="1" %)
191 1. Créez un nouveau flux de type **{{glossaryReference glossaryId="Glossary" entryId="Courbes"}}Courbes{{/glossaryReference}}**.
192 1. Sélectionnez le modèle de données et entrez le nom **Courbe d’évolution du CA par mois**.
193 1. Déposez la dimension **Date** sur l’axe **Abscisse** (au niveau Mois de la hiérarchie Date).
194 1. Déposez la mesure **CA** sur l’axe **Lignes**.
195 1. Depuis l'onglet **Paramètres spécifiques** du panneau de droite, ajoutez le marqueur **Cercle** (contenu dans la catégorie **Autre**).
196 [[image:Add_marker_lines_FR.png||alt="Courbe d’évolution du CA par mois"]]
197
198 1. Cliquez sur **OK **en bas à droite de la fenêtre d'édition pour enregistrer le flux.
199
200 == Carte de répartition du CA par région ==
201
202 1. Créez un nouveau flux de type **Carte**.
203 1. Sélectionnez le modèle de données et entrez le nom **Répartition du CA par région**.
204 1. Déposez la mesure **CA** sur l’axe **Axe des mesures**.
205 1. Déposez la dimension **Région Magasin** dans l’axe **Géographie** : sélectionnez le niveau **Continent** de la hiérarchie **Géographique** et cochez la case **Ajouter l’action "Naviguer dans les hiérarchies"**.
206 [[image:Region_hierarchy_selection_FR.png||alt="Hirérarchie région magasin"]]
207
208 1. Dans l'onglet **Interaction **du paneau de droite, cochez la case **Naviguer dans la hiérarchie** **si un filtre est appliqué**.
209 [[image:Map_revenue_region_FR.png||alt="Naviguer dans la hiérarchie si un filtre est appliqué"]]
210
211 1. Cliquez sur **Couleurs **dans la barre d'outils** **pour afficher les options de couleur.
212 1. Cliquez sur le bouton **Éditer [[image:Edit_button.png||alt="Editer" height="28" width="27"]] **à droite de la palette principale afin d'ouvrir le **Gestionnaire de la palette de couleurs**.
213 1. Cliquez sur le bouton **+** pour créer une nouvelle palette de couleurs :
214 1*. Entrez le nom  **_tutoriel_carte**.
215 1*. Définissez les 2 couleurs de la palette : codes couleur #FFEBD7 et #B15900.
216 [[image:Color_map_tuto_map_FR.png]]
217
218 1*. Cliquez sur** OK**.
219 ➡ La nouvelle palette de couleurs s'applique à la carte.
220 [[image:1738328590656-399.png||alt="Carte nouvelle palette" height="417" width="651"]]
221 1. Cliquez sur **OK **en bas à droite de la fenêtre d'édition pour enregistrer le flux.
222
223 == Comparaison du CA par produit ==
224
225 (% start="1" %)
226 1. Créez un nouveau flux de type **Barres**.
227 1. Sélectionnez le modèle de données et entrez le nom **Comparaison du CA par produit**.
228 1. Déposez la dimension **Produit **sur l’axe **Barre**.
229 1. Déposez la mesure **CA** sur l’axe **Empilement**.
230 1. Modifiez la distribution des couleurs dans les options de couleurs : activez la distribution des couleurs sur l'axe **Barres**.
231 [[image:Color_palette_bar_FR.png||alt="Distribution couleurs Barres"]]
232
233 1. Cliquez sur le bouton de tri de l’axe **Barre** et appliquez un tri décroissant sur la mesure **CA**.
234 [[image:Sort_bar_product_revenue_FR.png||alt="Tri décroissant CA"]]
235
236 1. Appliquez le format **Nb Abbrev** sur la mesure **CA**.
237 [[image:Apply_nb_abbrev_revenue.png]]
238
239
240 (% start="8" %)
241 1. Dans l'onglet **Etiquettes **du panneau de droite:
242 1*. activez le **Contenu des barres**.
243 1*. cochez la case **Couleur automatique du texte**.
244 [[image:1738329396496-547.png||alt="Comparaison du CA par produit"]]
245 1. Cliquez sur **OK **en bas à droite de la fenêtre d'édition pour enregistrer le flux.
246
247 == Tableau listant les familles de produit ==
248
249 Nous allons créer un tableau listant les familles de produit que nous allons utiliser afin de créer une section. Cette section permettra de dupliquer la page de détails du chiffre d'affaires pour chaque famille de produit contenue dans le tableau.
250
251 (% start="1" %)
252 1. Créez un nouveau flux de type **Tableau**.
253 1. Sélectionnez le modèle de données et entrez le nom **Liste des familles de produit**.
254 1. Déposez la dimension **Famille** sur l’axe **Colonne 1**.
255 1. Cliquez sur le bouton de tri de l’axe **Colonne 1** et appliquez un tri alphabétique croissant.
256 [[image:Sort_alphabetic_family_measure_FR.png||alt="Liste des familles de produit"]]
257
258 (% start="5" %)
259 1. Cliquez sur **OK **en bas à droite de la fenêtre d'édition pour enregistrer le flux.
260
261 Nous avons créé tous les graphiques nécessaires au rapport. Nous allons donc à présent créer la {{glossaryReference glossaryId="Glossary" entryId="fabrique de documents"}}fabrique de documents{{/glossaryReference}} PDF.
262
263 = Étape 3 : Configurer la fabrique PDF =
264
265 (% class="box infomessage" %)
266 (((
267 ℹ La totalité de cette partie du tutoriel se déroule dans le Studio.
268 )))
269
270 (((
271 (% role="presentation" %)
272 Nous allons ici créer et configurer la {{glossaryReference glossaryId="Glossary" entryId="fabrique de documents"}}fabrique de documents{{/glossaryReference}} PDF. Nous allons y ajouter les graphiques précédemment créés ainsi que des zones de texte, images, numéros de pages... afin d'obtenir un rapport complet.
273
274 (% id="HCrE9ationetpropriE9tE9sdelafabriquePDF" role="presentation" %)
275 == Créer et définir les propriétés de la fabrique PDF ==
276 )))
277
278 1. Créez un nouveau flux de type **Fabrique de documents PDF** puis, dans l’onglet **Propriétés** :
279 1. Nommez ce flux **Rapport PDF**.
280 1. Définissez le nom de sortie du fichier PDF dans le champ **Nom des exportations** : tutoriel_rapport_CA_${filter.Date}_${filter.Région Magasin}_${date.yyyyMMddhhmm}.
281
282 (% class="box infomessage" %)
283 (((
284 💡 Le texte **${date.yyyyMMddhhmm}** mis dans le champ **Nom des exportations** correspond à un mot clé DigDash permettant d’obtenir la date du jour sous le format AAAAMMJJhhmm.
285 )))
286
287 (% start="4" %)
288 1. Cliquez sur le bouton **Editeur**.
289 [[image:New_PDF_builder_FR.png||alt="Nouvelle fabrique PDF"]]
290
291 ➡ L'éditeur de {{glossaryReference glossaryId="Glossary" entryId="fabrique de documents"}}fabrique de documents{{/glossaryReference}} PDF s'ouvre. Nous allons y configurer le modèle de fabrique PDF.
292
293 (((
294 == Modifier les paramètres de page ==
295
296 Nous allons tout d'abord modifier la mise en page :
297 )))
298
299 * Dans l'onglet **Paramètres **du panneau de droite, passez le document au format **A4 paysage (297 x 210 mm)**.
300
301 [[image:Page_size_landscape_FR.png||alt="Page paysage"]]
302
303 == Configurer la page de garde ==
304
305 Dans la première page existante qui fera office de page de garde, nous allons ajouter :
306
307 * Une bannière d’entête qui sera répétée sur toutes les pages (image)
308 * Une bannière de pied de page qui sera répétée sur toutes les pages (image)
309 * Une numérotation des pages qui sera répétée sur toutes les pages (texte)
310 * Un logo (image)
311 * Un titre (texte)
312
313 === Ajouter la bannière d'en-tête ===
314
315 Pour ajouter l’image correspondant à la bannière d’en-tête :
316
317 1. Cliquez sur le bouton **Image**.
318 1. Cliquez sur une zone vide de la page à droite pour créer une zone d’image.(((
319 [[image:Add_image_area_FR.png||alt="Ajout image"]]
320 )))
321 1. Cliquez sur le bouton [[image:1716900965745-365.png]] de la zone créée puis cliquez sur **Editer** pour ouvrir le **Gestionnaire d’icônes**.
322 [[image:Edit_picture_area_FR.png||alt="Editer image"]]
323
324 1. Dans l’onglet **Indicateurs**, cliquez sur **Ajouter une icône personnalisée**.
325 1. Ajoutez les 2 images **_custom_tutoriel_pdf_banniere_haut.png** et **_custom_tutoriel_pdf_banniere_bas.png **(téléchargées précédemment) puis cliquez sur **OK** dans la fenêtre **Ajouter une icône personnalisée**.
326 (% style="border:none; color:#36525b; display:inline-block; font-family:~"Open Sans~",sans-serif; font-size:11pt; font-style:normal; font-variant:normal; font-weight:400; height:309px; overflow:hidden; text-decoration:none; white-space:pre-wrap; width:709px" %)[[image:Add_custom_picture_FR.png]]
327
328 (% start="6" %)
329 1. Dans la fenêtre **Gestionnaire d’icônes**, sélectionnez l’image **_custom_tutoriel_pdf_banniere_haut.png** puis cliquez sur **OK**.
330
331 La première image est maintenant présente dans le modèle du PDF. Pour la déplacer et la redimensionner, vous pouvez la sélectionner puis la glisser/déposer ou maintenir l’un des coins. Afin d’être plus précis, vous pouvez également renseigner les valeurs directement dans les champs de la barre d'outils au-dessus de la page :
332
333 * **X** (coordonnées X à partir du bord gauche de la page)
334 * **Y** (coordonnées Y à partir du bord haut de la page)
335 * **L** (largeur de l’élément)
336 * **H** (hauteur de l’élément)
337
338 (% class="box warningmessage" %)
339 (((
340 ❗Ces valeurs varient selon la résolution de l'écran. Pour un même positionnement, les valeurs dans votre éditeur peuvent être différentes des valeurs illustrées ici.
341 )))
342
343 (% start="7" %)
344 1. Redimensionnez-la sur la largeur de la page et positionnez-la en haut de la page.
345 1. Cliquez à nouveau sur le bouton [[image:1716900965745-365.png]] de la zone créée, cliquez sur **Type** puis sélectionnez **En-tête **:** **cela va permettre de répéter cet élément sur toutes les pages du rapport PDF.
346 [[image:Picture_type_header_FR.png||alt="Type En_tête"]]
347
348
349 === Ajouter la bannière de pied de page ===
350
351 Pour ajouter la bannière de pied de page, réalisez les mêmes actions que ci-dessus. Pour cet élément :
352
353 (% start="1" %)
354 1. Sélectionnez l’image **_custom_tutoriel_pdf_banniere_bas.png**.
355 1. Redimensionnez-la sur la largeur de la page comme la précédente et positionnez-la en bas de la page.
356 1. Sélectionnez le **Type Pied de page**.
357
358 (% style="line-height: 1.2; text-align: justify;" %)
359 === Ajouter le logo ===
360
361 (% style="line-height:1.2; text-align:justify" %)
362 Pour ajouter le logo :
363
364 1. Cliquez sur le bouton **Image**.
365 1. Cliquez sur une zone vide de la page à droite pour créer une zone d’image.
366 1. Cliquez sur le bouton [[image:1716900965745-365.png]] de la zone créée puis sur **Éditer**.
367 ➡ Le **Gestionnaire d'icônes** s'affiche.
368 1. Dans l’onglet **Infographies**, cliquez sur **Ajouter une icône vectorielle**.
369 [[image:Ajout_logo1.png||alt="Ajout infographie"]]
370
371 1. Ajoutez l’image **_custom_tutoriel_pdf_logo_digdash.svg** (téléchargée précédemment)
372 1. Sélectionnez alors l’image **_custom_tutoriel_pdf_logo_digdash.svg** dans la liste puis cliquez sur **OK**.
373 [[image:Add_vector_icon_digdash_logo_FR.png||alt="Logo DigDash"]]
374
375 1. Redimensionnez-la et positionnez-la comme illustré ci-dessous : 
376 [[image:Logo_position_FR.png||alt="Logo positionné"]]
377
378 (% style="line-height: 1.2; text-align: justify;" %)
379 === Ajouter le texte ===
380
381 (% style="line-height:1.2; text-align:justify" %)
382 Pour ajouter le texte :
383
384 1. Cliquez sur le bouton **Texte**.
385 1. Cliquez sur une zone vide de la page à droite pour créer une zone de texte.
386 1. Cliquez sur le bouton de menu de la zone créée puis cliquez sur **Editer**.
387 1. Dans la zone de texte, renseignez les textes ci-dessous en ajoutant un retour à la ligne entre : 
388 1*. Rapport des indicateurs CA
389 1*. Date du rapport : ${date.dd/MM/yyyy}
390 1. Sélectionnez la première ligne de texte, définissez la taille de la police à 72 et centrez.
391 1. Sélectionnez la seconde ligne de texte, définissez la taille de la police à 16 et centrez.
392 1. Cliquez sur** OK**.
393 [[image:Add_report_title_FR.png||alt="Ajout texte"]]
394
395 1. Redimensionnez et positionnez la zone de texte comme illustré ci-dessous :[[image:Title_added_FR.png||alt="Titre ajouté"]]
396
397 === Ajouter les numéros de page ===
398
399 Pour ajouter la numérotation des pages :
400
401 1. Cliquez sur le bouton **Numéro de page** puis sélectionnez **Numéro de page (Pied de page)**.
402 ➡ La numérotation de page s'ajoute automatiquement en bas à droite de la page.
403 [[image:Page_numbers_added_FR.png||alt="Numéro de page"]]
404
405 (% style="line-height:1.2; text-align:justify" %)
406 La page de garde est à présent terminée. Nous allons ajouter une nouvelle page à notre PDF. Pour cela, cliquez sur le bouton **+ **dans la barre d'outils au-dessus de la page.
407
408 (% style="line-height: 1.2;" %)
409 Vous pouvez vous déplacer entre les différentes pages en utilisant les flèches positionnées en bas.
410 [[image:Add_page2_FR.png||alt="Ajout page 2"]]
411
412 (% style="line-height: 1.2;" %)
413 == Configurer la page de synthèse ==
414
415 (% style="line-height:1.2; text-align:justify" %)
416 Dans cette deuxième page qui sera la synthèse des indicateurs de chiffre d'affaires, nous allons ajouter :
417
418 * Un titre (texte)
419 * 2 textes de description (texte)
420 * Les graphiques : 
421 ** Synthèse du CA par famille de produit
422 ** Evolution du CA par mois
423 ** Répartition du CA par région
424
425 (% style="line-height: 1.2; text-align: justify;" %)
426 === Ajouter le titre ===
427
428 (% style="line-height:1.2; text-align:justify" %)
429 Pour ajouter le titre :
430
431 1. Cliquez sur le bouton **Texte**.
432 1. Cliquez sur une zone vide de la page à droite pour créer une zone de texte.
433 1. Cliquez sur le bouton de menu de la zone créée puis cliquez sur **Editer**
434 1. Dans l'éditeur de texte, entrez le titre : //Synthèse globale//.
435 1. Définissez la taille de la police à 28 et centrez.
436 [[image:Page2_title_FR.png]]
437
438 1. Cliquez sur **OK**.
439 1. Redimensionnez la zone de texte et positionnez-la comme suit :
440 [[image:Page2_title_added_FR.png||alt="Titre ajouté"]]
441
442
443 (% style="line-height: 1.2; text-align: justify;" %)
444 === Ajouter les textes de description ===
445
446 (% style="line-height:1.2; text-align:justify" %)
447 Pour ajouter les textes de description, procédez de même que ci-dessus :
448
449 1. Dans la première zone de texte, entrez le texte ci-après : //Ci-dessous un tableau récapitulatif du CA réalisé par les différentes familles de produits pour l'année _KEYWORD_YEAR_ en comparaison à l'année précédente.//
450
451 (% class="box infomessage" %)
452 (((
453 **_KEYWORD_YEAR_** correspond à un mot clé qui sera remplacé par la valeur de l’année sélectionnée lors de la génération du rapport PDF.
454 )))
455
456 (% start="2" %)
457 1. Dans la seconde zone de texte, entrez le texte ci-après : //Les pages suivantes détaillent le CA selon chaque famille de produits//.
458 1. Redimensionnez et positionnez les zones de texte afin d'obtennir un résultat similaire à l'illustration ci-dessous :
459 [[image:Text_areas_added_FR.png||alt="Zones de texte ajoutés"]]
460
461 === Ajouter les graphiques ===
462
463 Pour ajouter les graphiques :
464
465 1. Dans l'onglet **{{glossaryReference glossaryId="Glossary" entryId="Flux"}}Flux{{/glossaryReference}} par rôle** du panneau de gauche, sélectionnez le rôle contenant vos graphiques.
466 1. Recherchez le graphique **Synthèse du CA par famille de produit**.
467 1. Glissez-déposez le graphique **Synthèse du CA par famille de produit** depuis la liste des flux vers la page.
468 1. Procédez de même pour les 2 autres graphiques : **Evolution du CA par mois** et **Répartition du CA par région**.
469 1. Redimensionnez et positionnez les zones de graphiques afin d'obtenir le modèle suivant :
470 [[image:Page2_flows_added_FR.png||alt="Graphiques ajoutés"]]
471
472 (% class="box infomessage" %)
473 (((
474 💡 Il est possible de faire une multi-sélection des flux (Ctrl + clic gauche) afin de glisser-déposer plusieurs flux en simultané.
475 )))
476
477 (% start="6" %)
478 1. Vous pouvez vérifier le rendu des différents éléments en activant le **Rendu final** dans la barre d'outils au-dessus de la page. Ainsi, si la zone n'est pas adaptée au contenu, vous pouvez redimensionner la zone.
479 [[image:Page2_rendering_FR.png||alt="Rendu final"]]
480
481 La page de synthèse étant terminée, nous allons maintenant ajouter une nouvelle page à notre PDF. Pour cela, cliquez sur le bouton **+** comme précédemment.
482
483 == Configurer la page de détails ==
484
485 Dans cette troisième page qui sera le détail des indicateurs de CA par famille de produit, nous allons ajouter :
486
487 * Un titre (texte)
488 * Un texte de description (texte)
489 * Les graphiques : 
490 ** Détails du CA par mois
491 ** Comparaison du CA par produit
492 ** Répartition du CA par région
493
494 Cette troisième page va faire appel à la notion de section, c’est-à-dire que cette page (et les éléments qu’elle contient) sera répétée et filtrée selon les valeurs d’un tableau (Liste des familles de produit).
495
496 === Ajouter le titre ===
497
498 (% style="line-height:1.2; text-align:justify" %)
499 Pour ajouter le titre :
500
501 1. Cliquez sur le bouton **Texte**.
502 1. Cliquez sur une zone vide de la page à droite pour créer une zone de texte.
503 1. Cliquez sur le bouton de menu de la zone créée puis cliquez sur **Editer**.
504 1. Dans la zone de texte, entrez le texte ci-après : **Détails pour la famille de produit _KEYWORD_CATEGORY_**
505
506 (% class="box infomessage" %)
507 (((
508 💡 ** _KEYWORD_CATEGORY_** correspond à un mot clé qui sera remplacé par la valeur de la famille de produit concernée lors de la génération du rapport PDF.
509 )))
510
511 (% start="5" %)
512 1. Sélectionnez le texte puis mettez la taille de la police à **28** et centrez.
513 1. Cliquez sur **OK**.
514 1. Redimensionnez et positionnez la zone de texte comme ci-dessous :
515 [[image:Page3_title_added_FR.png||alt="Titre ajouté"]]
516
517 (% style="line-height: 1.2; text-align: justify;" %)
518 === Ajouter les graphiques ===
519
520 (% style="line-height:1.2; text-align:justify" %)
521 Pour ajouter les graphiques :
522
523 1. Dans l'onglet **{{glossaryReference glossaryId="Glossary" entryId="Flux"}}Flux{{/glossaryReference}} par rôle** du panneau de gauche, sélectionnez le rôle contenant vos graphiques.
524 1. Recherchez le graphique **Détail du CA par mois**.
525 1. Glissez-déposez le graphique **Détail du CA par mois** depuis le panneau de gauche vers la page.
526 1. Procédez de même pour les 2 autres graphiques : **Comparaison du CA par produit** et **Répartition du CA par région**.
527 1. Redimensionnez et positionnez les zones de graphiques afin d'obtenir le modèle suivant :
528 [[image:Page3_flows_added_FR.png||alt="Graphiques ajoutés"]]
529
530 1. Comme sur la page précédente, activez le **Rendu final **pour vérifier le rendu.
531
532
533 (% class="box infomessage" style="line-height: 1.2; text-align: justify;" %)
534 (((
535 💡 S’il y a trop d’éléments sur votre page, vous pouvez accéder à chaque élément à partir de l’onglet **Objets sur la page **puis accéder à leurs propriétés en faisant un clic-droit dessus.
536 [[image:Objects_on_page_FR.png||alt="Objets sur la page"]]
537 )))
538
539 === Ajouter une section ===
540
541 (% class="wikigeneratedid" %)
542 Nous allons définir une section afin d'afficher cette troisième page pour chaque famille de produit. Pour cela :
543
544 1. Sélectionnez l'onglet **Sections** dans le panneau de droite.
545 1. L'index correspond au numéro de page. Sélectionnez l'index **3** puis cliquez sur **Ajouter...**
546 ➡ La boite de dialogue **Source de la section** s'affiche.
547 1. Sélectionnez le rôle utilisé puis le tableau **Liste des familles de produits**.
548 [[image:Add_section_FR.png||alt="Ajout section"]]
549
550 1. Cliquez sur **OK**.
551 ➡ La section est ajoutée. Elle s'affiche également en dessous-de la page.
552 [[image:Section_added_FR.png||alt="Section ajoutée"]]
553
554 (% class="wikigeneratedid" %)
555 Le modèle est à présent terminé. Cliquez sur **OK** en bas à droite de la fenêtre pour l'enregistrer et fermer l'éditeur.
556
557 == Configurer la substitution de mots ==
558
559 Le rapport PDF contient certains mots clés qui devront être remplacés par la valeur des données lors de la génération du rapport. Pour cela, nous mettons en place une substitution de mots clés :
560
561 1. Dans l’onglet **Propriétés **de la boite **Propriétés du flux**, cliquez sur **Configurer**.
562 [[image:Configure_PDf_builder_FR.png||alt="Configurer"]]
563 1. Cliquez sur l’onglet **Substitution de mots**.
564 1. Cliquez sur le bouton **Ajouter…**
565 1. Dans le champ **Clé**,** **renseignez le mot clé **_KEYWORD_CATEGORY_**
566 1. Dans le champ **Valeur**, renseignez **${filter.Famille}** puis cliquez sur** OK.**
567 [[image:Wod_substitution_FR.png||alt="Substitution de mots"]]
568
569 1. Répétez l’opération pour ajouter une seconde substitution :
570 1. Dans le champ **Clé**, renseignez le mot clé **_KEYWORD_YEAR_**
571 1. Dans le champ** Valeur**, renseignez **${filter.Date}**.
572 1. Cliquez sur **OK**.
573
574 La fabrique PDF est désormais terminée.
575 Nous allons maintenant créer un tableau de bord dans lequel un bouton permettra d'exécuter la {{glossaryReference glossaryId="Glossary" entryId="fabrique de documents"}}fabrique de documents{{/glossaryReference}} PDF.
576
577 = Étape 4 : Créer le tableau de bord et générer le rapport PDF =
578
579 (% class="box infomessage" style="line-height: 1.2; text-align: justify;" %)
580 (((
581 ℹ Cette partie du tutoriel se déroule dans l’Éditeur de tableau de bord puis dans le Tableau de bord.
582 )))
583
584 == Créer la page de tableau de bord ==
585
586 Pour créer la page de tableau de bord **Rapport PDF **:
587
588 1. Lancez l'Éditeur de tableaux de bord.
589 1. Sélectionnez le rôle utilisé.
590 1. Cliquez sur le bouton **+** pour créer une nouvelle page de tableau de bord et nommez-la **Rapport PDF**.
591 [[image:New_page_PDF_report_FR.png||alt="New page"]]
592
593 == Ajouter un bouton d'exécution de la fabrique PDF ==
594
595 Nosu allons maintenant ajouter un bouton qui nous permettra de générer le rapport PDF depuis la page de tableau de bord.
596
597 1. Depuis l’onglet **Contenu additionnel**, glissez-déposez un bouton sur la page vide nouvellement créée.
598 1. Sélectionnez le bouton et dans la section **Affichage** du panneau de droite, entrez PDF dans le champ **Texte**.
599 1. Dans la section **Actions**, cliquez sur le bouton **Ajouter.**
600 1. Dans la boite de dialogue **Action**, sélectionnez l'action **Exécute un flux de type Fabrique De Document PDF** puis sélectionnez le flux **Rapport PDF**.
601 [[image:Add_PDF_button_FR.png||alt="Ajout bouton PDF"]]
602
603 == Ajouter un filtre Date ==
604
605 Nous ajoutons ici un filtre Date qui nous permettra de sélectionner l'année souhaitée pour le rapport.
606
607 1. Étant donné qu’il n'est pas possible d'ajouter un filtre sur une page qui ne contient aucun graphique, ajoutez le graphique **Répartition du CA par région** depuis l’onglet **{{glossaryReference glossaryId="Glossary" entryId="Flux"}}Flux{{/glossaryReference}} d’information (Graphiques Existants) **sur la page.
608 [[image:Add_graph_dashboard_FR.png||alt="Ajout graphique"]]
609
610 1. Depuis l’onglet **Filtres / Variables**, ajoutez un filtre sur la dimension **Date.**
611 1. Dans le panneau de propriétés du filtre, sélectionnez **Date** et **Année **dans les listes déroulantes** Hiérarchie **et **Niveau.**
612 1. Les données du rapport seront filtrées sur une année donnée. Ainsi, dans la section **Affichage** du même panneau : 
613 1*. Cochez la case **Cacher l’élément “Tous” **
614 1*. Cochez la case **Interdire la sélection vide**.
615 1*. Décochez la case **Sélection multiple**.
616 [[image:Add_filter_date_FR.png]]
617
618 == Générer le rapport PDF ==
619
620 Il ne nous reste plus qu'à accéder au tableau de bord et à générer le rapport PDF.
621
622 1. Cliquez sur le bouton d'accès au Dashboard [[image:1738571706912-923.png||alt="Accès Dashboard"]] et enregistrez les modifications.
623 [[image:Save_DB_message_FR.png]]
624 1. Dans le tableau de bord, sélectionnez une année puis cliquez sur le bouton **PDF** pour générer un rapport PDF.
625
626 Nous obtenons, en sélectionnant par exemple l'année 2019, le rapport suivant [[ tutoriel_rapport_CA_2019_Tous_202502031041.pdf>>attach:tutoriel_rapport_CA_2019_Tous_202502031041.pdf]] .​​​
627
628 En filtrant géographiquement au niveau Pays sur la France pour l'année 2018, nous obtenons le rapport suivant [[ tutoriel_rapport_CA_2018_France_202502031047.pdf>>attach:tutoriel_rapport_CA_2018_France_202502031047.pdf]]
629
630 = Félicitations ! =
631
632 Vous avez réussi à créer votre première {{glossaryReference glossaryId="Glossary" entryId="fabrique de documents"}}fabrique de documents{{/glossaryReference}} PDF.
633 Il ne reste plus qu'à créer votre propre rapport à partir de vos données!