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:
Unterstützte Makros:
$$BODYASHTML$$— Der Body wird als HTML eingefügt. Wenn der Body noch kein HTML ist (nicht mit<HTML>beginnt), wird er automatisch konvertiert: Sonderzeichen werden escaped und Zeilenumbrüche durch<br>ersetzt.$$BODY$$— Der Body wird als Plaintext eingefügt (ohne HTML-Konvertierung).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"
# Plaintext-Body wird als HTML konvertiert
$body = "Zeile 1`r`nZeile 2"
$sig = "$$BODYASHTML$$<br>Grüße"
$result = Merge-EulandaMailBody -Body $body -Signature $sig
# Ergebnis: "Zeile 1<br>`r`nZeile 2<br>Grüße"