Comment travailler avec les feuilles MaviBot
Le « Sheets » La section de MaviBot est un outil de stockage et de gestion pratiques des données au sein de la plateforme. Vous n’avez plus besoin de passer d’un service à l’autre : toutes vos feuilles sont désormais disponibles dans un seul projet.
Fonctionnalités :
Créez des feuilles avec autant de lignes et de colonnes que vous le souhaitez.
Stockez et modifiez les données sans outils ni 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 adaptez-les à 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, allez à la « Sheets » section dans le projet requis :
Ensuite, vous verrez le « Créer une feuille » bouton. Cliquez dessus pour ouvrir une fenêtre modale où vous devez saisir le nom du tableau :
Entrez un nom pour le tableau et cliquez sur « Terminé ». Le nouveau tableau sera alors créé dans le projet et apparaîtra dans les « Sheets » section.
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 :
Fonction d’ajout de colonnes :
a) pour ajouter des colonnes lettrées
Le bouton ajoute au tableau des colonnes libellées de A à Z.
b) pour ajouter des colonnes avec des noms personnalisés
Un clic sur le bouton ouvre une fenêtre modale où vous pouvez nommer la nouvelle colonne.
Entrez un nom et cliquez sur « Terminé » pour ajouter la colonne au tableau.
Bouton pour ajouter des traits :
Export de la feuille
Vous 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.
Le Import CSV la fonctionnalité 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, rendez-vous dans la section principale :
Ensuite, trouvez le Supprimer bouton 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 l’ID d’une feuille
Vous aurez besoin d’un ID de feuille pour utiliser les fonctions du chatbot liées à ce tableau.
Accédez à votre tableau. Trouvez le tableau souhaité dans la liste et cliquez sur son nom pour l’ouvrir.
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 unique de caractères à la fin de l’URL.
Exemple : Dans une URL comme
https://mavibot.ai/projects/11111/table/2l’ID du tableau est2.Copier l’ID Sélectionnez et copiez ce numéro depuis la barre d’adresse pour l’utiliser dans la configuration de votre 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': 'Entrées supprimées : 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 effectuer la recherche. Si non spécifié, la recherche sera effectuée dans toutes les colonnes
return_from – facultatif. Le nom de la colonne à partir de laquelle renvoyer la valeur
Réponse : si return_from est spécifié, la valeur de la colonne indiqué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 à partir de laquelle récupérer les valeurs
return_column – facultatif. Le nom de la colonne à partir de laquelle renvoyer la valeur
Réponse : si l’entrée est trouvée, renvoie un dictionnaire du type {"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 simultanément dans plusieurs colonnes 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 à partir de 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 similitude (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 contenant les numéros des lignes trouvées
quantity — le nombre de lignes trouvées
list — une chaîne contenant toutes les valeurs de la colonne sélectionnée
Si une erreur se produit, la réponse sera status: false accompagné d’une description de l’erreur : {"status": false, "error": "Erreur ou 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 simultanément dans plusieurs colonnes 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 similitude (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 contenant les numéros des lignes trouvées
row_data — 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é d’une description de l’erreur : {"status": false, "error": "Erreur ou description"}
Mis à jour