Belirtilen değerlerle tabloda yeni bir kayıt oluşturma

Belirtilen değerlerle bir tabloda yeni bir kayıt oluşturun.

new_record(table_id, data)

Yanıt: yeni kayıt kimliği

Örnek

Tablodaki mevcut bir kaydı düzenleme

edit_record(table_id, record_id, data)

Yanıt:

Düzenlenen kaydın tüm verilerini şu formatta döndürür: {"column_name1": "value3", "column_name2": "value4"}.

Örnek

Bir kaydı kimliğine göre tablodan silme

delete_record(table_id, record_id)

Yanıt:

{'message': 'Silinen kayıtlar: 1'}

Tabloda belirtilen değere göre kayıt bulma

find_record(table_id, value, find_in, return_from)

Yanıt:

return_from belirtilmişse, belirtilen sütundaki değer (tabloda mevcutsa) döndürülür. return_from belirtilmemişse veya sütun mevcut değilse, bulunan kaydın tüm verileri yanıt olarak döndürülür, örneğin: {"column_name1": "value3", "column_name2": "value4"}.

Örnek

Belirtilen kayıttan değer alma

get_record_data(table_id, record_id)

Yanıt: Bir kayıt bulunursa, {"column_name1": "value1", "column_name2": "value2"} şeklinde bir sözlük döndürülür. return_column parametresi sağlanmışsa ve böyle bir sütun mevcutsa, yalnızca o sütundaki değer döndürülür.

Tablo kimliğini nerede bulabilirim?

Sohbet botu işlevleriyle çalışmak için tablo kimliğine ihtiyacınız olacak. Listede istediğiniz tabloyu bulun ve üzerine tıklayın.

Ardından, adres çubuğuna tıklayın.

Adres çubuğunda, şuna benzer bir URL göreceksiniz:
https://salebot.pro/projects/11111/table/2,
burada istediğiniz tablonun kimliğini bulabilirsiniz:

Tablodan kayıt alma

get_records_from_table(table_id, start_row, count, start_col, end_col) - tablodan kayıt alma.

Parametre Açıklama Not
table_id tablo kimliği
start_row İsteğe bağlı parametre, bir tam sayı. Satır aralığının başlangıcını belirtir. Okumaya başlanacak satır numarası (dahil). Tırnak işareti olmadan yazın.
count İsteğe bağlı parametre, bir tam sayı. Alınacak satır sayısını belirtir. Varsayılan değer 1000'dir, maksimum 5000. Tırnak işareti olmadan belirtin.
start_col İsteğe bağlı parametre, bir dize. Sütun aralığının başlangıcını belirtir. Okumaya başlanacak sütunun adı (dahil). Tırnak işareti içinde yazın.
end_col İsteğe bağlı parametre, bir dize. Sütun aralığının sonunu belirtir. Tablo değerlerinin okunacağı sütunun adı (dahil). Tırnak işareti içinde yazın.

Yalnızca satır veya sütun aralığının başlangıcını belirtirseniz, bu noktadan itibaren tüm veriler döndürülür. Başlangıcı atlayıp yalnızca bitişi belirterek o noktaya kadar olan verileri de alabilirsiniz.

Örnek

Tablodan kayıtları almanız gereken blokta, blok ayarlarındaki "Hesap Makinesi" bölümüne gidin ve gerekli parametrelerle işlevi girin.

Verilerin tabloda nasıl görüntülendiğini görelim.

Şimdi, test modunda "Başlangıç" bloğunu çalıştırın.

Bot tarafından gönderilen mesajda tablodan değişkene yazılan verileri görebiliriz. Mesajda #{} sözdizimini kullanarak değişkene atıfta bulunduğumuz için, içinde depolanan veriler bot sohbetinde görüntülendi.

Belirtilen aralıktaki tablodan veri alma

table_read_cells(table_id, cell_data) - aralıklar belirterek tablodan veri almayı sağlar.

İstek sırasında herhangi bir sorun oluşmazsa, yanıt durumu ve tüm hücreleri değerleriyle birlikte içeren bir sözlük olacaktır:

{"status": true, "A1": "value", "A3": "value", "B3": "value", "A4": "value", "B4": "value", "C1": "", "C2": "value", "C3": "ddddddd"veya hata durumunda: {"status": false, "err": "Hata mesajı veya açıklaması"}

Hesap Makinesinde örnek

Örneğin, tablo hücreleri aşağıdaki belirtilen değerleri içeriyor:

Bot aracılığıyla tablodan veri almak için, Hesap Makinesi'ndeki işlevlere gerekli aralıkları iletin.

Örnekte, bir değişken tutan #{res} yapısı, işlev ve belirtilen aralık kullanılarak alınan verilerin mesajda görüntülenmesine yardımcı olur:

Sütun adları farklıysa (örneğin, "Ürün", "Sayı", "Tutar"), aralığı {"Product1":"Amount3"} biçimini kullanarak belirtmelisiniz; burada:

• Product ilk sütunun adıdır
• 1 bunun 1 numaralı sütun olduğunu belirtir
• Amount üçüncü sütunun adıdır
• 3 bunun 3 numaralı sütun olduğunu belirtir