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_id
ID de la table
data
un dictionnaire contenant les données à enregistrer. Exemple : {"column_name1": "value1", "column_name2": "value2"}. Si la colonne n'existe pas, elle est créée.
Réponse : ID du nouvel enregistrement
Exemple
Modifier un enregistrement existant dans la table
edit_record(table_id, record_id, data)
table_id
ID de la table
record_id
ID de l'enregistrement modifié
data
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.
Réponse :
Renvoie toutes les données de l'enregistrement modifié au format : {"column_name1": "value3", "column_name2": "value4"}.
Exemple
Supprimer un enregistrement de la table par son ID
delete_record(table_id, record_id)
table_id
ID de la table
record_id
ID de l'enregistrement supprimé
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_id
ID de la table
value
la valeur à faire correspondre
find_in -
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.
return_from
paramètre facultatif. Nom de la colonne depuis laquelle renvoyer la valeur.
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
Récupérer une valeur à partir de l'enregistrement spécifié
get_record_data(table_id, record_id)
table_id
ID de la table
record_id
ID de l'enregistrement à partir duquel les valeurs sont récupérées
return_column
paramètre facultatif. Nom de la colonne dont la valeur doit être renvoyée.
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 ?
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.
Ensuite, cliquez sur la barre d'adresse.
Dans la barre d'adresse, vous verrez une URL comme https://salebot.pro/projects/11111/table/2, où vous pouvez trouver l'ID de la table souhaitée :
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.
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.
Exécutez maintenant le bloc « Start » en mode test.
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.
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_id
paramètre requis, ID de la table
! cell_data
paramètre requis, un dictionnaire de plages.
cell_data exemple : '{"a1":"a1", "a3": "b4", "c1": "c3"}'
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 :
Pour récupérer des données de la table via le bot, transmettez les plages requises aux fonctions dans le Calculatrice.
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 :
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
Mis à jour