# Travailler avec les tableaux MaviBot

## Créer un nouvel enregistrement dans la table avec les valeurs spécifiées

Créer un nouvel enregistrement dans une table avec les valeurs spécifiées.

new\_record(table\_id, data)

<table><thead><tr><th width="188.26171875">Paramètres</th><th>Description</th></tr></thead><tbody><tr><td>table_id </td><td>ID de la table</td></tr><tr><td>data</td><td>un dictionnaire contenant les données à enregistrer.<br><br>Exemple : {"column_name1": "value1", "column_name2": "value2"}. Si la colonne n'existe pas, elle est créée.</td></tr></tbody></table>

Réponse : ID du nouvel enregistrement

### Exemple

<div data-with-frame="true"><figure><img src="/files/2b86e7d087c6d3bc29f55127079874552b1147f8" alt="" width="563"><figcaption></figcaption></figure></div>

## Modifier un enregistrement existant dans la table

edit\_record(table\_id, record\_id, data)

<table><thead><tr><th width="304.22265625">Paramètres</th><th>Description</th></tr></thead><tbody><tr><td>table_id</td><td>ID de la table</td></tr><tr><td>record_id</td><td>ID de l'enregistrement modifié</td></tr><tr><td>data</td><td>un dictionnaire contenant les données à modifier. Exemple : {"column_name1": "value3", "column_name2": "value4"}. Si la colonne n'existe pas, elle n'est PAS créée.</td></tr></tbody></table>

Réponse :

Renvoie toutes les données de l'enregistrement modifié au format : {"column\_name1": "value3", "column\_name2": "value4"}.

### Exemple

<div data-with-frame="true"><figure><img src="/files/735cb85032c4fbbc9b532b654d1b5d99497222c8" alt="" width="563"><figcaption></figcaption></figure></div>

## Supprimer un enregistrement de la table par son ID

delete\_record(table\_id, record\_id)

<table><thead><tr><th width="298.4140625">Paramètres</th><th>Description</th></tr></thead><tbody><tr><td>table_id</td><td>ID de la table</td></tr><tr><td>record_id</td><td> ID de l'enregistrement supprimé</td></tr></tbody></table>

Réponse :

{'message': 'Enregistrements supprimés : 1'}

## Trouver un enregistrement dans la table à partir de la valeur spécifiée

find\_record(table\_id, value, find\_in, return\_from)

<table><thead><tr><th width="304.22265625">Paramètres</th><th>Description</th></tr></thead><tbody><tr><td>table_id</td><td>ID de la table</td></tr><tr><td>value</td><td>la valeur à faire correspondre</td></tr><tr><td>find_in - </td><td>paramètre facultatif. Nom de la colonne par laquelle effectuer la recherche. Si non spécifié, la recherche sera effectuée dans toutes les colonnes.</td></tr><tr><td>return_from</td><td>paramètre facultatif. Nom de la colonne depuis laquelle renvoyer la valeur.</td></tr></tbody></table>

Réponse :

Si return\_from est spécifié, la valeur de la colonne indiquée (si elle existe dans la table) sera renvoyée. Si return\_from n'est pas spécifié ou si la colonne n'existe pas, toutes les données de l'enregistrement trouvé seront renvoyées dans la réponse, par exemple : {"column\_name1": "value3", "column\_name2": "value4"}.

### Exemple

<div data-with-frame="true"><figure><img src="/files/fcea38b9a6f784cfa9bc46ad294ec1a2be3d0938" alt=""><figcaption></figcaption></figure></div>

## Récupérer une valeur à partir de l'enregistrement spécifié

get\_record\_data(table\_id, record\_id)

<table><thead><tr><th width="298.4140625">Paramètres</th><th>Description</th></tr></thead><tbody><tr><td>table_id</td><td>ID de la table</td></tr><tr><td>record_id</td><td>ID de l'enregistrement à partir duquel les valeurs sont récupérées</td></tr><tr><td>return_column</td><td>paramètre facultatif. Nom de la colonne dont la valeur doit être renvoyée.</td></tr></tbody></table>

Réponse : si un enregistrement est trouvé, un dictionnaire comme {"column\_name1": "value1", "column\_name2": "value2"} est renvoyé. Si le paramètre return\_column est fourni et qu'une telle colonne existe, seule la valeur de cette colonne sera renvoyée.

### Où puis-je trouver l'ID d'une table ?

<div data-with-frame="true"><figure><img src="/files/a9719590c41f7eadcec3f44cca1456c46f0e958d" alt="" width="220"><figcaption></figcaption></figure></div>

Pour travailler avec les fonctions du chatbot, vous aurez besoin de l'ID de la table. Trouvez la table souhaitée dans la liste et cliquez dessus.

<div data-with-frame="true"><figure><img src="/files/f578a3d9222091650f9107b6da3a618ea964958d" alt=""><figcaption></figcaption></figure></div>

Ensuite, cliquez sur la barre d'adresse.

Dans la barre d'adresse, vous verrez une URL comme
&#x20;<https://salebot.pro/projects/11111/table/2>,
&#x20;où vous pouvez trouver l'ID de la table souhaitée :

<div data-with-frame="true"><figure><img src="/files/28c80d0bdbaeef31a33ed1b6003ee7089df508c5" alt="" width="563"><figcaption></figcaption></figure></div>

## Récupérer un enregistrement depuis la table

get\_records\_from\_table(table\_id, start\_row, count, start\_col, end\_col) - récupération d'un enregistrement depuis la table.

| Paramètre  | Description                                                                      | Remarque                                                                                              |
| ---------- | -------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| table\_id  | ID de la table                                                                   |                                                                                                       |
| start\_row | Paramètre facultatif, un entier. Spécifie le début de l'intervalle de lignes.    | Numéro de ligne à partir duquel commencer la lecture (inclus). Écrivez-le sans guillemets.            |
| count      | Paramètre facultatif, un entier. Spécifie le nombre de lignes à récupérer.       | Par défaut, la valeur est 1000, avec un maximum de 5000. Spécifiez-la sans guillemets.                |
| start\_col | Paramètre facultatif, une chaîne. Spécifie le début de l'intervalle de colonnes. | Nom de la colonne à partir de laquelle commencer la lecture (inclus). Écrivez-le entre guillemets.    |
| end\_col   | Paramètre facultatif, une chaîne. Spécifie la fin de l'intervalle de colonnes.   | Nom de la colonne jusqu'à laquelle lire les valeurs du tableau (inclus). Écrivez-le entre guillemets. |

Si vous ne spécifiez que le début de l'intervalle de lignes ou de colonnes, toutes les données à partir de ce point seront renvoyées. Vous pouvez également omettre le début et spécifier uniquement la fin pour obtenir les données jusqu'à ce point.

### Exemple

Dans le bloc où vous devez récupérer des enregistrements de la table, allez à la **« Calculatrice »** section dans les paramètres du bloc et saisissez la fonction avec les paramètres requis.

Voyons comment les données sont affichées dans le tableau.

<div data-with-frame="true"><figure><img src="/files/af8e09f12b60fec818e8b985462b7961dba5150c" alt=""><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/53795d1f664a05524614aaf8f1156b750e724b40" alt="" width="563"><figcaption></figcaption></figure></div>

Exécutez maintenant le bloc « Start » en mode test.

<div data-with-frame="true"><figure><img src="/files/87e4a24c4dd1e3a6c7ea934d9d82fe07f5ff8bec" alt="" width="375"><figcaption></figcaption></figure></div>

Nous pouvons voir les données qui ont été écrites dans la variable depuis le tableau dans le message envoyé par le bot. Comme nous avons fait référence à la variable dans le message à l'aide de la syntaxe `#{}` , les données qu'elle contenait ont été affichées dans le chat du bot.

<div data-with-frame="true"><figure><img src="/files/5101653ccb4796b58fc4c0a4cb91f870b65cf3dc" alt="" width="563"><figcaption></figcaption></figure></div>

## Récupérer des données de la table dans une plage spécifiée

table\_read\_cells(table\_id, cell\_data) - permet de récupérer des données de la table en spécifiant des plages.

<table><thead><tr><th width="286.37890625">Paramètre</th><th>Description</th></tr></thead><tbody><tr><td><mark style="color:red;"><strong>!</strong></mark> table_id</td><td>paramètre requis, ID de la table</td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark> cell_data</td><td>paramètre requis, un dictionnaire de plages.<br><strong>cell_data</strong> exemple : <code>'{"a1":"a1", "a3": "b4", "c1": "c3"}'</code></td></tr></tbody></table>

Si aucun problème ne s'est produit pendant la requête, la réponse sera un dictionnaire contenant le statut et toutes les cellules avec leurs valeurs :

`{"status": true, "A1": "value", "A3": "value", "B3": "value", "A4": "value", "B4": "value", "C1": "", "C2": "value", "C3": "ddddddd"ou, en cas d'erreur : {"status": false, "err": "Message d'erreur ou description"}`

### Exemple dans la calculatrice

Par exemple, les cellules du tableau contiennent les valeurs spécifiées suivantes :

<div data-with-frame="true"><figure><img src="/files/b6bbad09232de9d65a208fba409e21d324bffb07" alt="" width="563"><figcaption></figcaption></figure></div>

Pour récupérer des données de la table via le bot, transmettez les plages requises aux fonctions dans le **Calculatrice**.

<div data-with-frame="true"><figure><img src="/files/f3878d6028e2c9f466965e6905a058acc5564d9d" alt="" width="563"><figcaption></figcaption></figure></div>

Dans l'exemple, la construction #{res}, qui contient une variable, aide à afficher dans le message les données récupérées à l'aide de la fonction et de la plage spécifiée :

<div data-with-frame="true"><figure><img src="/files/38c89962a06489379f54631eb909aee6f4ac59e1" alt="" width="563"><figcaption></figcaption></figure></div>

Si les noms des colonnes sont différents (par exemple, "Product", "Number", "Amount"), vous devez spécifier la plage en utilisant le format {"Product1":"Amount3"}, où :

• **Product** est le nom de la première colonne\
• **1** indique que c'est la colonne numéro 1\
• **Montant** est le nom de la troisième colonne\
• **3** indique que c'est la colonne numéro 3

<div data-with-frame="true"><figure><img src="/files/33d7c374c530e23d0ee7fa5d142b35124a98c10c" alt="" width="563"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/2992f64e37afa467511cb13cbdf80f3829ff9aba" alt="" width="563"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/72c234ae21f919d1985cad343074691bc043761d" alt="" width="563"><figcaption></figcaption></figure></div>


---

# Agent Instructions: 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:

```
GET https://docs.mavibot.ai/doc/fr/chatbot/functions/calculatrice/tables.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.