Profilkonfiguration

Konfiguration von Profilen für Datenverarbeitung, PDF-Generierung und E-Mail-Regeln.

Profile sind das Herzstück von PDF Mail Engine. Ein Profil erstellt ein wiederverwendbares Regelwerk zum Lesen Ihrer Daten, Generieren von PDFs und Senden von E-Mails. Sie können mehrere Profile für verschiedene Zwecke erstellen, z. B. „Monatsrechnungen", „Veranstaltungstickets" oder „Zahlungserinnerungen".

Basiskonfiguration

Beim Erstellen oder Bearbeiten eines Profils legen Sie im Abschnitt Core Configuration (Basiskonfiguration) die wesentlichen Einstellungen für die Dateigenerierung fest.

Einstellung	Beschreibung
Profile Name (Profilname)	Geben Sie Ihrem Profil einen eindeutigen Namen (z. B. „Rechnungen_2024"). Dieser Name dient der Organisation Ihrer Dateien und Protokolle.
Description (Beschreibung)	Fügen Sie eine private Notiz zum Zweck dieses Profils hinzu. Optional und nur für Ihre Referenz.
Template File (Vorlagendatei)	Wählen Sie die Regeldatei (`.yaml`), die definiert, wie Ihr PDF- und E-Mail-Inhalt generiert wird. Standard: `templates/template.yaml`
Master Data File (Master-Daten-Datei)	Wählen Sie Ihre Kundenliste oder Ihr Adressbuch (CSV oder Excel). Standard: `data/master_data.csv`
PDF Output Folder (PDF-Ausgabeordner)	Wählen Sie, wo die generierten PDFs gespeichert werden sollen. Standard: `outputs`

Automatische Organisation

Wenn Sie einen Auftrag ausführen, erstellt PDF Mail Engine automatisch einen Unterordner in Ihrem PDF-Ausgabeordner im Format Profilname_Datum_Uhrzeit. Sie müssen nicht für jeden Lauf manuell neue Ordner erstellen.

Optionale Konfiguration

Verwenden Sie diese Einstellungen, wenn Sie mit bestimmten Excel-Dateien arbeiten oder die Kompatibilität mit japanischen Excel-Umgebungen sicherstellen möchten.

Excel-Blattauswahl

Wenn Ihre Daten in einer Excel-Datei (.xlsx) vorliegen, können Sie genau angeben, welches Blatt gelesen werden soll.

Import Sheet Name: Der Name des Excel-Blatts mit Ihren Transaktionsdaten (die Liste der zu verarbeitenden Elemente).
Master Sheet Name: Der Name des Excel-Blatts mit Ihren Kunden-Masterdaten.

Standardverhalten

Wenn Sie diese Felder leer lassen, liest PDF Mail Engine automatisch das erste Blatt Ihrer Excel-Datei.

Kompatibilitätseinstellungen

Add BOM Output: Aktivieren Sie diese Option, wenn Sie exportierte CSV-Dateien in Microsoft Excel unter Windows öffnen möchten. Dadurch wird eine spezielle Markierung (BOM) zur Datei hinzugefügt, um die fehlerhafte Darstellung von Sonderzeichen zu verhindern.

Technische Details

Dieser Abschnitt richtet sich an Systemadministratoren und Benutzer, die Profile durch direkte Dateibearbeitung konfigurieren.

Datei- und Pfadlogik

Alle Dateipfade in der Konfiguration sind relativ zu Ihrem Profil-Arbeitsbereich-Ordner. So können Sie den gesamten Profilordner auf einen anderen Computer kopieren oder verschieben, ohne Verknüpfungen zu unterbrechen.

Feldschlüssel	Interner Schlüssel	Standardwert	Hinweise
Profile Name	`profile_name`	(Erforderlich)	Max. 50 Zeichen.
Description	`description`	`null`	Optionale interne Notizen.
Template File	`pdf_template_path`	`templates/template.yaml`	YAML-Format erforderlich.
Master Data	`master_csv_path`	`data/master_data.csv`	Unterstützt CSV, XLSX, XLS.
PDF Output	`pdf_output_base_dir`	`outputs`	Erstellt automatisch Unterordner.
Import Sheet	`import_sheet_name`	`null` (Erstes Blatt)	Für Transaktionsdaten.
Master Sheet	`master_sheet_name`	`null` (Erstes Blatt)	Für Masterdaten.
Root Path	`profile_root_path`	(Automatisch generiert)	Optional. Überschreibt das Standard-Datenverzeichnis für dieses Profil.
BOM Output	`csv_export_with_bom`	`false`	Auf `true` setzen für Excel/Shift-JIS-Kompatibilität.