> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alyzai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Ajouter un widget

> Indicateur, graphe ou table : l’assistant de création en cinq étapes.

> [!NOTE]
>
> Tutoriel · 10 min

> [!TIP]
>
> **Exemple métier.** Les exemples achats, qualité ou industrie illustrent le parcours. Adaptez
> les données, les rôles et le vocabulaire à votre contexte.

## Résultat attendu

Vous allez ajouter un widget à une page existante, le relier à une source, vérifier son aperçu,
puis enregistrer sa position. À la fin, le widget doit rester visible après avoir quitté le mode
composition et rechargé la page.

## Avant de commencer

* Ouvrez une page que vous êtes autorisé à modifier.
* Identifiez la source à utiliser : table, formulaire ou résultat de workflow.
* Vérifiez que cette source contient au moins une donnée exploitable et que vous pouvez la
  consulter.
* Choisissez le résultat à montrer : un chiffre, une évolution, un détail ligne à ligne ou une vue
  par carte.

<Snippet file="snippets/permissions.mdx" />

L’assistant de création relie une **source** à une **représentation**. Son aperçu permet de contrôler
le résultat avant d’ajouter le widget à la page.

<video autoPlay muted loop playsInline controls alt="Démonstration des étapes de création et de placement d’un widget" aria-label="Démonstration des étapes de création et de placement d’un widget" poster="/images/product/espaces/widget-place.png">
  <source src="https://mintcdn.com/alyzai/St7evzCbpXJOLQ-i/videos/creer-un-widget.mp4?fit=max&auto=format&n=St7evzCbpXJOLQ-i&q=85&s=d34e0d70066788bf534039756c10c844" type="video/mp4" />

  Votre navigateur ne peut pas lire la démonstration. Les cinq étapes ci-dessous décrivent le
  même parcours.
</video>

La démonstration montre les cinq étapes qui relient une source, une représentation et le placement du widget.

**1. Passez en mode édition**

Sur une page vide, cliquez directement sur **Ajouter un widget**. Sur une page qui contient
déjà des éléments, ouvrez **Composer la page**, puis choisissez **Ajouter un widget** dans le
menu. Sélectionnez l’action du même nom, et non **Importer un widget** ou **Boutons de page**.

**2. Choisissez le type de lecture**

Donnez un titre et une description, puis sélectionnez une représentation : **Indicateur**,
**Jauge**, **Barres**, **Courbe**, **Donut**, **Tableau**, **Galerie**, **Fiche** ou **Tableau
croisé**. Choisissez le type qui répond directement à la question annoncée dans le titre.

**3. Reliez la source**

Dans **Studio Data**, ouvrez l’étape **Source** et choisissez **Dataset** ou **Workflow**.
Sélectionnez ensuite la source précise. Un dataset marqué **Non déployé** reste indisponible ;
utilisez une source active et vérifiez son nombre de lignes.

**4. Configurez le calcul et la présentation**

Utilisez **Ajouter une étape** pour filtrer, calculer, agréger, trier, limiter, aplatir ou
croiser les données. Pour un indicateur, ajoutez par exemple **Agréger**, puis choisissez
**Nombre**, **Somme** ou **Moyenne** et le regroupement éventuel. Revenez dans
**Représentation** pour régler la présentation et le format de la valeur.

**5. Ajoutez puis placez le widget**

Lorsque l’aperçu correspond au résultat attendu, cliquez sur **Créer le widget**. Il apparaît
sur la page avec sa valeur calculée. Ouvrez ensuite **Composer la page** si vous devez le
déplacer ou modifier sa taille, puis quittez la composition.

![Page Parcours QA avec un indicateur affichant 4 755](https://mintcdn.com/alyzai/St7evzCbpXJOLQ-i/images/product/espaces/widget-place.png?fit=max\&auto=format\&n=St7evzCbpXJOLQ-i\&q=85\&s=adccd453186f5529ec34eefd6ae5ea46)

Le widget créé reste visible sur la page avec sa valeur calculée depuis le dataset sélectionné.

> [!TIP]
>
> **Du résumé vers le détail.** Placez quelques indicateurs en haut de page, les tendances au
> milieu et le registre détaillé en dessous. Un widget doit répondre à une question identifiable ;
> évitez d’ajouter une visualisation uniquement parce qu’elle est disponible.

## Vérification finale

1. Quittez **Composer la page** et confirmez que les poignées d’édition disparaissent.
2. Comparez le résultat avec quelques lignes de la source ou avec une valeur connue.
3. Si la page comporte des filtres, appliquez-en un et vérifiez que le widget se recalcule.
4. Rechargez la page : le widget, sa taille et sa position doivent être conservés.

## En cas de problème

| Symptôme | Contrôle recommandé |
| - | - |
| La source n’apparaît pas | Vérifiez le workspace, votre accès à la source et son type. |
| L’aperçu est vide | Retirez les filtres, contrôlez le champ choisi et confirmez que la source contient des lignes. |
| Le chiffre semble faux | Vérifiez l’agrégat, le format du champ et le périmètre appliqué. |
| Le bouton **Ajouter** reste indisponible | Revenez aux étapes précédentes : une source ou une configuration obligatoire manque. |
| Le widget disparaît après rechargement | Enregistrez la composition avant de quitter le mode édition. |

## Étapes suivantes

> [card] [Sources & moteur de calcul](https://docs.alyzai.com/fr/espaces/sources-et-moteur.md)
>
> Comprendre le trajet de la donnée jusqu’au widget.

> [card] [Filtrer et explorer](https://docs.alyzai.com/fr/espaces/filtrer-et-explorer.md)
>
> Tester le recalcul sur un sous-ensemble.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.