> ## 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.

# Lampiran

> Panduan lengkap komponen Lampiran YiDA di DingTalk — atur tipe unggahan, batas jumlah file, format yang didukung, serta pratinjau dan pengeditan online untuk mengoptimalkan alur kerja formulir Anda.

## 1. Kasus penggunaan

Skenario yang memerlukan unggahan konten file, seperti sertifikat, materi, data, dan kontrak.

Saat ini, setiap Lampiran di YiDA dibatasi hingga 100 MB.

<Note>
  Untuk atribut komponen, penggunaan, dan contoh, [**klik di sini**](/id/open/yida/components/interface).
</Note>

## 2. Fitur dasar

### 2.1 Tipe unggah

Fitur: Atur cara Lampiran diunggah.

**Jalur:** Atribut >> Pengaturan detail unggah >> Tipe unggah

Tipe unggah: dua opsi tersedia—klik dan seret-dan-lepas.

**Klik** (jika diatur ke klik, klik Unggah File untuk mengunggah Lampiran secara langsung)

**Seret-dan-lepas** (jika diatur ke seret-dan-lepas, seret File ke dalam kotak putus-putus untuk mengunggah):

### 2.2 Konten tombol

Fitur: Atur Teks tombol Unggah.

**Jalur**: Atribut >> Pengaturan detail unggah >> Konten tombol (opsi ini hanya muncul saat tipe unggah diatur ke klik)

Efeknya sebagai berikut:

Konten tombol secara default adalah Unggah File. Sesuaikan Teks tombol sesuai kebutuhan Anda.

Efeknya sebagai berikut:

### 2.3 Tipe tombol

Tipe tombol: primary, second (sekunder), dan normal.

primary: tombol memiliki latar belakang biru dengan Teks putih.

Efeknya sebagai berikut:

second (sekunder): tombol memiliki border biru dan Teks biru. Efeknya sebagai berikut:

normal: tombol memiliki border abu-abu dan Teks abu-abu. Efeknya sebagai berikut:

### 2.4 Pilih Banyak dan jumlah maksimum File

#### 2.4.1 Pilih Banyak

Fitur: Saat Pilih Banyak Aktif, Pengguna dapat mengunggah beberapa Lampiran secara bersamaan.

**Jalur**: Atribut >> Pengaturan detail unggah >> Pilih Banyak

**Catatan**: Dengan Pilih Banyak Aktif, Pengguna dapat memilih beberapa File saat mengunggah. Namun, jumlah File yang dapat dipilih bergantung pada nilai yang diatur di "Jumlah maksimum File."

#### 2.4.2 Jumlah maksimum File

Fitur: Atur jumlah maksimum Lampiran yang dapat diunggah.

**Jalur**: Atribut >> Pengaturan detail unggah >> Jumlah maksimum File

Saat jumlah maksimum File diatur ke 4, efeknya sebagai berikut:

### 2.5 Tipe File Unggah

Fitur: Atur format File yang diizinkan untuk diunggah.

<Note>
  Ekstensi File hanya mendukung angka dan huruf Inggris.
</Note>

**Jalur:** Atribut >> Pengaturan detail unggah >> Tipe File Unggah

Contoh: Jika Tipe File Unggah diatur ke PDF, hanya File PDF yang dapat diunggah. Efeknya sebagai berikut:

Setelah pengaturan ini, Tipe File lain tidak dapat diunggah pada Halaman Unggah. Seperti yang ditunjukkan di bawah, File dalam format Gambar lainnya menjadi abu-abu dan tidak dapat dipilih. Hanya File PDF yang dapat dipilih dan diunggah.

Properti ini sebenarnya mengatur atribut accept untuk unggahan File (yang membatasi Tipe File yang diizinkan). Untuk detailnya, lihat [**tautan**](https://developer.mozilla.org/zh-CN/docs/Web/HTML/Element/Input#attr-accept) ini.

### 2.6 Pratinjau Lampiran online

Melakukan Pratinjau sebelum pengiriman memungkinkan Anda memverifikasi bahwa Lampiran yang diunggah sudah benar. Melakukan Pratinjau setelah pengiriman mengurangi kebutuhan untuk mengunduh Lampiran, sehingga menghemat penyimpanan lokal. Saat ini, Pratinjau Lampiran online didukung di PC maupun seluler, sebelum dan setelah pengiriman data.

Pratinjau mendukung tiga tipe dokumen Office—Excel, Word, dan PPT—serta PDF. Ekstensi yang didukung:

Excel: et, xls, xlt, xlsx, xlsm, xltx, xltm, csv

Word: doc, docx, txt, dot, wps, wpt, dotx, docm, dotm

PPT: ppt, pptx, pptm, pptm, ppsm, pps, potx, potm, dpt, dps

Pratinjau online di PC

Pratinjau online di seluler

### 2.7 Unggah Lampiran di komentar

Saat mengomentari data formulir yang telah dikirim, Anda dapat mengunggah Lampiran baik di PC maupun seluler.

Unggah Lampiran di komentar pada PC

Unggah Lampiran di komentar pada seluler

## 3. Pengeditan Lampiran online

### 3.1 Prasyarat

Catatan: Fitur ini eksklusif untuk Edisi Professional ke atas.

1. Saat ini, pengeditan Lampiran hanya mendukung tiga tipe dokumen Office—Word, PPT, dan Excel. Ekstensi yang didukung:

Excel: et, xls, xlt, xlsx, xlsm, xltx, xltm, csv

Word: doc, docx, txt, dot, wps, wpt, dotx, docm, dotm

PPT: ppt, pptx, pptm, pptm, ppsm, pps, potx, potm, dpt, dps

**Catatan**: Selain tipe di atas, Pratinjau Lampiran juga mendukung PDF.

### 3.2 Cara mengaktifkan

Untuk menggunakan pengeditan Lampiran online, Aktifkan terlebih dahulu tombol "Pengeditan online" pada komponen Lampiran.

Mengaktifkan tombol hanya berarti formulir mendukung pengeditan online. Untuk mengedit Lampiran yang telah diunggah setelah pengiriman data, Anda juga perlu mengonfigurasi Izin.

**Catatan**: Konfigurasi Izin berbeda antara formulir dan formulir alur kerja. Rujuk pada jalur berikut:

**Jalur**: Buka formulir target >> Pengaturan >> Izin halaman >> Tambah grup izin >> Pilih Izin yang dapat diedit di kolom Lampiran

**Jalur**: Buka formulir alur kerja target >> Pengaturan >> desain alur kerja >> Siapkan node persetujuan >> Konfigurasikan Izin tindakan penyetuju pada node persetujuan saat ini >> Pilih "Dapat diedit" di kolom Lampiran (penyetuju dengan Izin ini dapat mengedit Lampiran secara online selama persetujuan)

Setelah konfigurasi, Buka detail formulir untuk mengedit Lampiran secara online. Efeknya sebagai berikut:

Klik tombol "Edit" untuk Membuka Halaman pengeditan baru.

### 3.3 Cara kerja pengeditan online

#### 3.3.1 Simpan otomatis

Halaman pengeditan menyimpan secara otomatis setelah setiap suntingan. Anda juga dapat menekan "Ctrl+S" untuk menyimpan secara manual.

Menyimpan terlalu sering tidak disarankan. Setiap penyimpanan manual membuat Versi baru, dan sistem membatasi Versi yang disimpan—saat ini hingga 10.

#### 3.3.2 Rekaman kolaborasi

Klik "Rekaman kolaborasi" di sudut kanan atas untuk melihat Riwayat suntingan setiap Pengguna yang pernah mengerjakan dokumen.

**Catatan**: Fitur "Riwayat Versi" pada Halaman ini belum tersedia.

Efeknya sebagai berikut:

## 4. Validasi lanjutan

Contoh skenario: Mewajibkan Pengguna untuk mengunggah tepat 2 Lampiran—tidak lebih, tidak kurang.

**Jalur**: Aktifkan Pilih Banyak >> Atur jumlah maksimum File ke 2 >> Klik Validasi >> Fungsi kustom. Salin kode berikut ke Halaman Fungsi kustom. Efeknya sebagai berikut:

Salin dan gunakan kembali kode berikut (sesuaikan angka sesuai kebutuhan, tetapi tetap selaras dengan jumlah maksimum File):

```javascript theme={"theme":{"light":"github-light","dark":"github-dark"}}
function validateRule(value) {
  return value.length == 2
}
```

Hasilnya seperti ini:

## 5. FAQ

<AccordionGroup>
  <Accordion id="q1" title="5.1 Bagaimana cara mengatur jumlah minimum Lampiran?">
    Untuk mengatur jumlah minimum Lampiran, konfigurasikan Fungsi validasi kustom pada komponen Lampiran.

    **Jalur**: Klik komponen Lampiran >> Panel atribut >> Fungsi validasi kustom

    Salin dan gunakan kembali kode berikut:

    ```javascript theme={"theme":{"light":"github-light","dark":"github-dark"}}
    function validateRule(value) {
      // Validasi gagal jika kurang dari 2 Lampiran diunggah
      return value.length >= 2
    }
    ```
  </Accordion>

  <Accordion id="q2" title="5.2 Bagaimana cara mengekspor File Lampiran?">
    Mengekspor Lampiran dan Gambar didukung. Unduh File dari halaman manajemen data.
  </Accordion>

  <Accordion id="q3" title="5.3 Mengapa Gambar yang diunggah tidak dapat diputar?">
    Gambar yang diunggah melalui komponen Lampiran tidak dapat diputar. Jika Anda membutuhkan rotasi, gunakan komponen Unggah Gambar untuk mengirimkan data Gambar.
  </Accordion>

  <Accordion id="q4" title="5.4 Bagaimana cara mendapatkan URL Pratinjau online sebuah Lampiran?">
    Buat tindakan OnChange pada komponen Lampiran. URL Pratinjau yang Anda peroleh tidak menyertakan domain, jadi saat menetapkannya ke komponen Teks satu baris, Tambah "[https://www.yidaapps.com](https://www.yidaapps.com)" di depannya seperti yang ditunjukkan di bawah ini:

    Contoh kode:

    ```ruby theme={"theme":{"light":"github-light","dark":"github-dark"}}
    export function onChange({ value }) {
      console.log('onChange', value);
      this.$('singleLineTextFieldId').setValue("https://www.yidaapps.com"+value[0].imgURL)
    }
    ```
  </Accordion>
</AccordionGroup>

### 5.5 Kesalahan Pratinjau Lampiran: Server error, try again!

Jika Kesalahan "Server error, try again!" muncul saat melakukan Pratinjau Lampiran di Halaman Rekaman sumber, periksa apakah UserID DingTalk Pengguna yang melakukan Pratinjau mengandung garis bawah "\_". UserID hanya mendukung huruf besar dan kecil, angka 0-9, dan tanda hubung (-).

**Jalur untuk mengatur UserID**: Admin masuk ke [DingTalk Admin Console](https://oa.dingtalk.io) >> \[Kontak] di panel kiri >> \[Manajemen Kontak Internal] >> \[Tambah Pengguna] >> Atur \[UserID Karyawan].

**Tips:**

* UserID adalah pengenal unik Karyawan dalam organisasi. Setelah dibuat, tidak dapat diubah.

* Setelah keluar dan bergabung kembali ke organisasi, rekaman sebelumnya di organisasi—seperti kehadiran, laporan, persetujuan, dan data formulir YiDA—tidak dapat lagi dilihat. Lanjutkan dengan hati-hati.

### 5.6 Kondisi untuk Pratinjau Lampiran

* Pratinjau Lampiran memiliki batas ukuran File: 20 MB untuk paket Edisi Gratis dan Edisi Basic, dan 60 MB atau lebih untuk Edisi Professional dan Edisi Dedicated. File yang lebih besar harus diunduh ke perangkat Anda sebelum dapat dipratinjau.