Platzhalter bei Serien-E-Mails

Platzhalter bei Serien-E-Mails

 
Zur Individualisierung können bei der Erstellung von Serien-E-Mails eine Reihe von Platzhaltern und Regeln benutzt werden.

Folgende Felder können durch [feldname] ausgegeben werden. Die meisten davon entsprechen den Feldern von Kontakt/Firma/Person im Adressmodul. Bei Feldern, die es für Personen und für Firmen gibt, ist zur Unterscheidung ein 'p' oder 'f' vorangestellt (z.B. pkundennr, fkundennr):

  •     [vorname]
  •     [name]
  •     [geschlecht]
  •     [titel]
  •     [geburt] (07.09.2005)
  •     [geburt_intern] (20050907)
  •     [alter] (Alter in Jahren)
  •     [pkundennr]
  •     [plieferantennr]
  •     [firma]
  •     [gesellschaftsform]
  •     [gruendungsjahr]
  •     [fkundennr]
  •     [flieferantennr]
  •     [kontaktname]
  •     [zusatz]
  •     [strasse]
  •     [plz]
  •     [ort]
  •     [landiso] (de)
  •     [land] (Deutschland)
  •     [email]
  •     [telefon]
  •     [fax]
  •     [handy]
  •     [url]
  •     [postfach]
  •     [gemeindeschluessel]
  •     [ortsteil]
  •     [region]
  •     [anrede]
  •     [position]
  •     [abteilung]
  •     [etage]
  •     [pkontakttyp]
  •     [fkontakttyp]
  •     [sehr_geehrt] (Sehr geehrte/r Frau/Herr)

Hinweise:
Einige zusätzliche Felder enthalten verschiedene Schreibweisen anderer Datenfelder (Angabe in Klammern).
Eine eckige Klammer "[" leitet normalerweise immer einen Platzhalter ein.  Möchten Sie in der Serien-E-Mail an anderer Stelle im Text eine eckige Klammern verwenden, so stellen Sie dieser ein Backslash voran "\[".

 
Exakte Syntax der Platzhalter:

platzhalter: "[" wert "]"
wert: feldname | konstante | ausdruck | unaeroperator wert | wert operator wert | "(" wert  ")"
konstante: string | zahl
string: "'" zeichenkette "'" (anführungszeichen durch \')
zahl: [ "+" | "-" ] ziffern [ "." ziffern ]
ausdruck: funktion | if-statement
funktion: "funktionsname(" [ wert {"," wert } ] ")"
if-statement: "if(" wert "," wert ")" {"elsif(" wert "," wert ")"} ["else(" wert ")"]
operator: "^" | "*" | "/" | "%" | "+" | "-" | "=" | "!=" | "<>" | "<" | ">" | "<=" | ">=" | "~" | "~~" | "&" | "|"
unaeroperator: "!"
funktionsname: "substr" | "round" | ... siehe unten

Bei if und elsif ist der erste Wert die Bedingung. Der zweite Wert ist das Ergebnis, wenn die Bedingung 'true' ist.

Die Priorität der Operatoren ist die angegebene Reihenfolge. Diese Reihenfolge führt dazu, dass relativ wenig Klammern geschrieben werden müssen und die mathematischen Regeln eingehalten werden. So kann man z.B. ohne Klammern schreiben: [ a*2>4 & b>3 & !c & d+5=9 ]


Operatoren:

~: Suche in String mit Platzhaltern "*" und "?"
~~: Suche in String mit Regular Expression
&,|: Logisches UND und ODER
^: hoch (23=8)
%: Modulo; Eine ganzzahlige Division ist nicht vorhanden, kann aber durch trunc(a/b) erreicht werden
+: Kann auch für die Verkettung von Strings verwendet werden
*: Bei String*Zahl wird der String entsprechend oft verkettet


Implementierte Funktionen:

round(z,n): Runden der Zahl z auf n Nachkommastellen.
upper(s): String in Großbuchstaben umwandeln
lower(s): String in Kleinbuchstaben umwandeln
upperFirst(s): Das erste Zeichen des Strings in Großbuchstabe umwandeln
lowerFirst(s): Das erste Zeichen des Strings in Kleinbuchstabe umwandeln
date(): Das aktuelle Datum
time(): Die aktuelle Uhrzeit
string(h): Das Argument in einen String umwandeln
number(h): Das Argument in eine Zahl umwandeln
link(s): Den String als URL ausgeben. Hängt mailto: oder http:// davor, wenn nicht vorhanden.



Einfache Beispiele zur Verwendung von Platzhaltern in einer Serien-E-Mail:
  1. Ausgabe der Anrede zu Beginn der E-Mail:
    [sehr_geehrt] [name]
    würde z.B. in einer Mail an Frau Maier ersetzt werden durch: "Sehr geehrte Frau Maier". Die Mail an Herrn Schmitt würde beginnen mit "Sehr geehrter Herr Schmitt".
    Vorraussetzung dafür ist, dass im Adressmodul in den gespeicherten Adressdaten zu den Empfängern im Feld Anrede z.B. "Herr" oder "Frau" eingetragen wurde. Ist das Feld Anrede leer, so erfolgt im Falle von Frau Maier lediglich eine Ersetzung zu "Sehr geehrte/r Frau/Herr Maier".

  2. Ausgabe von Name und Anschrift in der Serien-E-Mail:
    [anrede] [vorname] [name]
    [strasse]
    [plz] [ort]
    wird in der Mail an Frau Maier entsprechend den gespeicherten Adressdaten ersetzt durch:
    Frau Anja Maier
    Königsstrasse 6
    67661 Kaiserslautern

  3. Ausgabe des aktuellen Datums:
    "Heute ist der [date()]."
    wird in der Serien-E-Mail durch das aktuelle Datum ersetzt:
    "Heute ist der 01.10.2005."

    Die folgenden beiden Screenshots zeigen die Anwendung der obigen Beispiele sowie das Ergebnis, welches Sie sich vor dem Absenden über die Vorschaufunktion anzeigen lassen können:





Komplexe Beispiele mit Verwendung von Verzweigungen und Operatoren:
  1. Opa oder Oma? [if(alter>80,if(geschlecht='männlich'|anrede='Herr','Opa')else('Oma'))]
  2. Wenn Nachname mit T beginnt: [if(upper(name)~'T*','ja')]
    oder alternativ: [if(upper(substr(name,0,1))='T','ja']
  3. Wenn vor dem 31.08.1970 geboren: [if(geburt_intern<'19700831','ja')else('nein')]
  4. Wenn Geburtsdatum nicht angegeben: [if(!geburt,'Wir benötigen noch Ihr Geburtsdatum.')]
  5. Link zu Homepage: Ihre Homepage ist [link(url)]
  6. Wenn Alter durch 10 teilbar und mindestens 40: [if(alter%10=0&alter>=40,'ja')]

Allgemeiner Hinweis: Alle Leerzeichen außerhalb von eckigen Klammern werden in der Nachricht ausgegeben.

 

Wichtiger Hinweis: Sie sehen diese vereinfachte Inhaltsdarstellung, weil Ihr Browser kein JavaScript unterstützt oder Sie JavaScript deaktiviert haben.
Um die korrekte Darstellung im Frameset der x-organizer Doku zu sehen, aktivieren Sie bitte JavaScript und klicken hier.

 

Letzte Änderung: Mi. 22.02.2012 21:35