Einen neuen Datensatz in der Tabelle mit den angegebenen Werten erstellen
Erstellt einen neuen Datensatz in einer Tabelle mit den angegebenen Werten.
new_record(table_id, data)
Antwort: Neue Datensatz-ID
Beispiel
Einen vorhandenen Datensatz in der Tabelle bearbeiten
edit_record(table_id, record_id, data)
Antwort:
Gibt die vollständigen Daten des bearbeiteten Datensatzes im Format zurück: {"column_name1": "value3", "column_name2": "value4"}.
Beispiel
Einen Datensatz aus der Tabelle anhand seiner ID löschen
delete_record(table_id, record_id)
Antwort:
{'message': 'Deleted records: 1'}
Einen Datensatz in der Tabelle anhand des angegebenen Werts finden
find_record(table_id, value, find_in, return_from)
Antwort:
Wenn return_from angegeben ist, wird der Wert aus der angegebenen Spalte zurückgegeben (sofern diese in der Tabelle existiert). Wenn return_from nicht angegeben ist oder die Spalte nicht existiert, werden die vollständigen Daten des gefundenen Datensatzes in der Antwort zurückgegeben, z. B.: {"column_name1": "value3", "column_name2": "value4"}.
Beispiel
Abrufen eines Werts aus dem angegebenen Datensatz
get_record_data(table_id, record_id)
Antwort: Wenn ein Datensatz gefunden wird, wird ein Wörterbuch wie {"column_name1": "value1", "column_name2": "value2"} zurückgegeben. Wenn der Parameter return_column angegeben ist und eine solche Spalte existiert, wird nur der Wert aus dieser Spalte zurückgegeben.
Wo finde ich eine Tabellen-ID?
Um mit Chatbot-Funktionen zu arbeiten, benötigen Sie die Tabellen-ID. Suchen Sie die gewünschte Tabelle in der Liste und klicken Sie darauf.
Klicken Sie als Nächstes auf die Adressleiste.
In der Adressleiste sehen Sie eine URL wie
https://salebot.pro/projects/11111/table/2,
wo Sie die ID der gewünschten Tabelle finden:
Abrufen eines Datensatzes aus der Tabelle
get_records_from_table(table_id, start_row, count, start_col, end_col) - Abrufen eines Datensatzes aus der Tabelle.
| Parameter | Beschreibung | Hinweis |
|---|---|---|
| table_id | Tabellen-ID | |
| start_row | Optionaler Parameter, eine Ganzzahl. Gibt den Beginn des Zeilenbereichs an. | Die Zeilennummer, ab der gelesen werden soll (inklusive). Ohne Anführungszeichen angeben. |
| count | Optionaler Parameter, eine Ganzzahl. Gibt die Anzahl der abzurufenden Zeilen an. | Standardmäßig 1000, maximal 5000. Ohne Anführungszeichen angeben. |
| start_col | Optionaler Parameter, eine Zeichenkette. Gibt den Beginn des Spaltenbereichs an. | Der Name der Spalte, ab der gelesen werden soll (inklusive). In Anführungszeichen angeben. |
| end_col | Optionaler Parameter, eine Zeichenkette. Gibt das Ende des Spaltenbereichs an. | Der Name der Spalte, bis zu der Tabellenwerte gelesen werden sollen (inklusive). In Anführungszeichen angeben. |
Wenn Sie nur den Beginn des Zeilen- oder Spaltenbereichs angeben, werden alle Daten ab diesem Punkt zurückgegeben. Sie können den Beginn auch weglassen und nur das Ende angeben, um Daten bis zu diesem Punkt zu erhalten.
Beispiel
Gehen Sie im Block, in dem Sie Datensätze aus der Tabelle abrufen möchten, zum Abschnitt "Rechner" in den Blockeinstellungen und geben Sie die Funktion mit den erforderlichen Parametern ein.
Sehen wir uns an, wie die Daten in der Tabelle angezeigt werden.
Führen Sie nun den Block "Start" im Testmodus aus.
Wir können die Daten sehen, die aus der Tabelle in die Variable geschrieben wurden, in der vom Bot gesendeten Nachricht. Da wir in der Nachricht mit der #{}-Syntax auf die Variable verwiesen haben, wurden die darin gespeicherten Daten im Bot-Chat angezeigt.
Daten aus der Tabelle innerhalb eines angegebenen Bereichs abrufen
table_read_cells(table_id, cell_data) - Ermöglicht das Abrufen von Daten aus der Tabelle durch Angabe von Bereichen.
Wenn während der Anfrage keine Probleme aufgetreten sind, enthält die Antwort ein Wörterbuch mit dem Status und allen Zellen mit ihren Werten:
{"status": true, "A1": "value", "A3": "value", "B3": "value", "A4": "value", "B4": "value", "C1": "", "C2": "value", "C3": "ddddddd" oder im Fehlerfall: {"status": false, "err": "Fehlermeldung oder -beschreibung"}
Beispiel im Rechner
Angenommen, die Tabellenzellen enthalten die folgenden angegebenen Werte:
Um Daten aus der Tabelle über den Bot abzurufen, übergeben Sie die erforderlichen Bereiche an die Funktionen im Rechner.
Im Beispiel hilft das Konstrukt #{res}, das eine Variable enthält, dabei, in der Nachricht die Daten anzuzeigen, die mit der Funktion und dem angegebenen Bereich abgerufen wurden:
Wenn die Spaltennamen unterschiedlich sind (z. B. "Produkt", "Anzahl", "Betrag"), müssen Sie den Bereich im Format {"Product1":"Amount3"} angeben, wobei:
• Product der Name der ersten Spalte ist
• 1 angibt, dass es sich um Spalte Nummer 1 handelt
• Amount der Name der dritten Spalte ist
• 3 angibt, dass es sich um Spalte Nummer 3 handelt
