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

# Agrégation

> Agrégez les valeurs d’Enregistrements liés, par exemple leur somme, leur nombre, leur moyenne, leur maximum et leur minimum.

Les Champs Agrégation calculent des statistiques à partir de plusieurs Enregistrements liés. Un Champ Agrégation part généralement d’un Champ **Lien** existant, sélectionne un Champ cible dans les Enregistrements liés et calcule le résultat à l’aide de la fonction choisie.

## Cas d’utilisation

| Scénario                 | Utilité                                                                                  |
| ------------------------ | ---------------------------------------------------------------------------------------- |
| Montant d’une commande   | Agréger les prix des lignes d’une commande pour calculer son total                       |
| Progression d’une tâche  | Compter les tâches liées, les tâches terminées ou calculer la moyenne des évaluations    |
| Valeur client            | Agréger les dépenses totales ou le nombre de commandes à partir des commandes du client  |
| Nettoyage des étiquettes | Combiner les étiquettes, les participants ou les canaux sources des Enregistrements liés |

## Création et configuration

<Steps>
  <Step title="Créer une relation de liaison">
    Avant de créer un Champ Agrégation, créez un Champ **Lien**.
  </Step>

  <Step title="Choisir le type de Champ">
    Cliquez sur `+` dans l’en-tête de la Table pour ajouter un Champ, puis choisissez **Agrégation**.
  </Step>

  <Step title="Choisir le Champ Lien et le Champ cible">
    Choisissez le Champ Lien qui fournit la source des données, puis le Champ cible sur lequel effectuer le calcul.
  </Step>

  <Step title="Choisir la fonction d’agrégation">
    Choisissez une fonction selon le type du Champ cible, comme la somme, le nombre, la moyenne, le maximum ou le minimum.
  </Step>
</Steps>

## Mise en forme et affichage

Les résultats d’agrégation peuvent généralement utiliser des paramètres de mise en forme et d’affichage interactif :

* **Mise en forme** : définissez la précision décimale, les symboles monétaires ou les pourcentages.
* **Affichage interactif** : affichez les résultats numériques sous forme de barres, d’anneaux ou dans d’autres styles.

Consultez [Mise en forme](/fr/basic/field/common/formatter) et [Affichage interactif](/fr/basic/field/common/show-as) pour plus de détails.

## Utilisations courantes

* **Totaux de commandes d’une librairie** : dans une Table `Commandes`, utilisez le Champ Lien `Livres sélectionnés` pour agréger le Champ `Prix` de la Table `Livres`. Choisissez **SUM** pour calculer le total de la commande.
* **Statistiques des tâches d’un projet** : dans une Table `Projets`, comptez les tâches liées ou calculez leur taux d’achèvement.
* **Dépenses totales des clients** : dans une Table `Clients`, agrégez les montants des commandes associées pour connaître les dépenses totales de chaque client.

## Formules d’agrégation prises en charge

| Nom de la formule | Explication                                                                      |
| ----------------- | -------------------------------------------------------------------------------- |
| COUNTALL          | Compte toutes les valeurs, y compris les valeurs textuelles et les valeurs vides |
| COUNTA            | Compte les valeurs non vides                                                     |
| COUNT             | Compte les éléments numériques                                                   |
| SUM               | Calcule la somme de toutes les valeurs numériques                                |
| MAX               | Renvoie la plus grande valeur numérique                                          |
| MIN               | Renvoie la plus petite valeur numérique                                          |
| AND               | Renvoie vrai si toutes les valeurs sont vraies                                   |
| OR                | Renvoie vrai si au moins une valeur est vraie                                    |
| XOR               | Renvoie vrai si un nombre impair de valeurs sont vraies                          |
| ARRAY\_JOIN       | Réunit toutes les valeurs d’un tableau dans une chaîne                           |
| ARRAY\_UNIQUE     | Supprime les doublons et renvoie un tableau de valeurs uniques                   |
| ARRAY\_COMPACT    | Supprime les valeurs vides et renvoie un nouveau tableau                         |
| CONCATENATE       | Réunit plusieurs valeurs dans une chaîne                                         |

## Remarques

* **Mises à jour dynamiques** : les Champs Agrégation effectuent leurs calculs en temps réel. Si les données sources ou les relations de liaison changent, le résultat de l’agrégation est actualisé.
* **Limites liées aux types de données** : certaines fonctions ne fonctionnent qu’avec des types de Champ précis. Par exemple, **SUM** fonctionne uniquement avec les Champs Nombre. Si vous choisissez un Champ Texte, Teable ne propose pas la somme comme option.
* **Performances** : un grand nombre de Champs Agrégation peut nuire aux performances, en particulier s’ils concernent de nombreux Enregistrements. Planifiez soigneusement les relations de liaison et vérifiez régulièrement les paramètres d’agrégation.
