Felder in Output.Rocks

Felder sind die grundlegenden Bausteine für die Datenintegration in Output.Rocks Vorlagen. Sie ermöglichen das Einfügen von Daten, bedingte Logik und die Steuerung von Dokumentflüssen.

Was sind Felder?

In einer Output.Rocks Vorlage werden Felder verwendet, um anzuzeigen, wo Daten eingefügt oder wie der Dokumentfluss gesteuert werden soll. Alle Felder werden durch spezielle Markierungen gekennzeichnet:

Felder beginnen mit << und enden mit >>.
Innerhalb dieser Markierungen steht der Feldname, der die Daten referenziert oder eine spezielle Funktion auslöst.
Produziert das Feld eine Ausgabe, wird diese genau so formatiert wie das abschließende Tag >> im .docx Dokument.

Output.Rocks unterstützt verschiedene Arten von Feldern:

Vorlage:

<<name>>
<<kunde.adresse.strasse>>

Eigenschaften:

Direkte Wertersetzung aus JSON-Daten
Unterstützung verschachtelter Strukturen mit Punktnotation
Automatische Formatierung basierend auf Vorlagen-Styling

Einfache Datenfelder sind die häufigste Feldart und bilden die Grundlage für alle anderen Feldtypen.

Erweiterte Feldtypen

Vorlage:

<<cs_{verbrauch.aktuell > verbrauch.vorjahr}>>
📈 Verbrauchsanstieg
Ihr Stromverbrauch ist um <<{verbrauch.aktuell - verbrauch.vorjahr}>> kWh gestiegen.
Wir empfehlen unsere Energiespartipps.
<<else_{verbrauch.aktuell < verbrauch.vorjahr}>>
📉 Verbrauchsreduzierung
Glückwunsch! Sie haben <<{verbrauch.vorjahr - verbrauch.aktuell}>> kWh eingespart.
<<else>>
➡️ Konstanter Verbrauch
Ihr Verbrauch ist gegenüber dem Vorjahr unverändert.
<<es_>>

Anwendungsfälle:

Personalisierte Verbrauchsanalysen
Tarifspezifische Informationen
Saisonale Hinweise und Empfehlungen
Kundentypspezifische Inhalte

Bedingte Abschnitte ermöglichen intelligente Vorlagen, die sich automatisch an verschiedene Datensituationen anpassen.

Mehr Details unter Bedingte Abschnitte.

Spezielle Felder und Variablen

Verfügbare Spezialfelder:

<<pageBreak>> - Erzwingt einen Seitenumbruch
<<columnBreak>> - Erzwingt einen Spaltenumbruch
<<pageBreakNotLast>> - Seitenumbruch nur wenn nicht letztes Element
<<link:url>> - Erstellt einen Hyperlink
<<barcode:wert>> - Generiert einen Barcode

Spezielle Felder geben Ihnen präzise Kontrolle über das Layout und die Struktur Ihres Dokuments.

Mehr Details unter Seitenumbrüche und andere Umbrüche.

Feldnamenskonventionen

Sie finden die Namensrichtlinien im Vorlagen‑Editor unter "Best Practices".

Grundregeln für Feldnamen

✅ Erlaubte Zeichen

Buchstaben: a-z, A-Z (Anfang erforderlich)
Zahlen: 0-9 (nach erstem Buchstaben)
Unterstriche: _ (überall erlaubt)
Bindestriche: - (mit Einschränkungen)

❌ Nicht erlaubt

Zahlen am Anfang: 1kunde
Sonderzeichen: @, #, $, %, &
Leerzeichen: kunde name
Umlaute: ä, ö, ü, ß

Spezielle Namenskonventionen

Punktnotation für JSON-Hierarchien:

<<vertrag.tarif.grundpreis>>
<<verbrauch.historie[0].kwh>>

Beispiel-JSON:

{
  "kunde": {
    "adresse": {
      "strasse": "Energieweg 15"
    }
  },
  "vertrag": {
    "tarif": {
      "grundpreis": 12.95
    }
  }
}

Die Punktnotation ermöglicht den Zugriff auf beliebig tief verschachtelte Datenstrukturen.

Wichtige Hinweise zur Felderkennung

Strenge Syntaxregeln: Output.Rocks ist sehr streng bei der Erkennung von Feldern. Wenn ein Feld nicht korrekt formatiert ist, wird es ignoriert und als statischer Text behandelt.

Leerzeichen-Toleranz: Zwischen den öffnenden << und dem Feldnamen sowie zwischen dem Feldnamen und den schließenden >> ist ein einzelnes Leerzeichen erlaubt. Mehr Leerzeichen führen zur Nicht-Erkennung des Feldes.

Formatierung: Die Formatierung der Ausgabe wird durch das Styling des abschließenden >> Tags in der .docx-Vorlage bestimmt (Schriftart, Größe, Farbe, etc.).