• Bahasa Indonesia

      • Koleksi File

      Pengenalan

      Koleksi file cocok untuk menyimpan metadata file, seperti nama file, ekstensi, ukuran, tipe MIME, path, URL, alamat pratinjau, lokasi penyimpanan, dan meta kustom. File itu sendiri disimpan oleh mesin penyimpanan file, sedangkan koleksi file menyimpan metadata file.

      Koleksi file hanya dapat dibuat melalui halaman database utama. Database eksternal, sumber data REST API, dan sumber data NocoBase eksternal tidak mendukung pembuatan koleksi file.

      Skenario penggunaan

      Koleksi file cocok untuk skenario bisnis berikut:

      • Lampiran kontrak, file faktur, bukti penggantian biaya
      • Gambar produk, dokumen identitas karyawan, dokumen proyek
      • File yang diunggah, dipratinjau, dan diunduh dari catatan bisnis
      • Repositori lampiran yang memerlukan pengelolaan metadata file secara terpisah

      Alur penggunaan

      Koleksi file biasanya tidak digunakan secara langsung sebagai tabel bisnis utama. Alur yang umum adalah:

      1. Membuat koleksi file untuk menyimpan metadata seperti judul file, nama file, ukuran, tipe, URL, dan lokasi penyimpanan.
      2. Membuat field relasi di tabel bisnis untuk menghubungkannya ke koleksi file. Misalnya, menghubungkan tabel「Lampiran Kontrak」ke koleksi file「Lampiran Kontrak」.
      3. Menambahkan field relasi di blok formulir tabel bisnis, sehingga pengguna dapat mengunggah file saat menambahkan atau mengedit catatan bisnis.
      4. Setelah pengunggahan selesai, NocoBase akan menulis metadata file ke koleksi file dan menghubungkan catatan file dengan catatan bisnis saat ini melalui field relasi.
      5. Menampilkan field lampiran di blok detail, blok tabel, atau blok daftar tabel bisnis, sehingga pengguna dapat melihat, mempratinjau, atau mengunduh file.

      Konfigurasi pembuatan

      Di database utama, klik「Create collection」, lalu pilih「File collection」untuk membuat koleksi file.

      20240324090414

      Konfigurasi pembuatan koleksi file pada dasarnya sama dengan tabel biasa. Koleksi file telah dilengkapi sekumpulan field metadata file bawaan untuk menyimpan judul, path, URL, lokasi penyimpanan, dan informasi ekstensi file yang diunggah.

      KonfigurasiKeterangan
      Collection display nameNama yang ditampilkan untuk tabel di antarmuka, misalnya「Lampiran Kontrak」「File Faktur」「Gambar Produk」。
      Collection nameNama identifikasi tabel, yang digunakan untuk referensi internal seperti API, field relasi, izin, dan alur kerja.
      CategoriesKategori tabel. Kategori hanya memengaruhi cara pengorganisasian antarmuka pengelolaan tabel, bukan struktur tabel.
      DescriptionDeskripsi tabel. Anda dapat menjelaskan file apa yang disimpan oleh koleksi file ini, siapa yang mengunggahnya, dan tabel bisnis mana yang terkait.
      Preset fieldsField prasetel. Saat membuat koleksi file, sebaiknya pertahankan field sistem dan field bawaan koleksi file.

      Field bawaan

      Setelah dibuat, koleksi file biasanya berisi field bawaan berikut. File itu sendiri disimpan di penyimpanan file, sedangkan koleksi file menyimpan metadata berikut.

      FieldNama fieldKeterangan
      IDidField kunci utama default, yang digunakan untuk mengidentifikasi satu catatan file secara unik.
      TitletitleJudul file, biasanya digunakan untuk ditampilkan di antarmuka.
      File namefilenameNama file.
      Extension nameextnameEkstensi file.
      SizesizeUkuran file.
      MIME typemimetypeTipe MIME file.
      PathpathPath file di penyimpanan.
      URLurlAlamat akses file.
      PreviewpreviewAlamat pratinjau file.
      Storagestorage / storageIdPenyimpanan tempat file berada. storage adalah field relasi, sedangkan storageId adalah foreign key terkait.
      MetametaMetadata ekstensi file.
      Waktu dibuatcreatedAtSecara otomatis mencatat waktu pembuatan catatan file.
      PembuatcreatedBySecara otomatis mencatat pengguna yang mengunggah atau membuat catatan file.
      Waktu diperbaruiupdatedAtSecara otomatis mencatat waktu pembaruan terakhir catatan file.
      Diperbarui olehupdatedBySecara otomatis mencatat pengguna yang terakhir memperbarui catatan file.
      RuangspaceTersedia setelah plugin multi-ruang diaktifkan, digunakan untuk mengisolasi data berdasarkan ruang. Field ini tidak akan muncul jika multi-ruang tidak diaktifkan.

      20240324090527

      Field kunci utama

      Koleksi file, sama seperti tabel biasa, memerlukan field kunci utama. Field lampiran dan field relasi akan menggunakan kunci utama untuk menghubungkan metadata file.

      Jika koleksi file tidak memiliki kunci utama, tetapkan「Record unique key」saat mengedit tabel data. Jika tidak, catatan lampiran mungkin tidak dapat dihubungkan, dipratinjau, atau diedit dengan benar.

      Membangun relasi

      Buat field relasi di tabel bisnis untuk menghubungkannya ke koleksi file.

      20240324091529

      Penggunaan konfigurasi halaman

      Data koleksi file biasanya dibuat secara otomatis melalui pengunggahan dengan komponen lampiran. Komponen ini digunakan di blok formulir, blok detail, atau blok relasi.

      20260710160424

      20240324091321

      Lokasi konfigurasiTujuan
      Blok formulirMengunggah lampiran dalam catatan tabel bisnis.
      Blok detailMenampilkan, mempratinjau, atau mengunduh lampiran.
      Blok tabelMenampilkan field lampiran dalam daftar.
      Blok relasiMengelola langsung catatan file yang terkait dengan catatan bisnis saat ini.

      Mengedit konfigurasi

      Dalam daftar tabel data, klik「Edit」di sisi kanan koleksi file untuk mengubah nama tampilan, kategori, deskripsi, mode pagination sederhana,「Record unique key」, dan konfigurasi lainnya.

      Field metadata file biasanya ditulis secara otomatis selama proses pengunggahan. Sebaiknya jangan mengubah url、path、storageId dan field lainnya menjadi makna bisnis yang berbeda. Jika perlu menambahkan informasi bisnis file, Anda dapat menambahkan field baru, misalnya「Tipe file」「Tahap terkait」「Diarsipkan」。

      Menghapus tabel data

      Dalam daftar tabel data, klik「Delete」di sisi kanan koleksi file untuk menghapus koleksi file.

      Menghapus koleksi file akan menghapus catatan metadata file dan metadata Collection terkait. Sebelum menghapus, pastikan terlebih dahulu apakah field lampiran, field relasi, blok halaman, izin, alur kerja, dan API di tabel bisnis masih bergantung padanya.

      Peringatan

      Koleksi file menyimpan metadata file. Menghapus catatan koleksi file dapat menyebabkan referensi lampiran dalam catatan bisnis tidak valid; apakah file itu sendiri ikut dihapus bergantung pada penyimpanan file dan konfigurasi bisnis. Sebelum melakukan operasi, pastikan terlebih dahulu apakah file tersebut masih digunakan oleh bisnis.

      Tautan terkait

      • Tabel biasa — Lihat konfigurasi umum dan cara penggunaan blok
      • Field tabel data — Lihat konfigurasi field lampiran dan field relasi
      • Pengelola file — Lihat konfigurasi terkait penyimpanan file
      • Multi-ruang — Pelajari field ruang dan kemampuan isolasi ruang