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

Modifié par Aurelie Bertrand le 2024/12/17 09:08

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
258.2	46	Le premier écran propose trois 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.
	50	* Sélectionner un fichier de données fourni par DigDash.
78.3	51
1.1	52	:
203.1	53	: [[image:1636108413024-978.png\|\|queryString="width=882&height=516" height="516" width="882"]]
4.1	54	:
166.1	55
	56	(((
171.3	57	=== Sélection d'un fichier de données ===
184.1	58
193.1	59	[[image:1636107356129-174.png\|\|queryString="width=207&height=174" height="174" width="207"]]
171.2	60	)))
166.1	61
171.2	62	(((
167.1	63	==== Sélection d'un fichier local ====
	64
258.3	65	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	66
200.1	67	[[image:1636107631359-906.png\|\|queryString="width=720&height=166" height="166" width="720"]]
193.1	68
167.1	69	==== Sélection d'un fichier depuis un serveur de document ====
	70
258.3	71	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	72
200.1	73	[[image:1636107700831-854.png\|\|queryString="width=727&height=186" height="186" width="727"]]
193.1	74
180.1	75	=== Sélection d'un modèle de données existant ===
166.1	76
193.1	77	[[image:1636107388698-579.png\|\|queryString="width=204&height=172" height="172" width="204"]]
184.1	78
177.1	79	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	80
179.1	81	(% class="box infomessage" %)
	82	(((
258.3	83	Un modèle sera considéré comme entièrement éditable lorsqu'il s'agira d'un modèle de données issu de l'utilisation de l'Assistant de création de tableau de bord.
	84	\\Un modèle sera considéré comme partiellement éditable lorsqu'il s'agira d'un modèle de données non issu de l'utilisation de l'Assistant de création de tableau de bord. L'on pourra ainsi seulement ajouter des mesures calculées ainsi que modifier la nature des colonnes du modèle.
	85	\\Tous les modèles de données de types autres que xls, xlsx, csv, xml, json ne sont pas éditables.
179.1	86	)))
170.1	87
166.1	88	=== Sélection d'un fichier de démonstration ===
	89
193.1	90	[[image:1636107434724-965.png\|\|queryString="width=208&height=174" height="174" width="208"]]
184.1	91
174.1	92	Il s'agit de sources de données fournis par DigDash associées à des tableaux de bord pré-établis.
170.2	93
166.1	94	== Chargement de la source de données ==
	95	)))
	96
200.1	97	: 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	98
200.1	99	: [[image:1636109158405-811.png]]
21.2	100	:
228.3	101	: En continuant, l’outil effectuera une analyse contextuelle du fichier pour vous suggérer les tableaux de bord les plus appropriés.
157.1	102	:
1.1	103
21.2	104	(((
156.1	105	== Sélection du tableau de bord ==
174.1	106
228.4	107	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	108
	109	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).
156.1	110	)))
38.1	111
156.1	112	(((
	113	=== (% id="cke_bm_230S" style="display:none" %) (%%)Cas 1 : aucun tableau de bord pré-configuré n'a été détecté ===
	114
38.1	115	Il est possible qu'aucun tableau de bord pré-configuré ne corresponde à la source de données chargée.
	116
229.3	117	==== Sélection du tableau de bord personnalisé ====
174.1	118
259.2	119	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	120
174.1	121	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	122
232.2	123	(((
264.1	124	(% class="wikigeneratedid" id="H" %)
	125	[[image:1650450415897-458.png]]
39.1	126
163.1	127	==== Choix des graphiques ====
155.1	128	)))
	129
	130	La sélection d'un tableau de bord personnalisé vous mènera à une vue similaire de celle ci-dessous.
	131
258.2	132	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	133
200.1	134	La partie droite représente le contenu du tableau de bord à construire.
155.1	135
269.1	136	[[image:ACTB_general.png\|\|queryString="width=957&height=613" alt="Choix_graphiques" data-xwiki-image-style-alignment="center" height="613" width="957"]]
200.1	137
155.1	138	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	139	Dans la liste déroulante Type de graphique, plusieurs types de graphiques sont disponibles :
155.1	140
258.2	141	* 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	142	** //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.
	143	** //Analyse géographique// : une dimension géographique a été détectée. La représentation par carte est proposée automatiquement.
	144	** //Liste //: une ou plusieurs dimensions ont été détectées. Une représentation en tableau est proposée automatiquement.
258.2	145	** Tuiles : une ou plusieurs mesures ont été détectées. Une représentation en tuile est proposée automatiquement.(((
269.1	146	[[image:Recommandations.png\|\|alt="Recommandations" data-xwiki-image-style-alignment="center"]]
258.2	147	)))
	148	* 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	149
269.1	150	[[image:Choix_graphique_exemple.png\|\|alt="Choix_graphique" data-xwiki-image-style-alignment="center"]]
258.2	151
	152	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	153	)))
	154
	155	(((
157.1	156	=== (% 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	157	)))
	158
	159	: DigDash peut détecter si un tableau de bord pré-configuré correspond aux données de votre source.
	160
	161	(((
229.3	162	==== Sélection du tableau de bord pré-configuré ====
174.1	163	)))
155.1	164
174.1	165	(((
228.5	166	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	167	)))
	168
228.5	169	: 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	170
	171	(((
235.2	172	[[image:1650450301493-721.png]]
155.1	173
259.2	174	En sélectionnant celui-ci, le tableau de bord comprendra des graphiques propres à la vente (carte des ventes, Chiffre d'affaires,...).
	175
235.2	176
155.1	177	(((
157.1	178	==== Choix des graphiques ====
155.1	179	)))
	180
175.1	181	: 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	182	:
	183	: Les graphiques pré-configurés s'ajoutent directement au contenu du tableau de bord à construire.
155.1	184
203.1	185	[[image:1636109959245-192.png]]
155.1	186
259.2	187	Vous pouvez ensuite enrichir le contenu de votre tableau de bord et rajouter vos propres graphiques dans la partie Graphiques supplémentaires.
155.1	188
269.1	189	[[image:Graphiques_supplémentaires.png\|\|alt="Graphiques_supplementaires" data-xwiki-image-style-alignment="center"]]
155.1	190
	191	(((
80.1	192	== Edition de la source de données ==
24.2	193
228.5	194	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	195
78.7	196	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	197
84.4	198	=== Prévisualisation des données de la source ===
1.1	199
259.2	200	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	201
216.2	202	[[image:1636112035431-638.png]]
55.2	203
83.3	204	Des options existent pour vous permettre de former au mieux votre source.
55.2	205
259.2	206	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	207
164.1	208	==== Transformation de colonnes ====
	209
175.1	210	(% class="box warningmessage" %)
	211	(((
259.2	212	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	213	)))
	214
216.2	215	(% class="wikigeneratedid" %)
219.2	216	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	217
253.2	218	[[image:1650458909866-641.png]]
164.1	219
218.1	220	(% class="wikigeneratedid" id="HFonctions" %)
219.2	221	L'on pourra ainsi appliquer les fonctions pré-établies dans le produit ainsi que des formats.
218.1	222
84.4	223	=== Configuration du modèle de données ===
1.1	224
76.5	225	{{info}}
259.2	226	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	227	{{/info}}
	228
236.1	229	{{info}}
	230	Une dimension est composée d’un ensemble de membres organisés selon une ou plusieurs hiérarchies.
	231	{{/info}}
	232
	233	{{info}}
	234	Une mesure est une quantité à représenter qui peut être agrégée avec une formule d’agrégation.
	235	{{/info}}
	236
259.2	237	L'onglet Configurer le modèle de données vous permet de configurer les dimensions et mesures détectées par DigDash.
1.1	238
140.1	239	L'on pourra ainsi modifier leur type, leur nom d'affichage et même créer des mesures calculées.
55.3	240
237.2	241	[[image:1650455916483-310.png]]
	242
	243
51.3	244	)))
1.1	245
59.2	246	(((
229.6	247	==== Paramètres des colonnes ====
	248
237.2	249	Le panneau latéral vous permet de connaître la définition de chaque colonne sélectionnée.
229.6	250
	251
	252	===== Paramètres d'une dimension =====
	253
230.2	254	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	255
242.2	256	[[image:1650457399549-926.png]]
229.6	257
	258	===== Paramètres d'une mesure =====
	259
230.2	260	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	261
242.2	262	[[image:1650457181559-809.png]][[image:1650457224390-702.png]]
229.6	263
242.2	264
229.3	265	==== Ajout de mesures calculées ====
66.7	266
252.1	267	Le bouton [[image:1650458653912-616.png]] vous permet de rajouter des mesures calculées à votre modèle de données.
76.2	268
70.7	269	{{info}}
75.2	270	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	271	{{/info}}
	272
76.2	273	(% class="wikigeneratedid" %)
140.1	274	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	275
254.2	276	(% class="box warningmessage" %)
	277	(((
	278	Le nom d'une mesure calculée ou mesure dérivée ne peut plus être éditée après sa création.
	279	)))
	280
80.1	281	===== Fonctions générales =====
73.2	282
250.2	283	[[image:1650458342219-420.png]]
73.2	284
140.1	285	Les fonctions générales proposent des formules basiques telles que le pourcentage de progression.
76.2	286
80.1	287	===== Transformateurs =====
73.2	288
250.2	289	[[image:1650458529775-292.png]]
73.2	290
77.4	291	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	292
80.1	293	===== Formule =====
66.6	294	)))
	295
140.1	296	: La sélection de "Formule..." fera apparaître la boîte de dialogue suivante :
70.1	297	:
214.2	298	: [[image:1636110973085-813.png\|\|queryString="width=282&height=321" height="321" width="282"]]
73.2	299	:
140.1	300	: 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	301	: Vous êtes invité(e) à saisir un nom et la formule.
66.6	302
169.1	303	== (% style="color:inherit; font-family:inherit; font-size:29px" %)Construction du tableau de bord(%%) ==
66.2	304	)))
59.2	305
77.5	306	: Vous avez la possibilité de gérer plusieurs éléments pour la visualisation de votre tableau de bord.
177.1	307	:
66.2	308
	309	(((
176.1	310	=== (% style="color:inherit; font-family:inherit; font-size:23px" %)Nom de votre tableau de bord(%%) ===
	311	)))
84.2	312
176.1	313	(((
84.2	314	(% class="wikigeneratedid" %)
212.1	315	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	316
	317	{{info}}
140.1	318	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	319	{{/info}}
	320
169.1	321	=== Disposition des graphiques ===
66.2	322
141.1	323	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	324
	325	[[image:1602856226445-298.png]]
	326
140.1	327	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	328
141.1	329	Chaque modèle proposé supporte un nombre de graphiques limité (affiché en survolant le modèle avec la souris).
59.2	330
	331	[[image:1602857685204-489.png]]
	332
	333
84.2	334	(% class="wikigeneratedid" id="HOrdredesgraphiques" %)
175.1	335	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	336
	337	[[image:1602857767860-961.png]]
	338
228.6	339	=== Validation et construction du tableau de bord ===
66.2	340
66.5	341	(% id="cke_bm_291S" style="display:none" %) (%%)Cliquer sur le bouton [[image:1602855958729-795.png]] pour finaliser la construction de votre tableau de bord.
	342
	343	Patientez quelques instants.
	344
141.1	345	L'assistant se ferme et vous découvrez votre tableau de bord dans l'Editeur de tableau de bord.
66.5	346
175.1	347	Si vous le souhaitez, vous pouvez continuer à compléter votre tableau de bord (ajout de filtres, dimensions,...).
61.1	348	)))
1.1	349
262.1	350	=== Édition du tableau de bord a posteriori ===
97.2	351
259.2	352	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	353
262.1	354	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	355
269.1	356	[[image:Edition_graphique.png\|\|alt="Edition_graphique" data-xwiki-image-style-alignment="center"]]
225.2	357
166.1	358	= Edition du modèle de données a posteriori =
97.2	359
175.1	360	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	361
250.2	362	[[image:1650458139080-561.png]]
99.2	363
	364
98.2	365	Pour accéder à l'interface d'édition, deux possibilités :
97.2	366
262.1	367	* 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	368	[[image:Edit_data_model_ACTB_FR.png]]
98.2	369
	370
	371
272.1	372	* via le bouton Editer lors de la création de nouveaux graphiques à partir de ce modèle de données.
	373	[[image:Edit_data_model_from_newgraph.png]]
98.2	374
272.1	375

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

Sommaire