Ana içeriğe geç
PDF4me APIEntegrasyonlarBilgi BankasıUzantılarAPI Test CihazıBlog

Şablonlardaki Köprü Bağlantıları - Dinamik Bağlantılar Kılavuzu

Hiper bağlantılar, faturalarda, sözleşmelerde, tekliflerde, yasal belgelerde, raporlarda ve çeşitli ticari iletişimlerde yer alarak modern belgelerin vazgeçilmez bir parçası haline gelmiştir. PDF4me Oluşturulan belgeler içinde dinamik köprü ekleme olanağı sağlayarak etkileşimli, web bağlantılı dokümanlar oluşturmanıza olanak tanır.

Köprü Bağlantı Sözdizimi​

Aşağıdaki şablon sözdizimini kullanarak belgelerinize tıklanabilir köprüler ekleyin:

<<link[linkUrl][linkDisplay]>>

Bileşenler:

  • linkUrl - Hedef URL veya web adresi
  • linkDisplay - Tıklanabilir bağlantı için görüntülenen metin

Temel Köprü Örneği​

Basit Bağlantı Ekleme​

Şablon Sözdizimi:

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

Veri Kaynağı (JSON):

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

Oluşturulan Çıktı:

Visit our website: PDF4me API Website

(Nerede "PDF4me API "Web sitesi" tıklanabilir bir bağlantıdır. https://dev.pdf4me.com/)

Birden fazla köprü bağlantısı​

Belge içinde farklı veri alanlarını kullanarak birden fazla köprü oluşturun.

Örnek: İletişim Bilgileri​

Şablon:

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

Veri:

{
  "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"
}

Tablolardaki Köprü Bağlantıları​

Düzenli bağlantı sunumları için köprü bağlantılarını tablo yapılarıyla birleştirin.

Kaynak Tablosu Örneği​

Şablon:

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

Veri:

{
  "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"
    }
  ]
}

Dinamik URL Yapı​

İnşa etmek URLs İfadeler ve birleştirmeler kullanarak dinamik olarak.

Örnek: Ürün Bağlantıları​

Şablon:

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

Örnek: E-posta Bağlantıları​

Şablon:

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

Veri:

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

Çıktı:

Contact: John Smith

(Tıklama, şablondaki adresle e-posta istemcisini açar.)

Koşullu Köprü Bağlantıları​

Yalnızca belirli koşullar karşılandığında köprü bağlantıları görüntüle.

Örnek: İsteğe Bağlı Web Sitesi Bağlantısı​

Şablon:

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

Foreach içeren şablon:

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

Biçimlendirilmiş Görüntü Metni​

Biçimlendirilmiş bağlantılar için köprü görüntü metnine metin biçimlendirmesi uygulayın.

Örnek: Büyük Harfle Yazılmış Bağlantılar​

Şablon:

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

Veri:

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

Çıktı:

Visit: Pdf4me Solutions

(Doğru büyük/küçük harf kullanımı ve tıklanabilir bağlantı ile)

Yaygın Kullanım Senaryoları​

Bağlantılar İçeren Fatura Alt Bilgisi​

Şablon:

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

Rapor Referansları​

Şablon:

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

Ürün Kataloğu​

Şablon:

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

<</foreach>>

Köprü Bağlantısı En İyi Uygulamaları​

URL Yönetmek​

  1. Doğrula URLs - Emin olmak URLs Şablonlara aktarılmadan önce düzgün şekilde biçimlendirilirler.
  2. Kullanmak HTTPS - Güvenliği tercih edin HTTPS URLs mümkün olduğu yerlerde
  3. Kısa görüntüleme metni - Bağlantı metinlerini kısa ve açıklayıcı tutun.
  4. Test bağlantıları - Oluşturulan tüm bağlantıların doğru çalıştığını doğrulayın.

Bağlantı Stili​

  1. Tutarlı biçimlendirme - Belgeler genelinde benzer bağlantı metni kalıpları kullanın.
  2. Açık bağlam - Bağlantının amacını görüntülenen metinden açıkça belirtin.
  3. Görsel farklılık - Bağlantıların görsel olarak ayırt edilebilir olduğundan emin olun (genellikle otomatiktir).

Veri Hazırlığı​

  1. Özel karakterleri kodlayın - Özel karakterleri ele alma URLs düzgün bir şekilde
  2. Varsayılan değerleri sağlayın - Eksik değerler için yedek değerler bulundurun URL veri
  3. Doğrulama - Doğrula URL Şablon işleme başlamadan önce uygulamanızdaki formatları kontrol edin.

Desteklenen Köprü Bağlantı Türleri​

Web Bağlantıları​

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

E-posta Bağlantıları​

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

Kendi e-posta adresinizi veya yer tutucu bir adres kullanın; bazı sunucularda bağlantıların bozulmasını önlemek için şablonlarda ham destek/iletişim e-posta adreslerinden kaçının.

Belge Bağlantıları​

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

Telefon Bağlantıları (uyumlu izleyiciler için)​

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

Sorun giderme​

Sık Karşılaşılan Sorunlar​

Sorun: Oluşturulan belgedeki bağlantılar tıklanamaz durumda.
Çözüm: Sözdiziminin tam olarak eşleştiğini doğrulayın: <<link[url][text]>>

Sorun: Kırık URLs çıktıda
Çözüm: Özel karakterleri kontrol et; kodla URLs düzgün bir şekilde

Sorun: Görüntülenen metin, birleştirme alanı sözdizimini gösterir.
Çözüm: Kapanışı sağlayın >> parantezler mevcuttur

Sorun: Bağlantılar düz metin olarak görüntülenir.
Çözüm: Belge görüntüleyicinin köprüleri desteklediğini doğrulayın.

Örnek: Müşteri İletişimi​

Şablon:

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]>>

Veri:

{
  "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"
}

:::İpucu: Bağlantı Testi Oluşturulan belgelerin farklı ortamlarda doğru şekilde çalıştığından emin olmak için her zaman gerçek köprü bağlantılarıyla test edin. PDF İzleyiciler ve platformlar. Bazı izleyiciler belirli bağlantı türlerini farklı şekilde ele alabilir.

:::