Code source wiki de Assistant de création de tableau de bord

Modifié par Aurelie Bertrand le 2025/09/08 11:37

version	line-number	content
161.1	1	{{ddtoc}}{{/ddtoc}}
1.1	2
161.1	3	----
1.1	4
	5	= Préambule =
	6
77.5	7	(((
78.2	8	L'assistant de création de tableau de bord a pour but de vous aider à créer un tableau de bord en quelques clics depuis une source de données et ce, de manière intuitive.
1.1	9
154.1	10	DigDash s'efforcera de vous proposer des tableaux de bord pouvant correspondre à votre besoin.
	11
77.5	12	Les types de tableaux de bord proposés sont paramétrables pour répondre au mieux aux habitudes et usages des utilisateurs.
	13	)))
	14
11.2	15	(((
77.5	16	{{info}}
	17	Une source de données ou datasource est l'endroit où l’on va chercher les données avant de les structurer dans le modèle de données.
	18	{{/info}}
11.2	19
77.5	20	{{info}}
78.2	21	Un tableau de bord ou dashboard est un ensemble de pages permettant de visualiser des flux d’informations sur le web et d’interagir avec les données.
77.5	22	{{/info}}
	23
105.1	24	= (% style="color:inherit; font-family:inherit; font-size:29px" %)Autorisations pré-requises(%%) =
77.5	25	)))
	26
	27	(((
77.7	28	L'utilisateur voulant accéder à l'assistant devra au préalable être dans le groupe d'autorisations nommé "Utilisateur final pour Self-service BI".
11.2	29	)))
	30
173.1	31	= Utilisation de l'assistant =
1.1	32
259.2	33	(% class="box errormessage" %)
	34	(((
263.1	35	❗ Attention : Le modèle de données (si nouvellement créé ou modifié) et les graphiques créés ne seront sauvegardés qu'une fois que vous aurez cliqué sur le bouton Terminer et construire le tableau de bord sur la page Construisez votre propre tableau de bord.
259.2	36	Si vous quittez l'Assistant de Création de tableau de bord auparavant, tous les graphiques créés ainsi que le modèle de données (si nouvellement créé) seront perdus.
	37	)))
1.1	38
269.1	39	Depuis l'Éditeur de tableaux de bord, sélectionnez dans la barre d'outils située en haut à droite l'Assistant de création de tableau de bord [[image:1734366114590-450.png]].
259.2	40
269.1	41	[[image:1734365990340-662.png\|\|alt="Bouton ACTB"]]
170.3	42
269.1	43
156.1	44	== Sélection de de la source de données ==
	45
275.1	46	Le premier écran propose deux possibilités pour le chargement de votre source de données :
106.1	47
258.2	48	* Charger un fichier directement depuis votre ordinateur.
	49	* Charger un modèle de données existant dans DigDash.
78.3	50
1.1	51	:
275.1	52	: [[image:ACTB_home_FR.png\|\|alt="Accueil" height="531" width="867"]]
4.1	53	:
166.1	54
	55	(((
171.3	56	=== Sélection d'un fichier de données ===
184.1	57
193.1	58	[[image:1636107356129-174.png\|\|queryString="width=207&height=174" height="174" width="207"]]
171.2	59	)))
166.1	60
171.2	61	(((
167.1	62	==== Sélection d'un fichier local ====
	63
258.3	64	Sélectionner le bouton radio Depuis un fichier sur votre ordinateur pour choisir un fichier de données localement de type xls, xlsx, csv, xml ou json.
170.1	65
200.1	66	[[image:1636107631359-906.png\|\|queryString="width=720&height=166" height="166" width="720"]]
193.1	67
167.1	68	==== Sélection d'un fichier depuis un serveur de document ====
	69
258.3	70	Sélectionner le bouton radio Depuis un fichier sur vos serveurs de documents pour choisir un fichier sur un de vos serveurs de documents.
170.1	71
200.1	72	[[image:1636107700831-854.png\|\|queryString="width=727&height=186" height="186" width="727"]]
193.1	73
180.1	74	=== Sélection d'un modèle de données existant ===
166.1	75
193.1	76	[[image:1636107388698-579.png\|\|queryString="width=204&height=172" height="172" width="204"]]
184.1	77
177.1	78	Les modèles auxquels vous avez accès sont limités au rôle courant. Dans le cas d'un utilisateur, seuls les modèles des rôles auxquels celui-ci a accès apparaîtront.
171.4	79
275.1	80	Un modèle est considéré comme entièrement éditable lorsqu'il s'agit d'un modèle de données issu de l'utilisation de l'Assistant de création de tableau de bord, c'est-à-dire un modèle de données basé sur un fichier et entièrement créé depuis l'Assistant.
170.1	81
278.1	82	Un modèle est considéré comme partiellement éditable lorsqu'il s'agit d'un modèle de données non issu de l'utilisation de l'Assistant de création de tableau de bord, c'est-à-dire un modèle de données basé sur un fichier créé depuis le Studio. L'on pourra ainsi seulement ajouter des mesures calculées ainsi que modifier la nature des colonnes du modèle.
275.1	83
280.1	84	Tous les modèles de données de types autres que xls, xlsx, csv, xml, json ne sont pas éditables. Il est possible de choisir un modèle de données ayant pour source une base de données mais il ne pourra pas être modifié : il sera en Non éditable.
275.1	85
277.1	86	[[image:1757320920970-282.png]]
	87
166.1	88	== Chargement de la source de données ==
	89	)))
	90
200.1	91	: A cette étape, vous pouvez suivre le statut du chargement de votre source de données. Pour les fichiers de type Excel, vous pouvez choisir la feuille de calcul sur laquelle travailler comme dans l'exemple ci-dessous.
25.5	92
200.1	93	: [[image:1636109158405-811.png]]
21.2	94	:
228.3	95	: En continuant, l’outil effectuera une analyse contextuelle du fichier pour vous suggérer les tableaux de bord les plus appropriés.
157.1	96	:
1.1	97
21.2	98	(((
156.1	99	== Sélection du tableau de bord ==
174.1	100
228.4	101	A cette étape, vous serez invité(e) à sélectionner le tableau de bord qui correspondra à votre besoin après lecture de vos données.
200.1	102
	103	Une prévisualisation de vos données succincte vous permettra également de vérifier si le modèle de données créé par DigDash a bien été effectué. Il sera par exemple possible de vérifier comment DigDash a détecté et distingué vos colonnes en tant que dimension ou mesure. Dans le cas d'une mauvaise lecture de vos données, il sera possible d'éditer ce modèle de données (voir partie Edition de la source de données).
279.1	104
	105	Dans certains cas, DigDash peut détecter que vos données correspondent à un tableau de bord pré-configuré. Il vous porpose alors un tableau avec des graphiques pertinents par rapport à vos données, que vous pouvez cependant personnaliser.
156.1	106	)))
38.1	107
156.1	108	(((
	109	=== (% id="cke_bm_230S" style="display:none" %) (%%)Cas 1 : aucun tableau de bord pré-configuré n'a été détecté ===
	110
38.1	111	Il est possible qu'aucun tableau de bord pré-configuré ne corresponde à la source de données chargée.
	112
229.3	113	==== Sélection du tableau de bord personnalisé ====
174.1	114
259.2	115	Dans ce cas-là, vous serez par défaut invité(e) à créer un tableau de bord personnalisé en cliquant sur le bouton Continuer.
38.1	116
174.1	117	Le tableau de bord personnalisé vous laisse totalement libre des graphiques à créer dans votre tableau de bord suivant les différents axes d'analyses expliqués ci-après.
38.1	118
232.2	119	(((
264.1	120	(% class="wikigeneratedid" id="H" %)
	121	[[image:1650450415897-458.png]]
39.1	122
163.1	123	==== Choix des graphiques ====
155.1	124	)))
	125
	126	La sélection d'un tableau de bord personnalisé vous mènera à une vue similaire de celle ci-dessous.
	127
258.2	128	La partie gauche de cette interface permet d'accéder à la liste des graphiques pouvant être ajoutés dans votre tableau de bord.
155.1	129
200.1	130	La partie droite représente le contenu du tableau de bord à construire.
155.1	131
269.1	132	[[image:ACTB_general.png\|\|queryString="width=957&height=613" alt="Choix_graphiques" data-xwiki-image-style-alignment="center" height="613" width="957"]]
200.1	133
155.1	134	Les dimensions et mesures de la source de données sont reconnues automatiquement. L'utilisateur peut donc créer simplement les graphes souhaités.
258.2	135	Dans la liste déroulante Type de graphique, plusieurs types de graphiques sont disponibles :
155.1	136
258.2	137	* Le type Recommandations affiche une liste de graphes qui dépendent des objets disponibles dans le modèle de données sélectionné. Par exemple, l'analyse géographique n'est proposée que si une dimension géographique existe dans le modèle. Quatre types d'analyse sont présents :
155.1	138	** //Analyse de tendance// : une dimension temps a été détectée. La courbe représentant l'évolution d'une mesure par date est proposée automatiquement.
	139	** //Analyse géographique// : une dimension géographique a été détectée. La représentation par carte est proposée automatiquement.
	140	** //Liste //: une ou plusieurs dimensions ont été détectées. Une représentation en tableau est proposée automatiquement.
258.2	141	** Tuiles : une ou plusieurs mesures ont été détectées. Une représentation en tuile est proposée automatiquement.(((
269.1	142	[[image:Recommandations.png\|\|alt="Recommandations" data-xwiki-image-style-alignment="center"]]
258.2	143	)))
	144	* Les autres types Comparaison, Tableaux, Indicateurs, Cartes vous permettent de faire une analyse librement : choisissez le type de graphique que vous souhaitez dans la liste déroulante, le graphique désiré et les dimensions et mesures à associer.
155.1	145
269.1	146	[[image:Choix_graphique_exemple.png\|\|alt="Choix_graphique" data-xwiki-image-style-alignment="center"]]
258.2	147
	148	Une fois le type de graphique et les données définies, cliquez sur le bouton Ajouter au tableau de bord à côté du graphe pour l'ajouter au tableau de bord.
155.1	149	)))
	150
	151	(((
157.1	152	=== (% style="color:inherit; font-family:inherit; font-size:29px" %)Cas 2 : des tableaux de bord pré-configurés ont été détectés(%%) ===
155.1	153	)))
	154
	155	: DigDash peut détecter si un tableau de bord pré-configuré correspond aux données de votre source.
	156
	157	(((
229.3	158	==== Sélection du tableau de bord pré-configuré ====
174.1	159	)))
155.1	160
174.1	161	(((
228.5	162	Vous pourrez alors sélectionner ce tableau de bord avec des graphiques pré-configurés ou le choix de réaliser un tableau de bord personnalisé toujours proposé.
174.1	163	)))
	164
228.5	165	: Dans notre exemple, le fichier retail_v7_de_world.xls correspond au tableau de bord pré-configuré "Vente au détail" avec un très bon score.
174.1	166
	167	(((
235.2	168	[[image:1650450301493-721.png]]
155.1	169
259.2	170	En sélectionnant celui-ci, le tableau de bord comprendra des graphiques propres à la vente (carte des ventes, Chiffre d'affaires,...).
	171
235.2	172
155.1	173	(((
157.1	174	==== Choix des graphiques ====
155.1	175	)))
	176
175.1	177	: La sélection de ce tableau de bord génère par la suite une liste des représentations graphiques pertinentes qui composera votre tableau de bord : ici des graphiques propres à la vente (carte des ventes, Chiffre d'affaires, etc.).
174.1	178	:
	179	: Les graphiques pré-configurés s'ajoutent directement au contenu du tableau de bord à construire.
155.1	180
203.1	181	[[image:1636109959245-192.png]]
155.1	182
259.2	183	Vous pouvez ensuite enrichir le contenu de votre tableau de bord et rajouter vos propres graphiques dans la partie Graphiques supplémentaires.
155.1	184
269.1	185	[[image:Graphiques_supplémentaires.png\|\|alt="Graphiques_supplementaires" data-xwiki-image-style-alignment="center"]]
155.1	186
	187	(((
80.1	188	== Edition de la source de données ==
24.2	189
228.5	190	Il est vivement conseillé de prendre connaissance de la manière dont est formaté votre modèle de données et d'amener d'éventuelles rectifications si besoin.
1.1	191
78.7	192	Le bouton [[image:1602853746744-718.png]] vous permettra d'en apprendre davantage sur votre source. Vous aurez notamment l'occasion de prévisualiser vos données ainsi que de les configurer.
78.5	193
84.4	194	=== Prévisualisation des données de la source ===
1.1	195
259.2	196	L'onglet Prévisualiser les données vous permet de visualiser une partie succincte de vos données pour en comprendre leur nature.
1.1	197
216.2	198	[[image:1636112035431-638.png]]
55.2	199
83.3	200	Des options existent pour vous permettre de former au mieux votre source.
55.2	201
259.2	202	Ces options sont fonctions de la nature de la source de données importée. Par exemple, dans la capture ci-dessus, il s'agit d'un fichier Excel. Le choix du classeur ou de la feuille de calcul est proposé.
70.3	203
164.1	204	==== Transformation de colonnes ====
	205
175.1	206	(% class="box warningmessage" %)
	207	(((
259.2	208	Les options de transformation de colonnes ne sont disponibles que pour les modèles de données nouvellement créés ainsi que pour les modèles de données existants si et seulement si ceux-ci ont été créés depuis l'Assistant de Création de Tableau de bord.
175.1	209	)))
	210
216.2	211	(% class="wikigeneratedid" %)
219.2	212	Vous pouvez appliquer des transformations sur vos colonnes soit via le bouton [[image:1636111836544-291.png]] ou directement sur les en-têtes de vos colonnes.
216.2	213
253.2	214	[[image:1650458909866-641.png]]
164.1	215
218.1	216	(% class="wikigeneratedid" id="HFonctions" %)
219.2	217	L'on pourra ainsi appliquer les fonctions pré-établies dans le produit ainsi que des formats.
218.1	218
84.4	219	=== Configuration du modèle de données ===
1.1	220
76.5	221	{{info}}
259.2	222	Le modèle de données est une représentation "intelligente" d’une source de données. Le modèle de données est composé de mesures et de dimensions.
76.5	223	{{/info}}
	224
236.1	225	{{info}}
	226	Une dimension est composée d’un ensemble de membres organisés selon une ou plusieurs hiérarchies.
	227	{{/info}}
	228
	229	{{info}}
	230	Une mesure est une quantité à représenter qui peut être agrégée avec une formule d’agrégation.
	231	{{/info}}
	232
259.2	233	L'onglet Configurer le modèle de données vous permet de configurer les dimensions et mesures détectées par DigDash.
1.1	234
140.1	235	L'on pourra ainsi modifier leur type, leur nom d'affichage et même créer des mesures calculées.
55.3	236
237.2	237	[[image:1650455916483-310.png]]
	238
	239
51.3	240	)))
1.1	241
59.2	242	(((
229.6	243	==== Paramètres des colonnes ====
	244
237.2	245	Le panneau latéral vous permet de connaître la définition de chaque colonne sélectionnée.
229.6	246
	247
	248	===== Paramètres d'une dimension =====
	249
230.2	250	Outre le fait que vous pouvez à tout moment changer la nature d'une dimension, il est également possible de lui ajouter des hiérarchies par groupement automatique ou via les hiérarchies partagées.
229.6	251
242.2	252	[[image:1650457399549-926.png]]
229.6	253
	254	===== Paramètres d'une mesure =====
	255
230.2	256	Outre le fait que vous pouvez à tout moment changer la nature d'une mesure, il est également possible de lui ajouter des objectifs.
229.6	257
242.2	258	[[image:1650457181559-809.png]][[image:1650457224390-702.png]]
229.6	259
242.2	260
229.3	261	==== Ajout de mesures calculées ====
66.7	262
252.1	263	Le bouton [[image:1650458653912-616.png]] vous permet de rajouter des mesures calculées à votre modèle de données.
76.2	264
70.7	265	{{info}}
75.2	266	Une mesure calculée ou mesure dérivée est une mesure dont la définition est issue d’une formule basée ou non sur d’autres mesures / dimensions.
70.7	267	{{/info}}
	268
76.2	269	(% class="wikigeneratedid" %)
140.1	270	On distingue plusieurs manières de les créer. Vous pouvez en effet utiliser des fonctions (ou formules) préétablies existantes (générales ou de transformations) ou définir vous-même la formule à appliquer.
76.2	271
254.2	272	(% class="box warningmessage" %)
	273	(((
	274	Le nom d'une mesure calculée ou mesure dérivée ne peut plus être éditée après sa création.
	275	)))
	276
80.1	277	===== Fonctions générales =====
73.2	278
250.2	279	[[image:1650458342219-420.png]]
73.2	280
140.1	281	Les fonctions générales proposent des formules basiques telles que le pourcentage de progression.
76.2	282
80.1	283	===== Transformateurs =====
73.2	284
250.2	285	[[image:1650458529775-292.png]]
73.2	286
77.4	287	Les fonctions de transformations s'appliquent sur des mesures et vous permettent d'afficher les valeurs pour l'année précédente, le mois précédent la semaine précédente ou le jour précédent.
76.3	288
80.1	289	===== Formule =====
66.6	290	)))
	291
140.1	292	: La sélection de "Formule..." fera apparaître la boîte de dialogue suivante :
70.1	293	:
214.2	294	: [[image:1636110973085-813.png\|\|queryString="width=282&height=321" height="321" width="282"]]
73.2	295	:
140.1	296	: Cette dialogue vous permet de définir librement la formule de votre mesure en y insérant les mesures ou dimensions de votre choix.
228.6	297	: Vous êtes invité(e) à saisir un nom et la formule.
66.6	298
169.1	299	== (% style="color:inherit; font-family:inherit; font-size:29px" %)Construction du tableau de bord(%%) ==
66.2	300	)))
59.2	301
77.5	302	: Vous avez la possibilité de gérer plusieurs éléments pour la visualisation de votre tableau de bord.
177.1	303	:
66.2	304
	305	(((
176.1	306	=== (% style="color:inherit; font-family:inherit; font-size:23px" %)Nom de votre tableau de bord(%%) ===
	307	)))
84.2	308
176.1	309	(((
84.2	310	(% class="wikigeneratedid" %)
212.1	311	Donnez un nom à votre tableau de bord. Il est obligatoire. Ce nom sera défini comme le nom de la catégorie des graphiques crées dans le portefeuille de utilisateur/du rôle courant.
84.2	312
	313	{{info}}
140.1	314	Le portefeuille d'un rôle ou d'un utilisateur est un espace de travail dont les droits peuvent être donnés au cas par cas.
84.2	315	{{/info}}
	316
169.1	317	=== Disposition des graphiques ===
66.2	318
141.1	319	DigDash vous propose des modèles pour disposer au mieux vos graphiques dans le tableau de bord à créer. Le modèle sélectionné par défaut est le modèle automatique.
59.2	320
	321	[[image:1602856226445-298.png]]
	322
140.1	323	Le modèle automatique dispose automatiquement les graphiques de manière à ajuster au mieux votre contenu, et ce, sans limitation du nombre de graphiques.
59.2	324
141.1	325	Chaque modèle proposé supporte un nombre de graphiques limité (affiché en survolant le modèle avec la souris).
59.2	326
	327	[[image:1602857685204-489.png]]
	328
	329
84.2	330	(% class="wikigeneratedid" id="HOrdredesgraphiques" %)
175.1	331	Sur la partie gauche, vous pouvez glisser-déposer les graphiques de votre tableau de bord pour ordonner vos graphiques dans le modèle de disposition sélectionné. En effet, le modèle de disposition prend en compte l'ordre des éléments pour l'agencement. A noter que le premier est le plus important.
59.2	332
	333	[[image:1602857767860-961.png]]
	334
228.6	335	=== Validation et construction du tableau de bord ===
66.2	336
66.5	337	(% id="cke_bm_291S" style="display:none" %) (%%)Cliquer sur le bouton [[image:1602855958729-795.png]] pour finaliser la construction de votre tableau de bord.
	338
	339	Patientez quelques instants.
	340
141.1	341	L'assistant se ferme et vous découvrez votre tableau de bord dans l'Editeur de tableau de bord.
66.5	342
175.1	343	Si vous le souhaitez, vous pouvez continuer à compléter votre tableau de bord (ajout de filtres, dimensions,...).
61.1	344	)))
1.1	345
262.1	346	=== Édition du tableau de bord a posteriori ===
97.2	347
259.2	348	Vous avez la possibilité de compléter votre tableau de bord nouvellement crée via l'outil de Self-Service BI dans lequel vous pourrez par exemple modifier les couleurs de vos graphiques, modifier les icônes de vos tuiles, etc.
175.1	349
262.1	350	Pour accéder à l'interface de Self-Service BI, placez-vous sur un des graphiques du tableau de bord créé et sélectionnez l'icône [[image:Digdash.user_guide.dashboard.dashboard_editor_guide.edit_dashboard.WebHome@Bouton_edition_graphique_icone.png\|\|alt="Edition_graphique"]].
225.2	351
269.1	352	[[image:Edition_graphique.png\|\|alt="Edition_graphique" data-xwiki-image-style-alignment="center"]]
225.2	353
166.1	354	= Edition du modèle de données a posteriori =
97.2	355
175.1	356	Un modèle de données issu de la création de tableau de bord via cet assistant est modifiable a posteriori. Vous avez, par exemple, la possibilité de rajouter des mesures calculées.
97.2	357
250.2	358	[[image:1650458139080-561.png]]
99.2	359
	360
98.2	361	Pour accéder à l'interface d'édition, deux possibilités :
97.2	362
262.1	363	* placez-vous sur un des graphiques du tableau de bord créé et sélectionnez le sous-menu Éditer le modèle de données via l'icône [[image:1636117832252-592.png\|\|queryString="width=34&height=48" height="48" width="34"]].
272.1	364	[[image:Edit_data_model_ACTB_FR.png]]
98.2	365
280.1	366	* via le bouton Editer lors de la création de nouveaux graphiques à partir de ce modèle de données.
272.1	367	[[image:Edit_data_model_from_newgraph.png]]
98.2	368
272.1	369

Code source wiki de Assistant de création de tableau de bord

Sommaire