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

# Utiliser les tables et datasets

> Choisir une source structurée, comprendre ses colonnes et l’exploiter dans Alyzai.

> [!NOTE]
>
> Concept · 8 min

Les documents conviennent au texte à lire et à citer. Les **tables** et **datasets** conviennent aux données structurées : une ligne représente un élément, et chaque colonne porte une propriété stable.

Une table est plus qu’un affichage. Ses colonnes servent de contrat commun aux formulaires,
widgets, rapports, agents et workflows qui la réutilisent. Une modification de structure doit donc
être traitée comme un changement partagé.

## Quand utiliser une table

* filtrer, trier ou agréger des valeurs ;
* alimenter un widget ou un rapport ;
* collecter des réponses de formulaire dans des colonnes connues ;
* permettre à un agent de retrouver un enregistrement précis ;
* traiter un grand nombre de lignes dans une automatisation.

## Concevoir une structure fiable

| Élément | Bonne pratique |
| - | - |
| Identifiant | une valeur unique et stable par ligne |
| Nom de colonne | court, explicite et sans ambiguïté |
| Type | cohérent pour toutes les valeurs de la colonne |
| Valeur vide | distinguée d’un zéro, de `false` ou d’un texte vide |
| Date et heure | stockées dans un format et un fuseau compris par l’équipe |
| Liste de valeurs | gouvernée afin d’éviter les variantes orthographiques |
| Relation | fondée sur un identifiant stable plutôt que sur un libellé variable |
| Accès | limité aux personnes, agents et processus qui en ont besoin |

> [!TIP]
>
> **Exemple métier.** Une table « Fournisseurs » illustre bien les identifiants, catégories et
> statuts, mais le même modèle convient à des clients, équipements, dossiers ou demandes.

## Table ou document ?

Utilisez une table si la question porte sur des lignes, des colonnes, un filtre ou un calcul. Utilisez un document si la réponse doit être trouvée dans un passage rédigé. Lorsque les deux sont utiles, gardez les faits structurés dans la table et les explications dans un document lié.

## Cycle d’une donnée structurée

```mermaid theme={null}
flowchart LR
	A["Création ou import"] --> B["Contrôle des types"]
	B --> C["Utilisation par formulaire ou workflow"]
	C --> D["Widget, rapport ou agent"]
	D --> E["Correction dans la source"]
	E --> B
```

Avant de brancher plusieurs modules, ajoutez quelques lignes représentatives et contrôlez les
filtres, calculs et valeurs vides. Pour un import volumineux, vérifiez un échantillon avant de
considérer l’opération comme terminée.

## Limites

* Une colonne qui mélange plusieurs types devient difficile à filtrer et à calculer.
* Modifier un nom ou un type peut affecter les formulaires, widgets, rapports ou workflows qui le réutilisent.
* Un accès à la collection ne remplace pas toujours les permissions de la source externe.
* Un export est un instantané et ne reste pas synchronisé avec la table.
* Un total correct ne prouve pas que chaque ligne est valide ; contrôlez aussi les doublons et les
  valeurs extrêmes.
* Une écriture par agent ou workflow doit cibler des colonnes explicites et rester soumise aux
  droits configurés.

<Snippet file="snippets/human-validation.mdx" />

## Questions fréquentes

> [accordion] Comment choisir l’identifiant d’une ligne ?
>
> Utilisez une valeur stable, unique et indépendante d’un libellé susceptible de changer. Si
> la source fournit déjà un identifiant fiable, conservez-le.

> [accordion] Peut-on renommer une colonne utilisée ailleurs ?
>
> Oui, mais vérifiez d’abord les formulaires, widgets, rapports, agents et workflows qui la
> référencent, puis retestez-les après le changement.

> [accordion] Pourquoi un calcul ignore-t-il certaines lignes ?
>
> Contrôlez les filtres, les valeurs vides et le type réel de la colonne. Un nombre stocké
> comme texte peut être exclu d’un agrégat.

> [accordion] Quand utiliser un dataset plutôt qu’un document ?
>
> Lorsque le besoin principal porte sur un grand nombre de lignes, des filtres, des calculs ou
> des traitements structurés plutôt que sur la lecture d’un texte.

## Étapes suivantes

> [card] [Créer un formulaire](https://docs.alyzai.com/fr/formulaires/creer-un-formulaire.md)
>
> Collecter des lignes avec des champs contrôlés.

> [card] [Choisir les sources d’un espace](https://docs.alyzai.com/fr/espaces/sources-et-moteur.md)
>
> Brancher une donnée structurée sur un widget.


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