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

# Templat Word

> Pelajari cara menggunakan komponen Templat Word di YiDA untuk formulir alur kerja — unggah templat .docx, ikat variabel formulir, dan hasilkan dokumen Word otomatis dengan format standar.

Artikel ini menjelaskan komponen Templat Word dan cara menggunakannya.

| **Fitur**    | **Edisi Gratis** | **Edisi Professional** | **Edisi Dedicated** |
| ------------ | ---------------- | ---------------------- | ------------------- |
| Templat Word | Tidak didukung   | Didukung               | Didukung            |

<Warning>
  ⚠️ Catatan: Hanya formulir alur kerja yang mendukung komponen Templat Word. Setiap formulir alur kerja mendukung maksimal 5 komponen Templat Word.
</Warning>

## Atribut komponen

| **Atribut**      | **Deskripsi**                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Judul**        | Nama komponen. Mendukung judul multibahasa.<br />Default: Templat Word.                                                                                                                                                                                                                                                                                                                                                                                        |
| **Deskripsi**    | Informasi tambahan tentang komponen, ditampilkan di bawah komponen.                                                                                                                                                                                                                                                                                                                                                                                            |
| **File templat** | Bagian utama komponen. Unggah templat Word saat mendesain formulir. Setelah templat diunggah, Anda dapat mengedit, melihat pratinjau, dan mengunduhnya.<br />Hanya file `.docx` berukuran kurang dari 20 MB yang didukung. Gunakan `${component unique identifier}` di dalam konten file untuk mereferensikan nilai komponen formulir. Edisi Basic tidak mendukung pengeditan online. Untuk detail, lihat [Edit lampiran secara online](/id/yida/form/hgdfkl). |
| **Validasi**     | Mendukung validasi bidang wajib.                                                                                                                                                                                                                                                                                                                                                                                                                               |

## **Catatan penggunaan**

Komponen Templat Word adalah fitur YiDA yang **menghasilkan lampiran Word berdasarkan templat Word dan nilai bidang formulir**. Komponen ini cocok untuk skenario yang memerlukan format standar, seperti manajemen dokumen resmi berskala nasional.

Catatan penggunaan:

* Konten dalam templat Word dapat diikat ke variabel formulir. Atur konten dalam templat sebagai pengenal unik komponen formulir. Format variabelnya adalah `${component unique identifier}`.

* Didukung pada halaman manajemen data YiDA (tampilan, ekspor), formulir terkait (tampilan, filter), catatan perubahan detail formulir, perancang alur kerja (aturan pengiriman Langkah, pengaturan izin bidang), dan catatan cetak.

* Pada perancang alur kerja, Anda dapat mengatur izin (Dapat Diedit, Hanya Baca, Tersembunyi) komponen Templat Word pada Langkah yang berbeda.

* Saat ini hanya didukung pada formulir alur kerja.

* Mengambil dan menetapkan nilai melalui JS API tidak didukung.

* Melihat format data Templat Word melalui Open API tidak didukung.

Konfigurasi templat cetak default adalah sebagai berikut:

Hasil cetak adalah sebagai berikut:

## Contoh

Ikuti langkah-langkah berikut untuk menggunakan komponen Templat Word.

### Langkah 1: Buat formulir alur kerja

<Steps>
  <Step title="Sign in to the YiDA console and create a blank app" />

  <Step title="Click Create workflow form to create a workflow form" />

  <Step title="Drag a Single-line text component and a Word template component into the form" />

  <Step title="Select the Single-line text component, click Premium in the right-hand attributes panel, and copy the unique identifier of the Single-line text component" />
</Steps>

### Langkah 2: Buat templat Word

1. Buat dokumen Word (`.docx`) secara lokal, lalu buka.

2. Tambahkan pengenal unik komponen Teks satu baris yang disalin pada Langkah 1 ke dalam dokumen Word. Formatnya adalah `${Single-line text component unique identifier}`.

3. Simpan file.

### Langkah 3: Gunakan templat dalam alur kerja

1. Kembali ke halaman desain formulir di konsol YiDA.
2. Pilih komponen Templat Word. Pada panel Atribut di sebelah kanan, klik Pilih templat Word dan unggah dokumen Word yang dibuat pada langkah sebelumnya.

<Steps>
  <Step title="Click Preview in the upper-right corner, then click Visit this page" />

  <Step title="Enter content in the Single-line text field, then click Submit. After submission succeeds, preview the content of the Word document on the approval page" />
</Steps>

Seperti ditunjukkan di bawah, placeholder `${}` di dalam templat Word berhasil digantikan dengan nilai formulir yang sebenarnya.

## **Pertimbangan**

* Jika formulir berisi subformulir, referensi `${placeholder}` ke komponen Teks satu baris, teks multi-baris, angka, Pilih, dropdown pilih, pilih banyak, dropdown pilih banyak, tanggal, dan unggah gambar di dalam subformulir tidak dapat dirender pada komponen Templat Word. Mencetak konten yang mereferensikan komponen Templat Word dari dalam subformulir juga tidak didukung.

* Jika aplikasi telah mengaktifkan penyimpanan OSS khusus untuk komponen penyimpanan file seperti gambar dan lampiran, referensi dari templat Word tidak didukung.

* Untuk menggunakan variabel bertipe gambar dalam templat Word, pengenal komponen harus diawali dengan prefiks variabel tertentu.

* Contoh: `attachmentField_kdtv9ayf`, `imageField_kdtv9aye`, `digitalSignatureField_kdtv9aye`.