> ## 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.

# Sources & moteur de calcul

> Tables, workflows, formulaires : ce qui alimente vos widgets, et comment ils se recalculent.

> [!NOTE]
>
> Concept · 6 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.

Une **source** fournit les données qu’un widget lit, agrège ou organise. Le widget ne crée pas la
donnée métier : il lui applique une représentation et, selon son type, un calcul comme une somme,
une moyenne ou un nombre de lignes.

Comprendre ce lien permet de répondre à trois questions : d’où vient le résultat, quand peut-il
changer et où corriger une valeur incorrecte.

## Quand choisir chaque source

| Source | Ce qu’elle contient | À choisir lorsque… |
| - | - | - |
| **Table** | Des lignes structurées et leurs colonnes | vous devez afficher un registre ou calculer directement dessus |
| **Workflow** | Le résultat produit par une suite d’étapes | l’indicateur dépend de jointures, règles ou transformations |
| **Formulaire** | Les réponses collectées auprès des utilisateurs | la page doit suivre une campagne, une demande ou une saisie |

> [!TIP]
>
> **Exemple métier.** Une table peut contenir des commandes, un workflow calculer les écarts entre
> engagement et capacité, et un formulaire recueillir des incidents. Dans un autre contexte, le
> même modèle peut suivre des candidatures, des dossiers clients ou des contrôles internes.

## Du changement source au widget

```mermaid theme={null}
flowchart LR
	A["Source<br/>table, formulaire ou workflow"] --> B["Configuration du widget"]
	B --> C["Calcul<br/>filtre, regroupement, agrégat"]
	C --> D["Affichage<br/>indicateur, graphe, table…"]
```

Lorsque la source évolue, le widget relit son état disponible et recalcule sa représentation. Pour
un formulaire ou une table, cela intervient après l’enregistrement de la nouvelle donnée. Pour un
workflow, le résultat ne change qu’après une exécution qui produit une nouvelle sortie.

Un filtre de page ajoute un périmètre temporaire au calcul. Il ne modifie pas les lignes de la
source et ne crée pas une copie du widget.

## Retrouver l’origine d’un résultat

> [!NOTE]
>
> Conservez des noms explicites pour les sources et les champs. Si un chiffre paraît incohérent,
> contrôlez dans cet ordre : les filtres actifs, la source sélectionnée, le champ, l’agrégat puis
> la dernière exécution éventuelle du workflow.

Une galerie pilotée par une table affiche une fiche par ligne et peut ouvrir un détail au clic.
Une table, elle, privilégie la comparaison ligne à ligne. Ces deux widgets peuvent utiliser la même
source tout en répondant à des questions différentes.

## Limites et permissions

* Un membre ne voit que les sources auxquelles son rôle donne accès.
* Partager une page ne remplace pas les droits nécessaires sur ses dépendances.
* Un champ absent ou mal typé ne peut pas être corrigé dans le widget ; intervenez sur la source.
* Un widget montre l’état disponible, pas nécessairement l’heure de production de chaque donnée.
  Ajoutez une date de mise à jour dans la source lorsque cette information est importante.
* Une transformation complexe doit rester dans un workflow afin d’être testable et réutilisable,
  plutôt que d’être reconstruite dans plusieurs widgets.

## Étapes suivantes

> [card] [Filtrer et explorer](https://docs.alyzai.com/fr/espaces/filtrer-et-explorer.md)
>
> Vérifier comment un périmètre recalcule les widgets.

> [card] [Ajouter un widget](https://docs.alyzai.com/fr/espaces/ajouter-un-widget.md)
>
> Relier concrètement une source à une représentation.


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