Übersicht

Get-EulandaMailSignature #

ÜBERSICHT #

Liest die E-Mail-Signatur aus der EULANDA SQL-Registry und fügt sie zusammen.

SYNTAX #

Get-EulandaMailSignature [[-Conn] <__ComObject>] [[-Udl] <string>] [[-ConnStr] <string>]
    [[-UserName] <string>] [<CommonParameters>]

BESCHREIBUNG #

Die Funktion Get-EulandaMailSignature liest die E-Mail-Signatur aus zwei Ebenen der EULANDA SQL-Registry und kombiniert sie zu einer fertigen Signatur:

1. Globale Signatur (\USER\.ALLUSER\Grundwerte\EmailSignature.txt) Wird unter Einstellungen → Allgemein → E-Mail-Signatur (global) gepflegt. Enthält typischerweise den Firmendisclaimer und kann den Makro-Platzhalter $$USERSIGNATURE$$ enthalten, um die Position der Benutzer-Signatur festzulegen.

2. Benutzer-Signatur (\USER\{RegistryUser}\Grundwerte\EmailSignature.txt) Wird unter Einstellungen → Benutzer → E-Mail-Signatur gepflegt. Enthält die persönliche Grußformel und den Namen des Absenders.

Zusammenbau-Logik:

• Wenn die globale Signatur $$USERSIGNATURE$$ enthält, wird dieser Platzhalter durch die Benutzer-Signatur ersetzt. So kann die globale Signatur als Wrapper fungieren und die Anordnung steuern.
• Wenn kein Platzhalter vorhanden ist, werden Benutzer-Signatur und globale Signatur einfach hintereinander gesetzt.
• Wenn nur eine der beiden Ebenen vorhanden ist, wird diese allein verwendet.

Die $$-Platzhalter sind strukturelle Makros, die Textblöcke einfügen. Sie sind nicht zu verwechseln mit den %-Datenplatzhaltern (z.B. %Firma%, %KopfNummer%), die erst später beim Versand über Expand-InvoiceTemplate aufgelöst werden. Die %-Platzhalter in der Signatur bleiben erhalten und können vom Aufrufer expandiert werden.

Der RegistryUser wird über Get-EulandaRegistryUser ermittelt und berücksichtigt dabei SQL-Login-Umleitung und Custom-Funktionen.

PARAMETER #

-Conn #

Type: __ComObject

Ein bereits geöffnetes ADODB.Connection-Objekt zur EULANDA-Datenbank.

-Udl #

Type: string

Pfad zu einer UDL-Datei mit den Verbindungsdaten.

-ConnStr #

Type: string

Ein ADO-Connection-String zur EULANDA-Datenbank.

-UserName #

Type: string

Optionaler Windows-Benutzername für die Benutzer-Signatur. Wenn nicht angegeben, wird der aktuelle Windows-Anmeldename verwendet.

AUSGABEN #

string

Die zusammengesetzte E-Mail-Signatur. Kann leer sein, wenn weder globale noch Benutzer-Signatur hinterlegt ist.

BEISPIELE #

# Signatur über UDL-Datei abrufen
$signature = Get-EulandaMailSignature -Udl "C:\Users\cn\EULANDA_1 EULANDA.udl"
Write-Host $signature

# Signatur über bestehende Verbindung, für bestimmten Benutzer
$conn = Get-ConnByUdl -Udl "C:\Users\cn\EULANDA_1 EULANDA.udl"
$signature = Get-EulandaMailSignature -Conn $conn -UserName "markus"

# Signatur abrufen und mit Rechnungsdaten expandieren
$signature = Get-EulandaMailSignature -Conn $conn
$expanded = Expand-InvoiceTemplate -Template $signature `
  -Conn $conn -InvoiceNo 37476 -Variables @{ format = 'ZUGFeRD' }