Wiki source code of Gestionnaire de formats

Last modified by Aurelie Bertrand on 2025/10/01 11:24
Show last authors
1 {{ddtoc/}}
2
3 ----
4
5 Les formats sont utilisés sur les mesures et les dimensions temps (valeurs numériques et dates) dans les modèles de données et les graphiques.
6
7 DigDash fournit un ensemble de formats de différents types Nombre, Date, Icône, Mois, Pourcentage et Alerteur.
8
9 Le **Gestionnaire de formats** permet de créer de nouveaux formats ainsi que d'éditer des formats existants.
10
11 Chaque format possède au moins une configuration, dite //Défaut// .
12 La configuration du format peut être déclinée en configurations spécifiques à chaque langue.
13
14 (% class="box warningmessage" %)
15 (((
16 ❗ Modifier ou renommer un format impacte tous les éléments qui l'utilisent.
17 Cliquez droit sur le format et sélectionnez [[Analyse des dépendances>>doc:Digdash.user_guide.studio.managers.dependencies.WebHome]] pour afficher son périmètre d'utilisation ou utilisez la fonction** Dupliquer.**
18 )))
19
20 (% class="wikigeneratedid" id="H" %)
21 [[image:Format_manager_FR.png||alt="Gestionnaire formats"]]
22
23 = Gérer les formats =
24
25 (% class="wikigeneratedid" %)
26 **Pour créer un nouveau format :**
27
28 1. Dans le panneau de gauche contenant les différents types de formats, sélectionnez celui que vous souhaitez créer (Nombre, Date, Icône, Mois, Pourcentage, Temps ou Alerteur).
29 1. Cliquez sur le bouton **+ .**
30 ➡ Une boîte de dialogue **Nom du format **s'affiche.
31 1. Renseignez le **Nom** du format.
32 1. Dans la liste déroulante **Rôle**, sélectionnez le rôle auquel vous souhaitez restreindre l'accès à la fonction ou **Aucun **pour la partager avec tous les rôles puis cliquez sur **OK**. Le champ peut également être utilisé comme barre de recherche dans le cas d'un grand nombre de rôles.
33 ➡ L'onglet de configuration **Défaut** s'affiche alors. La configuration **Défaut** sera appliquée à toutes les langues à moins que vous n'ayez spécifié une configuration spécifique pour une ou plusieurs langues. Consultez le paragraphe [[Spécifier un format spécifique selon les langues>>doc:||anchor="langues"]]** **pour plus de détails.
34 1. Saisissez les paramètres du format comme indiqué dans les descriptions de formats ci-dessous.
35 1. Cliquez sur **OK** pour enregistrer et fermer.
36
37 **Pour dupliquer un format : **
38
39 * Sélectionnez le format initial et cliquez sur le bouton** [[image:Duplicate_button.png||alt="Dupliquer" height="18" width="20"]] **puis procédez comme pour la création d'un format.
40
41 **Pour modifier la valeur affichée (nom du format) dans les différentes langues :**
42
43 * Cliquez sur le bouton [[image:Translate_button.png||height="19" width="20"]] pour accéder à l'interface d'**Edition multilangue** et entrer la valeur affichée dans chaque langue. Consultez la page [[Traduire le nom d'un objet>>doc:Digdash.user_guide.studio.translate_items.WebHome]] pour plus de détails.
44
45 **Pour supprimer un format :**
46
47 * Sélectionnez le format que vous souhaitez supprimer, cliquez sur le bouton [[image:Delete_button.png||height="18" width="18"]].
48
49 (% class="box infomessage" %)
50 (((
51 ℹ Les formats étiquetés (Défaut) ne peuvent être supprimés.
52 )))
53
54 **Pour renommer un format :**
55
56 1. Sélectionnez le format que vous souhaitez renommer, faites un clic droit et choisissez **Renommer**.
57 1. Saisissez le nom de format souhaité, puis cliquez sur **OK**.
58
59 (% class="box infomessage" %)
60 (((
61 ℹ Les formats étiquetés (Défaut) ne peuvent être renommés.
62 )))
63
64 (% class="box message" %)
65 (((
66 Vous pouvez également créer, dupliquer, supprimer un format ainsi qu'accéder à l'édition multi-langue et réaliser une [[analyse de dépendances>>doc:Digdash.user_guide.studio.managers.dependencies.WebHome]] via un clic-droit sur le format souhaité. L'outil d'analyse de dépendances permet de visualiser les utilisations du format.
67 [[image:Format_manager_menu_FR.png||alt="Menu contextuel"]]
68 )))
69
70 == **Spécifier un format spécifique selon les langues{{id name="langues"/}}** ==
71
72 Vous pouvez utiliser des formats différents selon les langues. Par exemple, les dates ou les nombres peuvent avoir des formats différents selon la langue.
73
74 Lorsque vous créez un format, la configuration **Défaut **est sélectionnée. Le format par défaut sera appliqué à tous les langues à moins que vous n'ayez spécifié un format spécifique pour une langue. C'est la langue du contexte d'utilisation du format (par exemple, la langue d'une page de tableau de bord avec un flux contenant une dimension sur laquelle le format est affecté) qui détermine quelle configuration sera utilisée : la configuration de la langue du contexte, si elle existe ; dans le cas contraire, la configuration par défaut. 
75 \\Chaque configuration est affichée dans un onglet spécifique à chaque langue matérialisée par le drapeau de la langue.
76 Les langues disponibles sont celles configurées dans les paramètres serveurs. Consultez la page [[Langues>>doc:Digdash.deployment.configuration.configuration_guide.locales.WebHome]] pour plus de détails.
77 Lorsqu'une configuration spécifique à la langue existe, l'onglet est complété d'une coche ✓. Dans le cas contraire, l'onglet est grisé et son infobulle rappelle que la configuration n'existe pas pour cette langue.
78
79 [[image:1757667186126-540.png]]
80
81 Lorsqu'une configuration spécifique a été créée pour toutes les langues, la configuration par défaut n'est pas utilisée.
82
83 [[image:Format_manager_all_lang_FR.png]]
84
85 Pour spécifier un format pour une langue donnée :
86
87 1. Sélectionnez l'onglet de la langue à configurer.
88 1. Cliquez sur le lien qui s'affiche sur la page pour éditer.
89 [[image:Format_manager_new_lang_FR.png||height="451" width="901"]]
90 1. Saisissez les paramètres du format comme indiqué dans les descriptions de formats ci-dessous.
91
92 Pour supprimer une configuration spécifique à une langue :
93
94 1. Sélectionnez l'onglet de la langue.
95 1. Cliquez sur le bouton [[image:1757668336917-592.png]] dans la barre d'outils.
96 ➡ Le format par défaut sera alors utilisé pour cette langue.
97
98 (% class="box infomessage" %)
99 (((
100 La configuration **Défaut **ne peut être supprimée.
101 )))
102
103 == Copier/coller la configuration d'un format ==
104
105 Il est possible de copier une configuration et de l'appliquer à un format du même type (par exemple, Nombre).
106 Pour cela :
107
108 1. Cliquez sur le bouton [[image:1757669318878-165.png]] dans la barre d'outils de la configuration de format à copier.
109 1. Sélectionnez le format et l'onglet de configuration souhaités.
110 1. Cliquez sur le bouton ​​​​​​​[[image:1757669510512-725.png]] pour appliquer la configuration copiée.
111
112 = Format Nombre =
113
114 |=Paramètre sélectionné|=Description
115 |Séparateur des milliers|(((
116 Selon la langue choisie, vous pouvez utiliser un point ou une virgule comme séparateur de milliers.
117
118 Exemple : si vous utilisez le point comme séparateur de milliers, la valeur 10000 sera affichée 10.000.
119 )))
120 |Séparateur de décimales|Sélectionnez le point ou la virgule comme séparateur de décimales
121 |Affichage des nombres négatifs|(((
122 Sélectionnez le type d'affichage souhaité pour les valeurs négatives.** **
123
124 Exemples :
125
126 * **Inchangé **: la valeur -5212 sera affichée -5212
127 * **Entre parenthèses : **la valeur -5212 sera affichée (5212)
128 * **Valeur absolue** -5212 sera affichée 5212
129 )))
130 |Préfixer les nombres positifs par le signe +|Exemple : 5212 sera affiché +5212
131 |Remplacer NaN|Choisissez la valeur que vous souhaitez afficher si la valeur retournée par la mesure n'est pas un nombre. Sinon, la valeur NaN (Not a Number) sera affichée.
132 |(((
133 Nombre maximum de
134
135 décimales
136 )))|(((
137 Indiquez le nombre de décimales souhaitées. Si la valeur à afficher comporte plus de décimales que le nombre indiqué, la valeur sera arrondie.
138
139 Cochez **Forcer** pour afficher le nombre de décimales indiquées même si la valeur à afficher comporte moins de décimales.
140
141 Exemple : Si vous sélectionnez 2 décimales et cochez la case **Forcer**, la valeur 8,2 sera affichée 8,20, la valeur 5,452 sera affiché 5,45.
142 )))
143 |Zéro non significatif|Indiquez le nombre de valeurs à afficher avant la virgule.
144 Exemple : si vous sélectionnez 5 comme nombre de zéro non significatifs, le nombre 8,25 sera affiché 00008,25.
145 |Unité|(((
146 Choisissez l'unité souhaitez pour la mesure. L'unité est placée à la suite du nombre affiché. Cochez **Devant** pour affichez l'unité avant la valeur.
147
148 Exemple : si vous indiquez € comme unité et cochez la case Devant, la valeur 42 sera affichée € 42
149 )))
150 |Multiplicateur|Indiquez la valeur par laquelle vous souhaitez multiplier votre nombre
151 |Couleur|Sélectionnez les couleurs souhaitées pour l'affichage des valeurs positives, négative et nulles.
152 |Utiliser les abréviations|(((
153 Cochez cette case pour utiliser les abréviations numériques (k pour milliers, M pour millions, G pour milliards)
154
155 Exemple : si vous cochez la case Utiliser les abréviations, la valeur 5000 sera affichée 5k
156 )))
157
158 = Format Date =
159
160 Les formats de date sont formés par juxtaposition de caractères alphabétiques, chaque code représentant une unité de date pouvant être répété entre une et quatre fois. Un format de date peut être testé directement dans l'éditeur de formats.
161
162 (% border="2" class="table-striped" %)
163 |=(% colspan="1" rowspan="2" style="text-align: center; width: 160.8px;" %)Code de format|=(% colspan="1" rowspan="2" style="text-align: center; width: 1px;" %)Signification|=(% colspan="4" rowspan="1" style="text-align: center;" %)Affichage selon le nombre d'occurrences du code de format
164 |=(% colspan="1" scope="col" style="width: 25%;" %)1|=(% colspan="1" style="width: 25%;" %)2|=(% colspan="1" style="width: 25%;" %)3|=(% colspan="1" style="width: 25%;" %)4
165 |(% style="text-align:center; width:160.8px" %)**Y / y**|(% style="width:1px" %)(((
166 Année
167 )))|(% style="width:122px" %)(((
168 y
169
170 affiche l'année sur 4 chiffres
171 )))|(% style="width:89px" %)(((
172 yy
173
174 affiche l'année sur 2 chiffres
175 )))|(% style="width:140px" %)(((
176 yyy
177
178 affiche l'année sur 4 chiffres
179 )))|(% style="width:332px" %)(((
180 yyyy
181
182 affiche l'année sur 4 chiffres
183 )))
184 |(% style="text-align:center; width:160.8px" %)**M**|(% style="width:1px" %)(((
185 Mois
186 )))|(% style="width:122px" %)(((
187 M
188
189 affiche le mois comme une valeur comprise entre 1 et 12
190 )))|(% style="width:89px" %)(((
191 MM
192
193 affiche le mois sur deux chiffres (valeur comprise entre 01 et 12)
194 )))|(% style="width:140px" %)(((
195 MMM
196
197 affiche le mois sur trois lettres comme jan, fev, ..
198 )))|(% style="width:332px" %)(((
199 MMMM
200
201 affiche le nom du mois comme janvier, février, ...
202 )))
203 |(% style="text-align:center; width:160.8px" %)**Q / q**|(% style="width:1px" %)(((
204 Trimestre
205
206
207 )))|(% style="width:122px" %)(((
208 Q
209
210 affiche le trimestre entre 1 et 4
211 )))|(% style="width:89px" %)(((
212 QQ
213
214 affiche le trimestre entre 01 et 04
215 )))|(% style="width:140px" %)(((
216 QQQ
217
218 affiche le trimestre entre T1 et T4
219 )))|(% style="width:332px" %)(((
220 QQQQ
221
222 affiche le trimestre entre 1er trimestre et 4ème trimestre
223 )))
224 |(% style="text-align:center; width:160.8px" %)**w**|(% style="width:1px" %)Numéro de semaine dans l'année|(% style="width:122px" %)(((
225 w
226
227 sur deux chiffres maximum
228 )))|(% style="width:89px" %)(((
229 ww
230
231 sur deux chiffres minimum [*]
232 )))|(% style="width:140px" %)(((
233 www
234
235 sur trois chiffres minimum [*]
236 )))|(% style="width:332px" %)(((
237 wwww
238
239 sur quatre chiffres minimum [*]
240 )))
241 |(% style="text-align:center; width:160.8px" %)**W**|(% style="width:1px" %)Numéro de semaine dans le mois|(% style="width:122px" %)(((
242 W
243
244 sur deux chiffres maximum
245 )))|(% style="width:89px" %)(((
246 WW
247
248 sur deux chiffres minimum [*]
249 )))|(% style="width:140px" %)(((
250 WWW
251
252 sur trois chiffres minimum [*]
253 )))|(% style="width:332px" %)(((
254 WWWW
255
256 sur quatre chiffres minimum [*]
257 )))
258 |(% style="text-align:center; width:160.8px" %)**d**|(% style="width:1px" %)Jour dans le mois|(% style="width:122px" %)(((
259 d
260
261 sur deux chiffres maximum, de 1 à 31
262 )))|(% style="width:89px" %)(((
263 dd
264
265 affiche le jour sur deux chiffres, de 01 à 31
266 )))|(% style="width:140px" %)(((
267 ddd
268
269 sur trois chiffres minimum [*]
270 )))|(% style="width:332px" %)(((
271 dddd
272
273 sur quatre chiffres minimum [*]
274 )))
275 |(% style="text-align:center; width:160.8px" %)**D**|(% style="width:1px" %)Jour dans l'année|(% style="width:122px" %)(((
276 D
277
278 sur deux chiffres maximum
279 )))|(% style="width:89px" %)(((
280 DD
281
282 sur deux chiffres minimum [*]
283 )))|(% style="width:140px" %)(((
284 DDD
285
286 sur trois chiffres minimum [*]
287 )))|(% style="width:332px" %)(((
288 DDDD
289
290 sur quatre chiffres minimum [*]
291 )))
292 |(% style="text-align:center; width:160.8px" %)**E**|(% style="width:1px" %)Nom du jour de la semaine|(% style="width:122px" %)(((
293 E
294
295 Abrégé sur trois caractères (lun. , mar. , mer. , jeu. ...)
296 )))|(% style="width:89px" %)(((
297 EE
298
299 Abrégé sur trois caractères (lun. , mar. , mer. , jeu. ...)
300 )))|(% style="width:140px" %)(((
301 EEE
302
303 Abrégé sur trois caractères (lun. , mar. , mer. , jeu. ...)
304 )))|(% style="width:332px" %)(((
305 EEEE
306
307 Nom complet
308 )))
309 |(% style="text-align:center; width:160.8px" %)**e**|(% style="width:1px" %)Jour de la semaine|(% style="width:122px" %)(((
310 e
311
312 Numéro du jour de la semaine sur un chiffre
313 )))|(% style="width:89px" %)(((
314 ee
315
316 Numéro du jour de la semaine sur deux chiffres
317 )))|(% style="width:140px" %)(((
318 eee
319
320 Abrégé sur trois caractères (lun. , mar. , mer. , jeu. ...)
321 )))|(% style="width:332px" %)(((
322 eeee
323
324 Nom complet
325 )))
326 |(% style="text-align:center; width:160.8px" %)**a**|(% style="width:1px" %)AM / PM|(% colspan="4" rowspan="1" style="text-align:center; width:122px" %)Affiche AM avant midi, PM après midi
327 |(% style="text-align:center; width:160.8px" %)**H**|(% style="width:1px" %)(((
328 Heure affichée de 0 à 23
329 )))|(% style="width:122px" %)(((
330 H
331
332 sur deux chiffres maximum
333 )))|(% style="width:89px" %)(((
334 HH
335
336 sur deux chiffres minimum [*]
337 )))|(% style="width:140px" %)(((
338 HHH
339
340 sur trois chiffres minimum [*]
341 )))|(% style="width:332px" %)(((
342 HHHH
343
344 sur quatre chiffres minimum [*]
345 )))
346 |(% style="text-align:center; width:160.8px" %)**k**|(% style="width:1px" %)Heure affichée de 1 à 24|(% style="width:122px" %)(((
347 k
348
349 sur deux chiffres maximum
350 )))|(% style="width:89px" %)(((
351 kk
352
353 sur deux chiffres minimum [*]
354 )))|(% style="width:140px" %)(((
355 kkk
356
357 sur trois chiffres minimum [*]
358 )))|(% style="width:332px" %)(((
359 kkkk
360
361 sur quatre chiffres minimum [*]
362 )))
363 |(% style="text-align:center; width:160.8px" %)**K**|(% rowspan="2" style="width:1px" %)Heure de 0 à 11 suivie de AM pour le matin ou PM pour l'après midi|(% rowspan="2" style="width:122px" %)(((
364
365
366 sur deux chiffres maximum
367 )))|(% rowspan="2" style="width:89px" %)(((
368
369
370 sur deux chiffres minimum [*]
371 )))|(% rowspan="2" style="width:140px" %)(((
372
373
374 sur trois chiffres minimum [*]
375 )))|(% rowspan="2" style="width:332px" %)(((
376
377
378 sur quatre chiffres minimum [*]
379 )))
380 |(% style="text-align:center; width:160.8px" %)**h**
381 |(% style="text-align:center; width:160.8px" %)**m**|(% style="width:1px" %)minutes|(% style="width:122px" %)(((
382 m
383
384 sur deux chiffres maximum
385 )))|(% style="width:89px" %)(((
386 mm
387
388 sur deux chiffres minimum [*]
389 )))|(% style="width:140px" %)(((
390 mmm
391
392 sur trois chiffres minimum [*]
393 )))|(% style="width:332px" %)(((
394 mmmm
395
396 sur quatre chiffres minimum [*]
397 )))
398 |(% style="text-align:center; width:160.8px" %)**s**|(% style="width:1px" %)secondes|(% style="width:122px" %)(((
399 s
400
401 sur deux chiffres maximum
402 )))|(% style="width:89px" %)(((
403 ss
404
405 sur deux chiffres minimum [*]
406 )))|(% style="width:140px" %)(((
407 sss
408
409 sur trois chiffres minimum [*]
410 )))|(% style="width:332px" %)(((
411 ssss
412
413 sur quatre chiffres minimum [*]
414 )))
415
416 {{id name="FormatDateAsterisque"/}}
417
418 [*] précédé à gauche d'autant de 0 que nécessaires
419
420 = Format Icône =
421
422 Ces formats peuvent être utilisées pour visualiser une tendance ou l'atteinte d'un objectif.
423 Trois formats icônes sont créés par défaut : //Objectif//, //Tendance// et //Tendance (inverse)//.
424
425 [[image:Format_manager_icon_FR.png]]
426
427 La liste des icônes utilisées pour chaque type de valeur (Positif, Zéro, Négatif et Invalide) est affichée sur la gauche de la section **Edition du format**.
428 Pour modifier ces icônes :
429
430 * Glissez-déposez les icônes souhaités de la liste à droite vers les rectangles à gauche. Un ensemble d'icônes est proposé par défaut. Vous pouvez ajouter vos propres icônes en cliquant sur l'icône **Ajouter une icône personnalisée [[image:Add_custom_icon_FR.png||alt="Ajout icône"]]**.
431
432 (% class="box infomessage" %)
433 (((
434 Le bouton [[image:Table_view_icon_FR.png||alt="Vue tableau"]] permet d'afficher une vue tableau des icônes disponibles.
435 )))
436
437 = Format Mois =
438
439 Le format Mois est utilisé pour associer un mois à une valeur numérique (1= Janvier,... 12 = Décembre).
440
441 = Format Pourcentage =
442
443 Le format Pourcentage est utilisé pour associer un pourcentage à une valeur numérique (exemple : 0.4567 = 45.67 %).
444
445 1. Indiquez le nombre de décimales souhaitées.
446 1. Cochez la case **Forcer** pour afficher le nombre de décimales indiquées même si la valeur à afficher comporte moins de décimales.
447 Par exemple, si vous sélectionnez 2 décimales et cochez la case **Forcer**, la valeur 0.823 est affichée 82,30 %.
448 1. Cochez la case **Séparateur de décimales** pour entrer le séparateur souhaité (par défaut, un point).
449 1. Choisissez la valeur que vous souhaitez afficher si la valeur retournée par la mesure n'est pas un nombre. Sinon, la valeur NaN (Not a Number) sera affichée.
450 ➡ Un aperçu du format obtenu est affiché en-dessous.
451
452 [[image:Format_manager_%_FR.png||alt="Pourcentage"]]
453
454 = Format Alerteur{{id name="Alerteur"/}} =
455
456 (% class="box infomessage" %)
457 (((
458 💡 Consultez le tutoriel [[Créer et appliquer un Alerteur>>doc:Digdash.user_guide.tutorials.Alerter.WebHome]] pour des exemples d'utilisation détaillés.
459 )))
460
461 Le format Alerteur est utilisé pour modifier l'affichage de valeurs et mettre en évidence les valeurs exceptionnelles grâce à l'utilisation de texte, couleurs ou icônes.
462
463 L'alerteur définit lui même une liste d'alerteurs de type valeurs ou intervalles de valeurs.
464
465 1. Cliquez sur le bouton** + **au-dessus du tableau des alerteurs.
466 ➡ La boite** Créer un nouvel alerteur **s'affiche.
467 1. Dans la section **Type en entrée**, sélectionnez un des choix proposés :
468 1*. **Valeur** : indiquez la valeur à formater
469 1*. **Intervalle : **indiquez la plage de valeurs à formater ( **Minimum** et **maximum)**. La valeur "infini" est accessible via la petite flèche à droite du champ texte.
470 1. Dans la section **Type en sortie**, sélectionnez le type d'affichage souhaité :
471 1*. **Texte** : dans le champ **Valeur**, entrez le texte de votre choix qui remplacera à l'affichage la valeur ou l'intervalle de valeurs. Vous avez également la possibilité de choisir une **Couleur de texte** et une **Couleur de remplissage **(fond du texte).
472 1*. **Couleur** : sélectionnez au moins une des options suivantes :
473 1**. **Format **: pour formater différemment une valeur ou un intervalle spécifique. Sélectionnez un format dans la liste déroulante ou liquez sur le bouton **Editer **pour définir un format.
474 1**. **Couleur de texte**
475 1**. **Couleur de remplissage** :  couleur de fond du texte
476 1*. **Icône** : Sélectionnez une image.
477 Le bouton **Ajouter une icône personnalisée** [[image:Add_custom_icon_FR.png||alt="Ajout icone"]] vous permet ajouter vos propres icônes.
478 1*. **Couleur + icône** : combinaison de **Couleur **et **Icône** qui permet d'afficher un texte formaté avec une icône.
479
480 [[image:Format_manager_alerter2_FR.png||alt="Alerteur"]]
481
482 = Format Autre =
483
484 Dans autre, on retrouve un format surface et 2 formats temps. Si vous créez des [[formats personnalisés>>doc:.custom_format.WebHome]], ils sont également listés ici.
485
486 * Le format **Surface (are) **est utilisé pour associer une surface en centiares à une surface décomposeés en hectares, ares, centiares.
487
488 (% class="box infomessage" %)
489 (((
490 Depuis la version 2024R1, ce format utilise un séparateur des milliers. Une surface est ainsi affichée sous la forme :
491 **8 437 ha 54 a 23 ca** (au lieu de **8437 ha 54 a 23 ca **auparavant).
492 )))
493
494 * Le format **Année(s) **est utilisé pour associer un temps en secondes à une durée sous la forme année, mois, Jours, heures, minutes et secondes.
495 Par exemple, la valeur 70 sera affichée 0:1:10 (1 minute 10 secondes), la valeur 100000 sera affichée 1j 3:46:40 (1 jour 3 heures 46 minutes et 40 secondes)
496
497 * Le format **Heure(s) **est utilisé pour associer un temps en secondes à une durée en heures minutes et secondes.
498
499 = Page connexe... =
500
501 {{ddchildren}}{{/ddchildren}}