Teks multi-baris

Pengenalan

Di NocoBase, teks multi-baris (Multi-line text) digunakan untuk menyimpan konten teks yang memerlukan baris baru atau memiliki panjang yang cukup besar.

Teks multi-baris secara default menggunakan kotak input multi-baris, sehingga cocok untuk catatan, penjelasan, pendapat penanganan, dan konten lainnya. Teks ini dapat digunakan dalam filter, izin, kondisi alur kerja, dan kueri API.

Jika konten biasanya hanya terdiri dari satu baris, seperti nama, nomor, atau judul, sebaiknya pilih teks satu baris. Jika konten memerlukan tata letak, gambar, atau kemampuan teks kaya, pilih bidang teks kaya atau Markdown.

Skenario penggunaan

Teks multi-baris cocok untuk skenario bisnis berikut:

  • Catatan pelanggan, catatan pesanan, pendapat penanganan tiket
  • Alamat lengkap, deskripsi masalah, penjelasan kebutuhan
  • Rangkuman klausul kontrak, penjelasan latar belakang proyek
  • Konten teks yang perlu dimasukkan dalam beberapa baris

Pembuatan dan konfigurasi

Di halaman «Configure fields» pada tabel data, klik «Add field», lalu pilih «teks multi-baris» untuk membuat bidang teks multi-baris.

20240512165017

KonfigurasiPenjelasan
Field interfaceJenis antarmuka bidang. Teks multi-baris sesuai dengan textarea, yang menentukan cara memasukkan dan menampilkan data di halaman.
Field display nameNama yang ditampilkan bidang di antarmuka, misalnya «Catatan pelanggan», «Pendapat penanganan», atau «Alamat lengkap». Sebaiknya gunakan nama yang dapat langsung dipahami oleh pengguna bisnis.
Field nameNama identifikasi bidang yang digunakan untuk referensi internal seperti API, bidang relasi, izin, dan alur kerja. Setelah dibuat biasanya tidak dapat diubah, hanya mendukung huruf, angka, dan garis bawah, serta harus diawali dengan huruf.
Field typeJenis bidang pada lapisan data. Teks multi-baris secara default adalah text, dan juga dapat dipetakan menjadi string atau json sesuai dengan bidang sumber.
Default valueNilai default. Saat menambahkan rekaman, nilai default dapat diisi secara otomatis jika pengguna tidak mengisinya.
Validation rulesAturan validasi. Dapat membatasi panjang minimum, panjang maksimum, panjang tetap, penggunaan huruf besar atau kecil, maupun ekspresi reguler.
DescriptionDeskripsi bidang. Cocok untuk menuliskan makna bidang, persyaratan pengisian, sumber data, atau penanggung jawab pemeliharaan.
Perhatian

Nama bidang akan digunakan sebagai referensi oleh blok halaman, izin, alur kerja, dan API. Pastikan penamaannya sebelum membuat bidang untuk menghindari biaya penyesuaian konfigurasi di kemudian hari.

Karakteristik bidang

Perilaku default bidang teks multi-baris adalah sebagai berikut:

KarakteristikPenjelasan
Default Field interfacetextarea.
Default Field typetext.
Field type yang tersediatext, json, dan string.
Komponen halamanMode pengeditan menggunakan kotak input multi-baris.
FilterMendukung filter berbasis teks, seperti berisi, tidak berisi, kosong, tidak kosong, dan lainnya.
PengurutanBiasanya tidak disarankan untuk pengurutan. Kemampuan pengurutan bergantung pada database dan jenis bidang tertentu.
ValidasiMendukung validasi panjang minimum, panjang maksimum, panjang tetap, penggunaan huruf besar atau kecil, ekspresi reguler, dan lainnya.

Mengedit konfigurasi

Setelah dibuat, klik «Edit» di sebelah kanan bidang untuk mengedit konfigurasi bidang teks multi-baris. Pengeditan bidang terutama digunakan untuk menyesuaikan cara bidang ditampilkan dan digunakan di NocoBase, seperti mengubah nama tampilan, deskripsi, nilai default, aturan validasi, atau konfigurasi khusus bidang.

Jika bidang berasal dari tabel yang telah disinkronkan di database utama, pengeditan biasanya dilakukan untuk pemetaan bidang—memetakan bidang database menjadi Field type dan Field interface NocoBase.

KonfigurasiDapat dieditPenjelasan
Field display nameYaMengubah nama tampilan bidang di antarmuka tanpa mengubah nama identifikasinya.
Field nameTidakNama identifikasi bidang biasanya tidak dapat diubah melalui formulir pengeditan setelah dibuat.
Field interfaceDidukung dalam kondisi tertentuBidang database utama atau bidang tersinkronisasi dapat disesuaikan saat pemetaan bidang. Penyesuaian ini akan memengaruhi cara input, tampilan, dan validasi di halaman.
Field typeDidukung dalam kondisi tertentuBidang database utama atau bidang tersinkronisasi dapat disesuaikan saat pemetaan bidang. Sebelum menyesuaikannya, pastikan data yang ada dapat digunakan dengan jenis baru tersebut.
Default valueYaMenyesuaikan nilai default saat menambahkan rekaman.
Validation rulesYaMenyesuaikan aturan validasi bidang.
DescriptionYaMenambahkan makna bidang, persyaratan pengisian, sumber data, atau penanggung jawab pemeliharaan.
Perhatian

Mengganti Field type atau Field interface bukan sekadar mengubah nama tampilan. Hal ini akan memengaruhi cara penyimpanan bidang, komponen input, aturan validasi, kondisi filter, dan cara penggunaan variabel alur kerja. Jika jumlah data yang ada cukup banyak, pastikan terlebih dahulu format datanya sesuai.

Menghapus bidang

Klik «Delete» di sebelah kanan bidang untuk menghapus bidang teks multi-baris. Di database utama, Anda juga dapat memilih beberapa bidang lalu menghapusnya secara massal.

Saat menghapus bidang teks multi-baris yang dibuat di database utama, kolom aktual di database beserta data yang ada di dalamnya biasanya akan ikut dihapus. Saat menghapus bidang yang disinkronkan dari database atau dipetakan dari sumber data eksternal, cakupan dampaknya bergantung pada sumber data dan asal bidang terkait.

Peringatan

Penghapusan bidang dapat memengaruhi blok halaman, formulir, filter, izin, alur kerja, API, impor dan ekspor, serta data yang ada. Pastikan terlebih dahulu apakah bidang tersebut masih digunakan oleh konfigurasi bisnis.

Penggunaan dalam konfigurasi halaman

Bidang teks multi-baris cocok untuk menampilkan konten panjang dalam formulir dan detail.

20260709224428

SkenarioPenggunaan
Blok formulirMemasukkan atau mengedit catatan, penjelasan, pendapat penanganan, dan konten lainnya.
Blok detailMenampilkan konten teks yang panjang.
Blok tabelMenampilkan ringkasan; konten yang terlalu panjang biasanya akan dipotong.
Alur kerja dan izinDigunakan sebagai bidang kondisi dalam penilaian, misalnya untuk memeriksa apakah catatan kosong.

Tautan terkait

  • Bidang — Pelajari fungsi, klasifikasi, dan logika pemetaan bidang
  • Tabel biasa — Membuat dan mengelola bidang dalam tabel biasa
  • Teks satu baris — Menyimpan konten teks pendek yang panjangnya tidak lebih dari satu baris
  • Markdown — Menyimpan konten dengan format Markdown
  • Teks kaya — Menyimpan konten dengan tata letak yang kompleks