Stil-Tab

Erscheinungsbild und Verhalten von Elementen konfigurieren.

Der Stil-Tab dient der Anpassung der Eigenschaften des aktuell ausgewählten Elements. Die verfügbaren Optionen ändern sich je nach Elementtyp (Text, Bild, Barcode usw.).

Gemeinsame Layout-Eigenschaften

Alle Elemente teilen grundlegende Layout-Steuerungen:

  • X / Y: Die Koordinaten des Elements in Millimetern.
  • Positionsmodus:
    • Absolut: Feste Koordinaten (X, Y) relativ zum Seitenursprung.
    • Relativ: Positioniert das Element automatisch unterhalb des vorherigen Elements in der Ebenenliste. Nützlich für dynamische Inhalte, die sich ausdehnen.
  • Breite / Höhe: Die Abmessungen des Elements in Millimetern.
    • 0 = Auto: Die meisten Elemente dehnen sich automatisch aus, um ihren Inhalt aufzunehmen, wenn der Wert auf 0 gesetzt ist.

Bedingte Sichtbarkeit

Elemente unterstützen eine visible-Eigenschaft (über YAML konfigurierbar), die ein Element basierend auf Datenwerten bedingt ein- oder ausblendet. Wenn die Bedingung false ergibt, wird das Element bei der PDF-Generierung vollständig übersprungen.

Beispiel (in der Vorlagen-YAML):

visible: "{{Status}} == 'PAID'"

Elementspezifische Einstellungen

Textelement

Das Textelement unterstützt dynamische Größenanpassung und Überlaufbehandlung.

  • Auto-Sizing (Breite/Höhe = 0):

    • Wenn Breite und Höhe 0 sind, dehnt sich das Textfeld automatisch horizontal und vertikal aus, um den Inhalt aufzunehmen (unbegrenzt).

  • Feste Abmessungen:

    • Wenn Sie eine bestimmte Breite festlegen, wird der Text innerhalb dieser Breite umgebrochen.
    • Wenn Sie eine bestimmte Höhe festlegen, können Sie das Überlaufverhalten steuern.
    • Überlauf:
      • Sichtbar: Inhalt, der über die Box hinausragt, bleibt sichtbar.
      • Abschneiden: Inhalt, der die Abmessungen überschreitet, wird ausgeblendet.

  • Zeilenhöhe: Steuert den vertikalen Abstand zwischen Textzeilen. Angabe als Multiplikator (z. B. 1,2 = 120 % der Schriftgröße).

Bildelement

  • Quelle: Wenn Sie ein Bild auswählen, wird es automatisch in den assets-Ordner innerhalb Ihres Profilarbeitsbereichs kopiert.
  • Anpassung: Steuert die Skalierung des Bildes innerhalb seiner Box (Einpassen, Füllen, Strecken).
  • Deckkraft: Steuert die Transparenz des Bildes (0–100 %).

Barcode-Element

Generiert Standard-1D-Barcodes.

  • Typen: CODE128, JAN, EAN13, EAN8, CODE39, UPCA, NW-7, ITF
  • JAN/EAN:
    • Unterstützt 13-stellige oder 8-stellige Codes.
    • Wenn Sie eine 12-stellige Zahl für JAN/EAN13 eingeben, berechnet die Engine automatisch die Prüfziffer und fügt sie an.
  • CODE39:
  • NW-7 (Codabar):
    • Ähnlich wie CODE39 müssen Sie die Start-/Stoppzeichen (A, B, C oder D) in Ihren Eingabedaten einschließen (z. B. A12345678A).
  • CODE128:
    • Wechselt automatisch zwischen den Subsets A, B und C, um die Barcodelänge zu optimieren. Sie müssen das Subset nicht manuell angeben.

QR-Code-Element

Generiert 2D-QR-Codes.

  • Farbe: Legt die Vordergrundfarbe der QR-Code-Module fest.
  • Hintergrundfarbe: Legt die Hintergrundfarbe hinter dem QR-Code fest.
  • Deckkraft: Steuert die Transparenz des QR-Codes (0–100 %).
  • Ruhezone:
    • Standardmäßig wird ein 4-Modul-Rand angewendet.
    • Deaktivieren Sie Ruhezone verwenden, um den Rand auf Null zu setzen (randlos).

Statische Tabelle

Eine Tabelle mit fester Zeilen- und Spaltenanzahl, manuell bearbeitbar.

  • Spalten: Anzahl der Spalten und deren Überschriften definieren.
  • Zeilen: Zeilen manuell hinzufügen oder entfernen.
  • Inhaltstypen: Zellen können Text, Barcode oder QR-Code enthalten.
  • Mindestzeilen:
    • Stellt sicher, dass die Tabelle immer mindestens N Zeilen anzeigt.
    • Wenn die manuellen Daten weniger als N Zeilen umfassen, werden leere Platzhalterzeilen hinzugefügt.

Gruppentabelle (Transaktionsdaten)

Eine dynamische Tabelle, die über Transaktionsdaten iteriert, die mit einem Gruppierungsschlüssel verknüpft sind.

  • Gruppierungsschlüssel: Definiert, welche Transaktionsdatensätze für diese Tabelle gruppiert werden.
  • Inhaltstypen: Unterstützt Text, Barcode und QR-Code in Zellen.
  • Mindestzeilen:
    • Stellt sicher, dass die Tabelle immer mindestens N Zeilen anzeigt, und fügt leere Zeilen hinzu, wenn die Transaktionsdaten weniger als N Zeilen umfassen.
    • Nützlich für ein einheitliches Layouthöhe auch bei variablen Datenmengen.
  • Seitenumbruch:
    • Wenn die Zeilenanzahl die Seitenhöhe (definiert durch Ränder) überschreitet, bricht die Tabelle automatisch um und wird auf der nächsten Seite fortgesetzt.
  • Summen & Fußzeilen:
    • Die Gruppentabelle hat keine eingebaute Fußzeile für Summen.
    • Lösung: Erstellen Sie ein separates Text- oder Statische Tabelle-Element für Ihre Summen und platzieren Sie es in der Ebenenliste unterhalb der Gruppentabelle. Setzen Sie den Positionsmodus auf Relativ.
    • Abstandskontrolle: Im Relativen Modus können Sie über die Y-Eigenschaft den vertikalen Abstand (in mm) zwischen dem unteren Rand der Gruppentabelle und dem oberen Rand dieses Fußzeilenelements festlegen.