Lewati ke konten utama
API PDF4meIntegrasiBasis PengetahuanEkstensiPenguji APIBlog

Hyperlink dalam Templat - Panduan Tautan Dinamis

Hyperlink telah menjadi komponen penting dalam dokumen modern, muncul dalam faktur, kontrak, penawaran harga, dokumen hukum, laporan, dan berbagai komunikasi bisnis. PDF4me Memungkinkan penyisipan hyperlink dinamis di dalam dokumen yang dihasilkan, sehingga Anda dapat membuat dokumentasi interaktif yang terhubung ke web.

Sisipkan hyperlink yang dapat diklik ke dalam dokumen Anda menggunakan sintaks templat berikut:

<<link[linkUrl][linkDisplay]>>

Komponen:

  • linkUrl - Targetnya URL atau alamat web
  • linkDisplay - Teks yang ditampilkan untuk tautan yang dapat diklik

Contoh Tautan Sederhana​

Penyisipan Tautan Sederhana​

Sintaks Templat:

Visit our website: <<link[websiteUrl][companyName]>>

Sumber Data (JSON):

{
  "websiteUrl": "https://dev.pdf4me.com/",
  "companyName": "PDF4me API Website"
}

Output yang dihasilkan:

Visit our website: PDF4me API Website

(Di mana "PDF4me API "Situs web" adalah tautan yang dapat diklik ke https://dev.pdf4me.com/)

Buat beberapa hyperlink dalam satu dokumen menggunakan kolom data yang berbeda.

Contoh: Informasi Kontak​

Templat:

Website: <<link[website][websiteName]>>
Support Portal: <<link[supportUrl][supportText]>>
Documentation: <<link[docsUrl][docsText]>>

Data:

{
  "website": "https://pdf4me.com/",
  "websiteName": "PDF4me Homepage",
  "supportUrl": "https://dev.pdf4me.com/support/",
  "supportText": "Contact Support",
  "docsUrl": "https://dev.pdf4me.com/documentation/",
  "docsText": "View Documentation"
}

Tautan hiperteks dalam tabel​

Gabungkan hyperlink dengan struktur tabel untuk penyajian tautan yang terorganisir.

Contoh Tabel Sumber Daya​

Templat:

Resource | Link
<<foreach [resource in resources]>>
<<[resource.name]>> | <<link[resource.url][resource.linkText]>>
<</foreach>>

Data:

{
  "resources": [
    {
      "name": "API Documentation",
      "url": "https://dev.pdf4me.com/documentation/",
      "linkText": "View Docs"
    },
    {
      "name": "Support Center",
      "url": "https://dev.pdf4me.com/support/",
      "linkText": "Get Help"
    },
    {
      "name": "Code Samples",
      "url": "https://github.com/pdf4me/samples",
      "linkText": "Browse Code"
    }
  ]
}

Dinamis URL Konstruksi​

Membangun URLs menggunakan ekspresi dan penggabungan secara dinamis.

Contoh: Tautan Produk​

Templat:

<<foreach [product in products]>>
Product: <<[product.name]>>
View Details: <<link["https://example.com/product/" + product.id][product.name]>>
<</foreach>>

Contoh: Tautan Email​

Templat:

Contact: <<link["mailto:" + employee.email][employee.name]>>

Data:

{
  "employee": {
    "name": "John Smith",
    "email": "[email protected]"
  }
}

Keluaran:

Contact: John Smith

(Mengklik akan membuka aplikasi email dengan alamat dari templat.)

Tautan Bersyarat​

Tampilkan hyperlink hanya jika kondisi tertentu terpenuhi.

Contoh: Tautan Situs Web Opsional​

Templat:

<<if [websiteUrl != null]>>
Visit us: <<link[websiteUrl][websiteName]>>
<</if>>

Templat dengan Foreach:

<<foreach [contact in contacts]>>
<<[contact.name]>>
<<if [contact.website != null]>> - <<link[contact.website]["Visit Website"]>><</if>>
<</foreach>>

Teks Tampilan yang Diformat​

Terapkan pemformatan teks pada teks tampilan hyperlink untuk tautan bergaya.

Contoh: Tautan yang Ditulis dengan Huruf Kapital​

Templat:

Visit: <<link[url][companyName:caps]>>

Data:

{
  "url": "https://pdf4me.com",
  "companyName": "pdf4me solutions"
}

Keluaran:

Visit: Pdf4me Solutions

(Dengan penulisan huruf kapital yang tepat dan tautan yang dapat diklik)

Kasus Penggunaan Umum​

Templat:

Questions? Visit our FAQ: <<link[faqUrl]["FAQ Page"]>>
Payment Portal: <<link[paymentUrl]["Pay Invoice"]>>
Contact Support: <<link["mailto:" + supportEmail]["Email Support"]>>

Referensi Laporan​

Templat:

Data Sources:
<<foreach [source in dataSources]>>
- <<[source.name]>>: <<link[source.url][source.description]>>
<</foreach>>

Katalog Produk​

Templat:

<<foreach [product in products]>>
Product Name: <<[product.name]>>
Price: $<<[product.price]>>
More Info: <<link[product.detailsUrl]["View Details"]>>

<</foreach>>

URL Manajemen​

  1. Validasi URLs - Memastikan URLs diformat dengan benar sebelum diteruskan ke template.
  2. Menggunakan HTTPS - Lebih suka yang aman HTTPS URLs jika memungkinkan
  3. Teks tampilan singkat - Buat teks tautan ringkas dan deskriptif
  4. Tautan uji - Verifikasi bahwa semua tautan yang dihasilkan berfungsi dengan benar

Penataan Tautan​

  1. Format yang konsisten - Gunakan pola teks tautan yang serupa di seluruh dokumen.
  2. Konteks yang jelas - Jelaskan tujuan tautan secara jelas dari teks yang ditampilkan
  3. Perbedaan visual - Pastikan tautan dapat dibedakan secara visual (biasanya otomatis)

Persiapan Data​

  1. Mengenkode karakter khusus - Menangani karakter khusus di URLs dengan baik
  2. Berikan nilai default - Sediakan nilai cadangan untuk nilai yang hilang URL data
  3. Validasi - Validasi URL format dalam aplikasi Anda sebelum pemrosesan templat

Tautan Web​

<<link["https://example.com"]["Visit Website"]>>

Tautan Email​

<<link["mailto:[email protected]"]["Email Us"]>>

Gunakan email Anda sendiri atau alamat email sementara; hindari menggunakan alamat email dukungan/kontak mentah dalam templat untuk mencegah tautan rusak di beberapa penyedia hosting.

Tautan Dokumen​

<<link["file:///path/to/document.pdf"]["View PDF"]>>

Tautan Telepon (untuk penampil yang kompatibel)​

<<link["tel:+1234567890"]["Call Us"]>>

Penyelesaian Masalah​

Masalah Umum​

Masalah: Tautan tidak dapat diklik dalam dokumen yang dihasilkan.
Larutan: Pastikan sintaksnya sama persis: <<link[url][text]>>

Masalah: Rusak URLs dalam output
Larutan: Periksa karakter khusus; lakukan pengkodean URLs dengan baik

Masalah: Teks yang ditampilkan menunjukkan sintaks bidang gabungan.
Larutan: Pastikan penutupan >> tanda kurung ada

Masalah: Tautan ditampilkan sebagai teks biasa.
Larutan: Verifikasi apakah penampil dokumen mendukung hyperlink.

Contoh Lengkap: Komunikasi Pelanggan​

Templat:

Dear <<[customerName]>>,

Thank you for your recent purchase. Your order details are available at:
<<link[orderTrackingUrl]["Track Your Order"]>>

For assistance, please visit:
- Help Center: <<link[helpUrl]["Get Help"]>>
- Email Support: <<link["mailto:" + supportEmail]["Contact Support"]>>
- Live Chat: <<link[chatUrl]["Start Chat"]>>

Best regards,
<<[companyName]>>

Data:

{
  "customerName": "John Smith",
  "orderTrackingUrl": "https://example.com/track/12345",
  "helpUrl": "https://example.com/help",
  "supportEmail": "[email protected]",
  "chatUrl": "https://example.com/chat",
  "companyName": "Acme Corporation"
}
Pengujian Tautan

Selalu uji dokumen yang dihasilkan dengan hyperlink sebenarnya untuk memastikan tautan tersebut berfungsi dengan benar di berbagai platform. PDF pemirsa dan platform. Beberapa pemirsa mungkin menangani jenis tautan tertentu secara berbeda.