< Benutzung Einstellungen >

Serial Mail Hilfe

Vorlagenformat

Die Vorlage ist eine standard Email, welche Sie in Ihrem Entwürfe Ordner speichern. Das Programm analysiert die bei Start die gewählte Vorlage und ersetzt bestimmte Platzhalter mit den entsprechenden Werten aus dem Adressbucheintrag des jeweiligen Empfängers.

Syntax

Die Platzhalter haben folgende (XML konforme) Syntax.

Platzhalter für Information aus dem Adressbuch

<ab:tagname label="label attribute" number="optional item number" default="optional default value"/>

wobei tagname eines der untern aufgeführten Schlüsselwörter ist.

Platzhalter für Attachments

<finder:file name="pfad/dateiname"/>

Beispiele

Beispieler solcher Platzhalter sind

<ab:first_name/>
Wird ersetzt werden durch des Empfängers Vorname oder gelöscht, falls der Vorname leer ist.
<ab:first_name default="Not available."/>
Wird ersetzt werden durch des Empfängers Vorname oder durch "Nicht verfügbar" (ohne Anführungszeichen), sollte der Vorname leer sein.
<ab:email label="work" default="No work email given."/>
Wird ersetzt werden durch des Empängers (erste) Arbeits Email Addresse oder durch "No work email given." (ohne Anführungszeichen), sollte diese nicht existieren.
<ab:email label="work" number="2" default="No second work email given."/>
Wird ersetzt werden durch des Empängers zweite Arbeits Email Addresse oder durch "No second work email given." (ohne Anführungszeichen), sollte diese nicht existieren.
<finder:file name="/Users/fries/Pictures/flower.jpg"/>
Wird ersetzt durch eine Anlage (Attachment) - hier ein Bild - "flower.jpg" welches sich unter /Users/fries/Pictures/flower.jpg" befindet.

Ünterstützte Platzhalter (Tags) für Informationen aus dem Adressbuch

Unterstützte Platzhalter (Tags) Adressbuch Wert Label Attribut Number Attribut Default Attribut
ab:first_name Vorname. Nein Nein Optional
ab:last_name Nachname. Nein Nein Optional
ab:title Title (Präfix) Nein Nein Optional
ab:suffix Suffix Nein Nein Optional
ab:phone Telefonnummer. Optional Optional Optional
ab:email Emailadresse. Optional Optional Optional
ab:note Notiz / Bemerkung Nein Nein Optional
ab:address.street Straße Optional Optional Optional
ab:address.state Bundesland (z.B. bei US Adressen) Optional Optional Optional
ab:address.zip PLZ Optional Optional Optional
ab:address.city Stadt Optional Optional Optional
ab:address.country Land Optional Optional Optional
ab:address.country.code Ländercode Optional Optional Optional
ab:custom Wert eines freidefinierbaren Feldes mit dem unter durch das Label Attribut gegebenen Bezeichner. Erfordert Optional Optional
ab:middle_name Mittelname Nein Nein Optional
ab:organization Organisation Nein Nein Optional
ab:department Abteilung Nein Nein Optional
ab:job_title Dienstbezeichnung Nein Nein Optional
ab:birth_date Gebutsdatum Nein Nein Optional
ab:birth_date.day Tag des Gebutsdatums Nein Nein Optional
ab:birth_date.month Monat des Gebutsdatums Nein Nein Optional
ab:birth_date.year Jahr des Gebutsdatums Nein Nein Optional
ab:url URL Optional Optional Optional
ab:home_page Home Page Nein Nein Optional
ab:aim AIM Benutzername Nein Nein Optional
ab:icq ICQ Benutzername Nein Nein Optional
ab:msn MSN Benutzername Nein Nein Optional
ab:nickname Spitzname Nein Nein Optional

Attribute

Ein Platzhalter (im Englischen Tag) kann mit den drei Attibuten label, number und default versehen werden. Mittels der Attribute label und number können Einträge gewählt werden, sollten für den Entsprechenden Adressbucheintrag mehrere Einträge erlaubvt sein. So ist es z.B. Möglich unter Email mehrere Emailadressen zu führen, z.B. 3 mit dem Bezeichner (im Englischen Label) Privat ("home") und 2 mit dem Bezeichner Arbeit ("work"). Mit dem default Attribut können Sie einen sogenannten "Fehlwert" angeben, d.h. ein Wert, der verwendet wird, sollte für diese Person der angesprochene Eintrag im Adressbuch leer sein.

Unterstützte Bezeichner (Label)

Es können alle Bezeichner benutzt werden, die das Mac OS X Adressbuch unterstütz. Allerdings ist zu beachten, dass der Bezeichner im Serial Mail Platzhalter mit dem englischen Wort angegeben werden muss und nicht so wie er im Adressbuch (bei Verwendung einer anderen Spracheinstellung als English) erscheint. Selbstdefinierte Bezeichner werden selbstverständlich exakt so angesprochen wie Sie im Adressbuch definiert wurden.

Label Adressbuch Eintrag Nutzbar bei
work Arbeit phone, email, address
home Privat phone, email, address
mobile Mobiltelefonnummer phone

Einfügen von Anhänge mittels Platzhalter

Platzhalter (Tag) Resultat Name attribute Default value
finder:file Fügt ein attachment ein welches aus der Datei besteht die im name Attribut spezifiziert wurde. Erfordert: Pfad zur Datei No
Der Pfadname der in finder:file spezifiziert wird kann durch den Namen den Empfängers parametrisiert werden. Somit ist es möglich einem Empfänger einen individuellen Anhang zukommen zu lassen. Der Pfad darf hierzu ein oder zwei platzhalter enthalten welche durch die zwei Zeichen %@ gegeben sind. Die erste Stelle mit %@ wird bei der Generierung der Email durch den Vornamen des Empfängers ersetzt. Die zweite Stelle mit %@ wird bei der Generierung der Email durch den Nachnamen des Empfängers ersetzt.

Beispiel

Enhält die Vorlage den Platzhalter <finder:file name="/Users/fries/Desktop/Results-%@-%@.pdf"/> so wird in die für John Doe erzeugte Email die Datei "/Users/fries/Desktop/Results-John-Doe.pdf" an der Stelle des Platzhalter eingefügt.

Bemerkungen

Existiert im Adressbuch keine Eintragung unter Email, so wird von Serial Mail keine Email für diese Person generiert.