Wiki source code of Gestionnaire de formats

Last modified by Aurelie Bertrand on 2025/02/07 10:13
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 propose 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 ou supprimer des formats existants.
10
11 (% class="box warningmessage" %)
12 (((
13 ❗ Modifier un format impacte tous les éléments qui l'utilisent.
14 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.**
15 )))
16
17 (% class="wikigeneratedid" id="H" %)
18 [[image:Format_manager_FR.png||alt="Gestionnaire formats"]]
19
20 (% class="wikigeneratedid" %)
21 **Pour créer un format :**
22
23 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).
24 1. Cliquez sur le bouton **+ .**
25 ➡ Une boîte de dialogue **Nom du format **s'affiche.
26 1. Renseignez le **Nom** du format.
27 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.
28 1. Saisissez les paramètres du format comme indiqué dans les descriptions de formats ci-dessous.
29
30 **Pour dupliquer un format : **
31
32 * 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.
33
34 **Pour modifier la valeur affichée dans les différentes langues :**
35
36 * Cliquez sur le bouton [[image:Translate_button.png||height="19" width="20"]] our accéder à l'interface d'**Edition multilangue** et entrer la valeur affichée dans chaque langue.
37
38 **Pour supprimer un format :**
39
40 * Sélectionnez le format que vous souhaitez supprimer, cliquez sur le bouton [[image:Delete_button.png||height="18" width="18"]].
41
42 (% class="box infomessage" %)
43 (((
44 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.
45 [[image:Format_manager_menu_FR.png||alt="Menu contextuel"]]
46 )))
47
48 **Pour renommer un format :**
49
50 1. Sélectionnez le format que vous souhaitez renommer, faites un clic droit et choisissez **Renommer**.
51 1. Saisissez le nom de format souhaité, puis cliquez sur **OK**.
52
53 (% class="box infomessage" %)
54 (((
55 Les formats étiquetés (Défaut) ne peuvent être renommés.
56 )))
57
58 **Utiliser un format multi-langue**
59
60 Vous pouvez utiliser des formats différents selon les langages (par exemple, les dates ou les nombres peuvent avoir des formats différents selon la langue).
61
62 Quand vous créer un format, la langue **Défaut **est sélectionnée (dans la liste déroulante en haut à droite). Le format par défaut sera appliqué à tous les langages à moins que vous n'ayez spécifié un format spécifique pour un langage.
63 Pour spécifier un format pour un langage, sélectionnez le langage dans la liste déroulante, puis spécifiez le format.
64
65 = Format Nombre =
66
67 |=Paramètre sélectionné|=Description
68 |Séparateur des milliers|(((
69 Selon la langue choisie, vous pouvez utiliser un point ou une virgule comme séparateur de milliers.
70
71 Exemple : si vous utilisez le point comme séparateur de milliers, la valeur 10000 sera affichée 10.000.
72 )))
73 |Séparateur de décimales|Sélectionnez le point ou la virgule comme séparateur de décimales
74 |Affichage des nombres négatifs|(((
75 Sélectionnez le type d'affichage souhaité pour les valeurs négatives.** **
76
77 Exemples :
78
79 * **Inchangé **: la valeur -5212 sera affichée -5212
80 * **Entre parenthèses : **la valeur -5212 sera affichée (5212)
81 * **Valeur absolue** -5212 sera affichée 5212
82 )))
83 |Préfixer les nombres positifs par le signe +|Exemple : 5212 sera affiché +5212
84 |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.
85 |(((
86 Nombre maximum de
87
88 décimales
89 )))|(((
90 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.
91
92 Cochez **Forcer** pour afficher le nombre de décimales indiquées même si la valeur à afficher comporte moins de décimales.
93
94 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.
95 )))
96 |Zéro non significatif|Indiquez le nombre de valeurs à afficher avant la virgule.
97 Exemple : si vous sélectionnez 5 comme nombre de zéro non significatifs, le nombre 8,25 sera affiché 00008,25.
98 |Unité|(((
99 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.
100
101 Exemple : si vous indiquez € comme unité et cochez la case Devant, la valeur 42 sera affichée € 42
102 )))
103 |Multiplicateur|Indiquez la valeur par laquelle vous souhaitez multiplier votre nombre
104 |Couleur|Sélectionnez les couleurs souhaitées pour l'affichage des valeurs positives, négative et nulles.
105 |Utiliser les abréviations|(((
106 Cochez cette case pour utiliser les abréviations numériques (k pour milliers, M pour millions, G pour milliards)
107
108 Exemple : si vous cochez la case Utiliser les abréviations, la valeur 5000 sera affichée 5k
109 )))
110
111 = Format Date =
112
113 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.
114
115 (% border="2" class="table-striped" %)
116 |=(% 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
117 |=(% 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
118 |(% style="text-align:center; width:160.8px" %)**Y / y**|(% style="width:1px" %)(((
119 Année
120 )))|(% style="width:122px" %)(((
121 y
122
123 affiche l'année sur 4 chiffres
124 )))|(% style="width:89px" %)(((
125 yy
126
127 affiche l'année sur 2 chiffres
128 )))|(% style="width:140px" %)(((
129 yyy
130
131 affiche l'année sur 4 chiffres
132 )))|(% style="width:332px" %)(((
133 yyyy
134
135 affiche l'année sur 4 chiffres
136 )))
137 |(% style="text-align:center; width:160.8px" %)**M**|(% style="width:1px" %)(((
138 Mois
139 )))|(% style="width:122px" %)(((
140 M
141
142 affiche le mois comme une valeur comprise entre 1 et 12
143 )))|(% style="width:89px" %)(((
144 MM
145
146 affiche le mois sur deux chiffres (valeur comprise entre 01 et 12)
147 )))|(% style="width:140px" %)(((
148 MMM
149
150 affiche le mois sur trois lettres comme jan, fev, ..
151 )))|(% style="width:332px" %)(((
152 MMMM
153
154 affiche le nom du mois comme janvier, février, ...
155 )))
156 |(% style="text-align:center; width:160.8px" %)**Q / q**|(% style="width:1px" %)(((
157 Trimestre
158
159
160 )))|(% style="width:122px" %)(((
161 Q
162
163 affiche le trimestre entre 1 et 4
164 )))|(% style="width:89px" %)(((
165 QQ
166
167 affiche le trimestre entre 01 et 04
168 )))|(% style="width:140px" %)(((
169 QQQ
170
171 affiche le trimestre entre T1 et T4
172 )))|(% style="width:332px" %)(((
173 QQQQ
174
175 affiche le trimestre entre 1er trimestre et 4ème trimestre
176 )))
177 |(% style="text-align:center; width:160.8px" %)**w**|(% style="width:1px" %)Numéro de semaine dans l'année|(% style="width:122px" %)(((
178 w
179
180 sur deux chiffres maximum
181 )))|(% style="width:89px" %)(((
182 ww
183
184 sur deux chiffres minimum [*]
185 )))|(% style="width:140px" %)(((
186 www
187
188 sur trois chiffres minimum [*]
189 )))|(% style="width:332px" %)(((
190 wwww
191
192 sur quatre chiffres minimum [*]
193 )))
194 |(% style="text-align:center; width:160.8px" %)**W**|(% style="width:1px" %)Numéro de semaine dans le mois|(% style="width:122px" %)(((
195 W
196
197 sur deux chiffres maximum
198 )))|(% style="width:89px" %)(((
199 WW
200
201 sur deux chiffres minimum [*]
202 )))|(% style="width:140px" %)(((
203 WWW
204
205 sur trois chiffres minimum [*]
206 )))|(% style="width:332px" %)(((
207 WWWW
208
209 sur quatre chiffres minimum [*]
210 )))
211 |(% style="text-align:center; width:160.8px" %)**d**|(% style="width:1px" %)Jour dans le mois|(% style="width:122px" %)(((
212 d
213
214 sur deux chiffres maximum, de 1 à 31
215 )))|(% style="width:89px" %)(((
216 dd
217
218 affiche le jour sur deux chiffres, de 01 à 31
219 )))|(% style="width:140px" %)(((
220 ddd
221
222 sur trois chiffres minimum [*]
223 )))|(% style="width:332px" %)(((
224 dddd
225
226 sur quatre chiffres minimum [*]
227 )))
228 |(% style="text-align:center; width:160.8px" %)**D**|(% style="width:1px" %)Jour dans l'année|(% style="width:122px" %)(((
229 D
230
231 sur deux chiffres maximum
232 )))|(% style="width:89px" %)(((
233 DD
234
235 sur deux chiffres minimum [*]
236 )))|(% style="width:140px" %)(((
237 DDD
238
239 sur trois chiffres minimum [*]
240 )))|(% style="width:332px" %)(((
241 DDDD
242
243 sur quatre chiffres minimum [*]
244 )))
245 |(% style="text-align:center; width:160.8px" %)**E**|(% style="width:1px" %)Nom du jour de la semaine|(% style="width:122px" %)(((
246 E
247
248 Abrégé sur trois caractères (lun. , mar. , mer. , jeu. ...)
249 )))|(% style="width:89px" %)(((
250 EE
251
252 Abrégé sur trois caractères (lun. , mar. , mer. , jeu. ...)
253 )))|(% style="width:140px" %)(((
254 EEE
255
256 Abrégé sur trois caractères (lun. , mar. , mer. , jeu. ...)
257 )))|(% style="width:332px" %)(((
258 EEEE
259
260 Nom complet
261 )))
262 |(% style="text-align:center; width:160.8px" %)**e**|(% style="width:1px" %)Jour de la semaine|(% style="width:122px" %)(((
263 e
264
265 Numéro du jour de la semaine sur un chiffre
266 )))|(% style="width:89px" %)(((
267 ee
268
269 Numéro du jour de la semaine sur deux chiffres
270 )))|(% style="width:140px" %)(((
271 eee
272
273 Abrégé sur trois caractères (lun. , mar. , mer. , jeu. ...)
274 )))|(% style="width:332px" %)(((
275 eeee
276
277 Nom complet
278 )))
279 |(% 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
280 |(% style="text-align:center; width:160.8px" %)**H**|(% style="width:1px" %)(((
281 Heure affichée de 0 à 23
282 )))|(% style="width:122px" %)(((
283 H
284
285 sur deux chiffres maximum
286 )))|(% style="width:89px" %)(((
287 HH
288
289 sur deux chiffres minimum [*]
290 )))|(% style="width:140px" %)(((
291 HHH
292
293 sur trois chiffres minimum [*]
294 )))|(% style="width:332px" %)(((
295 HHHH
296
297 sur quatre chiffres minimum [*]
298 )))
299 |(% style="text-align:center; width:160.8px" %)**k**|(% style="width:1px" %)Heure affichée de 1 à 24|(% style="width:122px" %)(((
300 k
301
302 sur deux chiffres maximum
303 )))|(% style="width:89px" %)(((
304 kk
305
306 sur deux chiffres minimum [*]
307 )))|(% style="width:140px" %)(((
308 kkk
309
310 sur trois chiffres minimum [*]
311 )))|(% style="width:332px" %)(((
312 kkkk
313
314 sur quatre chiffres minimum [*]
315 )))
316 |(% 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" %)(((
317
318
319 sur deux chiffres maximum
320 )))|(% rowspan="2" style="width:89px" %)(((
321
322
323 sur deux chiffres minimum [*]
324 )))|(% rowspan="2" style="width:140px" %)(((
325
326
327 sur trois chiffres minimum [*]
328 )))|(% rowspan="2" style="width:332px" %)(((
329
330
331 sur quatre chiffres minimum [*]
332 )))
333 |(% style="text-align:center; width:160.8px" %)**h**
334 |(% style="text-align:center; width:160.8px" %)**m**|(% style="width:1px" %)minutes|(% style="width:122px" %)(((
335 m
336
337 sur deux chiffres maximum
338 )))|(% style="width:89px" %)(((
339 mm
340
341 sur deux chiffres minimum [*]
342 )))|(% style="width:140px" %)(((
343 mmm
344
345 sur trois chiffres minimum [*]
346 )))|(% style="width:332px" %)(((
347 mmmm
348
349 sur quatre chiffres minimum [*]
350 )))
351 |(% style="text-align:center; width:160.8px" %)**s**|(% style="width:1px" %)secondes|(% style="width:122px" %)(((
352 s
353
354 sur deux chiffres maximum
355 )))|(% style="width:89px" %)(((
356 ss
357
358 sur deux chiffres minimum [*]
359 )))|(% style="width:140px" %)(((
360 sss
361
362 sur trois chiffres minimum [*]
363 )))|(% style="width:332px" %)(((
364 ssss
365
366 sur quatre chiffres minimum [*]
367 )))
368
369 {{id name="FormatDateAsterisque"/}}
370
371 [*] précédé à gauche d'autant de 0 que nécessaires
372
373 = Format Icône =
374
375 Ces formats peuvent être utilisées pour visualiser une tendance ou l'atteinte d'un objectif.
376 Trois formats icônes sont créés par défaut : //Objectif//, //Tendance// et //Tendance (inverse)//.
377
378 [[image:Format_manager_icon_FR.png]]
379
380 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**.
381 Pour modifier ces icônes :
382
383 * 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"]]**.
384
385 (% class="box infomessage" %)
386 (((
387 Le bouton [[image:Table_view_icon_FR.png||alt="Vue tableau"]] permet d'afficher une vue tableau des icônes disponibles.
388 )))
389
390 = Format Mois =
391
392 Le format Mois est utilisé pour associer un mois à une valeur numérique (1= Janvier,... 12 = Décembre).
393
394 = Format Pourcentage =
395
396 Le format Pourcentage est utilisé pour associer un pourcentage à une valeur numérique (exemple : 0.4567 = 45.67 %).
397
398 1. Indiquez le nombre de décimales souhaitées.
399 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.
400 Par exemple, si vous sélectionnez 2 décimales et cochez la case **Forcer**, la valeur 0.823 est affichée 82,30 %.
401 1. Cochez la case **Séparateur de décimales** pour entrer le séparateur souhaité (par défaut, un point).
402 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.
403 ➡ Un aperçu du format obtenu est affiché en-dessous.
404
405 [[image:Format_manager_%_FR.png||alt="Pourcentage"]]
406
407 = Format Alerteur{{id name="Alerteur"/}} =
408
409 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.
410
411 L'alerteur définit lui même une liste d'alerteurs de type valeurs ou intervalles de valeurs.
412
413 1. Cliquez sur le bouton** + **au-dessus du tableau des alerteurs.
414 ➡ La boite** Créer un nouvel alerteur **s'affiche.
415 1. Dans la section **Type en entrée**, sélectionnez un des choix proposés :
416 1*. **Valeur** : indiquez la valeur à formater
417 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.
418 1. Dans la section **Type en sortie**, sélectionnez le type d'affichage souhaité :
419 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).
420 1*. **Couleur** : sélectionnez au moins une des options suivantes :
421 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.
422 1**. **Couleur de texte**
423 1**. **Couleur de remplissage** :  couleur de fond du texte
424 1*. **Icône** : Sélectionnez une image.
425 Le bouton **Ajouter une icône personnalisée** [[image:Add_custom_icon_FR.png||alt="Ajout icone"]] vous permet ajouter vos propres icônes.
426 1*. **Couleur + icône** : combinaison de **Couleur **et **Icône** qui permet d'afficher un texte formaté avec une icône.
427
428 [[image:Format_manager_alerter2_FR.png||alt="Alerteur"]]
429
430 = Format Autre =
431
432 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.
433
434 * Le format **Surface (are) **est utilisé pour associer une surface en centiares à une surface décomposeés en hectares, ares, centiares.
435
436 (% class="box infomessage" %)
437 (((
438 Depuis la version 2024R1, ce format utilise un séparateur des milliers. Une surface est ainsi affichée sous la forme :
439 **8 437 ha 54 a 23 ca** (au lieu de **8437 ha 54 a 23 ca **auparavant).
440 )))
441
442 * 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.
443 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)
444
445 * Le format **Heure(s) **est utilisé pour associer un temps en secondes à une durée en heures minutes et secondes.
446
447 = Page connexe... =
448
449 {{ddchildren}}{{/ddchildren}}