# 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)

<table><thead><tr><th width="188.26171875">Parametreler</th><th>Açıklama</th></tr></thead><tbody><tr><td>table_id </td><td>tablo ID'si</td></tr><tr><td>data</td><td>kaydedilecek verileri içeren bir sözlük.<br><br>Örnek: {"column_name1": "value1", "column_name2": "value2"}. Sütun yoksa oluşturulur.</td></tr></tbody></table>

Yanıt: yeni kayıt ID'si

### Örnek

<div data-with-frame="true"><figure><img src="/files/81335e1e90fcb664fa173d404fab048303a7d68f" alt="" width="563"><figcaption></figcaption></figure></div>

## Tablodaki mevcut bir kaydı düzenle

edit\_record(table\_id, record\_id, data)

<table><thead><tr><th width="304.22265625">Parametreler</th><th>Açıklama</th></tr></thead><tbody><tr><td>table_id</td><td>tablo ID'si</td></tr><tr><td>record_id</td><td>düzenlenen kayıt ID'si</td></tr><tr><td>data</td><td>düzenlenecek verileri içeren bir sözlük. Örnek: {"column_name1": "value3", "column_name2": "value4"}. Sütun yoksa oluşturulmaz.</td></tr></tbody></table>

Yanıt:

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

### Örnek

<div data-with-frame="true"><figure><img src="/files/56b59997f600b54b07ec68e92f48cb32fdf699e8" alt="" width="563"><figcaption></figcaption></figure></div>

## ID'sine göre tablodan bir kaydı sil

delete\_record(table\_id, record\_id)

<table><thead><tr><th width="298.4140625">Parametreler</th><th>Açıklama</th></tr></thead><tbody><tr><td>table_id</td><td>tablo ID'si</td></tr><tr><td>record_id</td><td> silinen kayıt ID'si</td></tr></tbody></table>

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)

<table><thead><tr><th width="304.22265625">Parametreler</th><th>Açıklama</th></tr></thead><tbody><tr><td>table_id</td><td>tablo ID'si</td></tr><tr><td>value</td><td>eşleştirilecek değer</td></tr><tr><td>find_in - </td><td>isteğe bağlı parametre. Arama yapılacak sütunun adı. Belirtilmezse, arama tüm sütunlarda yapılır.</td></tr><tr><td>return_from</td><td>isteğe bağlı parametre. Değerin döndürüleceği sütunun adı.</td></tr></tbody></table>

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

<div data-with-frame="true"><figure><img src="/files/fa3b3022dae4ee24611829bd89b89cea13097a66" alt=""><figcaption></figcaption></figure></div>

## Belirtilen kayıttan bir değer al

get\_record\_data(table\_id, record\_id)

<table><thead><tr><th width="298.4140625">Parametreler</th><th>Açıklama</th></tr></thead><tbody><tr><td>table_id</td><td>tablo ID'si</td></tr><tr><td>record_id</td><td>değerlerin alındığı kayıt ID'si</td></tr><tr><td>return_column</td><td>isteğe bağlı parametre. Değerin döndürülmesi gereken sütunun adı.</td></tr></tbody></table>

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?

<div data-with-frame="true"><figure><img src="/files/c7105e013282916ac1d60f0775c27f4a2ab8b7cc" alt="" width="220"><figcaption></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="/files/946e41fd963d0851f371af32ce5ab15af7c54426" alt=""><figcaption></figcaption></figure></div>

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

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

<div data-with-frame="true"><figure><img src="/files/20ab3f0a723ff06e1a7c4b6b68944abff1f8a3ab" alt="" width="563"><figcaption></figcaption></figure></div>

## 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.

<div data-with-frame="true"><figure><img src="/files/e3ce6d9b4cc26bc764a45961b02fc6aeec546de0" alt=""><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/70780cd7b73dfca35956ed54f818168182e036ee" alt="" width="563"><figcaption></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="/files/38ff99712fe8bfbe1b6bfd8e2daae015b80f7af9" alt="" width="375"><figcaption></figcaption></figure></div>

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.

<div data-with-frame="true"><figure><img src="/files/c4f6360e67970092b7a844ba862fd046eb3fd664" alt="" width="563"><figcaption></figcaption></figure></div>

## Belirtilen bir aralık içinde tablodan veri al

table\_read\_cells(table\_id, cell\_data) - aralıkları belirterek tablodan veri almayı sağlar.

<table><thead><tr><th width="286.37890625">Parametre</th><th>Açıklama</th></tr></thead><tbody><tr><td><mark style="color:kırmızı;"><strong>!</strong></mark> table_id</td><td>gerekli parametre, tablo ID'si</td></tr><tr><td><mark style="color:kırmızı;"><strong>!</strong></mark> cell_data</td><td>gerekli parametre, aralıkları içeren bir sözlük.<br><strong>cell_data</strong> örnek: <code>'{"a1":"a1", "a3": "b4", "c1": "c3"}'</code></td></tr></tbody></table>

İ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:

<div data-with-frame="true"><figure><img src="/files/321ec57dcd6f231e0c221fcf876b3d124d8de73d" alt="" width="563"><figcaption></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="/files/3616ef8584d9da0047fade7e33406be8b5719e0f" alt="" width="563"><figcaption></figcaption></figure></div>

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:

<div data-with-frame="true"><figure><img src="/files/67d00c22fbd1f488e36a03e60ba26e392ccd6539" alt="" width="563"><figcaption></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="/files/aac548805cd2a3a55b2280a042c93aeb7169c219" alt="" width="563"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/7f9fc24e448f3e6dcdb3a6966eb3957486fcc886" alt="" width="563"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/9a2887198a6f40f66bb9c1afa8738f7a91b3d7ba" alt="" width="563"><figcaption></figcaption></figure></div>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mavibot.ai/doc/tr/chatbot/functions/hesap-makinesi/tables.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.