Bahagian "Helaian" dalam MaviBot adalah alat untuk penyimpanan dan pengurusan data yang mudah dalam platform. Anda tidak perlu lagi bertukar antara perkhidmatan yang berbeza—semua helaian anda kini tersedia dalam satu projek.

Ciri-ciri:

  • Cipta helaian dengan sebarang bilangan baris dan lajur.
  • Simpan dan edit data tanpa alat atau perkhidmatan pihak ketiga.
  • Masukkan nilai, edit baris dan lajur, atau padamkannya terus melalui chatbot menggunakan fungsi.

Kelebihan:

  • Memudahkan pengurusan data: anda boleh memasukkan maklumat ke dalam jadual terus dari bot.
  • Fleksibel dan mudah digunakan: cipta seberapa banyak jadual yang anda perlukan dan sesuaikan untuk tugas perniagaan anda.

Urus jadual anda tanpa meninggalkan Mavibot

Jadual membantu perniagaan menstruktur data dan mempercepatkan proses.

Cara mencipta helaian

Untuk memulakan, pergi ke bahagian "Helaian" dalam projek yang diperlukan:

Seterusnya, anda akan melihat butang "Cipta helaian". Klik padanya untuk membuka tetingkap modal di mana anda perlu memasukkan nama jadual:

Masukkan nama untuk jadual dan klik "Selesai". Jadual baru kemudiannya akan dicipta dalam projek dan muncul di bahagian "Helaian".

Tetapan helaian

Selepas mencipta helaian, anda perlu menambah baris dan lajur. Untuk melakukan ini, cari butang "Pergi ke" pada jadual yang dikehendaki dan klik padanya:

Anda akan melihat tetapan berikut:

  1. Fungsi untuk menambah lajur:

а) untuk menambah lajur berhuruf

Butang ini menambah lajur berlabel A hingga Z ke jadual.

b) untuk menambah lajur dengan nama tersuai

Mengklik butang membuka modal di mana anda boleh menamakan lajur baru.

Masukkan nama dan klik "Selesai" untuk menambah lajur ke jadual.

  1. Butang untuk menambah baris:

  1. Eksport helaian

Membolehkan anda mengeksport helaian dalam format CSV dengan semua data dan nilai, contohnya, untuk memindahkan helaian ke projek Mavibot lain atau ke perkhidmatan hamparan lain.

  1. Ciri Import CSV membolehkan anda memuat naik data dari perkhidmatan luaran.

Ciri-ciri lain

Terdapat menu lungsur yang membolehkan anda melayari helaian dengan cepat tanpa meninggalkan bahagian utama.

Anda juga boleh mencipta jadual baru terus dari menu sisi.

Untuk memadam helaian, pergi ke bahagian utama:

Kemudian, cari butang Padam pada kad jadual yang ingin anda alih keluar.

Amaran!

Jadual yang dipadam tidak boleh dipulihkan.

Cara memasukkan nilai ke dalam helaian

Anda boleh memasukkan nilai ke dalam helaian secara manual:

Atau dengan menggunakan fungsi dalam chatbot.

Cara mencari ID helaian

Anda memerlukan ID Helaian untuk menggunakan fungsi chatbot yang berkaitan dengan jadual ini.

  1. Navigasi ke jadual anda. Cari jadual yang dikehendaki dalam senarai dan klik pada namanya untuk membukanya.
  2. Cari ID Jadual dalam bar alamat. Klik pada bar alamat penyemak imbas anda — ID Jadual ialah rentetan aksara unik di hujung URL.

  1. Contoh:
    Dalam URL seperti https://mavibot.ai/projects/11111/table/2
    ID Jadual ialah 2.
  2. Salin ID
    Pilih dan salin nombor ini dari bar alamat untuk digunakan dalam konfigurasi chatbot anda.

Cara mencipta rekod baru dalam helaian

new_record(table_id, data) – cipta entri baru dalam jadual dengan nilai yang ditentukan.

table_id – ID jadual

data – kamus yang mengandungi data yang akan dimasukkan. Contoh: {"column_name1": "value1", "column_name2": "value2"}. Jika lajur tidak wujud, ia akan dicipta. Respons: ID entri baru

Contoh

Cara mengedit rekod sedia ada dalam helaian

edit_record(table_id, record_id, data)

table_id – ID jadual

record_id – ID entri yang akan diedit

data – kamus yang mengandungi data yang akan dikemas kini. Contoh: {"column_name1": "value3", "column_name2": "value4"}. Jika lajur tidak wujud, ia TIDAK akan dicipta.

Respons: Mengembalikan data penuh entri yang diedit dalam format {"column_name1": "value3", "column_name2": "value4"}

Contoh

Cara memadam rekod helaian mengikut ID

delete_record(table_id, record_id)

table_id – ID jadual

record_id – ID entri yang akan dipadam

Respons:

{'message': 'Deleted entries: 1'}

Cara mencari rekod pertama dengan nilai yang ditentukan dalam helaian

find_record(table_id, value, find_in, return_from)

table_id – ID jadual

value – nilai yang hendak dicari

find_in – pilihan. Nama lajur untuk dicari. Jika tidak dinyatakan, carian akan dilakukan merentas semua lajur

return_from – pilihan. Nama lajur dari mana nilai akan dikembalikan

Respons: Jika return_from dinyatakan, nilai lajur yang ditentukan akan dikembalikan (jika wujud dalam jadual). Jika return_from tidak dinyatakan atau lajur tidak wujud, data penuh entri yang ditemui akan dikembalikan: {"column_name1": "value3", "column_name2": "value4"}

Contoh

Cara mendapatkan nilai daripada rekod yang ditentukan

get_record_data(table_id, record_id, return_column )

table_id – ID jadual

record_id – ID entri untuk mendapatkan nilai

return_column – pilihan. Nama lajur dari mana nilai akan dikembalikan

Respons: Jika entri ditemui, mengembalikan kamus seperti {"column_name1": "value1", "column_name2": "value2"}. Jika return_column disediakan dan lajur wujud, hanya nilai dari lajur tersebut akan dikembalikan.

Cara mendapatkan semua nilai semasa mencari merentas berbilang lajur

find_records_multiple_cols_list(table_id, column_data, return_col, with_index, delimiter, algorithm) – Gunakan fungsi ini apabila anda perlu mencari merentas berbilang lajur sekaligus dan mendapatkan senarai nilai dari lajur dalam baris di mana semua nilai ditemui. (Ini serupa dengan fungsi sheet_search_in_multiple_cols_return_list untuk Google Sheets.)

table_id — ID jadual

column_data — pertanyaan carian, iaitu apa yang anda ingin cari

return_col — nombor lajur dari mana nilai akan dikembalikan

with_index — indeks atau penomboran dalam senarai nilai yang ditemui (0 – penomboran (1, 2, 3,…); 1 – indeks baris; "" – senarai nilai pada baris baru tanpa indeks atau penomboran)

delimiter — pemisah antara indeks dan nilai

algorithm — algoritma carian (F – padanan tepat, K – padanan kata kunci, R – ungkapan biasa, 1–100 – peratusan persamaan (lihat butiran di atas))

Contoh:

table_id = 7

data = {"age": "26", "city": "New York"}

return_col = "name"

with_index = 1

delimiter = " - "

algorithm = "F"

res = find_records_multiple_cols_list(table_id, data, return_col, with_index, delimiter, algorithm)

res_list = res["list"]

Jika pertanyaan berjaya dilaksanakan, respons adalah kamus yang mengandungi status dan semua sel dengan nilai:

{"status":true,"rows_index":[2,3],"quantity":2,"list":"2 - John\n3 - Anna"}

status — hasil carian

rows_index — tatasusunan dengan nombor baris yang ditemui

quantity — bilangan baris yang ditemui

list — rentetan dengan semua nilai dari lajur yang dipilih

Jika ralat berlaku, respons akan menjadi status: false bersama dengan penerangan ralat: {"status": false, "error": "Error or description"}

Cara mendapatkan nilai pertama semasa mencari merentas berbilang lajur

find_first_record_multiple_cols_row(table_id, column_data, algorithm) – gunakan fungsi ini apabila anda perlu mencari merentas berbilang lajur sekaligus dan mendapatkan baris padanan pertama. (Ini serupa dengan fungsi sheet_search_in_multiple_cols_return_row untuk Google Sheets.)

table_id — ID jadual

columns — pertanyaan carian, iaitu apa yang anda ingin cari

algorithm — algoritma carian (F – padanan tepat, K – padanan kata kunci, R – ungkapan biasa, 1–100 – peratusan persamaan (lihat butiran di atas))

Contoh:

table_id = 7

data = {"age": "26", "city": "New York"}

algorithm = "F"

res = find_first_record_multiple_cols_row(table_id, data, algorithm)

row_data = res["row_data"]

row_id = row_data["ID"]

row_name = row_data["name"]

row_age = row_data["age"]

Jika pertanyaan berjaya dilaksanakan, respons adalah kamus yang mengandungi status dan semua sel dengan nilai.

{"status":true,"rows_index":[2,3],"quantity":2,"row_data":{"ID":2,"name":"John","age":"26","city":"New York"},"row":2}

status — hasil carian

rows_index — tatasusunan dengan nombor baris yang ditemui

row_data — data dari baris yang ditemui

row — nombor baris yang ditemui

Jika ralat berlaku, respons akan menjadi status: false bersama dengan penerangan ralat: {"status": false, "error": "Error or description"}