Créer un nouvel enregistrement dans la table avec les valeurs spécifiées
Crée un nouvel enregistrement dans une table avec les valeurs spécifiées.
new_record(table_id, data)
Réponse : nouvel ID d'enregistrement
Exemple
Modifier un enregistrement existant dans la table
edit_record(table_id, record_id, data)
Réponse :
Retourne 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)
Réponse :
{'message': 'Deleted records: 1'}
Trouver un enregistrement dans la table par la valeur spécifiée
find_record(table_id, value, find_in, return_from)
Réponse :
Si return_from est spécifié, la valeur de la colonne spécifiée (si elle existe dans la table) sera retourné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 retournées dans la réponse, par exemple : {"column_name1": "value3", "column_name2": "value4"}.
Exemple
Récupérer une valeur de l'enregistrement spécifié
get_record_data(table_id, record_id)
Réponse : Si un enregistrement est trouvé, un dictionnaire comme {"column_name1": "value1", "column_name2": "value2"} est retourné. Si le paramètre return_column est fourni et qu'une telle colonne existe, seule la valeur de cette colonne sera retournée.
Où puis-je trouver un ID de 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 du type
https://salebot.pro/projects/11111/table/2,
où vous pouvez trouver l'ID de la table souhaitée :
Récupérer un enregistrement de la table
get_records_from_table(table_id, start_row, count, start_col, end_col) - récupère un enregistrement de la table.
| Paramètre | Description | Note |
|---|---|---|
| table_id | ID de la table | |
| start_row | Paramètre optionnel, un entier. Spécifie le début de la plage de lignes. | Le numéro de ligne à partir duquel commencer la lecture (inclus). Écrivez-le sans guillemets. |
| count | Paramètre optionnel, 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 sans guillemets. |
| start_col | Paramètre optionnel, une chaîne. Spécifie le début de la plage de colonnes. | Le nom de la colonne à partir de laquelle commencer la lecture (inclus). Écrivez-le entre guillemets. |
| end_col | Paramètre optionnel, une chaîne. Spécifie la fin de la plage de colonnes. | Le nom de la colonne jusqu'à laquelle lire les valeurs de la table (inclus). Écrivez-le entre guillemets. |
Si vous spécifiez uniquement le début de la plage de lignes ou de colonnes, toutes les données à partir de ce point seront retourné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 dans la section "Calculatrice" dans les paramètres du bloc et entrez la fonction avec les paramètres requis.
Voyons comment les données sont affichées dans la table.
Maintenant, exécutez le bloc "Démarrer" en mode test.
Nous pouvons voir les données qui ont été écrites dans la variable à partir de la table dans le message envoyé par le bot. Parce que nous avons référencé la variable dans le message en utilisant la syntaxe #{}, les données stockées dans celle-ci 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.
Si aucun problème ne s'est produit lors de 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 ou description d'erreur"}
Exemple dans la Calculatrice
Par exemple, les cellules de la table contiennent les valeurs spécifiées suivantes :
Pour récupérer des données de la table via le bot, passez les plages requises aux fonctions dans la 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 de colonnes sont différents (par exemple, "Produit", "Nombre", "Montant"), vous devez spécifier la plage en utilisant le format {"Product1":"Amount3"}, où :
• Product est le nom de la première colonne
• 1 indique qu'il s'agit de la colonne numéro 1
• Amount est le nom de la troisième colonne
• 3 indique qu'il s'agit de la colonne numéro 3
