> 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/les-workflows/les-tables.md).

# Les tables

La vue **table** vous permet de voir et manipuler vos données.

Une table regroupe le [**Workflow**](/ksaar-documentation/les-workflows/quest-ce-quun-parcours.md) de la table qui permet de créer un enregistrement, les [**Fiches**](/ksaar-documentation/les-workflows/modifier-afficher-vos-donnees.md) qui permettent de visualiser et modifier un enregistrement, et les [**Suivis**](/ksaar-documentation/les-workflows/les-suivis.md), qui permettent de modifier un enregistrement en suivant des étapes et en effectuant des actions.

On peut ajouter autant de tables que nécessaire.

Dans cette page, vous trouverez les principales fonctionnalités disponibles pour une table, telles que :

* [ajouter/modifier un champ d'une table](#ajouter-modifier-un-champ-dune-table)
* [ajouter/modifier/supprimer un enregistrement d'une table](#ajouter-modifier-supprimer-un-enregistrement-dune-table)
* [modifier/dupliquer/supprimer une table](#modifier-dupliquer-supprimer-une-table)
* [créer/modifier/supprimer une vue des enregistrements d'une table](#creer-modifier-supprimer-une-vue-des-enregistrements-dune-table)
* [ajouter/importer une table](#ajouter-importer-une-table)
* [exporter les enregistrements d'une table](#exporter-les-enregistrements-dune-table)

<figure><img src="/files/leKEWRckSxXt1xrJMwBH" alt=""><figcaption><p>Localisation de la vue table</p></figcaption></figure>

### Ajouter/Modifier un champ d'une table

Pour ajouter un champ à une table, cliquez sur le ➕ en haut à droite de la table. Vous pouvez alors choisir quel type de champ vous souhaitez ajouter.

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

Il est possible de modifier un champ en cliquant sur les trois points à droite du nom du champ. Vous pouvez alors :

* Paramétrer le champ : définir son identifiant unique et son type de champ

<figure><img src="/files/fEmxarTXztKiJXE1j5Rd" alt=""><figcaption><p>Exemple pour un champ nombre</p></figcaption></figure>

* Dupliquer le champ
* Copier son ID
* Masquer le champ dans la vue
* Supprimer le champ

{% hint style="warning" %}
Si vous supprimez un champ, tous ses enregistrements seront supprimés
{% endhint %}

Les champs d'une table peuvent être utilisés dans les workflows correspondants. Pour cela, côté **Front**, allez dans la colonne **Composants** au moment d'ajouter un élément.

<figure><img src="/files/4TDVM22x8fC3J7iAt7NV" alt=""><figcaption></figcaption></figure>

De la même manière, quand vous ajoutez un champ dans un workflow, il est automatiquement visualisable dans la table correspondante.

### Ajouter/Modifier/Supprimer un enregistrement d'une table

Pour ajouter un enregistrement, cliquez sur le ➕ en bas à droite de la table:

<figure><img src="/files/28dC9DaTodRWHtXdsoAM" alt=""><figcaption></figcaption></figure>

Vous pouvez modifier un enregistrement en cliquant dessus. Ici, on a modifié l'Id de la commande 1 en 10 :

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

Enfin, pour supprimer un enregistrement, effectuez un clique droit sur l'enregistrement. Les données des champs de cet enregistrement seront définitivement supprimées.&#x20;

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

### Modifier/Dupliquer/Supprimer une table

Cliquez sur les trois points à droite du nom de la table :

<figure><img src="/files/4tR1chu8VuxumXzrHrmt" alt=""><figcaption></figcaption></figure>

**Modifier** une table vous redirige vers la table en question.

**Copier** l'identifiant de la table.

**Dupliquer** une table vous crée une copie de la table et donc une copie du workflow.&#x20;

{% hint style="warning" %}
Lorsque vous supprimez une table, le workflow correspondant est automatiquement supprimé ainsi que tous les enregistrements de la table.
{% endhint %}

### Ouvrir le workflow, une fiche ou un suivi d'une table

Vous pouvez ouvrir le workflow associé à une table en cliquant sur *Workflow* dans la barre de gauche de la vue Data.\
Il est également possible d’accéder à la liste des fiches ou des suivis liés à cette table.

<figure><img src="/files/opZ3rYlzpEtW5oWrwjiU" alt="" width="342"><figcaption></figcaption></figure>

### Créer/modifier/supprimer une vue des enregistrements d'une table

Les **vues** permettent de **visualiser les données d’une même table de différentes façons**.\
Elles offrent la possibilité de filtrer les enregistrements selon des besoins spécifiques.

#### 🧩 Fonctionnement des vues

Chaque table contient **une vue par défaut** :

* Elle est **créée automatiquement** lors de la création de la table.
* Elle est **non supprimable** et **non renommable**.
* Elle est **toujours affichée en première position** dans la liste des vues.

<figure><img src="/files/5QmoncbqP6l5SpSa4cvJ" alt=""><figcaption><p>Exemple d'une vue par défaut</p></figcaption></figure>

{% hint style="info" %}
La vue par défaut est **non versionnée,** c'est-à-dire qu'elle peut être modifiée librement en *production* et en *développement*. C'est utile pour **filtrer des enregistrements directement en production**, par exemple pour du débogage ou des vérifications ponctuelles.
{% endhint %}

En complément de la vue par défaut, vous pouvez **créer autant de vues personnalisées que nécessaire**. &#x20;

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

<figure><img src="/files/MQtGoInKRJKUoM5GvF7c" alt=""><figcaption><p>Exemple d'une vue personnalisée</p></figcaption></figure>

Ces vues peuvent être **supprimées** ou **renommées** librement et disposent de leurs propres **filtres.**

{% hint style="info" %}
Les autres vues sont **versionnées**, c’est-à-dire qu’elles sont verrouillées en production. Toute modification (création, suppression, renommage ou changement de filtre) doit être effectuée depuis l’environnement de développement, puis mise en production.
{% endhint %}

#### 🔽 Trier les enregistrements d'une vue

Chaque vue dispose d’un moteur de tri permettant d’organiser dynamiquement l’ordre d’affichage des enregistrements.

Le tri peut être appliqué sur :

* les **champs de la table**
* les **champs de l’utilisateur créateur** de l’enregistrement
* les **métadonnées** (date de création, date de modification, identifiant)

Après avoir sélectionné le champ sur lequel trier, il est possible de choisir le **sens du tri** :

* **croissant** (A → Z / 0 → 9 / du plus ancien au plus récent),
* **décroissant** (Z → A / 9 → 0 / du plus récent au plus ancien).

Il est également possible de trier rapidement les enregistrements en **cliquant sur la flèche située à côté du nom d’un champ** dans l’en-tête de la vue.

<figure><img src="/files/8llV33FpMYLWoXxlhR2G" alt=""><figcaption></figcaption></figure>

#### 🔍 Filtrer les enregistrements d’une vue

Chaque vue dispose d’un **moteur de** [**conditions**](/ksaar-documentation/aller-plus-loin/les-conditions.md) permettant de filtrer dynamiquement les enregistrements affichés.

Les filtres peuvent être appliqués sur :

* des **champs de la table**
* des **champs de l’utilisateur créateur** de l’enregistrement

### Ajouter/Importer une table

Créez une table en cliquant sur **Ajouter ou importer** en haut de la liste des tables. Le workflow correspondant sera automatiquement créé.

<figure><img src="/files/9FHhZ0XwcGmaQIGhPcb7" alt="" width="341"><figcaption></figcaption></figure>

#### Créer un table vierge&#x20;

Cliquez sur **Créer une table vide**.

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

#### Créer une table par import

1️⃣ Cliquez sur **Importer vos données**.&#x20;

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

2️⃣ Sélectionnez la provenance de vos données, c'est à dire le format de votre fichier source.

<figure><img src="/files/5ChgStvwKkMMisAVstSG" alt=""><figcaption></figcaption></figure>

3️⃣ Collez vos données dans l'encart prévu à cet effet

<figure><img src="/files/eD0n15ajIePxNPHbQECB" alt=""><figcaption><p>Exemple pour l'import d'élèves et leur classe</p></figcaption></figure>

4️⃣ Choisissez le type de données de chaque colonne en cliquant sur ❗.

<figure><img src="/files/WneZhrX1iffuhu2TXd2O" alt=""><figcaption><p>Exemple pour l'import d'élèves et leur classe</p></figcaption></figure>

#### Importer des données dans une table existante&#x20;

{% content-ref url="/pages/-MTod7i8sqsOiWTTrMjV" %}
[Importer des données](/ksaar-documentation/les-workflows/importer-des-donnees.md)
{% endcontent-ref %}

### Exporter les enregistrements d'une table

{% content-ref url="/pages/-MTodJUkrmbf39nfLiV8" %}
[Exporter des données](/ksaar-documentation/les-workflows/exporter-des-donnees.md)
{% endcontent-ref %}


---

# 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/les-workflows/les-tables.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.