> For the complete documentation index, see [llms.txt](https://ksaar.gitbook.io/ksaar-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ksaar.gitbook.io/ksaar-documentation/aller-plus-loin/les-liaisons.md).

# Les Liaisons

On appelle **Liaison**, la table sélectionnée dans les champs [Liaison simple](/ksaar-documentation/les-elements/elements-liaisons.md#liaison-simple) et [Liaisons multiples](/ksaar-documentation/les-elements/elements-liaisons.md#liaisons-multiples).&#x20;

Lorsqu'une liaison est créée entre deux tables, il est possible d'utiliser les champs de la table liée dans les éléments, les conditions et les actions de la table à laquelle on l'a liée.&#x20;

Pour mieux comprendre comment utiliser les Éléments liaisons 👉🏻 [Éléments liaisons](/ksaar-documentation/les-elements/elements-liaisons.md).

### 🔠 Utiliser les champs d'une liaison dans un élément

Il possible d'utiliser les champs d'une table liée dans un élément (élément texte, élément tableau, ...) de la table à laquelle elle est liée.

#### 🚧 Exemple : ajouter les champs d'une liaison dans un tableau&#x20;

Reprenons l'exemple de l'application de gestion de chantiers de la page [Éléments Liaisons](/ksaar-documentation/les-elements/elements-liaisons.md). Dans la table **Nouveaux Chantiers**, on avait créé un élément Liaison simple lié à la table **Nouveaux Clients**. Cette Liaison simple va permettre d'utiliser tous les champs de la table **Nouveaux Clients** dans des éléments de la table **Nouveaux Chantiers**.

Pour afficher les informations des chantiers et des clients correspondants dans le même tableau :&#x20;

1️⃣ Créez un élément Tableau ayant pour source la table **Nouveaux Chantiers**.&#x20;

2️⃣ Cliquez sur Ajouter une colonne et sélectionnez les champs de la table **Nouveaux Chantiers** à afficher (ex : nom du chantier, localisation du chantier, ...).

<figure><img src="/files/hwYzvjs7bucuVNsarRXx" alt=""><figcaption></figcaption></figure>

3️⃣ Cliquez sur Ajouter une colonne puis sur la liaison de la table **Nouveaux Clients** et sélectionnez les champs de la table **Nouveaux clients** à afficher (nom du client, prénom du client, ...)&#x20;

<figure><img src="/files/IFXUAiM6sxTpvAjQm9eR" alt=""><figcaption><p>Ajout des champs d'une liaison dans un tableau</p></figcaption></figure>

Les informations des chantiers et des clients correspondants sont alors visualisables dans le même tableau.

### 💥 Utiliser les champs d'une liaison dans une action

Il possible d'utiliser les champs d'une liaison dans une action de la table à laquelle elle est liée.&#x20;

#### 🚧  Exemple : Mettre à jour les champs d'une liaison

Si on reprend l'exemple de l'Application de gestion de chantiers dans [Liaison simple](/ksaar-documentation/les-elements/elements-liaisons.md#liaison-simple). On souhaite maintenant connaître le nombre de chantiers associé à un client.&#x20;

1️⃣ Dans la table **Nouveaux Clients**, créez un champ nombre correspondant au nombre de chantiers du client.&#x20;

<figure><img src="/files/07xs6HQsTqr7wZxklS1g" alt=""><figcaption><p>Formulaire de création de client</p></figcaption></figure>

2️⃣ Dans la table **Nouveaux Chantiers**, ajoutez une action **Mettre à jour les champs**. Paramétrez la pour qu'à chaque fois qu'un chantier est lié à un client, le nombre de chantiers du client est incrémenté de 1 :

<figure><img src="/files/cZNOpBR1oYZh0PMAuPa8" alt=""><figcaption><p>Paramétrage de l'action Mettre à jour les champs</p></figcaption></figure>

Vous pourrez alors connaître le nombre total de chantiers que possède chaque client.&#x20;

### ☝🏻 Utiliser les champs d'une liaison dans une condition

Les champs d'une liaison peuvent être utilisés dans les conditions de la table à laquelle elle est liée.&#x20;

#### 🚧 Exemple : conditionner une action avec les champs d'une liaison

Reprenons l'exemple précédent de l'Application de gestion de chantiers. On souhaite maintenant conditionner un envoi de mail si un client a été lié à son premier chantier.

1️⃣ Ajoutez une action **Envoi de mail** juste après l'action **Mettre à jour les champs**.

2️⃣ Cliquez sur les trois points à droite de l'action puis sur conditions.

3️⃣ Paramétrez la condition pour que l'envoi de mail s'effectue uniquement si le nombre de chantier du client est égal à 1 :

<figure><img src="/files/ECZ9FpfJqPAGyXMK0BNO" alt=""><figcaption><p>Paramétrage de la condition d'envoi de mail</p></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ksaar.gitbook.io/ksaar-documentation/aller-plus-loin/les-liaisons.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
