Langue	Titre	Date
en	-	-
fr	-	-
es	-	-

Code source wiki de Créer et appliquer un Alerteur

Modifié par Aurelie Bertrand le 2025/02/07 10:14

version	line-number	content
2.1	1	(% class="box infomessage" %)
	2	(((
	3	🙋 Ce tutoriel est à destination des utilisateurs avancés.
	4
32.1	5	⏱ Il est prévu pour être suivi de manière autonome en 1 heure.
2.1	6	)))
	7
	8	----
	9
	10	{{ddtoc/}}
	11
	12	----
	13
	14	= Introduction =
	15
41.1	16	Dans ce tutoriel, nous allons décourvrir comme créer et appliquer un Alerteur (ou format alerteur) , et ce, à travers deux exemples.
2.1	17
26.1	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.
2.1	19
3.1	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.
2.1	21
23.1	22	Ce tutoriel se déroule dans le Studio.
27.1	23	Les différentes étapes de ce tutoriel sont les suivantes :
3.1	24
4.2	25	* Création du modèle de données basé sur le fichier retailfr.xls
38.1	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
4.2	29
2.1	30	= Pré-requis =
	31
	32	Afin de pouvoir effectuer ce tutoriel, il est requis de :
	33
45.1	34	* disposer d'une installation de DigDash Enterprise d'une version 2024R2 ou plus récente ;
2.1	35	* faire partie en tant qu'utilisateur du groupe d'autorisation "Concepteur de modèles de données";
4.3	36	* télécharger le fichier Excel [[retailfr.xls>>attach:retailfr.xls]].
2.1	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
4.3	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.
50.2	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.
4.3	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
45.2	65	* Bricolage
4.3	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…
43.1	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.
50.2	74	[[image:Add_rule_FR.png\|\|alt="Ajout règle"]]
4.3	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
30.1	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 :
4.3	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.
50.2	86	[[image:Measure_revenue_N-1_FR.png\|\|alt="CA Année N-1"]]
4.3	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**.
50.2	92	[[image:Measure_revenue_progression_FR.png\|\|alt="Mesure CA progression"]]
4.3	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.
6.2	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
48.1	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é.
6.2	104
54.1	105	[[image:New_flow_FR.png]]
6.2	106
	107	(% style="line-height: 1.2; text-align: justify;" %)
	108	== Tableau de synthèse du CA par famille de produit ==
	109
48.1	110	1. Créez un nouveau flux de type {{glossaryReference glossaryId="Glossary" entryId="Tableau croisé"}}Tableau croisé{{/glossaryReference}}.
6.2	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.
56.1	114	[[image:Crosstable_revenuebyfamilyproduct_FR.png\|\|alt="Tableau croisé"]]
6.2	115
	116	1. Cliquez sur le bouton de tri de l’axe Colonne 1 et appliquez un tri décroissant sur la mesure CA.
56.1	117	[[image:Crosstable_sort_FR.png\|\|alt="Tri décroissant"]]
6.3	118	1. Cliquez sur OK pour enregistrer.
6.4	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
6.5	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.
7.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.
59.1	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.
60.1	131	[[image:1737537540097-270.png\|\|alt="Sauvegarde filtres" height="120" width="467"]]
6.5	132
	133	= Étape 3 : Créer les alerteurs =
	134
13.1	135	Nous allons à présent créer les alerteurs que nous utiliserons dans les tableaux que nous avons créés précédemment.
6.6	136
13.1	137	Pour créer un nouvel alerteur :
	138
62.2	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"]](((
13.1	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 + .
62.2	144	[[image:Format_editor_alerter_FR.png\|\|alt="Editeur de format" height="518" width="861"]]
6.6	145
13.2	146	== Création de l'alerteur _tutoriel_progression ==
	147
13.5	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 :
13.2	149
13.4	150	* Une flèche rouge vers le bas pour une progression négative
	151	* Un signe égal gris pour une progression nulle
13.2	152	* Une flèche verte vers le haut pour une progression positive
	153
13.3	154	1. Créez un nouveau format alerteur avec le nom _tutoriel_progression et le rôle (Aucun) (pas de restriction du rôle).
66.2	155	[[image:Format_name_alerter_FR.png\|\|alt="Nom format" height="154" width="342"]]
13.3	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" %)
13.4	165	1. Cliquez sur le bouton + dans la section Edition du format à droite pour créer les différentes mises en forme :
39.1	166	1. Progression nulle :*
	167	11. Pour le Type en entrée, sélectionnez //Valeur //* **et entrez //0//.
	168	11. Pour le Type en sortie, sélectionnez //Couleur + icône// au Format* //Pourcentage.//
	169	11. Sélectionnez// //ensuite(% style="font-weight:bold" %)//* //(%%)le signe égal gris comme //Image//**.
66.2	170	[[image:Alerter_no_progression_FR.png\|\|alt="Progression nulle"]]
39.1	171	11. Cliquez sur OK*.
	172
13.4	173	1. Progression négative :*
	174	11. Pour le Type en entrée*, sélectionnez //Intervalle//.
	175	11. Sélectionnez// //ensuite// ////-infini// pour le Minimum et entrez //0// pour le Maximum*.
	176	11. Pour le Type en sortie, sélectionnez //Couleur + icône// au Format* //Pourcentage.//
15.2	177	11. Sélectionnez// //ensuite(% style="font-weight:bold" %)//* //(%%)la flèche rouge vers le bas comme //Image//**.
66.2	178	[[image:Alerter_negative_progression_FR.png\|\|alt="Negative progression"]]
13.4	179	11. Cliquez sur OK*.
66.2	180
13.4	181	1. Progression positive :*
	182	11. Pour le Type en entrée*, sélectionnez //Intervalle//.
	183	11. Entrez ensuite 0 pour le Minimum et sélectionnez //+infini// pour le Maximum*.
	184	11. Pour le Type en sortie, sélectionnez //Couleur + icône// au Format* //Pourcentage.//
15.2	185	11. Sélectionnez// //ensuite(% style="font-weight:bold" %)//* //(%%)la flèche verte vers le haut comme //Image//**.
66.2	186	[[image:Alerter_positive_progression_FR.png\|\|alt="Progression positive"]]
68.1	187
13.4	188	11. Cliquez sur OK*.
	189	➡ Les éléments de l'alerteur sont listés.
68.1	190	[[image:Format_alerter_progression_FR.png\|\|alt="Alerteur progression"]]
11.1	191
13.4	192	(% class="box infomessage" %)
13.2	193	(((
40.1	194	💡Vous pouvez créer plusieurs mises en forme pour votre alerteur.
68.1	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.
13.2	196	)))
	197
13.5	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 :
17.1	207	1. Marge supérieure à 480 :*
13.6	208	11. Pour le Type en entrée*, sélectionnez //Valeur//.
17.1	209	11. Entrez ensuite //480// pour le Minimum et sélectionnez //+infini// pour le Maximum*.
13.6	210	11. Pour le Type en sortie, sélectionnez //Couleur// au Format* //Nombre.//
15.1	211	11. Sélectionnez// //ensuite(% style="font-weight:bold" %)//* **//(%%)la couleur de remplissage (vert : #71c31f).
72.1	212	[[image:Alerter_margin+_FR.png\|\|alt="Marge supérieure"]]
13.5	213	11. Cliquez sur OK*.
	214
17.1	215	1. Marge inférieure à 480 :*
13.7	216	11. Pour le Type en entrée*, sélectionnez.
	217	11. Sélectionnez// //ensuite// ////-infini// pour le Minimum et entrez //450// pour le Maximum*.
	218	11. Pour le Type en sortie, sélectionnez //Couleur// au Format* //Nombre.//
18.1	219	11. Sélectionnez// //ensuite(% style="font-weight:bold" %)//* **//(%%)la couleur de remplissage (rouge : #d95858).
72.1	220	[[image:Alerter_margin-_FR.png\|\|alt="Marge inférieure"]]
13.5	221	11. Cliquez sur OK*.
	222	➡ Les éléments de l'alerteur sont listés.
72.1	223	[[image:Alerter_margin_FR.png\|\|alt="Alerteur marge"]]
13.2	224
21.2	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
16.1	231	La création des alerteurs est terminée : cliquez sur OK en bas à droite pour valider et fermer l'Editeur de format.
15.2	232	Nous allons à présent affecter les alerteurs aux données.
13.7	233
24.1	234	= Étape 4 : Appliquer l'alerteur aux données =
15.2	235
42.1	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.
16.1	239
42.1	240	Nous allons ici appliquer les formats alerteur au niveau des flux.
	241
37.1	242	== Alerteur progression du chiffre d'affaires ==
16.1	243
48.1	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.
16.1	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).
76.1	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"]]
21.1	250
35.1	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.
76.1	252	[[image:1737541274823-424.png\|\|alt="CA progression avec alerteur Filtre"]]
16.1	253
36.1	254	== Alerteur marge ==
16.1	255
48.1	256	1. Ouvrez le tableau //Synthèse CA et marge Bricolage// depuis l'onglet {{glossaryReference glossaryId="Glossary" entryId="Flux"}}Flux{{/glossaryReference}} du Studio.
16.1	257	1. Cliquez-droit sur la mesure Marge.
80.1	258	1. Dans le menu contextuel qui s'affiche, cliquez sur Appliquer un format > Alerteur > _tutoriel_marge (Alerteur).[[image:Apply_alerter_margin_FR.png]](((
20.1	259	➡ L'affichage de la mesure //Marge// est modifié en conséquence.
79.1	260	[[image:1737542143072-293.png\|\|alt="Affichage marge modifié"]]
25.1	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
19.1	275	)))

Code source wiki de Créer et appliquer un Alerteur

Sommaire