Sisipkan Gambar - Panduan Gambar Dinamis

PDF4me Memungkinkan penyisipan gambar dinamis dalam dokumen yang dihasilkan, memungkinkan Anda mengisi templat dengan logo, foto, bagan, diagram, dan konten visual lainnya dari sumber data Anda. Gambar dapat disediakan melalui publik. URLs atau Base64-string yang dikodekan.

---

Persyaratan Sintaks Gambar

The image syntax must be placed inside a Text Box in Word for proper image population. Create a text box at the desired location in your template before adding image merge fields.

---

Metode Penyisipan Gambar

PDF4me mendukung dua metode untuk menyediakan data gambar ke templat:

Metode 1: Citra Publik URL

Gunakan gambar yang dapat diakses publik. URLs untuk menyisipkan gambar dari sumber web.

Sintaksis:

<<image [imageUrl]>>

Contoh Data:

{
  "imageUrl": "https://public-url/image.png"
}

Contoh Kasus:

• Logo perusahaan yang dihosting di server publik
• Gambar produk dari platform e-commerce
• Bagan dan grafik yang dihasilkan dan diunggah secara online.
• Gambar sumber daya publik

---

Metode 2: Base64 Gambar yang Dikodekan

Sisipkan gambar menggunakan Base64- representasi string yang dikodekan dari file gambar.

Sintaksis:

<<image [imageBase64]>>

Contoh Data:

{
  "imageBase64": "iVBORw0KGgoAAAANSUhEUgAAAfQAAAH0CAYAAADL1t+KAAAACXBIWXMAABcSAAAXEgFnn9JSAACU6ElEQVR4nOz953tjR5bn+34jtoMn6D2ZSaaRL5lSmR5z5t5/+9xzZqZ7qktSeksmvfcG3mzsveO+2ACVUklKUspMksj1eZ7qqpZECCCZ+CEiVqyljDEGIYQQQlxr+rKfgBBCCCH+OAl0IYQQogtIoAshhBBdQAJdCCGE6AIS6EIIIUQXkEAXQggh..."
}

Keuntungan:

• Berfungsi tanpa koneksi internet.
• Aman - tanpa ketergantungan eksternal
• Kontrol penuh atas data gambar
• Cocok untuk dokumen sensitif

---

Opsi Pemformatan Gambar

Kontrol bagaimana gambar ditempatkan di dalam kotak teks menggunakan sakelar pemformatan. Opsi ini menentukan ukuran gambar dan perilaku rasio aspek.

Pertahankan Rasio Aspek

Sintaksis: <<image [imageUrl] -keepRatio>>

Perilaku:

• Mempertahankan ukuran kotak teks
• Mengubah ukuran gambar agar sesuai dengan batas kotak teks.
• Mempertahankan rasio aspek gambar asli
• Gambar mungkin tidak memenuhi seluruh kotak teks jika rasio berbeda.

Cocok untuk: Logo, ikon, dan gambar yang distorsinya harus dihindari.

---

Tinggi yang Sesuai

Sintaksis: <<image [imageUrl] -fitHeight>>

Perilaku:

• Mempertahankan lebar kotak teks
• Menyesuaikan tinggi kotak teks agar sesuai dengan rasio aspek gambar.
• Gambar memenuhi kotak teks sepenuhnya
• Ukuran kotak teks berubah untuk mengakomodasi gambar.

Cocok untuk: Gambar dengan tinggi variabel dalam tata letak yang fleksibel

---

Lebar yang Sesuai

Sintaksis: <<image [imageUrl] -fitWidth>>

Perilaku:

• Mempertahankan tinggi kotak teks
• Menyesuaikan lebar kotak teks agar sesuai dengan rasio aspek gambar.
• Gambar memenuhi kotak teks sepenuhnya
• Lebar kotak teks berubah untuk mengakomodasi gambar.

Cocok untuk: Banner horizontal, header dengan tinggi tetap.

---

Ukuran Pas

Sintaksis: <<image [imageUrl] -fitSize>>

Perilaku:

• Mengubah dimensi kotak teks agar sesuai dengan ukuran gambar.
• Menggunakan dimensi gambar asli
• Gambar ditampilkan dalam ukuran sebenarnya.
• Kotak teks akan menyesuaikan ukurannya agar sesuai dengan dimensi gambar.

Cocok untuk: Ketika ukuran gambar asli harus dipertahankan persis.

---

Ukuran Terbatas

Sintaksis: <<image [imageUrl] -fitSizeLim>>

Perilaku:

• Menyesuaikan ukuran kotak teks dengan ukuran gambar.
• Tidak akan bertambah melebihi dimensi kotak teks asli.
• Kotak teks dapat diperkecil jika gambar lebih kecil.
• Mencegah pembesaran kotak teks

Cocok untuk: Membatasi ukuran gambar maksimum sambil tetap mengizinkan gambar yang lebih kecil.

---

Perbandingan Pemformatan

Opsi Format	Lebar	Tinggi	Rasio Aspek	Ukuran Kotak Teks
-keepRatio	Tetap	Tetap	Terpelihara	Tidak berubah
-fitHeight	Tetap	Variabel	Terpelihara	Perubahan tinggi badan
-fitWidth	Variabel	Tetap	Terpelihara	Perubahan lebar
-fitSize	Variabel	Variabel	Terpelihara	Keduanya berubah
-fitSizeLim	Variabel	Variabel	Terpelihara	Terbatas

---

Contoh Praktis

Contoh 1: Logo Perusahaan

Templat:

[Create a text box in header]
<<image [companyLogo] -keepRatio>>

Data:

{
  "companyLogo": "https://company.com/images/logo.png"
}

---

Contoh 2: Gambar Produk

Templat:

<<foreach [product in products]>>
Product: <<[product.name]>>
[Text box:] <<image [product.imageUrl] -fitHeight>>
Price: $<<[product.price]>>

<</foreach>>

Data:

{
  "products": [
    {
      "name": "Laptop Pro",
      "imageUrl": "https://example.com/laptop.jpg",
      "price": "1299.99"
    },
    {
      "name": "Wireless Mouse",
      "imageUrl": "https://example.com/mouse.jpg",
      "price": "29.99"
    }
  ]
}

---

Contoh 3: Gambar Tanda Tangan (Base64)

Templat:

Authorized Signature:
[Text box:] <<image [signatureBase64] -fitSizeLim>>

Name: <<[signatoryName]>>
Date: <<[signatureDate]:"dd.MM.yyyy">>

Data:

{
  "signatureBase64": "iVBORw0KGgoAAAANSUhEUgA...[truncated]",
  "signatoryName": "John Smith",
  "signatureDate": "2024/01/15"
}

---

Gambar dalam Tabel

Gabungkan penyisipan gambar dengan struktur tabel untuk presentasi visual yang terorganisir.

Tabel Katalog Produk

Templat:

Product | Image | Price
<<foreach [item in catalog]>>
<<[item.name]>> | [Text box: <<image [item.imageUrl] -keepRatio>>] | $<<[item.price]>>
<</foreach>>

---

Penyisipan Gambar Bersyarat

Sisipkan gambar hanya jika data gambar tersedia.

Contoh Logo Opsional

Templat:

<<if [logoUrl != null]>>
[Text box:] <<image [logoUrl] -keepRatio>>
<</if>>

Gambar Cadangan Default

Templat:

<<if [productImage != null]>>
[Text box:] <<image [productImage] -fitHeight>>
<<else>>
[Text box:] <<image [defaultProductImage] -fitHeight>>
<</if>>

---

Beberapa Gambar dalam Dokumen

Menghasilkan dokumen dengan banyak gambar dinamis dari satu sumber data.

Contoh: Laporan dengan Grafik

Templat:

Sales Report - <<[reportMonth]:"MMMM yyyy">>

Revenue Chart:
[Text box:] <<image [revenueChartUrl] -fitWidth>>

Expense Chart:
[Text box:] <<image [expenseChartUrl] -fitWidth>>

Growth Chart:
[Text box:] <<image [growthChartUrl] -fitWidth>>

---

Pertimbangan Kualitas Gambar

Praktik Terbaik untuk Gambar URLs

1. Menggunakan HTTPS - Aman URLs mencegah peringatan keamanan
2. Permanen URLs - Memastikan URLs tetap dapat diakses
3. Ukuran yang sesuai - Gunakan gambar dengan ukuran yang sesuai untuk output
4. Kompatibilitas format - Format umum: PNG, JPG, GIF
5. Hosting CDN - Gunakan jaringan penyampaian konten yang andal

Praktik Terbaik untuk Base64 Gambar

1. Optimalkan ukuran file - Kompres gambar sebelum pengkodean
2. Gunakan resolusi yang sesuai. - Sesuaikan resolusi output yang diinginkan
3. Pertimbangkan ukuran data - Besar Base64 string meningkatkan ukuran payload
4. Pemilihan format - PNG demi transparansi, JPG untuk foto
5. Kualitas pengkodean - Pastikan dengan benar Base64 pengkodean

---

Pengaturan Kotak Teks di Word

Membuat Placeholder Gambar

1. Sisipkan Kotak Teks:

   • Menu Word Ribbon → Sisipkan → Kotak Teks
   • Gambar kotak teks di lokasi yang diinginkan
   • Sesuaikan ukuran kotak teks agar mendekati dimensi gambar.

2. Konfigurasi Kotak Teks:

   • Hapus batas kotak teks jika diinginkan.
   • Atur isi kotak teks ke "Tanpa Isi" untuk transparansi.
   • Konfigurasikan pembungkus teks sesuai kebutuhan.

3. Sintaks Tambah Gambar:

   • Klik di dalam kotak teks
   • Ketik sintaks bidang penggabungan gambar
   • Tambahkan opsi pemformatan yang sesuai.

---

Penyelesaian Masalah Penyisipan Gambar

Masalah Umum

Masalah: Gambar tidak muncul di dokumen yang dihasilkan.
Larutan: Pastikan sintaks gambar berada di dalam kotak teks, bukan paragraf biasa.

Masalah: Gambar tampak terdistorsi
Larutan: Menggunakan -keepRatio untuk mempertahankan rasio aspek

Masalah: Gambar terlalu besar atau terlalu kecil
Larutan: Sesuaikan ukuran kotak teks atau gunakan opsi penyesuaian yang sesuai.

Masalah: Base64 Gambar gagal dimuat
Larutan: Verifikasi Base64 Pengkodean telah selesai dan valid.

Masalah: URL Gambar tidak dimuat
Larutan: Memeriksa URL aksesibilitas, memastikan HTTPS, verifikasi format gambar

Masalah: Posisi gambar tidak tepat
Larutan: Pindahkan posisi kotak teks di templat Word.

---

Teknik Pencitraan Tingkat Lanjut

Ukuran Gambar Responsif

Untuk dokumen yang mungkin dilihat dalam berbagai ukuran:

[Large text box:] <<image [headerImage] -fitSizeLim>>

Ini memungkinkan gambar menyusut jika diperlukan tetapi tidak akan meluas melebihi batas kotak teks.

Gambar dengan Keterangan

Templat:

[Text box:] <<image [chartUrl] -fitWidth>>

Figure <<[$index + 1]>>: <<[chartTitle]>>
Source: <<[chartSource]>>

Pemformatan Gambar Bersyarat

Pilih format berdasarkan properti data:

<<if [imageOrientation == "landscape"]>>
[Wide text box:] <<image [imageUrl] -fitWidth>>
<<else>>
[Tall text box:] <<image [imageUrl] -fitHeight>>
<</if>>

---

Contoh Lengkap: Lembar Produk

Templat:

<<[productName]:caps>>

Product Image:
[Text box 300x300:] <<image [productImageUrl] -keepRatio>>

Specifications:
• Model: <<[modelNumber]>>
• Category: <<[category]>>
• Price: $<<[price]:"F2">>

Additional Images:
<<foreach [img in additionalImages]>>
[Text box 150x150:] <<image [img.url] -keepRatio>>
<<[img.caption]>>
<</foreach>>

Company Logo:
[Text box 200x60:] <<image [companyLogoBase64] -fitHeight>>

---

Optimasi Gambar

Untuk hasil terbaik, optimalkan gambar sebelum memasukkannya ke dalam sumber data Anda. Ubah ukuran gambar ke dimensi yang sesuai dan kompres untuk mengurangi ukuran file sambil mempertahankan kualitas.

:::peringatan Persyaratan Kotak Teks Gambar HARUS disisipkan di dalam Kotak Teks pada templat Word. Sintaks gambar dalam paragraf biasa tidak akan menampilkan gambar dengan benar. Selalu buat placeholder kotak teks untuk setiap lokasi gambar dinamis. :::