Ersetzungscodes und Bedingungen

Mit Ersetzungscodes schreiben Sie einen Text einmal und Octoserv setzt beim Anzeigen oder Versenden die Daten des Kontakts ein: den Namen, die Anrede, die Firma, ein Datum. Mit Bedingungen entscheiden Sie zusätzlich, welcher Satz überhaupt erscheint. So beginnt ein Angebot mit „Guten Tag Herr Wittmann,“, wenn Anrede und Nachname da sind, und sonst mit „Guten Tag,“.

Wo die Codes gelten

Es ist ein gemeinsames System. Ein Code bedeutet überall dasselbe und Sie lernen es nur einmal:

Absender und Unterschrift

In Brief- und Dokumentvorlagen (nicht in E-Mails) gibt es die Codes {sender.signature} (die Unterschrift als Bild), {sender.name}, {sender.first_name}, {sender.last_name}, {sender.email} und {sender.phone}. Sie gelten für den Benutzer, der das Dokument erstellt oder versendet. {sender.email} ist die Absenderadresse, die beim Erstellen oder Versenden gewählt ist (zentrale Adresse des Unternehmens oder eigene Adresse; Voreinstellung in den Angebotseinstellungen und unter Einstellungen → SMTP), nie die Adresse, mit der sich der Benutzer anmeldet. Die zentrale Adresse gibt es auch als {business.email}. Ohne Benutzer, zum Beispiel in einem Flow, bleiben die Codes {sender.*} leer. Mehr unter „Ein Brief aus einer Vorlage“.

Einen Code einfügen

Neben jedem Textfeld, das Codes versteht, sitzt der Knopf { } Tag. Er öffnet die Liste aller Codes, nach Gruppen geordnet und durchsuchbar. Ein Klick setzt den Code an die Stelle des Cursors. Oder Sie schreiben ihn von Hand in geschweiften Klammern.

CodeErgebnis
{contact.first_name}Vorname des Kontakts
{contact.last_name}Nachname des Kontakts
{contact.salutation}Anrede, zum Beispiel Herr oder Frau
{company.name}Firma des Kontakts
{owner.full_name}Name der zuständigen Person
{gruss}Eine eigene Ersetzungsregel, hier Ihre Grußformel
{offer.number}, {offer.title}, {offer.valid_until}Nur in Angeboten: Nummer, Titel und Gültigkeit des Angebots
Unbekannte Codes: Ein Code, der falsch geschrieben ist oder zu dem es nichts gibt, wird nicht ersetzt. Er bleibt als Text stehen. Prüfen Sie darum jeden neuen Text einmal in der Vorschau.

Ein Ersatztext, wenn der Wert fehlt

Nach einem senkrechten Strich schreiben Sie, was erscheinen soll, wenn der Kontakt keinen Wert hat:

Guten Tag {contact.first_name|liebe Kundin, lieber Kunde},

Bedingungen

Mit {if …}, {else} und {/if} erscheint ein Teil des Textes nur, wenn eine Bedingung stimmt. Das ist der Weg zu einer sauberen Anrede:

{if contact.salutation and contact.last_name}Guten Tag {contact.salutation} {contact.last_name},{else}Guten Tag,{/if}

Hat der Kontakt Anrede und Nachnamen, steht dort „Guten Tag Herr Wittmann,“. Fehlt eines von beiden, steht dort „Guten Tag,“. Die OctoPages-Angebote beginnen genau so.

Die Bedingung ist einer dieser Formen:

SchreibweiseBedeutung
{if contact.last_name}stimmt, wenn der Code einen Wert hat
{if !contact.last_name}stimmt, wenn der Code leer ist
{if contact.salutation == "Frau"}Vergleich: == (oder =), !=, ~ (enthält), !~ (enthält nicht), >, >=, <, <=
{if a and b}, {if a or b}Verknüpfung; „and“ bindet stärker als „or“

Mit {elseif …} prüfen Sie eine weitere Bedingung. Bedingungen dürfen ineinander stehen. Vergleichen Sie Zahlen, wird zahlenmäßig verglichen, sonst als Text ohne Beachtung der Groß-/Kleinschreibung. Steht ein {if} ohne {/if}, bleibt der Block unverändert stehen.

Formatieren

Hinter dem senkrechten Strich können Sie einen Wert umformen, auch mehrere nacheinander: {contact.last_name|upper}.

FormatWirkung
upper, lower, title, ucfirstGroß-/Kleinschreibung
trimLeerzeichen am Rand entfernen
substr:0,3ein Teil des Textes (Start, Länge)
truncate:40höchstens 40 Zeichen, bei Kürzung mit „...“
number:2Zahl mit Nachkommastellen, deutsch 1.234,50
date:d.m.Yein Datum in der angegebenen Schreibweise
and_list, or_list, csv, ul, olListen als „a, b und c“, „a, b oder c“, „a, b, c“ oder als Aufzählung

Datum

{date} ist das heutige Datum in Ihrer Zeitzone, {date.d.m.Y} in der Schreibweise Ihrer Wahl. Dahinter können Sie das Datum verschieben:

Dieses Angebot gilt bis {date.d.m.Y|+14 days}.

Erlaubt ist alles, was der Datumsleser versteht: +2 days, -1 week, next monday, first day of next month. Mit {local_date} gilt die Zeitzone des Kontakts.

Beispiel im Angebot

Im Angebotseditor, Reiter Anschreiben, haben Einleitung und Schlusstext den Knopf { } Tag. Die Vorschau zeigt den Text sofort mit den Daten des Kontakts. Textblöcke in den Bereichen verstehen die Codes ebenfalls. In der Vorschau stehen sie so, wie Sie sie tippen, in der Webansicht und im PDF des Kunden sind sie ersetzt.

{if contact.salutation and contact.last_name}Guten Tag {contact.salutation} {contact.last_name},{else}Guten Tag,{/if}

vielen Dank für Ihre Anfrage zum Angebot {offer.number}.
Vorlagen: Schreiben Sie die Codes in die Angebotsvorlage, dann beginnt jedes Angebot daraus mit der richtigen Anrede. Unter Angebote, Angebotsvorlagen sehen Sie jede Vorlage mit Ansehen und ändern sie mit Bearbeiten.