La section "Feuilles" dans MaviBot est un outil de stockage et de gestion pratique des données au sein de la plateforme. Vous n'avez plus besoin de basculer entre différents services : toutes vos feuilles sont désormais disponibles dans un seul projet.

Fonctionnalités :

  • Créez des feuilles avec un nombre illimité de lignes et de colonnes.
  • Stockez et modifiez des données sans outils ou services tiers.
  • Saisissez des valeurs, modifiez des lignes et des colonnes, ou supprimez-les directement via le chatbot à l'aide de fonctions.

Avantages :

  • Simplifie la gestion des données : vous pouvez saisir des informations dans un tableau directement depuis le bot.
  • Flexible et facile à utiliser : créez autant de tableaux que nécessaire et personnalisez-les pour vos tâches professionnelles.

Gérez vos tableaux sans quitter Mavibot

Les tableaux aident les entreprises à structurer leurs données et à accélérer les processus.

Comment créer des feuilles

Pour commencer, accédez à la section "Feuilles" dans le projet souhaité :

Ensuite, vous verrez le bouton "Créer une feuille". Cliquez dessus pour ouvrir une fenêtre modale où vous devez saisir le nom du tableau :

Saisissez un nom pour le tableau et cliquez sur "Terminé". Le nouveau tableau sera alors créé dans le projet et apparaîtra dans la section "Feuilles".

Paramètres des feuilles

Après avoir créé la feuille, vous devez ajouter des lignes et des colonnes. Pour ce faire, trouvez le bouton "Aller à" sur le tableau souhaité et cliquez dessus :

Vous verrez les paramètres suivants :

  1. Fonction d'ajout de colonnes :

а) pour ajouter des colonnes lettrées

Le bouton ajoute des colonnes étiquetées de A à Z au tableau.

b) pour ajouter des colonnes avec des noms personnalisés

Cliquer sur le bouton ouvre une fenêtre modale où vous pouvez nommer la nouvelle colonne.

Saisissez un nom et cliquez sur "Terminé" pour ajouter la colonne au tableau.

  1. Bouton d'ajout de lignes :

  1. Exportation de la feuille

Permet d'exporter la feuille au format CSV avec toutes les données et valeurs, par exemple pour déplacer la feuille vers un autre projet Mavibot ou vers un autre service de tableur.

  1. La fonctionnalité Importer CSV vous permet de charger des données depuis un service externe.

Autres fonctionnalités

Il existe un menu déroulant qui vous permet de parcourir rapidement les feuilles sans quitter la section principale.

Vous pouvez également créer de nouveaux tableaux directement depuis le menu latéral.

Pour supprimer une feuille, accédez à la section principale :

Ensuite, trouvez le bouton Supprimer sur la carte du tableau que vous souhaitez retirer.

Attention !

Les tableaux supprimés ne peuvent pas être restaurés.

Comment saisir des valeurs dans la feuille

Vous pouvez saisir des valeurs dans la feuille manuellement :

Ou en utilisant des fonctions dans le chatbot.

Comment trouver un ID de feuille

Vous aurez besoin d'un ID de feuille pour utiliser les fonctions du chatbot liées à ce tableau.

  1. Accédez à votre tableau. Trouvez le tableau souhaité dans la liste et cliquez sur son nom pour l'ouvrir.
  2. Localisez l'ID du tableau dans la barre d'adresse. Cliquez sur la barre d'adresse de votre navigateur — l'ID du tableau est la chaîne de caractères unique à la fin de l'URL.

  1. Exemple :
    Dans une URL comme https://mavibot.ai/projects/11111/table/2
    l'ID du tableau est 2.
  2. Copiez l'ID
    Sélectionnez et copiez ce nombre depuis la barre d'adresse pour l'utiliser dans votre configuration de chatbot.

Comment créer un nouvel enregistrement dans la feuille

new_record(table_id, data) – crée une nouvelle entrée dans le tableau avec les valeurs spécifiées.

table_id – l'ID du tableau

data – un dictionnaire contenant les données à saisir. Exemple : {"column_name1": "value1", "column_name2": "value2"}. Si une colonne n'existe pas, elle sera créée. Réponse : l'ID de la nouvelle entrée

Exemple

Comment modifier un enregistrement existant dans la feuille

edit_record(table_id, record_id, data)

table_id – l'ID du tableau

record_id – l'ID de l'entrée à modifier

data – un dictionnaire contenant les données à mettre à jour. Exemple : {"column_name1": "value3", "column_name2": "value4"}. Si une colonne n'existe pas, elle NE sera PAS créée.

Réponse : Renvoie les données complètes de l'entrée modifiée au format {"column_name1": "value3", "column_name2": "value4"}

Exemple

Comment supprimer un enregistrement de feuille par son ID

delete_record(table_id, record_id)

table_id – l'ID du tableau

record_id – l'ID de l'entrée à supprimer

Réponse :

{'message': 'Deleted entries: 1'}

Comment trouver le premier enregistrement avec la valeur spécifiée dans une feuille

find_record(table_id, value, find_in, return_from)

table_id – l'ID du tableau

value – la valeur à rechercher

find_in – facultatif. Le nom de la colonne dans laquelle rechercher. S'il n'est pas spécifié, la recherche sera effectuée dans toutes les colonnes

return_from – facultatif. Le nom de la colonne depuis laquelle renvoyer la valeur

Réponse : Si return_from est spécifié, la valeur de la colonne spécifiée sera renvoyée (si elle existe dans le tableau). Si return_from n'est pas spécifié ou si la colonne n'existe pas, les données complètes de l'entrée trouvée seront renvoyées : {"column_name1": "value3", "column_name2": "value4"}

Exemple

Comment obtenir les valeurs de l'enregistrement spécifié

get_record_data(table_id, record_id, return_column )

table_id – l'ID du tableau

record_id – l'ID de l'entrée dont il faut récupérer les valeurs

return_column – facultatif. Le nom de la colonne depuis laquelle renvoyer la valeur

Réponse : Si l'entrée est trouvée, renvoie un dictionnaire comme {"column_name1": "value1", "column_name2": "value2"}. Si return_column est fourni et que la colonne existe, seule la valeur de cette colonne sera renvoyée.

Comment récupérer toutes les valeurs lors d'une recherche sur plusieurs colonnes

find_records_multiple_cols_list(table_id, column_data, return_col, with_index, delimiter, algorithm) – Utilisez cette fonction lorsque vous devez rechercher sur plusieurs colonnes à la fois et récupérer une liste de valeurs d'une colonne dans les lignes où toutes les valeurs sont trouvées. (C'est similaire à la fonction sheet_search_in_multiple_cols_return_list pour Google Sheets.)

table_id — l'ID du tableau

column_data — la requête de recherche, c'est-à-dire ce que vous voulez trouver

return_col — le numéro de la colonne depuis laquelle renvoyer les valeurs

with_index — index ou numérotation dans la liste des valeurs trouvées (0 – numérotation (1, 2, 3,…) ; 1 – index de ligne ; "" – liste de valeurs sur de nouvelles lignes sans index ni numérotation)

delimiter — séparateur entre l'index et la valeur

algorithm — algorithme de recherche (F – correspondance exacte, K – correspondance par mot-clé, R – expression régulière, 1–100 – pourcentage de similarité (voir détails ci-dessus))

Exemple :

table_id = 7

data = {"age": "26", "city": "New York"}

return_col = "name"

with_index = 1

delimiter = " - "

algorithm = "F"

res = find_records_multiple_cols_list(table_id, data, return_col, with_index, delimiter, algorithm)

res_list = res["list"]

Si la requête s'exécute avec succès, la réponse est un dictionnaire contenant le statut et toutes les cellules avec des valeurs :

{"status":true,"rows_index":[2,3],"quantity":2,"list":"2 - John\n3 - Anna"}

status — le résultat de la recherche

rows_index — un tableau avec les numéros des lignes trouvées

quantity — le nombre de lignes trouvées

list — une chaîne avec toutes les valeurs de la colonne sélectionnée

Si une erreur se produit, la réponse sera status: false accompagnée d'une description de l'erreur : {"status": false, "error": "Error or description"}

Comment récupérer la première valeur lors d'une recherche sur plusieurs colonnes

find_first_record_multiple_cols_row(table_id, column_data, algorithm) – utilisez cette fonction lorsque vous devez rechercher sur plusieurs colonnes à la fois et récupérer la première ligne correspondante. (C'est similaire à la fonction sheet_search_in_multiple_cols_return_row pour Google Sheets.)

table_id — l'ID du tableau

columns — la requête de recherche, c'est-à-dire ce que vous voulez trouver

algorithm — l'algorithme de recherche (F – correspondance exacte, K – correspondance par mot-clé, R – expression régulière, 1–100 – pourcentage de similarité (voir détails ci-dessus))

Exemple :

table_id = 7

data = {"age": "26", "city": "New York"}

algorithm = "F"

res = find_first_record_multiple_cols_row(table_id, data, algorithm)

row_data = res["row_data"]

row_id = row_data["ID"]

row_name = row_data["name"]

row_age = row_data["age"]

Si la requête s'exécute avec succès, la réponse est un dictionnaire contenant le statut et toutes les cellules avec des valeurs.

{"status":true,"rows_index":[2,3],"quantity":2,"row_data":{"ID":2,"name":"John","age":"26","city":"New York"},"row":2}

status — le résultat de la recherche

rows_index — un tableau avec les numéros des lignes trouvées

row_data — les données de la ligne trouvée

row — le numéro de la ligne trouvée

Si une erreur se produit, la réponse sera status: false accompagnée d'une description de l'erreur : {"status": false, "error": "Error or description"}