MaviBot tablolarıyla çalışma

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

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

new_record(table_id, data)

Parametreler	Açıklama
table_id	tablo ID'si
data	kaydedilecek verileri içeren bir sözlük. Örnek: {"column_name1": "value1", "column_name2": "value2"}. Sütun yoksa oluşturulur.

Yanıt: yeni kayıt ID'si

Örnek

Tablodaki mevcut bir kaydı düzenle

edit_record(table_id, record_id, data)

Parametreler	Açıklama
table_id	tablo ID'si
record_id	düzenlenen kayıt ID'si
data	düzenlenecek verileri içeren bir sözlük. Örnek: {"column_name1": "value3", "column_name2": "value4"}. Sütun yoksa oluşturulmaz.

Yanıt:

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

Örnek

ID'sine göre tablodan bir kaydı sil

delete_record(table_id, record_id)

Parametreler	Açıklama
table_id	tablo ID'si
record_id	silinen kayıt ID'si

Yanıt:

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

Belirtilen değere göre tabloda bir kayıt bul

find_record(table_id, value, find_in, return_from)

Parametreler	Açıklama
table_id	tablo ID'si
value	eşleştirilecek değer
find_in -	isteğe bağlı parametre. Arama yapılacak sütunun adı. Belirtilmezse, arama tüm sütunlarda yapılır.
return_from	isteğe bağlı parametre. Değerin döndürüleceği sütunun adı.

Yanıt:

return_from belirtilirse, belirtilen sütundaki değer (tablodaysa) döndürülür. return_from belirtilmemişse veya sütun yoksa, bulunan kaydın tüm verileri yanıtta döndürülür; örneğin: {"column_name1": "value3", "column_name2": "value4"}.

Örnek

Belirtilen kayıttan bir değer al

get_record_data(table_id, record_id)

Parametreler	Açıklama
table_id	tablo ID'si
record_id	değerlerin alındığı kayıt ID'si
return_column	isteğe bağlı parametre. Değerin döndürülmesi gereken sütunun adı.

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

Tablo ID'sini nerede bulabilirim?

Chatbot işlevleriyle çalışmak için tablo ID'sine ihtiyacınız olacak. Listeden istediğiniz tabloyu bulun ve üzerine tıklayın.

Sonra, adres çubuğuna tıklayın.

Adres çubuğunda, https://salebot.pro/projects/11111/table/2 gibi bir URL göreceksiniz, burada istediğiniz tablonun ID'sini bulabilirsiniz:

Tablodan bir kayıt alma

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

Parametre	Açıklama	Not
table_id	tablo ID'si
start_row	İsteğe bağlı parametre, bir tamsayı. 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 tamsayı. Alınacak satır sayısını belirtir.	Varsayılan olarak değer 1000'dir, en fazla 5000 olabilir. 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çinde yazın.
end_col	İsteğe bağlı parametre, bir dize. Sütun aralığının bitişini belirtir.	Tablo değerlerinin okunacağı son sütunun adı (dahil). Tırnak içinde yazın.

Yalnızca satır veya sütun aralığının başlangıcını belirtirseniz, o noktadan itibaren tüm veriler döndürülür. Verileri o noktaya kadar almak için başlangıcı atlayıp yalnızca bitişi de belirtebilirsiniz.

Örnek

Tablodan kayıt almanız gereken blokta, "Hesaplayıcı" bölümüne gidin ve gerekli parametrelerle işlevi girin.

Verilerin tabloda nasıl görüntülendiğine bakalım.

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

Tablodan değişkene yazılan verileri, bot tarafından gönderilen mesajda görebiliriz. Değişkene mesajda #{} sözdizimini kullanarak başvurduğumuz için, içindeki veri bot sohbetinde görüntülendi.

Belirtilen bir aralık içinde tablodan veri al

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

Parametre	Açıklama
! table_id	gerekli parametre, tablo ID'si
! cell_data	gerekli parametre, aralıkları içeren bir sözlük. cell_data örnek: '{"a1":"a1", "a3": "b4", "c1": "c3"}'

İstek sırasında herhangi bir sorun oluşmadıysa, yanıt durum ve değerleriyle birlikte tüm hücreleri 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çerir:

Bot aracılığıyla tablodan veri almak için, gerekli aralıkları Hesaplayıcıda.

Hesapta, bir değişkeni tutan #{res} yapısı, işlev ve belirtilen aralık kullanılarak alınan verileri mesajda göstermeye yardımcı olur:

Sütun adları farklıysa (ör. "Product", "Number", "Amount"), aralığı {"Product1":"Amount3"} biçiminde belirtmelisiniz; burada:

• Product ilk sütunun adıdır • 1 sütun numarasının 1 olduğunu belirtir • Tutar üçüncü sütunun adıdır • 3 sütun numarasının 3 olduğunu belirtir