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)

Parameter Beschreibung
table_id Tabellen-ID
data Ein Wörterbuch mit den zu erfassenden Daten.

Beispiel: {"column_name1": "value1", "column_name2": "value2"}. Wenn die Spalte nicht existiert, wird sie erstellt.

Antwort: Neue Datensatz-ID

Beispiel

Einen vorhandenen Datensatz in der Tabelle bearbeiten

edit_record(table_id, record_id, data)

Parameter Beschreibung
table_id Tabellen-ID
record_id ID des zu bearbeitenden Datensatzes
data Ein Wörterbuch mit den zu bearbeitenden Daten. Beispiel: {"column_name1": "value3", "column_name2": "value4"}. Wenn die Spalte nicht existiert, wird sie NICHT erstellt.

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)

Parameter Beschreibung
table_id Tabellen-ID
record_id ID des zu löschenden Datensatzes

Antwort:

{'message': 'Deleted records: 1'}

Einen Datensatz in der Tabelle anhand des angegebenen Werts finden

find_record(table_id, value, find_in, return_from)

Parameter Beschreibung
table_id Tabellen-ID
value Der zu suchende Wert
find_in - Optionaler Parameter. Der Name der Spalte, in der gesucht werden soll. Wenn nicht angegeben, wird in allen Spalten gesucht.
return_from Optionaler Parameter. Der Name der Spalte, aus der der Wert zurückgegeben werden soll.

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)

Parameter Beschreibung
table_id Tabellen-ID
record_id ID des Datensatzes, aus dem die Werte abgerufen werden
return_column Optionaler Parameter. Der Name der Spalte, aus der der Wert zurückgegeben werden soll.

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.

Parameter Beschreibung
**!** table_id Erforderlicher Parameter, Tabellen-ID
**!** cell_data Erforderlicher Parameter, ein Wörterbuch mit Bereichen.
cell_data Beispiel: '{"a1":"a1", "a3": "b4", "c1": "c3"}'

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