Field

Pengenalan

Di NocoBase, Field adalah atribut bisnis dalam Collection (tabel data) yang digunakan untuk mendeskripsikan data. Field menjelaskan informasi apa saja yang dapat disimpan dalam sebuah record, serta bagaimana informasi tersebut dimasukkan, ditampilkan, difilter, dan digunakan dalam logika bisnis di halaman.

DefinisiPenjelasan
Data apa yang disimpanMisalnya teks, angka, tanggal, file, status, relasi, dan JSON.
Cara digunakan di halamanMisalnya untuk memasukkan dan menampilkan data menggunakan kotak input, pemilih tanggal, menu tarik-turun, pengunggah lampiran, dan pemilih relasi.
Cara berpartisipasi dalam kemampuan bisnisField digunakan oleh blok halaman, filter, pengurutan, izin, alur kerja, API, impor dan ekspor data, serta fitur lainnya.

Field dapat merujuk pada:

  • Kolom database yang sebenarnya dalam database utama
  • Kolom database yang sudah ada dalam database eksternal
  • Field dalam view database
  • Field dalam hasil kueri SQL
  • Field dalam respons REST API
  • Field relasi, field sistem, atau field virtual dalam tabel data

Anggaplah Field sebagai “atribut dari objek bisnis”. Contohnya:

Objek bisnisField terkait
PelangganNama pelanggan, nomor ponsel, tingkat pelanggan, penanggung jawab
PesananNomor pesanan, jumlah pesanan, status pesanan, pelanggan
KontrakNama kontrak, tanggal penandatanganan, lampiran kontrak, status persetujuan
TugasJudul tugas, waktu tenggat, prioritas, pelaksana
FileNama file, ukuran, tipe MIME, URL

Skenario penggunaan

Di bawah ini adalah rangkuman skenario penggunaan umum berdasarkan kategori field. Bagian ini membantu Anda menentukan kategori field yang tepat. Untuk konfigurasi spesifik, pemetaan tipe, dan hal-hal yang perlu diperhatikan, lihat dokumentasi kategori terkait.

Kategori fieldSkenario penggunaan
Field teksCocok untuk menyimpan nama, nomor, keterangan, informasi kontak, alamat tautan, dan konten lainnya.
Field teks kayaCocok untuk menyimpan isi utama, dokumen penjelasan, solusi penanganan, potongan kode, dan konten kompleks lainnya.
Field angkaCocok untuk menyimpan jumlah, nominal, penilaian, persentase, dan nilai numerik lainnya.
Field tanggal dan waktuCocok untuk menyimpan titik waktu, tanggal, waktu, stempel waktu dari sistem eksternal, dan konten lainnya.
Field status dan opsiCocok untuk menyimpan nilai dalam rentang tetap, seperti apakah diaktifkan, status pesanan, tingkat pelanggan, dan label pelanggan.
Field lampiranCocok untuk mengunggah file atau menyimpan alamat file eksternal.
Field relasiCocok untuk menyatakan hubungan antara tabel data yang berbeda, seperti pesanan dimiliki pelanggan, pelanggan memiliki pesanan, dan pengguna terkait dengan peran.
Field identifikasi dan kodeCocok untuk menyimpan kunci utama internal, ID sinkronisasi eksternal, identifikasi akses publik, dan nomor bisnis.
Field geometriCocok untuk menyimpan informasi spasial atau geografis, seperti lokasi toko, rute pengiriman, dan area layanan.
Field sistemCocok untuk menyimpan informasi sistem yang dikelola oleh NocoBase atau database, seperti ID, waktu dibuat, pembuat, dan waktu diperbarui.
Field lainnyaCocok untuk menangani kebutuhan field seperti pengurutan, formula, dan JSON yang tidak secara langsung termasuk dalam kategori lainnya.

Tipe Interface pada field

NocoBase mengelompokkan field ke dalam kategori berikut dari perspektif Interface:

20240512110352

Tipe data field

Setiap Field Interface memiliki tipe data default. Misalnya, untuk field dengan Interface angka (Number), tipe data defaultnya adalah double, tetapi dapat juga berupa float, decimal, dan lainnya. Saat ini tipe data yang didukung meliputi:

20240512103733

Pemetaan tipe field

Proses penambahan field pada database utama adalah:

  1. Pilih tipe Interface
  2. Konfigurasikan tipe data yang tersedia untuk Interface saat ini

20240512172416

Proses pemetaan field pada sumber data eksternal adalah:

  1. Secara otomatis memetakan tipe field yang sesuai (Field type) dan tipe UI (Field Interface) berdasarkan tipe field dalam database eksternal.
  2. Jika diperlukan, ubah ke tipe data dan tipe Interface yang lebih sesuai

20240512172759