#Erweiterte Funktionen

#Paginierung

#1. Seitenzahlen aktualisieren

#Syntax

Fügen Sie diese einfach in Ihrer Office-Software ein.

#Beispiel

In Microsoft Word:

• Verwenden Sie die Funktion „Einfügen → Seitenzahl“. In LibreOffice:
• Verwenden Sie die Funktion „Einfügen → Felder → Seitenzahl“.

#Ergebnis

Im generierten Bericht werden die Seitenzahlen auf jeder Seite automatisch aktualisiert.

#2. Inhaltsverzeichnis erstellen

#Syntax

Fügen Sie diese einfach in Ihrer Office-Software ein.

#Beispiel

In Microsoft Word:

• Verwenden Sie die Funktion „Einfügen → Index und Tabellen → Inhaltsverzeichnis“. In LibreOffice:
• Verwenden Sie die Funktion „Einfügen → Verzeichnisse → Verzeichnis, Index oder Bibliografie“.

#Ergebnis

Das Inhaltsverzeichnis des Berichts wird automatisch basierend auf dem Dokumentinhalt aktualisiert.

#3. Tabellenüberschriften wiederholen

#Syntax

Fügen Sie diese einfach in Ihrer Office-Software ein.

#Beispiel

In Microsoft Word:

• Klicken Sie mit der rechten Maustaste auf die Tabellenüberschrift → Tabelleneigenschaften → Aktivieren Sie „Als Kopfzeile auf jeder Seite wiederholen“. In LibreOffice:
• Klicken Sie mit der rechten Maustaste auf die Tabellenüberschrift → Tabelleneigenschaften → Registerkarte „Textfluss“ → Aktivieren Sie „Überschrift wiederholen“.

#Ergebnis

Wenn eine Tabelle mehrere Seiten umfasst, wird die Überschrift automatisch oben auf jeder Seite wiederholt.

#Internationalisierung (i18n)

#1. Statische Textübersetzung

#Syntax

Verwenden Sie das Tag {t(Text)}, um statischen Text zu internationalisieren:

{t(meeting)}

#Beispiel

Im Template:

{t(meeting)} {t(apples)}

JSON-Daten oder ein externes Lokalisierungs-Wörterbuch (z. B. für „fr-fr“) stellen die entsprechenden Übersetzungen bereit, wie z. B. „meeting“ → „rendez-vous“ und „apples“ → „Pommes“.

#Ergebnis

Beim Generieren des Berichts wird der Text entsprechend der Zielsprache durch die passende Übersetzung ersetzt.

#2. Dynamische Textübersetzung

#Syntax

Für Dateninhalte können Sie den :t-Formatierer verwenden, zum Beispiel:

{d.id:ifEQ(2):show({t(monday)}):elseShow({t(tuesday)})}

#Beispiel

Im Template:

{d.id:ifEQ(2):show({t(monday)}):elseShow({t(tuesday)})}

JSON-Daten und das Lokalisierungs-Wörterbuch stellen die entsprechenden Übersetzungen bereit.

#Ergebnis

Basierend auf der Bedingung wird „lundi“ oder „mardi“ ausgegeben (am Beispiel der Zielsprache).

#Schlüssel-Wert-Zuordnung

#1. Enum-Konvertierung (:convEnum)

#Syntax

{Daten:convEnum(EnumName)}

Zum Beispiel:

0:convEnum('ORDER_STATUS')

#Beispiel

Im API-Optionsbeispiel wird Folgendes übergeben:

{
  "enum": {
    "ORDER_STATUS": ["pending", "sent", "delivered"]
  }
}

Im Template:

0:convEnum('ORDER_STATUS')

#Ergebnis

Es wird „pending“ ausgegeben; wenn der Index den Enum-Bereich überschreitet, wird der ursprüngliche Wert ausgegeben.

#Dynamische Bilder

2. Klicken Sie mit der rechten Maustaste auf dieses Bild, bearbeiten Sie dessen „Alternativtext“ und geben Sie das gewünschte Bildfeld-Label ein, z. B. {d.imageUrl}:

3. Verwenden Sie die folgenden Beispieldaten zum Rendern:

{
  "name": "Apple",
  "imageUrl": "https://images.pexels.com/photos/206959/pexels-photo-206959.jpeg"
}

4. Im gerenderten Ergebnis wird das temporäre Bild durch das tatsächliche Bild ersetzt:

#Mehrere Bilder in einer Schleife ersetzen

Wenn Sie eine Gruppe von Bildern in die Vorlage einfügen möchten, z. B. eine Produktliste, können Sie dies auch über Schleifen realisieren. Die genauen Schritte sind wie folgt:

1. Angenommen, Ihre Daten sehen wie folgt aus:

{
  "products": [
    {
      "name": "Apple",
      "imageUrl": "https://images.pexels.com/photos/206959/pexels-photo-206959.jpeg"
    },
    {
      "name": "Banana",
      "imageUrl": "https://images.pexels.com/photos/61127/pexels-photo-61127.jpeg"
    }
  ]
}

2. Richten Sie in der DOCX-Vorlage einen Schleifenbereich ein und fügen Sie in jedem Schleifenelement temporäre Bilder ein, deren Alternativtext auf {d.products[i].imageUrl} gesetzt ist, wie unten gezeigt:

3. Nach dem Rendern werden alle temporären Bilder durch die entsprechenden Datenbilder ersetzt:

#Dynamische Bilder in XLSX-Dateien einfügen

Die Vorgehensweise in Excel-Vorlagen (XLSX) ist im Wesentlichen dieselbe, beachten Sie jedoch die folgenden Punkte:

1. Stellen Sie nach dem Einfügen eines Bildes sicher, dass Sie „Bild in Zelle“ auswählen und nicht, dass das Bild über der Zelle schwebt.

2. Nachdem Sie die Zelle ausgewählt haben, klicken Sie auf „Alternativtext anzeigen“, um das Feld-Label einzugeben, z. B. {d.imageUrl}.

#Barcode

#Barcodes generieren (z. B. QR-Codes)

Die Barcode-Generierung funktioniert auf die gleiche Weise wie bei dynamischen Bildern und erfordert nur drei Schritte:

1. Fügen Sie ein temporäres Bild in die Vorlage ein, um die Barcode-Position zu markieren.

2. Bearbeiten Sie den „Alternativtext“ des Bildes und geben Sie das Barcode-Format-Feld-Label ein, z. B. {d.code:barcode(qrcode)}, wobei qrcode der Barcode-Typ ist (siehe unterstützte Liste unten).

3. Nach dem Rendern wird das Platzhalterbild automatisch durch das entsprechende Barcode-Bild ersetzt:

#Unterstützte Barcode-Typen