Zum Hauptinhalt springen

Platzhalter

Beim Erstellen von Dokumenten in KOMMERZ werden teilweise Platzhalter verwendet, die bei der Erzeugung des Dokuments durch die endgültigen Werte ersetzt werden. Diese mögen kryptisch erscheinen, sind aber nützlich, um Dokumente dynamisch zu gestalten.

Beispiel:

Rechnungsdatum wird durch den Platzhalter [(${invoice.invoiceDate})] repräsentiert. Da das Rechnungsdatum erst bei Abschluss der Rechnung festgesetzt wird, steht an dieser Stelle der Platzhalter, solange sich die Rechnung im Entwurfsstatus befindet.

Platzhalter verwenden

In bestimmten Feldern können bei der Dokumentenerstellung Platzhalter verwendet werden, so dass du sie mit dynamischen Werten füllen lassen kannst. Du wirst sehen, dass einige Vorlagen in KOMMERZ Platzhalter enhalten. Du kannst selber Platzhalter in Vorlagen manuell einfügen, entfernen oder verschieben.

Platzhalter in Platzhaltern

Der Inhalt eines Platzhalters darf nicht seinerseits einen Platzhalter verwenden. Wenn beispielsweise Rechnung Fußtext den PLatzhalter [(${invoice.textFields.reference})] (= Referenz) verwendet, dann darf der Inhalt von Referenz nicht seinerseits einen Platzhalter verwenden.

Anwendungsbeispiel: Rechnungen

In der Rechnungserstellung können Platzhalter in folgenden Feldern verwendet werden:

  • Referenz
  • Kontaktperson
  • Betreff
  • Kopftext
  • Fußtext

Platzhalter für folgende Werte stehen dir dabei zur Verfügung:

  • Rechnungsnummer: [(${invoice.invoiceNumber})]
  • Rechnungsdatum: [(${invoice.invoiceDate})]
  • Zahlungsfrist: [(${invoice.daysOfGrace})]
  • Deine Kontaktdaten (siehe Konfiguration) [(${invoice.textFields.contact})]
  • Auftragsnummer/Referenz: [(${invoice.textFields.reference})]
  • Zahlungsziel: [(${invoice.deliveryDate})]