Import and Export
Buka di CMSPlugin Dynamic Table mendukung operasi data massal melalui impor dan ekspor berbasis file. Gunakan impor untuk memuat baris dari spreadsheet, dan ekspor untuk mengunduh isi tabel guna ditinjau, dicadangkan, atau diedit.
Buka Tools → Plugins → Dynamic Table → Tables, buka tabel, lalu masuk ke tab Data. Tombol impor dan ekspor ada di area kanan atas.
Mengekspor Data
Format Ekspor
| Format | Kegunaan |
|---|---|
| CSV | Teks biasa, kompatibel dengan aplikasi spreadsheet apa pun. |
| Excel | File .xlsx dengan header kolom, cocok untuk ditinjau dan diimpor ulang. |
Cara Mengekspor
- Klik Export.
- Pilih format file: CSV atau Excel.
- Secara opsional, masukkan judul file. Jika dikosongkan, nama tabel yang dipakai.
- Klik Download.
File yang diekspor berisi semua kolom aktif dan semua baris. Setiap baris menyertakan nomor baris dan semua nilai kolomnya. Kolom metadata (tanggal dibuat, tanggal diperbarui) disertakan sebagai referensi.
Mengimpor Data
Impor memuat baris dari file CSV atau Excel ke dalam tabel. Prosesnya terdiri dari dua langkah: validasi terlebih dahulu, lalu proses.
Mengunduh Template Impor
Sebelum menyiapkan file, unduh template impor untuk mendapatkan file yang sudah berformat dengan header kolom yang benar untuk tabel Anda.
- Klik Import.
- Klik Download Template.
- Buka template di aplikasi spreadsheet Anda.
- Isi baris-barisnya lalu simpan file.
Template berisi semua kolom aktif dalam urutan yang benar. Header kolom memakai nama kolom internal (snake_case).
Langkah 1: Validasi
- Klik Import.
- Unggah file CSV atau Excel Anda.
- Klik Validate.
Plugin membaca file dan memeriksa:
- Semua kolom wajib ada.
- Nama kolom cocok dengan skema tabel.
- Nilai sesuai dengan tipe kolomnya (misalnya kolom
numberberisi nilai numerik). - Baris duplikat terdeteksi berdasarkan kolom primary key (jika ada).
Hasil validasi menampilkan pratinjau baris yang akan diimpor, termasuk masalah yang terdeteksi.
| Hasil validasi | Artinya |
|---|---|
| Valid | Semua baris lolos pemeriksaan skema dan tipe. |
| Warnings | Beberapa baris memiliki primary key duplikat atau nilai opsional yang kosong. |
| Errors | Baris berisi tipe yang tidak cocok atau field wajib yang kosong. Error harus diperbaiki sebelum diproses. |
Langkah 2: Proses
Setelah meninjau pratinjau validasi, pilih cara menangani baris duplikat (jika tabel memiliki kolom primary key):
| Mode | Perilaku |
|---|---|
| Skip | Baris yang primary key-nya sudah ada di tabel dilewati. Baris yang sudah ada tidak diubah. |
| Replace | Baris yang primary key-nya sudah ada ditimpa dengan nilai yang diimpor. |
| Error | Impor ditolak jika ditemukan primary key duplikat. |
Jika tabel tidak memiliki kolom primary key, deteksi duplikat tidak berlaku dan semua baris dimasukkan sebagai record baru.
Klik Process untuk memulai impor. Plugin memasukkan atau memperbarui baris secara bertahap per batch. Setelah selesai, panel data dimuat ulang dan baris baru langsung dapat dicari.
Masalah Impor yang Umum
| Masalah | Kemungkinan penyebab |
|---|---|
| Column not found | Nama kolom di file Anda tidak cocok dengan nama internal kolom aktif mana pun. |
| Type mismatch | Nilai di kolom number atau date tidak dalam format yang diharapkan. |
| Required field empty | Sebuah baris tidak memiliki nilai untuk kolom yang ditandai wajib. |
| Primary key duplikat dengan mode Error | File berisi key yang sudah ada di tabel, dan mode Error dipilih. |
Setelah Impor
Setelah impor selesai:
- Baris baru langsung tersedia di panel data.
- Vector embedding untuk semua baris yang diimpor dibuat secara otomatis.
- Anda dapat menjalankan uji pencarian untuk memastikan baris yang diimpor diambil dengan benar.
Jika data yang diimpor berisi kolom searchable dan kualitas pencarian terasa kurang tepat, jalankan pembuatan ulang embedding untuk membangun ulang semua vektor.