Code source wiki de Requête en langage naturel

Modifié par Aurelie Bertrand le 2026/07/23 11:17
Afficher les derniers auteurs
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 récemment rafraîchis.
11 * L'indexation pour la recherche texte activée dans les modèles de données utilisés. Consultez le paragraphe [[Paramétrer l'indexation>>doc:Digdash.user_guide.studio.Create_datamodel.configure_data_model.Cube_advanced_parameters.WebHome||anchor="indexation"]] pour plus de détails.
12
13 Vous pouvez également configurer des synonymes afin d’améliorer la pertinence et l’efficacité des requêtes. Consultez la page [[Utilisation des synonymes>>doc:Digdash.user_guide.studio.managers.translation.synonyms_use.WebHome]] pour plus de détails.
14
15 = Création de graphiques via des requêtes en langage naturel =
16
17 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é.
18
19 == Depuis l’éditeur de tableaux de bord ==
20
21 (% class="wikigeneratedid" %)
22 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.
23
24 1. Ouvrez l'Editeur de tableaux de bord et sélectionnez la page de tableau sur laquelle vous souhaitez ajouter un graphique.
25 1. Dans le panneau latéral gauche, cliquez sur **Création de nouveaux graphiques **et cochez l'option **Langage naturel**.
26 [[image:Natural_language_panel_FR.png]]
27 1. Saisissez alors votre requête dans la barre de recherche.
28 Consultez le paragraphe [[Formulation d'une requête en langage naturel>>doc:||anchor="Formulation_requête"]] pour plus de détails.
29 ➡ Une liste de graphiques est proposée, classée par pertinence.
30 Consultez le paragraphe [[Résultats d'une requête>>doc:||anchor="Résultats_requête"]] pour plus de détails.
31 [[image:Natural_language_request_example_FR.png||alt="Exemple requête"]]
32 1. Cliquez sur le graphique de votre choix.
33 ➡ La boite **Création d'un nouveau graphique **s'affiche avec un aperçu du graphique.
34 [[image:1738661254101-163.png||alt="Création nouveau graphique"]]
35 1. Renommez le graphique si besoin et cliquez sur **Ajouter le graphique**.
36 ➡ 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)**.
37
38 == Depuis le tableau de bord ==
39
40 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.
41
42 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.
43 1. Dans le panneau latéral gauche, cliquez sur **Contenu additionnel** et afficher la liste des **Eléments.**
44 1. Glissez déposez l'élément **Requête sur les données** sur la page de tableau de bord.
45
46 (% class="box infomessage" %)
47 (((
48 💡 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.
49 )))
50
51 (% start="4" %)
52 1. Enregistrez et afficher le tableau de bord.
53 ➡ 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.
54 ➡ 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.
55 [[image:1738662183414-447.png]]
56 1. Cliquez sur le graphique souhaité pour obtenir un aperçu.
57 [[image:1738662401588-131.png||alt="Aperçu du flux"]]
58 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**.
59 Renommez-le si besoin et cliquez sur **OK.**
60 ➡ Il est ajouté au rôle.
61
62 = Formulation d’une requête en langage naturel{{id name="Formulation_requête"/}} =
63
64 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.
65
66 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.
67
68 Nous verrons dans la suite de ce document à quel point le choix des termes d’une requête est important.
69
70 == Type de graphique ==
71
72 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.
73
74 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).
75
76 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.
77
78 Voici les mots-clés à utiliser dans la requête pour le choix des graphiques :
79
80 |**Nom des graphiques**|**Mots-clés**
81 |Diagramme en secteurs|« secteur »
82 « camembert »
83 « ratio »
84 |Jauge|« jauge »
85 |Barre de progression|« barre de progression »
86 |Barres d’énergie|(((
87 « énergie »
88
89 « consommation »
90 )))
91 |Indicateur flèche|« flèche »
92 |Diagramme en colonnes|(((
93 « colonne »
94
95 « histogramme »
96 )))
97 |Diagramme en barres|« barre »
98 |Carte|« carte »
99 |Diagramme scatter|(((
100 « dispersion »
101
102 « corrélation »
103 )))
104 |Diagramme à bulles|« bulle »
105 |Diagramme en ligne|(((
106 « ligne »
107
108 « courbe »
109 )))
110 |Diagramme de surfaces|(((
111 « zone »
112
113 « surface »
114 )))
115 |Diagramme radar|« radar »
116 |Tableau|(((
117 « tableau »
118
119 « table »
120 )))
121 |Indicateur|« indicateur »
122 |{{glossaryReference glossaryId="Glossary" entryId="Tableau croisé"}}Tableau croisé{{/glossaryReference}}|« tableau croisé »
123 |Texte|« texte »
124
125 == Tri ==
126
127 Il vous est possible d’effectuer des opérations de tri dans vos requêtes via les mots-clés suivants :
128
129 |**Tri**|**Mots-clés**|**Exemples de requêtes**
130 |Croissant|(((
131 « trie » (croissant)
132
133 « triée » (croissant)
134
135 « ordonne » (croissant)
136
137 « ordonnée » (croissant)
138
139 « tri » (croissant)
140
141 « ordre » (croissant)
142
143 « croissant »
144 )))|(((
145 « Coûts par région en France en 2006 triés par coût en tableau »
146
147 « Coûts par région en France en 2006 triés en tableau »
148
149 « Coûts par région en France en 2006 croissants en tableau »
150
151 « Coûts par région en France en 2006 triés croissants en tableau »
152 )))
153 |Décroissant|(((
154 « trie » (décroissant)
155
156 « triée » (décroissant)
157
158 « ordonne » (décroissant)
159
160 « ordonnée » (décroissant)
161
162 « tri » (décroissant)
163
164 « ordre » (décroissant)
165
166 « décroissant »
167 )))|(((
168 « Coûts par région en France en 2006 triés décroissant par coût en tableau »
169
170 « Coûts par région en France en 2006 décroissants en tableau »
171
172 « Coûts par région en 2006 triés en décroissant en tableau »
173 )))
174
175 == Tendance d’une mesure ==
176
177 Une mesure a une tendance. Elle peut être stable (tendance par défaut), croissante ou décroissante :
178
179 |**Tendance**|**Signification**
180 |Stable|Tendance par défaut : Le plus grand est le meilleur
181 |Croissante|(((
182 Le plus grand est le meilleur
183
184 //Exemple : pour une marge//
185 )))
186 |Décroissante|(((
187 Le plus petit est le meilleur
188
189 //Exemple : pour un coût//
190 )))
191
192 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.
193
194 (% class="wikigeneratedid" id="HImpactdelatendancesurletri" %)
195 **Impact de la tendance sur le tri**
196
197 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.
198
199 |**Tendance**|**Exemples de requêtes**|**Tri obtenu**
200 |Stable|(((
201 « CA par région trié »
202
203 CA est une mesure à tendance stable
204 )))|//Le tri de la mesure CA sur la dimension région sera décroissant//
205 |Croissante|(((
206 « Marge par région triée »
207
208 Marge est une mesure à tendance croissante
209 )))|//Le tri de la mesure Marge sur la dimension région sera décroissant//
210 |Décroissante|(((
211 « Coût par région trié »
212
213 Coût est une mesure à tendance décroissante
214 )))|//Le tri de la mesure Coût sur la dimension région sera croissant//
215
216 == Le(s) pire(s) / le(s) meilleur(s) ==
217
218 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 :
219
220 |**Cas**|**Mots-clés**|**Exemple**
221 |Les X meilleurs|(((
222 « Top »
223
224 « meilleur »
225
226 « plus grand »
227
228 « plus important »
229 )))|(((
230 Le meilleur coût en France
231
232 Les 5 meilleures marges en 2016
233
234 Les 2 plus grands CA en Europe
235
236 Top 3 des coûts en France en 2016
237 )))
238 |Les X pires|(((
239 « Pire »
240
241 « moins bon »
242
243 « plus mauvais »
244
245 « plus petit »
246 )))|(((
247 Le pire coût en France
248
249 Les 5 pires marges en 2016
250
251 Les 2 plus mauvais CA en Europe
252 )))
253
254 == Méthode d’agrégation ==
255
256 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 :
257
258 |**Agrégation**|**Mots-clés**|**Exemples de requêtes**
259 |Somme|« somme »|« Somme du coût de communication »
260 |Moyenne|« moyenne »|« Moyenne du coût de communication »
261 |Minimum|« min »|« Min du coût de communication »
262 |Maximum|« max »|« Max du coût de communication »
263
264 == Objectif ==
265
266 Il est possible d’appliquer des objectifs sur des mesures en mentionnant dans la requête le mot-clé suivant :
267
268 |**Mots-clés**
269 |« objectif »
270
271 Vous pouvez également mentionner directement le nom des objectifs que vous voulez appliquer.
272
273 **Exemple**
274
275 Soit un modèle de données avec les colonnes suivantes
276
277 (((
278 |**Dimensions**|**Mesures**
279 |Date|Qualité de communication
280 |Type de ligne|Coût de communication (avec objectif « Obj »)
281 )))
282
283 * Exemple 1 : « Coût de communication en jauge avec objectif »
284 ➡ Tous les objectifs de toutes les mesures sont appliqués (un seul objectif par mesure).
285
286 * Exemple 2 : « Coût de communication en jauge avec Obj »
287 ➡ L’objectif « Obj » est appliqué sur la mesure associée « Coût de communication ».
288
289 == (% style="color:inherit; font-family:inherit; font-size:26px" %)Utilisation des synonymes (%%) ==
290
291 {{id name="Synonymes"/}}La recherche en langage naturel prend en charge les synonymes des termes de vos requêtes.
292
293 Vous pouvez renseigner des synonymes ou en importer depuis un dictionnaire. Consultez la page [[Utilisation des synonymes>>doc:Digdash.user_guide.studio.managers.translation.synonyms_use.WebHome]] pour plus de détails.
294
295 === Activation des dictionnaires des synonymes ===
296
297 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.
298 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**.
299
300 [[image:Activate_synonym_dictionary_FR.png]]
301
302
303 === Exemple d’utilisation ===
304
305 Soit un modèle de données avec les colonnes suivantes
306
307 (((
308 |**Dimensions**|**Mesures**
309 |Date|Qualité de communication
310 |Type de ligne|Coût de communication
311 )))
312
313 Dans ce cas :
314 La requête "//Prix de communication par genre de ligne"// est équivalente à la requête "//Coût de communication par type de ligne//"
315 (« prix » est un synonyme de « coût » et « genre » est synonyme de « type »).
316
317 (% class="box warningmessage" %)
318 (((
319 ❗Ceci n’est valable que si votre dictionnaire des synonymes contient ces synonymes.
320 )))
321
322 = Résultats d’une requête{{id name="Résultats_requête"/}} =
323
324 [[image:Requête_direct_TDB2.png]]
325
326 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.
327
328 * **Termes de la requête**
329
330 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.
331
332 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.
333
334 |(% colspan="3" %)**Exemple**
335 |(% colspan="3" %)Soit un modèle de données avec les colonnes suivantes(((
336 |**Dimensions**|**Mesures**
337 |Date|Qualité de communication
338 |Type de ligne|Coût de communication
339 )))
340 |(((
341 **Requête 1 :**
342
343 **Avec des noms exacts**
344 )))|(((
345 **Requête 2 :**
346
347 **Avec des noms partiels**
348 )))|(((
349 **Requête 3 :**
350
351 **Avec des synonymes**
352 )))
353 |« Coût de communication par type de ligne »|« Coût par type »|« Prix par genre de ligne »
354 |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.|(((
355 « prix » est synonyme de « coût », « genre de ligne » est synonyme de « type de ligne ».
356
357 Cette requête est différente de la requête d’origine, les notes seront basses.
358 )))
359 |Score* : 5/5|Score* : 3/5|Score* : 2/5
360 |(% colspan="3" %)* les scores présentés n’ont qu’un but démonstratif dans ce document
361
362 * **Type de graphique proposé**
363
364 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.