Merge-EulandaMailBody #
ÜBERSICHT #
Fügt E-Mail-Body und Signatur über Makro-Platzhalter zu einem vollständigen Anschreiben zusammen.
SYNTAX #
Merge-EulandaMailBody [[-Body] <string>] [[-Signature] <string>] [<CommonParameters>]
BESCHREIBUNG #
Die Funktion Merge-EulandaMailBody kombiniert den inhaltlichen E-Mail-Body (z.B. den Rechnungstext) mit der Signatur (Grußformel + Disclaimer) zu einem fertigen HTML-Anschreiben.
Die Zusammenführung erfolgt über strukturelle $$-Makro-Platzhalter in der Signatur. Diese Makros sind Blockeinfügungen, die bestimmen, wo der Body-Text innerhalb der Signatur positioniert wird:
Das Ergebnis ist immer eine HTML-Mail. Deshalb wird jeder Teil, der Klartext ist (Body wie Signatur), vorher zu HTML: die Zeichen &, < und > werden maskiert, jeder Zeilenumbruch (CRLF oder LF) wird genau ein <br>. Umlaute bleiben unverändert, das Dokument ist UTF-8. Als HTML gilt ein Text, sobald er ein HTML-Tag wie <br>, <p>, <div> oder <html> enthält; er bleibt dann, wie er ist. Eine Vorlage mit von Hand gesetzten <br> ändert sich also nicht.
Unterstützte Makros:
$$BODYASHTML$$— Der Body wird an dieser Stelle eingefügt.$$BODY$$— Ebenso. Delphi (RenderMailBody) setzt hier den Body unverändert ein und überlässt dem Mailprogramm, ob Text oder HTML daraus wird. Weil hier immer HTML entsteht, wird Klartext auch bei diesem Makro umgebrochen, sonst stünde die Mail in einer Zeile.Wenn kein Makro vorhanden ist, wird der Body vor die Signatur gesetzt, getrennt durch einen doppelten Zeilenumbruch (
<br><br>).
Diese Makros ermöglichen es, die Signatur als Gesamtvorlage zu gestalten, die den Body an einer definierten Stelle einbettet. Beispiel einer Signatur mit Makro:
$$BODYASHTML$$
<br>
Mit freundlichen Grüßen
Max Mustermann
<br>
<i>EULANDA Software GmbH — Firmendisclaimer</i>
Die $$-Makros sind nicht zu verwechseln mit den %-Datenplatzhaltern (z.B. %KopfNummer%, %Firma%), die über Expand-InvoiceTemplate aufgelöst werden. Merge-EulandaMailBody verarbeitet ausschließlich die strukturellen $$-Makros.
Diese Funktion bildet die Delphi-Funktion RenderMailBody aus elReports.pas nach.
PARAMETER #
-Body #
Type: string
Der inhaltliche E-Mail-Text, z.B. der Rechnungs- oder Angebotstext. Kann HTML oder Plaintext sein.
-Signature #
Type: string
Die E-Mail-Signatur, wie sie von Get-EulandaMailSignature zurückgegeben wird. Kann die Makro-Platzhalter $$BODYASHTML$$ oder $$BODY$$ enthalten.
AUSGABEN #
string
Das zusammengesetzte E-Mail-Anschreiben als HTML-String.
BEISPIELE #
# Einfacher Zusammenbau ohne Makro — Body + Signatur hintereinander
$body = "Anbei erhalten Sie Ihre Rechnung Nr. <b>37476</b>."
$sig = "Mit freundlichen Grüßen<br>Max Mustermann"
$result = Merge-EulandaMailBody -Body $body -Signature $sig
# Ergebnis: "Anbei erhalten Sie...37476.<br><br>Mit freundlichen Grüßen..."
# Signatur als Wrapper mit $$BODYASHTML$$ Makro
$body = "Anbei Ihre Rechnung."
$sig = "Sehr geehrte Damen und Herren,<br><br>$$BODYASHTML$$<br><br>EULANDA GmbH Disclaimer"
$result = Merge-EulandaMailBody -Body $body -Signature $sig
# Ergebnis: "Sehr geehrte...Anbei Ihre Rechnung.<br><br>EULANDA GmbH Disclaimer"
# Klartext-Body wird zu HTML, ein <br> je Zeilenumbruch
$body = "Zeile 1`r`nZeile 2"
$sig = "$$BODYASHTML$$<br>Grüße"
$result = Merge-EulandaMailBody -Body $body -Signature $sig
# Ergebnis (im HTML-Rahmen): "Zeile 1<br>Zeile 2<br>Grüße"