> ## Documentation Index
> Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Impor massal

> Impor massal data formulir YiDA untuk memigrasikan data dengan cepat — pelajari langkah, komponen yang didukung, dan persyaratan format Excel bagi admin formulir.

| **Fitur**                                                                        | **Paket Gratis**                           | **Edisi Basic**                            | **Edisi Professional**                     | **Edisi Dedicated**                         |
| -------------------------------------------------------------------------------- | ------------------------------------------ | ------------------------------------------ | ------------------------------------------ | ------------------------------------------- |
| **Edit massal data formulir mendukung validasi, asosiasi, dan notifikasi pesan** | Tidak didukung                             | Didukung                                   | Didukung                                   | Didukung                                    |
| **Data formulir yang diimpor massal dapat dihapus per batch**                    | Tidak didukung                             | Didukung                                   | Didukung                                   | Didukung                                    |
| **Data formulir yang diimpor massal mendukung aturan validasi**                  | Tidak didukung                             | Didukung                                   | Didukung                                   | Didukung                                    |
| **Batas impor data untuk formulir biasa**                                        | 5.000 record, ukuran file hingga **10 MB** | 5.000 record, ukuran file hingga **10 MB** | 5.000 record, ukuran file hingga **10 MB** | 50.000 record, ukuran file hingga **10 MB** |
| **Batas impor data untuk formulir alur kerja**                                   | 1.000 record, ukuran file hingga **20 MB** | 1.000 record, ukuran file hingga **20 MB** | 1.000 record, ukuran file hingga **20 MB** | 10.000 record, ukuran file hingga **20 MB** |

Formulir YiDA mendukung impor massal data untuk membantu admin formulir memigrasikan data dengan cepat. Impor massal juga dapat memicu aturan validasi, aturan bisnis, alur integrasi & otomatisasi, notifikasi pesan, dan callback pihak ketiga yang telah dikonfigurasi pada formulir saat data diimpor. Artikel ini menjelaskan cara mengimpor data formulir secara massal.

* Komponen yang didukung: Teks satu baris, Teks multi-baris, pilih satu, dropdown pilih satu, Pilih Banyak, dropdown pilih banyak, unggah gambar, Lampiran, Pengguna, Departemen, Numerik, tanggal, rentang tanggal, subformulir, formulir terkait (tabel utama).
* Komponen yang tidak didukung: tampilan gambar-teks, Teks Kaya, pilih bertingkat, Negara/Wilayah, lokasi, Tanda tangan, formulir terkait (subtabel).
* Data yang diimpor massal ditampilkan sesuai urutan baris pada file Excel.

## Langkah-langkah

Ikuti langkah berikut untuk mengimpor data secara massal.

1. Masuk ke workbench YiDA dan buka layar manajemen halaman aplikasi.

2. Pilih formulir yang datanya ingin diimpor, lalu klik **Manajemen data** > **Impor**.

3. Konfigurasikan aturan impor.

| Opsi aturan impor | Deskripsi                                                                                                                                                                                                                                                                                                                                                    |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Impor dipercepat  | Ketika impor dipercepat diaktifkan, sistem mengimpor data Excel Anda dalam batch sehingga waktu impor berkurang secara signifikan. Gunakan opsi ini untuk skenario impor sederhana (tanpa dependensi antar-record).<br />Jangan aktifkan opsi ini untuk skenario kompleks (misalnya, ketika data yang diimpor memerlukan logika pemrosesan hulu atau hilir). |
| Metode impor      | Tersedia tiga mode: hanya menambah record, hanya memperbarui record, serta menambah atau memperbarui record.<br />**Catatan**: Formulir alur kerja hanya mendukung penambahan record baru.                                                                                                                                                                   |
| Aturan impor      | Pilih opsi berikut selama impor massal:<br />• **Formulir alur kerja**: Kirim Notifikasi Kerja agar peserta alur kerja menerima notifikasi pesan.<br />• **Formulir biasa**: Picu aturan validasi, aturan bisnis, alur integrasi & otomatisasi, notifikasi pesan, dan callback pihak ketiga.                                                                 |

4. Unduh templat data formulir dan edit data sesuai contoh.

<Note>
  Untuk memastikan impor berjalan lancar, unduh templat terlebih dahulu dan ikuti contoh yang disediakan.
</Note>

5. Unggah file yang akan diimpor massal. Tipe file `.xls` dan `.xlsx` didukung.

6. Setelah unggahan selesai, verifikasi pratinjau data, konfigurasikan pemetaan **Bidang** dan **Pengirim** formulir, lalu klik **Impor** untuk memulai proses impor.

7. Ketika impor selesai, klik **Tutup** untuk menyelesaikan.

## Persyaratan format Excel

Impor massal harus mengikuti format yang diwajibkan setiap komponen secara ketat. Data dengan format yang salah akan gagal diimpor.

Persyaratan format Excel untuk setiap komponen YiDA adalah sebagai berikut:

| **Komponen**                                    | **Format**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | **Contoh**                                                                                                                                                                                                                                                                                                                                                                   |
| ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Teks satu baris**<br />**Teks multi-baris**   | Konten dalam format teks di spreadsheet.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | Ini adalah contoh teks satu baris                                                                                                                                                                                                                                                                                                                                            |
| **Numerik**                                     | Konten yang diformat sebagai angka di spreadsheet.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | 1234                                                                                                                                                                                                                                                                                                                                                                         |
| **Pilih**<br />**Dropdown pilih satu**          | Teks. Ketika file Excel berisi lebih dari 100 opsi untuk bidang pilih, kolom tersebut tidak dapat diimpor ke komponen pilih satu atau dropdown pilih satu.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | Opsi A                                                                                                                                                                                                                                                                                                                                                                       |
| **Pilih Banyak**<br />**Dropdown pilih banyak** | Ketika file Excel berisi lebih dari 100 opsi, kolom tersebut tidak dapat diimpor ke komponen pilih banyak atau dropdown pilih banyak. Saat ini hanya satu opsi yang dapat diimpor per baris. Pisahkan opsi dengan koma Inggris `,`. Jika nilai opsi mengandung `,`, escape sebagai `,`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | Opsi A,Opsi B                                                                                                                                                                                                                                                                                                                                                                |
| **Tanggal**                                     | Komponen tanggal saat ini hanya mendukung format berikut:<br />• yyyy-MM-dd HH:mm:ss<br />• yyyy-MM-dd HH:mm<br />• yyyy-MM-dd HH<br />• yyyy-MM-dd<br />• yyyy-MM<br />• yyyy                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | Contoh tanggal:<br />• 2022-12-31 23:50:59<br />• 2022-12-31 23:50<br />• 2022-12-31 23<br />• 2022-12-31<br />• 2022-12<br />• 2022                                                                                                                                                                                                                                         |
| **Rentang tanggal**                             | Komponen rentang tanggal saat ini hanya mendukung format berikut:<br />• yyyy-MM-dd HH:mm:ss\_yyyy-MM-dd HH:mm:ss<br />• yyyy-MM-dd HH:mm\_yyyy-MM-dd HH:mm<br />• yyyy-MM-dd HH\_yyyy-MM-dd HH<br />• yyyy-MM-dd\_yyyy-MM-dd<br />• yyyy-MM\_yyyy-MM<br />• yyyy\_yyyy                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | Contoh rentang tanggal:<br />• 2022-12-31 23:50:59\_2022-12-31 23:50:59<br />• 2022-12-31 23:50\_2022-12-31 23:50<br />• 2022-12-31 23\_2022-12-31 23<br />• 2022-12-31\_2022-12-31<br />• 2022-12\_2022-12<br />• 2022\_2022                                                                                                                                                |
| **Departemen**                                  | Sertakan jalur lengkap dari departemen tingkat atas dan pisahkan departemen induk dengan anak menggunakan `-`. Pisahkan beberapa departemen dengan koma Inggris `,`.<br />Nilai divalidasi saat impor. Baris yang gagal validasi akan dicatat sebagai error.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | Departemen pilih banyak:<br />DingTalk-YiDA-Produk YiDA,DingTalk-YiDA-Operasional YiDA<br />Departemen pilih satu:<br />DingTalk-YiDA-Produk YiDA                                                                                                                                                                                                                            |
| **Pengguna**                                    | Informasi pengguna mendukung dua format: **nama karyawan + ID Karyawan** dan **nama karyawan + ID pengguna**.<br />• Saat mengimpor berdasarkan ID Karyawan, gunakan format `Nama1(EmployeeID),Nama2(EmployeeID2)`. ID Karyawan dapat dilihat pada halaman Profil karyawan.<br />• Saat mengimpor berdasarkan `user ID`, gunakan format `Nama1[userID],Nama2[userID]`. ID pengguna dapat dilihat pada [konsol admin DingTalk](https://oa.dingtalk.io) > **Kontak** > **Manajemen anggota** > halaman **Informasi dasar** karyawan.<br />• Karyawan yang sudah keluar hanya dapat diimpor menggunakan format `Nama[userID]`. ID pengguna karyawan yang sudah keluar dapat dilihat di [konsol admin DingTalk](https://oa.dingtalk.io) > **Kontak** > **Smart HR** > **Manajemen offboarding** > Karyawan yang sudah keluar. | Contoh menggunakan ID pengguna:<br />• **Pengguna pilih banyak**: `Budi Santoso[yida777],Siti Aminah[yida888],Andi Wijaya[yida999]`<br />• **Pengguna pilih satu**: `Budi Santoso[yida888]`<br />Contoh menggunakan ID Karyawan:<br />• **Pengguna pilih banyak**: `Budi Santoso(777),Siti Aminah(888),Andi Wijaya(999)`<br />• **Pengguna pilih satu**: `Budi Santoso(888)` |
| **Lampiran**                                    | URL lampiran yang akan diimpor. URL harus memenuhi persyaratan berikut:<br />• Harus diawali dengan `http://` atau `https://`.<br />• Pisahkan beberapa URL dengan koma Inggris `,`.<br />• URL harus dapat diakses publik tanpa parameter autentikasi tambahan. Kosongkan sel jika sumber daya tidak tersedia.<br />• Format file tidak divalidasi secara default, dan pratinjau tidak didukung.<br />• Format impor dan ekspor konsisten. Misalnya, lampiran yang dikirim melalui formulir dapat diekspor lalu diimpor massal kembali dengan berhasil.                                                                                                                                                                                                                                                                  | `https://img.alicdn.com/imgextra/i3/O1CN01XcfOQL1Gc4xwrXIP6_!!6000000000642-2-tps-1636-800.png`                                                                                                                                                                                                                                                                              |
| **Unggah gambar**                               | URL gambar yang akan diimpor. URL gambar harus memenuhi persyaratan berikut:<br />• Harus diawali dengan `http://` atau `https://`.<br />• Pisahkan beberapa URL dengan koma Inggris `,`.<br />• URL harus dapat diakses publik tanpa parameter autentikasi tambahan. Kosongkan sel jika sumber daya tidak tersedia.<br />• Hanya format `.png`, `.jpg`, `.jpeg`, dan `.gif` yang didukung. Pratinjau didukung.<br />• Baris yang gagal validasi akan dicatat sebagai error.<br />• Format impor dan ekspor konsisten. Misalnya, gambar yang dikirim melalui formulir dapat diekspor lalu diimpor massal kembali dengan berhasil.                                                                                                                                                                                         | URL gambar                                                                                                                                                                                                                                                                                                                                                                   |
| **Formulir terkait**                            | Impor formulir terkait mendukung dua format: "**Judul\[ID Instance]**" dan "**informasi utama**".                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | Judul formulir terkait\[FINST-GO766481LI61UXEQCX2YV7JUGRKW2EVCZD64L0]<br />**atau**<br />Informasi utama formulir terkait                                                                                                                                                                                                                                                    |

## Catatan

Perhatikan hal berikut saat mengunggah file Excel:

* Ukuran file tidak boleh melebihi 10 MB, dan satu sheet tidak boleh berisi lebih dari 5.000 baris.
* Hanya format file `.xls` dan `.xlsx` yang didukung.
* Pastikan header sheet yang ingin diimpor tidak berisi sel kosong; jika ada, sistem tidak akan mengimpor sheet tersebut.
* Pemfilteran data yang diimpor massal berdasarkan variabel bawaan tidak didukung.
* Formula Excel seperti `SUM` atau `=H2*J2` tidak didukung pada file impor.
* Gambar dan lampiran yang diimpor disimpan dan dihitung dalam kuota lampiran Anda.
* Tabel pivot lintas tab tidak dapat diimpor.

## FAQ

* T: Bagaimana cara mengimpor data subformulir secara massal?

Metode 1: Cara baru untuk mengimpor dan mengekspor data subformulir secara massal kini tersedia. Untuk detailnya, lihat [Subformulir](/id/yida/form/in0w72).

Metode 2: Gunakan format data Excel di bawah ini.

Misalnya, subformulir pada formulir inventaris yang ditunjukkan di bawah ini.

| **Definisi formulir**           | Diagram definisi formulir           |
| ------------------------------- | ----------------------------------- |
| **Tampilan data Excel**         | Diagram tampilan data Excel         |
| **Tampilan data yang diimpor**  | Diagram tampilan data yang diimpor  |
| **Konfigurasi pemetaan bidang** | Diagram konfigurasi pemetaan bidang |

* T: Pesan "Mengimpor data, harap tunggu..." terus muncul, tetapi tidak ada data yang ditambahkan. Mengapa?

Periksa apakah ada kolom pada file Excel yang dihitung dengan formula (seperti `SUM` atau `=H2*J2`). File Excel yang berisi formula seperti itu tidak didukung untuk impor, dan memaksakan impor dapat menyebabkan berbagai error.

* T: Mengapa komponen tanggal dapat diimpor dengan berhasil meskipun formatnya berbeda dari yang dikonfigurasi pada formulir?

Saat ini, impor massal secara otomatis melengkapi atau memangkas presisi nilai tanggal berdasarkan format tanggal yang dikonfigurasi di desainer formulir. Contoh:

Hasil impor:

* T: Mengapa beberapa sel numerik terkadang gagal diimpor selama impor massal?

J: Saat mengimpor data yang berisi angka, jika Anda menggunakan komponen numerik, format sel di Excel harus diatur ke **Angka** atau **Umum**.
