Bilder einfügen – Dynamischer Bildleitfaden

PDF4me Ermöglicht das dynamische Einfügen von Bildern in generierte Dokumente, sodass Sie Vorlagen mit Logos, Fotos, Diagrammen, Grafiken und anderen visuellen Inhalten aus Ihren Datenquellen füllen können. Bilder können über öffentliche Kanäle bereitgestellt werden. URLs oder Base64-kodierte Zeichenketten.

---

Anforderungen an die Bildsyntax

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.

---

Bildeinfügungsmethoden

PDF4me Unterstützt zwei Methoden zur Bereitstellung von Bilddaten für Vorlagen:

Methode 1: Öffentliches Image URL

Verwenden Sie ein öffentlich zugängliches Bild. URLs um Bilder aus Webquellen einzufügen.

Syntax:

<<image [imageUrl]>>

Datenbeispiel:

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

Anwendungsfälle:

• Firmenlogos werden auf öffentlichen Servern gehostet
• Produktbilder von E-Commerce-Plattformen
• Diagramme und Grafiken werden online erstellt und gehostet.
• Bilder aus öffentlichen Ressourcen

---

Methode 2: Base64 Kodierte Bilder

Fügen Sie Bilder ein mit Base64-kodierte String-Repräsentation der Bilddatei.

Syntax:

<<image [imageBase64]>>

Datenbeispiel:

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

Vorteile:

• Funktioniert auch ohne Internetverbindung
• Sicher – keine externen Abhängigkeiten
• Vollständige Kontrolle über Bilddaten
• Geeignet für vertrauliche Dokumente

---

Bildformatierungsoptionen

Mit Formatierungsoptionen steuern Sie, wie Bilder in Textfeldern dargestellt werden. Diese Optionen bestimmen die Bildgröße und das Seitenverhältnis.

Seitenverhältnis beibehalten

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

Verhalten:

• Behält die Größe des Textfelds bei
• Skaliert das Bild so, dass es in die Grenzen des Textfelds passt.
• Behält das ursprüngliche Bildseitenverhältnis bei
• Das Bild füllt möglicherweise nicht das gesamte Textfeld aus, wenn die Seitenverhältnisse unterschiedlich sind.

Ideal für: Logos, Symbole und Bilder, bei denen Verzerrungen vermieden werden müssen

---

Passformhöhe

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

Verhalten:

• Behält die Breite des Textfelds bei.
• Passt die Höhe des Textfelds an das Seitenverhältnis des Bildes an.
• Das Bild füllt das Textfeld vollständig aus.
• Die Abmessungen des Textfelds ändern sich, um das Bild aufzunehmen.

Ideal für: Bilder mit variabler Höhe in flexiblen Layouts

---

Passende Breite

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

Verhalten:

• Behält die Höhe des Textfelds bei.
• Passt die Breite des Textfelds an das Seitenverhältnis des Bildes an.
• Das Bild füllt das Textfeld vollständig aus.
• Die Breite des Textfelds ändert sich, um das Bild aufzunehmen.

Ideal für: Horizontale Banner, Header mit fester Höhe

---

Passformgröße

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

Verhalten:

• Ändert die Abmessungen des Textfelds, um sie an die Bildgröße anzupassen
• Verwendet die Originalbildabmessungen
• Das Bild wird in Originalgröße angezeigt
• Das Textfeld wird an die exakten Bildabmessungen angepasst.

Ideal für: Wann soll die ursprüngliche Bildgröße exakt beibehalten werden?

---

Passform begrenzt

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

Verhalten:

• Passt das Textfeld an die Bildgröße an
• Die Abmessungen des ursprünglichen Textfelds werden nicht überschritten.
• Das Textfeld kann verkleinert werden, wenn das Bild kleiner ist.
• Verhindert die Vergrößerung des Textfelds

Ideal für: Beschränkung der maximalen Bildgröße bei gleichzeitiger Zulassung kleinerer Bilder

---

Formatierungsvergleich

Formatierungsoption	Breite	Höhe	Seitenverhältnis	Textfeldgröße
-keepRatio	Behoben	Behoben	Konserviert	Unverändert
-fitHeight	Behoben	Variable	Konserviert	Höhenänderungen
-fitWidth	Variable	Behoben	Konserviert	Breitenänderungen
-fitSize	Variable	Variable	Konserviert	Beide ändern sich
-fitSizeLim	Variable	Variable	Konserviert	Eingeschränkt

---

Praktische Beispiele

Beispiel 1: Firmenlogo

Vorlage:

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

Daten:

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

---

Beispiel 2: Produktbilder

Vorlage:

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

<</foreach>>

Daten:

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

---

Beispiel 3: Signaturbild (Base64)

Vorlage:

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

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

Daten:

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

---

Abbildung in Tabellen

Kombinieren Sie Bildeinfügung mit Tabellenstrukturen für übersichtliche visuelle Präsentationen.

Produktkatalogtabelle

Vorlage:

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

---

Bedingte Bildeinfügung

Fügen Sie Bilder nur dann ein, wenn Bilddaten verfügbar sind.

Optionales Logo-Beispiel

Vorlage:

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

Standardbild-Fallback

Vorlage:

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

---

Mehrere Bilder im Dokument

Generieren Sie Dokumente mit mehreren dynamischen Bildern aus einer einzigen Datenquelle.

Beispiel: Bericht mit Diagrammen

Vorlage:

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

---

Überlegungen zur Bildqualität

Bewährte Verfahren für Bilder URLs

1. Verwenden HTTPS - Sicher URLs Sicherheitswarnungen verhindern
2. Dauerhaft URLs - Sicherstellen URLs bleiben zugänglich
3. Angemessene Größe - Verwenden Sie Bilder in der für die Ausgabe geeigneten Größe.
4. Formatkompatibilität - Gängige Formate: PNG, JPG, GIF
5. CDN-Hosting - Nutzen Sie zuverlässige Content-Delivery-Netzwerke.

Bewährte Verfahren für Base64 Bilder

1. Dateigröße optimieren - Bilder vor der Kodierung komprimieren.
2. Verwenden Sie die geeignete Auflösung. - Die gewünschte Ausgabeauflösung anpassen
3. Berücksichtigen Sie die Datengröße. - Groß Base64 Zeichenketten erhöhen die Nutzdatengröße
4. Formatauswahl - PNG Aus Gründen der Transparenz JPG für Fotos
5. Kodierungsqualität - Sicherstellen, dass Base64 Kodierung

---

Textfeld-Einrichtung in Word

Erstellen von Bildplatzhaltern

1. Textfeld einfügen:

   • Menüband → Einfügen → Textfeld
   • Textfeld an der gewünschten Position zeichnen
   • Textfeld zur ungefähren Anpassung der Bildabmessungen verwenden

2. Textfeld konfigurieren:

   • Entfernen Sie bei Bedarf die Rahmen der Textfelder.
   • Stellen Sie die Textfeldfüllung auf „Keine Füllung“, um Transparenz zu gewährleisten.
   • Konfigurieren Sie den Textumbruch nach Bedarf.

3. Syntax zum Hinzufügen von Bildern:

   • Klicken Sie in das Textfeld
   • Syntax für Bild-Merge-Felder
   • Fügen Sie die passende Formatierungsoption hinzu.

---

Fehlerbehebung beim Einfügen von Bildern

Häufige Probleme

Ausgabe: Das Bild wird im generierten Dokument nicht angezeigt.
Lösung: Überprüfen Sie, ob sich die Bildsyntax innerhalb eines Textfelds und nicht in einem normalen Absatz befindet.

Ausgabe: Das Bild erscheint verzerrt.
Lösung: Verwenden -keepRatio um das Seitenverhältnis beizubehalten

Ausgabe: Bild zu groß oder zu klein
Lösung: Passen Sie die Größe des Textfelds an oder verwenden Sie die entsprechende Anpassungsoption.

Ausgabe: Base64 Bild kann nicht geladen werden
Lösung: Verifizieren Base64 Die Kodierung ist vollständig und gültig.

Ausgabe: URL Bild wird nicht geladen
Lösung: Überprüfen URL Barrierefreiheit sicherstellen HTTPSBildformat überprüfen

Ausgabe: Bildposition falsch
Lösung: Textfeld in Word-Vorlage neu positionieren

---

Fortgeschrittene Bildtechniken

Responsive Bildgrößenanpassung

Für Dokumente, die in verschiedenen Größen angezeigt werden können:

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

Dadurch kann das Bild bei Bedarf verkleinert werden, dehnt sich aber nicht über die Grenzen des Textfelds hinaus aus.

Bild mit Bildunterschrift

Vorlage:

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

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

Bedingte Bildformatierung

Formatierung anhand von Dateneigenschaften auswählen:

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

---

Vollständiges Beispiel: Produktdatenblatt

Vorlage:

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

---

:::Tipp Bildoptimierung Für optimale Ergebnisse optimieren Sie Bilder, bevor Sie sie in Ihre Datenquelle einbinden. Passen Sie die Bildgröße an die geeigneten Abmessungen an und komprimieren Sie die Bilder, um die Dateigröße zu reduzieren und gleichzeitig die Qualität zu erhalten.

:::

:::Warnung: Textfeld-Anforderung Bilder MÜSSEN in Word-Vorlagen in Textfelder eingefügt werden. Die Bildsyntax in normalen Absätzen führt nicht zur korrekten Darstellung der Bilder. Erstellen Sie daher für jede dynamische Bildposition einen Textfeld-Platzhalter.

:::