• Bahasa Indonesia

      • Formula

      Pendahuluan

      Di NocoBase, formula (Formula) digunakan untuk menghitung nilai field berdasarkan ekspresi.

      Field formula cocok untuk skenario seperti perhitungan jumlah, perhitungan skor, penggabungan teks, dan perhitungan bersyarat. Nilainya biasanya dihasilkan oleh ekspresi, sehingga tidak cocok untuk diisi langsung secara manual.

      Jika hasilnya perlu diisi secara manual, pilih field dasar yang sesuai. Jika logika perhitungannya sangat kompleks, pertimbangkan untuk menanganinya dengan workflow atau view database.

      Skenario penggunaan

      Formula cocok untuk skenario bisnis berikut:

      • Subtotal jumlah pesanan dan jumlah termasuk pajak
      • Skor, skor berbobot, dan skor kinerja
      • Nama tampilan setelah penggabungan teks
      • Hasil bisnis yang dihitung berdasarkan kondisi

      Pembuatan dan konfigurasi

      Di halaman「Configure fields」pada tabel data, klik「Add field」, lalu pilih「Formula」untuk membuat field formula.

      20240512173541

      KonfigurasiDeskripsi
      Field interfaceJenis antarmuka field. Formula sesuai dengan formula, yang menentukan cara field diisi dan ditampilkan di halaman.
      Field display nameNama yang ditampilkan untuk field di antarmuka, misalnya「Subtotal pesanan」「Skor keseluruhan」「Nama tampilan」. Sebaiknya gunakan nama yang dapat langsung dipahami oleh pengguna bisnis.
      Field nameNama identifikasi field yang digunakan untuk referensi internal seperti API, field relasi, izin, dan workflow. Setelah dibuat biasanya tidak dapat diubah, hanya mendukung huruf, angka, dan garis bawah, serta harus diawali huruf.
      Field typeJenis field pada lapisan data. Field formula menggunakan formula, sedangkan jenis hasilnya bergantung pada konfigurasi formula.
      Default valueNilai default. Saat membuat record baru, jika pengguna tidak mengisinya, nilai default dapat diisi secara otomatis.
      Validation rulesAturan validasi. Hal yang utama adalah memastikan ekspresi formula lengkap dan field yang direferensikan tersedia.
      DescriptionDeskripsi field. Cocok digunakan untuk menjelaskan arti field, persyaratan pengisian, sumber data, atau pihak yang memeliharanya.
      Perhatian

      Setelah dibuat, nama field akan direferensikan oleh blok halaman, izin, workflow, dan API. Pastikan penamaan sebelum membuatnya untuk menghindari biaya penyesuaian konfigurasi di kemudian hari.

      Fitur field

      Perilaku default field formula adalah sebagai berikut:

      FiturDeskripsi
      Default Field interfaceformula.
      Default Field typeformula.
      Field type yang dapat dipilihformula.
      Komponen halamanDalam mode pengeditan biasanya dikonfigurasi dengan ekspresi formula, sedangkan dalam mode tampilan menampilkan hasil perhitungan.
      FilterKemungkinan untuk memfilter bergantung pada hasil formula dan cara eksekusinya.
      PengurutanKemungkinan untuk mengurutkan bergantung pada hasil formula dan cara eksekusinya.
      ValidasiBergantung pada ekspresi formula dan jenis hasil.

      Pengeditan konfigurasi

      Setelah dibuat, klik「Edit」di sebelah kanan field untuk mengedit konfigurasi field formula. Pengeditan field terutama digunakan untuk menyesuaikan cara field ditampilkan dan digunakan di NocoBase, seperti mengubah nama tampilan, deskripsi, nilai default, aturan validasi, atau konfigurasi khusus field.

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

      KonfigurasiDapat dieditDeskripsi
      Field display nameYaMengubah nama tampilan field di antarmuka tanpa mengubah nama identifikasi field.
      Field nameTidakNama identifikasi field biasanya tidak dapat diubah melalui formulir pengeditan setelah dibuat.
      Field interfaceDukungan bersyaratField dari database utama atau field yang disinkronkan dapat disesuaikan saat pemetaan field. Penyesuaian akan memengaruhi cara halaman menerima input, menampilkan, dan memvalidasi data.
      Field typeDukungan bersyaratField dari database utama atau field yang disinkronkan dapat disesuaikan saat pemetaan field. Sebelum menyesuaikannya, pastikan data yang ada dapat digunakan dengan jenis baru.
      Default valueYaMenyesuaikan nilai default saat membuat record baru.
      Validation rulesYaMenyesuaikan aturan validasi field.
      DescriptionYaMelengkapi arti field, persyaratan pengisian, sumber data, atau pihak yang memeliharanya.
      Perhatian

      Mengganti Field type atau Field interface bukan sekadar mengubah nama tampilan. Perubahan ini akan memengaruhi cara field disimpan, komponen input, aturan validasi, kondisi filter, dan cara variabel workflow digunakan. Jika jumlah data yang ada cukup banyak, pastikan terlebih dahulu format datanya sesuai.

      Penghapusan field

      Klik「Delete」di sebelah kanan field untuk menghapus field formula. Di database utama, Anda juga dapat memilih beberapa field sekaligus untuk menghapusnya secara massal.

      Saat menghapus field formula yang dibuat di database utama, kolom sebenarnya di database beserta data yang sudah ada di kolom tersebut biasanya juga akan dihapus. Saat menghapus field yang disinkronkan dari database atau dipetakan dari sumber data eksternal, cakupan dampaknya bergantung pada sumber data dan asal field terkait.

      Peringatan

      Penghapusan field dapat memengaruhi blok halaman, formulir, filter, izin, workflow, API, impor dan ekspor, serta data yang sudah ada. Sebelum menghapus, pastikan field tersebut tidak lagi direferensikan oleh konfigurasi bisnis.

      Penggunaan dalam konfigurasi halaman

      Field formula cocok digunakan untuk menampilkan hasil perhitungan dalam tabel, detail, statistik, dan workflow. 20260710151619

      SkenarioPenggunaan
      Konfigurasi fieldMenulis ekspresi formula dan memilih field yang direferensikan.
      Blok tabelMenampilkan hasil perhitungan.
      Blok detailMenampilkan hasil perhitungan untuk satu record.
      WorkflowMembaca hasil formula untuk digunakan dalam penilaian berikutnya.

      Tautan terkait

      • Field — Memahami fungsi, klasifikasi, dan logika pemetaan field
      • Tabel biasa — Membuat dan mengelola field dalam tabel biasa
      • Angka — Menyimpan nilai numerik yang digunakan dalam perhitungan
      • JSON — Menyimpan hasil terstruktur