• Bahasa Indonesia

      • UUID

      Pengenalan

      Di NocoBase, UUID (UUID) digunakan untuk menghasilkan identifikasi unik UUID.

      UUID cocok untuk skenario sinkronisasi lintas sistem, identifikasi API publik, impor dan ekspor, serta lainnya. Dibandingkan ID auto-increment, UUID lebih sulit mengungkapkan skala data.

      Jika hanya digunakan sebagai kunci utama default internal NocoBase, Snowflake ID biasanya sudah cukup. Jika memerlukan nomor pendek, pilih Nano ID atausekuens.

      Skenario penggunaan

      UUID cocok untuk skenario bisnis berikut:

      • ID sinkronisasi sistem eksternal
      • Identifikasi API publik
      • Identifikasi catatan saat migrasi lintas database
      • ID catatan yang tidak ingin memperlihatkan pola kenaikan

      Membuat konfigurasi

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

      20240512173354

      KonfigurasiDeskripsi
      Field interfaceJenis antarmuka field. UUID terkait dengan uuid, yang menentukan cara input dan penampilannya di halaman.
      Field display nameNama yang ditampilkan field di antarmuka, misalnya「UUID」「Identifikasi eksternal」「ID publik」. Sebaiknya gunakan nama yang dapat langsung dipahami oleh pengguna bisnis.
      Field nameNama identifikasi field, digunakan untuk referensi internal seperti API, field relasi, izin, dan workflow. Biasanya tidak diubah setelah dibuat, hanya mendukung huruf, angka, dan garis bawah, serta harus diawali huruf.
      Field typeJenis field pada lapisan data. Field UUID secara default adalah uuid.
      Default valueNilai default. Saat menambahkan catatan, nilai default dapat diisi otomatis jika pengguna tidak mengisinya.
      Validation rulesBiasanya dibuat otomatis oleh sistem dan tidak perlu divalidasi secara manual.
      DescriptionDeskripsi field. Cocok untuk menjelaskan makna field, persyaratan pengisian, sumber data, atau penanggung jawab pemeliharaan.
      Perhatian

      Nama field akan dirujuk oleh blok halaman, izin, workflow, dan API setelah dibuat. Pastikan penamaannya sebelum membuat field untuk menghindari biaya penyesuaian konfigurasi di kemudian hari.

      Karakteristik field

      Perilaku default field UUID adalah sebagai berikut:

      KarakteristikDeskripsi
      Default Field interfaceuuid.
      Default Field typeuuid.
      Field type yang tersediauuid.
      Komponen halamanBiasanya dibuat secara otomatis dan tidak perlu diisi secara manual.
      FilterMendukung pencarian tepat berdasarkan UUID.
      PengurutanMendukung pengurutan, tetapi UUID biasanya tidak digunakan untuk pengurutan bisnis.
      ValidasiBiasanya dibuat secara otomatis dan dijaga keunikannya.

      Mengedit konfigurasi

      Setelah dibuat, klik「Edit」di sebelah kanan field untuk mengedit konfigurasi field UUID. 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 di database utama, pengeditan biasanya dilakukan sebagai pemetaan field—memetakan field database ke Field type dan Field interface NocoBase.

      KonfigurasiDapat dieditDeskripsi
      Field display nameYaMengubah nama tampilan field di antarmuka tanpa mengubah nama identifikasi field.
      Field nameTidakNama identifikasi field biasanya tidak dapat diubah dalam formulir pengeditan setelah dibuat.
      Field interfaceDidukung dengan syaratField database utama atau field tersinkronisasi dapat disesuaikan saat pemetaan field. Penyesuaian ini akan memengaruhi cara input, tampilan, dan validasi di halaman.
      Field typeDidukung dengan syaratField database utama atau field tersinkronisasi dapat disesuaikan saat pemetaan field. Sebelum menyesuaikannya, pastikan data yang ada dapat digunakan dengan jenis baru tersebut.
      Default valueYaMenyesuaikan nilai default saat menambahkan catatan baru.
      Validation rulesYaMenyesuaikan aturan validasi field.
      DescriptionYaMelengkapi makna field, 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 field, komponen input, aturan validasi, kondisi filter, dan cara penggunaan variabel workflow. Jika jumlah data yang ada cukup banyak, pastikan terlebih dahulu format data sesuai.

      Menghapus field

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

      Saat menghapus field UUID yang dibuat di database utama, biasanya kolom aktual di database beserta data yang ada di kolom tersebut 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. Pastikan terlebih dahulu apakah field masih dirujuk oleh konfigurasi bisnis.

      Penggunaan dalam konfigurasi halaman

      Field UUID cocok digunakan dalam skenario integrasi dan identifikasi publik. 20260710145759

      SkenarioPenggunaan
      Membuat tabelDigunakan sebagai kunci utama atau identifikasi unik.
      APIDigunakan sebagai identifikasi catatan publik.
      Sinkronisasi dataMenyinkronkan catatan lintas sistem.
      Impor dan eksporMempertahankan keunikan catatan.

      Tautan terkait

      • Field — Pelajari fungsi, klasifikasi, dan logika pemetaan field
      • Tabel biasa — Membuat dan mengelola field dalam tabel biasa
      • Snowflake ID — Menggunakan Snowflake ID default
      • Nano ID — Menggunakan ID acak pendek