URL Lampiran

Pengenalan

Di NocoBase, URL lampiran (Attachment URL) digunakan untuk menyimpan alamat akses file eksternal.

Kolom URL lampiran cocok untuk skenario ketika file sudah disimpan di sistem eksternal, penyimpanan objek, atau CDN, dan hanya alamat aksesnya yang perlu disimpan di NocoBase.

Jika file perlu diunggah dan dikelola oleh NocoBase, pilih Lampiran. Jika hanya berupa alamat halaman web biasa, pilih URL.

Skenario penggunaan

URL lampiran cocok untuk skenario bisnis berikut:

  • Alamat file di penyimpanan objek eksternal
  • Alamat gambar CDN
  • Alamat dokumen sistem pihak ketiga
  • Tautan file setelah migrasi data historis

Membuat konfigurasi

Pada halaman «Configure fields» tabel data, klik «Add field», lalu pilih «URL lampiran» untuk membuat kolom URL lampiran.

20241017092323

20241017092456

20241017092759

KonfigurasiKeterangan
Field interfaceJenis antarmuka kolom. URL lampiran sesuai dengan attachmentUrl, yang menentukan cara memasukkan dan menampilkannya di halaman.
Field display nameNama yang ditampilkan untuk kolom di antarmuka, misalnya «Alamat file», «URL gambar», atau «Lampiran eksternal». Sebaiknya gunakan nama yang mudah dipahami langsung oleh staf bisnis.
Field nameNama identifikasi kolom yang digunakan untuk referensi internal seperti API, kolom relasi, izin, dan alur kerja. Biasanya tidak diubah setelah dibuat, hanya mendukung huruf, angka, dan garis bawah, serta harus diawali dengan huruf.
Field typeJenis kolom pada lapisan data. URL lampiran biasanya menggunakan string atau text untuk menyimpan alamat.
Default valueNilai default. Saat menambahkan catatan baru, nilai default dapat diisi otomatis jika pengguna tidak mengisinya.
Validation rulesAturan validasi. Dapat digunakan untuk mengatur format URL, panjang, atau kewajiban pengisian.
DescriptionKeterangan kolom. Cocok untuk menjelaskan arti kolom, persyaratan pengisian, sumber data, atau pihak yang bertanggung jawab memeliharanya.
Perhatian

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

Karakteristik kolom

Perilaku default kolom URL lampiran adalah sebagai berikut:

KarakteristikKeterangan
Field interface defaultattachmentUrl.
Field type defaultstring.
Field type yang tersediastring, text, sesuai dengan konfigurasi kolom aktual.
Komponen halamanMode pengeditan menggunakan komponen input URL atau alamat lampiran.
FilterMendukung filter berbasis teks dan pemeriksaan nilai kosong.
PengurutanBiasanya tidak digunakan untuk pengurutan.
ValidasiMendukung validasi format URL, panjang, kewajiban pengisian, dan lainnya.

Mengedit konfigurasi

Setelah dibuat, klik «Edit» di sebelah kanan kolom untuk mengedit konfigurasi kolom URL lampiran. Pengeditan kolom terutama digunakan untuk menyesuaikan cara kolom ditampilkan dan digunakan di NocoBase, seperti mengubah nama tampilan, keterangan, nilai default, aturan validasi, atau konfigurasi khusus kolom.

Jika kolom berasal dari tabel yang sudah disinkronkan di database utama, pengeditan biasanya dilakukan untuk pemetaan kolom—memetakan kolom database ke Field type dan Field interface NocoBase.

KonfigurasiDapat dieditKeterangan
Field display nameYaMengubah nama kolom yang ditampilkan di antarmuka tanpa mengubah nama identifikasi kolom.
Field nameTidakNama identifikasi kolom biasanya tidak dapat diubah melalui formulir pengeditan setelah kolom dibuat.
Field interfaceDengan syaratKolom database utama atau kolom tersinkron dapat disesuaikan saat pemetaan kolom. Penyesuaian ini akan memengaruhi cara memasukkan, menampilkan, dan memvalidasi data di halaman.
Field typeDengan syaratKolom database utama atau kolom tersinkron dapat disesuaikan saat pemetaan kolom. Sebelum menyesuaikannya, pastikan data yang ada dapat digunakan dengan jenis baru tersebut.
Default valueYaMenyesuaikan nilai default saat menambahkan catatan baru.
Validation rulesYaMenyesuaikan aturan validasi kolom.
DescriptionYaMenambahkan arti kolom, persyaratan pengisian, sumber data, atau pihak yang bertanggung jawab memeliharanya.
Perhatian

Mengganti Field type atau Field interface bukan sekadar mengubah nama tampilan. Hal ini akan memengaruhi cara penyimpanan kolom, 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 kolom

Klik «Delete» di sebelah kanan kolom untuk menghapus kolom URL lampiran. Di database utama, Anda juga dapat memilih beberapa kolom lalu menghapusnya secara massal.

Saat menghapus kolom URL lampiran yang dibuat di database utama, kolom fisik di database beserta data yang ada di dalamnya biasanya juga akan dihapus. Saat menghapus kolom yang disinkronkan dari database atau dipetakan dari sumber data eksternal, cakupan dampaknya bergantung pada sumber data dan asal kolom terkait.

Peringatan

Penghapusan kolom dapat memengaruhi blok halaman, formulir, filter, izin, alur kerja, API, impor dan ekspor, serta data yang ada. Pastikan sebelum menghapus bahwa kolom tersebut tidak lagi digunakan oleh konfigurasi bisnis.

Penggunaan dalam konfigurasi halaman

Kolom URL lampiran cocok untuk menampilkan dan mengakses file eksternal. 20260709231803

SkenarioKegunaan
Blok formulirMemasukkan alamat file eksternal.
Blok detailMenampilkan tautan file.
Blok tabelMenampilkan tautan atau akses cepat ke thumbnail.
Alur kerjaMemasukkan alamat file ke dalam notifikasi atau permintaan eksternal.

Tautan terkait

  • Kolom — Memahami fungsi, klasifikasi, dan logika pemetaan kolom
  • Tabel biasa — Membuat dan mengelola kolom dalam tabel biasa
  • Lampiran — Mengunggah dan mengaitkan file NocoBase
  • URL — Menyimpan tautan biasa