• Bahasa Indonesia

      • Tabel Umum

      Data Source: Main DatabaseCommunity Edition+

      Pengenalan

      Tabel umum adalah jenis tabel data yang paling sering digunakan dan cocok untuk menyimpan data bisnis rutin seperti pelanggan, pesanan, kontrak, tiket kerja, formulir penggantian biaya, proyek, dan tugas. Jika sebagian besar objek bisnis tidak memiliki persyaratan struktur khusus, tabel umum sudah cukup untuk digunakan secara default.

      Tabel umum dapat berasal dari sumber data berikut:

      • Tabel baru yang dibuat di database utama
      • Tabel nyata yang sudah ada dan disinkronkan dari database utama
      • Tabel nyata yang sudah ada dari database eksternal
      • Sumber daya yang dipetakan melalui REST API
      • Tabel data dari aplikasi NocoBase eksternal

      Di NocoBase, semua data ini digunakan sebagai tabel umum. Perbedaannya adalah: tabel umum di database utama dapat dibuat dan dikelola struktur tabel nyatanya oleh NocoBase; sedangkan tabel umum dari sumber data eksternal biasanya hanya membaca struktur yang sudah ada, dan struktur tabel nyata tetap dikelola oleh sistem eksternal.

      Skenario penggunaan

      Tabel umum cocok untuk skenario bisnis berikut:

      • Data CRM seperti pelanggan, kontak, peluang, dan kontrak
      • Data transaksi seperti pesanan, surat jalan, retur, dan faktur
      • Data kolaborasi seperti tiket kerja, tugas, proyek, dan kebutuhan
      • Data proses seperti formulir penggantian biaya, pesanan pembelian, dan permohonan pembayaran
      • Data dasar seperti perangkat, aset, produk, dan toko

      Pembuatan dan konfigurasi

      Di database utama, klik «Create collection», lalu pilih «General collection» untuk membuat tabel umum.

      20240324085739

      KonfigurasiPenjelasan
      Collection display nameNama tabel yang ditampilkan di antarmuka, misalnya «Pelanggan», «Pesanan», atau «Lampiran kontrak». Sebaiknya gunakan nama yang dapat langsung dipahami oleh pengguna bisnis.
      Collection nameNama identitas tabel yang digunakan untuk referensi internal seperti API, field relasi, izin, dan workflow. Nama ini dibuat secara otomatis, tetapi juga dapat diubah secara manual; hanya mendukung huruf, angka, dan garis bawah, serta harus diawali dengan huruf.
      CategoriesKategori tabel data. Kategori hanya memengaruhi cara tabel data diatur dalam antarmuka pengelolaan, dan tidak mengubah struktur tabel data. Jika tabel data cukup banyak, sebaiknya kelompokkan berdasarkan modul bisnis, misalnya «Manajemen pelanggan», «Manajemen proyek», dan «Keuangan».
      DescriptionKeterangan tabel data. Anda dapat menuliskan data apa yang disimpan, siapa yang mengelolanya, dan proses bisnis apa yang terkait untuk memudahkan pemeliharaan selanjutnya.
      Use simple pagination modeMode pagination sederhana. Setelah diaktifkan, pagination pada blok tabel akan melewati penghitungan jumlah total record. Mode ini cocok untuk tabel dengan volume data sangat besar dan dapat mengurangi beban kueri.
      Preset fieldsField prasetel. Saat membuat tabel, Anda dapat memilih apakah akan menambahkan field umum secara otomatis, seperti ID, waktu dibuat, pembuat, waktu diperbarui, dan pengubah. Untuk tabel bisnis umum, sebaiknya field-field ini tetap dipertahankan.

      Field bawaan

      Saat membuat tabel umum, Anda dapat menggunakan Preset fields untuk menambahkan field sistem umum secara otomatis.

      FieldNama fieldPenjelasan
      IDidField primary key default yang digunakan untuk mengidentifikasi satu record secara unik. Tipe primary key default adalah Snowflake ID (53-bit).
      Waktu dibuatcreatedAtMencatat waktu pembuatan record secara otomatis. Umumnya digunakan untuk pengurutan, pemfilteran, audit, dan kondisi workflow.
      PembuatcreatedByMencatat pengguna yang membuat record secara otomatis. Umumnya digunakan untuk «hanya melihat data yang saya buat», kontrol izin, dan pelacakan tanggung jawab.
      Waktu diperbaruiupdatedAtMencatat waktu pembaruan terakhir record secara otomatis. Umumnya digunakan untuk menentukan apakah data telah diubah.
      PengubahupdatedByMencatat pengguna yang terakhir memperbarui record secara otomatis. Umumnya digunakan dalam skenario audit dan kolaborasi.
      RuangspaceTersedia setelah plugin multi-ruang diaktifkan, dan digunakan untuk mengisolasi data berdasarkan ruang. Jika multi-ruang tidak diaktifkan, field ini tidak akan muncul dalam field prasetel tabel umum.

      Field primary key

      Primary key menandai field primary key. Field ini digunakan untuk mengidentifikasi satu record secara unik pada tingkat database. Saat membuat tabel, sebaiknya pertahankan field prasetel ID; tipe primary key default adalah Snowflake ID (53-bit).

      20251209210153

      Arahkan kursor ke Interface pada field ID untuk memilih tipe primary key lainnya.

      20251209210517

      Tipe primary key yang tersedia:

      Perhatian

      Tabel data tanpa primary key harus menetapkan «Record unique key» saat mengedit tabel data. Jika tidak, blok tidak dapat dibuat di halaman dan record tidak dapat dilihat atau diedit dengan benar.

      Penggunaan dalam konfigurasi halaman

      Tabel umum dapat digunakan untuk sebagian besar blok data dan blok pemfilteran.

      BlokKegunaan
      Blok tabelMelihat, memfilter, mengurutkan, dan memproses record secara massal.
      Blok formulirMenambahkan atau mengedit satu record.
      Blok detailMelihat detail satu record.
      Blok daftarMenampilkan record dalam bentuk daftar.
      Blok kartu gridMenampilkan record seperti gambar, file, produk, dan aset dalam bentuk grid kartu.
      Blok kanbanMenampilkan record secara berkelompok berdasarkan field seperti status, tahap, dan penanggung jawab.
      Blok kalenderMenampilkan record berdasarkan tanggal atau rentang waktu.
      Blok grafikMembuat grafik statistik berdasarkan record.
      Blok petaMenampilkan record berdasarkan lokasi geografis.
      Blok GanttMenampilkan rencana proyek dan jadwal tugas berdasarkan waktu mulai dan selesai.
      Blok filter formulirMemfilter blok data pada halaman menggunakan kondisi formulir.
      Blok filter pohonMemfilter blok data pada halaman menggunakan struktur pohon, yang umumnya digunakan untuk pemfilteran hierarkis berdasarkan kategori, organisasi, wilayah, dan sebagainya.

      Mengedit konfigurasi

      Dalam daftar tabel data, klik «Edit» di sebelah kanan tabel umum untuk mengubah konfigurasi dasar tabel data. Pengeditan tabel data terutama digunakan untuk menyesuaikan metadata tabel data dan sebagian konfigurasi runtime, bukan untuk mengubah struktur field secara massal.

      Jika ingin menambahkan field, mengubah tipe field, menyesuaikan tipe antarmuka field, atau menghapus field, buka «Configure fields».

      edit_collection

      edit_collection_configure

      KonfigurasiDapat dieditPenjelasan
      Collection display nameYaNama tabel yang ditampilkan di antarmuka, misalnya «Pelanggan», «Pesanan», atau «Lampiran kontrak». Setelah diubah, hanya tampilan di antarmuka yang terpengaruh, bukan nama identitas tabel.
      Collection nameTidakNama identitas tabel yang digunakan untuk referensi internal seperti API, field relasi, izin, dan workflow. Setelah dibuat, nama ini tidak dapat diubah dalam formulir pengeditan.
      InheritsMendukung dengan syaratMemilih tabel induk yang akan diwarisi. Hanya tersedia jika database utama adalah PostgreSQL dan konfigurasi ini ditampilkan di antarmuka. Sebelum menyesuaikan relasi pewarisan tabel data yang sudah ada, pastikan struktur field, blok halaman, izin, dan workflow tidak bergantung pada struktur sebelumnya.
      CategoriesYaKategori tabel data. Kategori hanya memengaruhi cara tabel data diatur dalam antarmuka pengelolaan, dan tidak mengubah struktur tabel data.
      DescriptionYaKeterangan tabel data. Cocok digunakan untuk melengkapi informasi tentang tujuan tabel, pengelola, sumber data, dan proses bisnis terkait.
      Use simple pagination modeYaMode pagination sederhana. Setelah diaktifkan, pagination pada blok tabel akan melewati penghitungan jumlah total record. Mode ini cocok untuk tabel dengan volume data sangat besar.
      Record unique keyYaIdentitas unik record. Digunakan untuk menemukan satu record dalam blok, biasanya dengan memilih primary key atau field unik. Tabel data tanpa primary key wajib mengonfigurasi opsi ini; jika tidak, blok tidak dapat dibuat dengan benar dan record tidak dapat dilihat atau diedit.
      Perhatian

      Mengedit tabel data tidak akan menyesuaikan field yang sudah ada secara otomatis. Preset fields hanya berlaku saat tabel dibuat; jika setelah pembuatan Anda masih perlu menambahkan field seperti waktu dibuat, pembuat, waktu diperbarui, dan pengubah, tambahkan field tersebut secara terpisah melalui «Configure fields».

      Menghapus tabel data

      Dalam daftar tabel data, klik «Delete» di sebelah kanan tabel umum untuk menghapus tabel data. Tabel umum di database utama juga mendukung penghapusan secara bersamaan setelah dipilih secara massal.

      delete_collection

      Konfirmasi kedua akan muncul saat penghapusan. Setelah dikonfirmasi, NocoBase akan menghapus metadata Collection tabel umum ini serta tabel data nyata dan datanya di database utama.

      delete_collection_second_confirmation

      Pada dialog konfirmasi penghapusan terdapat opsi yang dapat dipilih: menghapus objek yang bergantung pada tabel data ini secara otomatis. Setelah diaktifkan, NocoBase akan mencoba menghapus sekaligus objek database yang bergantung pada tabel ini, seperti view database yang dibuat berdasarkan tabel ini, serta objek lain yang masih bergantung pada objek-objek tersebut.

      Peringatan

      Menghapus tabel umum adalah tindakan berisiko tinggi. Setelah dihapus, struktur tabel, data tabel, metadata field, serta blok halaman, field relasi, izin, workflow, dan pemanggilan API yang bergantung pada tabel ini mungkin tidak lagi berfungsi. Sebelum mencentang opsi penghapusan otomatis objek dependen, pastikan objek-objek tersebut juga boleh dihapus.