Código fuente wiki de Requête en langage naturel

Última modificación por Aurelie Bertrand el 2025/02/07 10:08
Mostrar los últimos autores
1 {{ddtoc/}}
2
3 ----
4
5 (% class="wikigeneratedid" %)
6 Les requêtes en langage naturel permettent d'explorer les données en transformant une demande en visualisation graphique. Ainsi, l'utilisateur peut interagir avec les données sans connaissances particulières.
7
8 = Prérequis =
9
10 Des cubes dans vos portefeuilles récemment rafraîchis.
11
12 = Création de graphiques via des requêtes en langage naturel =
13
14 Les requêtes en langage naturel peuvent s'effectuer depuis l'éditeur de tableaux de bord ou directement dans le tableau de bord. Elles se basent sur les modèles de données du rôle couramment sélectionné.
15
16 == Depuis l’éditeur de tableaux de bord ==
17
18 (% class="wikigeneratedid" %)
19 Dans l'éditeur de tableaux de bord, il est possible d'ajouter au tableau de bord un graphique créé via une requête en langage naturel.
20
21 1. Ouvrez l'Editeur de tableaux de bord et sélectionnez la page de tableau sur laquelle vous souhaitez ajouter un graphique.
22 1. Dans le panneau latéral gauche, cliquez sur **Création de nouveaux graphiques **et cochez l'option **Langage naturel**.
23 [[image:Natural_language_panel_FR.png]]
24 1. Saisissez alors votre requête dans la barre de recherche.
25 Consultez le paragraphe [[Formulation d'une requête en langage naturel>>doc:||anchor="Formulation_requête"]] pour plus de détails.
26 ➡ Une liste de graphiques est proposée, classée par pertinence.
27 Consultez le paragraphe [[Résultats d'une requête>>doc:||anchor="Résultats_requête"]] pour plus de détails.
28 [[image:Natural_language_request_example_FR.png||alt="Exemple requête"]]
29 1. Cliquez sur le graphique de votre choix.
30 ➡ La boite **Création d'un nouveau graphique **s'affiche avec un aperçu du graphique.
31 [[image:1738661254101-163.png||alt="Création nouveau graphique"]]
32 1. Renommez le graphique si besoin et cliquez sur **Ajouter le graphique**.
33 ➡ Le nouveau graphique est ajouté au tableau de bord sélectionné et à la liste des **{{glossaryReference glossaryId="Glossary" entryId="Flux"}}Flux{{/glossaryReference}} d'informations (Graphiques existants)**.
34
35 == Depuis le tableau de bord ==
36
37 Il est également possible de rajouter dans votre tableau de bord final un élément de contenu additionnel **// Requête sur les données//** pour pouvoir créer de nouveaux graphiques directement dans le tableau de bord.
38
39 1. Ouvrez l'Editeur de tableaux de bord et sélectionnez la page de tableau de bord sur laquelle vous souhaitez ajouter la boite de requête.
40 1. Dans le panneau latéral gauche, cliquez sur **Contenu additionnel** et afficher la liste des **Eléments.**
41 1. Glissez déposez l'élément **Requête sur les données** sur la page de tableau de bord.
42
43 (% class="box infomessage" %)
44 (((
45 💡 Il se peut que, lors de vos requêtes, vous filtriez sur les membres d’une dimension ou d’une mesure. Il est donc conseillé d'ajouter l’élément **//Éléments filtrés//** sur le tableau de bord pour les supprimer pour les prochaines requêtes.
46 )))
47
48 (% start="4" %)
49 1. Enregistrez et afficher le tableau de bord.
50 ➡ Vous pouvez saisir une requête dans la barre de recherche de la boite **Requête sur les données**. Consultez le paragraphe [[Formulation d'une requête en langage naturel>>doc:||anchor="Formulation_requête"]] pour plus de détails.
51 ➡ Les résultats sont affichés avec un score indiquant leur pertinence. Consultez le paragraphe [[Résultats d'une requête>>doc:||anchor="Résultats_requête"]] pour plus de détails.
52 ​​​​​​​​​​​​​​[[image:1738662183414-447.png]]
53 1. Cliquez sur le graphique souhaité pour obtenir un aperçu.
54 ​​​​​​​[[image:1738662401588-131.png||alt="Aperçu du flux"]]
55 1. Vous pouvez l'enregistrer en cliquant sur le bouton [[image:1705681243815-758.png||queryString="width=21&height=18" height="18" width="21"]] puis **Sauvegarder**.
56 Renommez-le si besoin et cliquez sur **OK.**
57 ➡ Il est ajouté au portefeuille de flux.
58
59 = Formulation d’une requête en langage naturel{{id name="Formulation_requête"/}} =
60
61 Les requêtes en langage naturel reposent principalement sur des mots-clés pour proposer les graphiques les plus pertinents ainsi que sur les noms des colonnes des modèles de données.
62
63 Une requête sera ainsi basiquement formée de noms de mesures de votre modèle et/ou de noms de dimensions, suivi ou pas de types de graphiques et/ou d’opérations de tri.
64
65 Nous verrons dans la suite de ce document à quel point le choix des termes d’une requête est important.
66
67 == Type de graphique ==
68
69 Pour une requête donnée, il vous sera proposé une liste de résultats de différents graphiques, dépendants du contenu de la requête.
70
71 Il est toutefois possible d’exiger un type de graphique en particulier, dans la mesure où cela reste cohérent (la requête "Coût de communication en courbe" n’est pas cohérente).
72
73 Le nombre de membres dans les résultats d’une requête a également une incidence. En effet, dans le cas d’une requête cohérente mais avec un nombre de résultats trop important, il vous sera proposé un graphique adapté au nombre de résultats à afficher.
74
75 Voici les mots-clés à utiliser dans la requête pour le choix des graphiques :
76
77 |**Nom des graphiques**|**Mots-clés**
78 |Diagramme en secteurs|« secteur »
79 « camembert »
80 « ratio »
81 |Jauge|« jauge »
82 |Barre de progression|« barre de progression »
83 |Barres d’énergie|(((
84 « énergie »
85
86 « consommation »
87 )))
88 |Indicateur flèche|« flèche »
89 |Diagramme en colonnes|(((
90 « colonne »
91
92 « histogramme »
93 )))
94 |Diagramme en barres|« barre »
95 |Carte|« carte »
96 |Diagramme scatter|(((
97 « dispersion »
98
99 « corrélation »
100 )))
101 |Diagramme à bulles|« bulle »
102 |Diagramme en ligne|(((
103 « ligne »
104
105 « courbe »
106 )))
107 |Diagramme de surfaces|(((
108 « zone »
109
110 « surface »
111 )))
112 |Diagramme radar|« radar »
113 |Tableau|(((
114 « tableau »
115
116 « table »
117 )))
118 |Indicateur|« indicateur »
119 |{{glossaryReference glossaryId="Glossary" entryId="Tableau croisé"}}Tableau croisé{{/glossaryReference}}|« tableau croisé »
120 |Texte|« texte »
121
122 == Tri ==
123
124 Il vous est possible d’effectuer des opérations de tri dans vos requêtes via les mots-clés suivants :
125
126 |**Tri**|**Mots-clés**|**Exemples de requêtes**
127 |Croissant|(((
128 « trie » (croissant)
129
130 « triée » (croissant)
131
132 « ordonne » (croissant)
133
134 « ordonnée » (croissant)
135
136 « tri » (croissant)
137
138 « ordre » (croissant)
139
140 « croissant »
141 )))|(((
142 « Coûts par région en France en 2006 triés par coût en tableau »
143
144 « Coûts par région en France en 2006 triés en tableau »
145
146 « Coûts par région en France en 2006 croissants en tableau »
147
148 « Coûts par région en France en 2006 triés croissants en tableau »
149 )))
150 |Décroissant|(((
151 « trie » (décroissant)
152
153 « triée » (décroissant)
154
155 « ordonne » (décroissant)
156
157 « ordonnée » (décroissant)
158
159 « tri » (décroissant)
160
161 « ordre » (décroissant)
162
163 « décroissant »
164 )))|(((
165 « Coûts par région en France en 2006 triés décroissant par coût en tableau »
166
167 « Coûts par région en France en 2006 décroissants en tableau »
168
169 « Coûts par région en 2006 triés en décroissant en tableau »
170 )))
171
172 == Tendance d’une mesure ==
173
174 Une mesure a une tendance. Elle peut être stable (tendance par défaut), croissante ou décroissante :
175
176 |**Tendance**|**Signification**
177 |Stable|Tendance par défaut : Le plus grand est le meilleur
178 |Croissante|(((
179 Le plus grand est le meilleur
180
181 //Exemple : pour une marge//
182 )))
183 |Décroissante|(((
184 Le plus petit est le meilleur
185
186 //Exemple : pour un coût//
187 )))
188
189 Vous pouvez éditer la tendance d’une mesure via le Studio Digdash, dans la configuration avancée d’une source de données, dans les propriétés de la mesure. Consultez le paragraphe [[Modifier la tendance de la mesure>>||anchor="Tendance_mesure"]] pour plus de détails.
190
191 (% class="wikigeneratedid" id="HImpactdelatendancesurletri" %)
192 **Impact de la tendance sur le tri**
193
194 La tendance a un impact sur le tri. En effet, si le type de tri (croissant ou décroissant) n’est pas explicitement mentionné, celui-ci se basera sur la tendance de la mesure sur laquelle le tri s’effectue. On obtiendra par conséquent un tri décroissant sur une mesure de tendance stable ou croissante et un tri croissant dans le cas d’une mesure de tendance décroissante.
195
196 |**Tendance**|**Exemples de requêtes**|**Tri obtenu**
197 |Stable|(((
198 « CA par région trié »
199
200 CA est une mesure à tendance stable
201 )))|//Le tri de la mesure CA sur la dimension région sera décroissant//
202 |Croissante|(((
203 « Marge par région triée »
204
205 Marge est une mesure à tendance croissante
206 )))|//Le tri de la mesure Marge sur la dimension région sera décroissant//
207 |Décroissante|(((
208 « Coût par région trié »
209
210 Coût est une mesure à tendance décroissante
211 )))|//Le tri de la mesure Coût sur la dimension région sera croissant//
212
213 == Le(s) pire(s) / le(s) meilleur(s) ==
214
215 Il est possible de connaître les X meilleurs/pires membres des résultats de votre requête en utilisant les mots-clés suivants :
216
217 |**Cas**|**Mots-clés**|**Exemple**
218 |Les X meilleurs|(((
219 « Top »
220
221 « meilleur »
222
223 « plus grand »
224
225 « plus important »
226 )))|(((
227 Le meilleur coût en France
228
229 Les 5 meilleures marges en 2016
230
231 Les 2 plus grands CA en Europe
232
233 Top 3 des coûts en France en 2016
234 )))
235 |Les X pires|(((
236 « Pire »
237
238 « moins bon »
239
240 « plus mauvais »
241
242 « plus petit »
243 )))|(((
244 Le pire coût en France
245
246 Les 5 pires marges en 2016
247
248 Les 2 plus mauvais CA en Europe
249 )))
250
251 == Méthode d’agrégation ==
252
253 Vous avez la possibilité de définir une fonction d’agrégation pour les mesures de votre requête en spécifiant les mots-clés suivants :
254
255 |**Agrégation**|**Mots-clés**|**Exemples de requêtes**
256 |Somme|« somme »|« Somme du coût de communication »
257 |Moyenne|« moyenne »|« Moyenne du coût de communication »
258 |Minimum|« min »|« Min du coût de communication »
259 |Maximum|« max »|« Max du coût de communication »
260
261 == Objectif ==
262
263 Il est possible d’appliquer des objectifs sur des mesures en mentionnant dans la requête le mot-clé suivant :
264
265 |**Mots-clés**
266 |« objectif »
267
268 Vous pouvez également mentionner directement le nom des objectifs que vous voulez appliquer.
269
270 **Exemple**
271
272 Soit un modèle de données avec les colonnes suivantes
273
274 (((
275 |**Dimensions**|**Mesures**
276 |Date|Qualité de communication
277 |Type de ligne|Coût de communication (avec objectif « Obj »)
278 )))
279
280 * Exemple 1 : « Coût de communication en jauge avec objectif »
281 ➡ Tous les objectifs de toutes les mesures sont appliqués (un seul objectif par mesure).
282
283 * Exemple 2 : « Coût de communication en jauge avec Obj »
284 ➡ L’objectif « Obj » est appliqué sur la mesure associée « Coût de communication ».
285
286 == (% style="color:inherit; font-family:inherit; font-size:26px" %)Utilisation des synonymes (%%) ==
287
288 {{id name="Synonymes"/}}La recherche en langage naturel prend en charge les synonymes des termes de vos requêtes.
289
290 === Création des dictionnaires des synonymes ===
291
292 Pour utiliser des termes synonymes dans vos requêtes, vous devez dans un premier temps importer un dictionnaire des synonymes dans Digdash.
293
294 Consultez la page [[Dictionnaire des synonymes>>doc:Digdash.user_guide.studio.managers.translation.synonyms_dictionary.WebHome]] pour savoir comment importer un dictionnaire des synonymes dans Digdash.
295
296 === Activation des dictionnaires des synonymes ===
297
298 Vous devez ensuite vous assurer que l’utilisation des dictionnaires des synonymes est bien activée pour la fonctionnalité **Requête en langage naturel** dans la configuration serveur.
299 Depuis le menu d'accueil, allez dans **Configuration -> Paramètres serveur -> Dictionnaires & Langues -> Dictionnaire des synonymes** et cochez la case **Utiliser les dictionnaires des synonymes pour les requêtes en langage naturel**.
300
301 [[image:Activate_synonym_dictionary_FR.png]]
302
303
304 === Exemple d’utilisation ===
305
306 Soit un modèle de données avec les colonnes suivantes
307
308 (((
309 |**Dimensions**|**Mesures**
310 |Date|Qualité de communication
311 |Type de ligne|Coût de communication
312 )))
313
314 Dans ce cas :
315 La requête "//Prix de communication par genre de ligne"// est équivalente à la requête "//Coût de communication par type de ligne//"
316 (« prix » est un synonyme de « coût » et « genre » est synonyme de « type »).
317
318 (% class="box warningmessage" %)
319 (((
320 ❗Ceci n’est valable que si votre dictionnaire des synonymes contient ces synonymes.
321 )))
322
323 = Résultats d’une requête{{id name="Résultats_requête"/}} =
324
325 [[image:Requête_direct_TDB2.png]]
326
327 Les résultats d’une requête vous proposent une liste de graphiques classés par pertinence avec un score associé sur 5. Plus ce score est grand, plus le graphe associé est considéré comme pertinent. Le nom du modèle de données associé est mentionné ainsi qu’une description du graphique.
328
329 * **Termes de la requête**
330
331 Le résultat d’une requête sera mieux noté si la requête contient dans ses termes les noms exacts des colonnes de vos modèles de données.
332
333 Une requête sera donc considérée comme moins bonne si elle contient dans ses termes des noms partiels de vos colonnes, ou alors des synonymes des noms des colonnes de votre modèle de données.
334
335 |(% colspan="3" %)**Exemple**
336 |(% colspan="3" %)Soit un modèle de données avec les colonnes suivantes(((
337 |**Dimensions**|**Mesures**
338 |Date|Qualité de communication
339 |Type de ligne|Coût de communication
340 )))
341 |(((
342 **Requête 1 :**
343
344 **Avec des noms exactes**
345 )))|(((
346 **Requête 2 :**
347
348 **Avec des noms partiels**
349 )))|(((
350 **Requête 3 :**
351
352 **Avec des synonymes**
353 )))
354 |« Coût de communication par type de ligne »|« Coût par type »|« Prix par genre de ligne »
355 |Avec seulement des termes exacts dans cette requête, les résultats peuvent être bien notés.|Avec des termes partiaux dans cette requête, les résultats peuvent être moins bien notés.|(((
356 « prix » est synonyme de « coût », « genre de ligne » est synonyme de « type de ligne ».
357
358 Cette requête est différente de la requête d’origine, les notes seront basses.
359 )))
360 |Score* : 5/5|Score* : 3/5|Score* : 2/5
361 |(% colspan="3" %)* les scores présentés n’ont qu’un but démonstratif dans ce document
362
363 * **Type de graphique proposé**
364
365 La liste des résultats d’une requête propose des graphiques plus ou moins pertinents quant à ce qui est attendu. Compte tenu de la nature des termes de la requête, certains graphiques seront moins bien classés que certains, d’où un score moins élevé pour ces derniers.