Configuration du profil

Comment configurer les profils pour définir le traitement des données, la génération PDF et les règles d'envoi d'e-mails.

Les profils sont au cœur de PDF Mail Engine. Un Profil crée un ensemble de règles réutilisables pour lire vos données, générer des PDF et envoyer des e-mails. Vous pouvez créer plusieurs profils pour différents usages, comme « Factures mensuelles », « Billets d'événement » ou « Rappels de paiement ».

Configuration principale

Lorsque vous créez ou modifiez un profil, la section Configuration Principale gère les paramètres essentiels pour commencer à générer des fichiers.

Paramètre	Description
Nom du Profil	Donnez un nom unique à votre profil (ex : « Invoices_2024 »). Ce nom est utilisé pour organiser vos fichiers et journaux.
Description	Ajoutez une note privée sur l'objectif de ce profil. Optionnel, pour votre usage uniquement.
Fichier Modèle	Sélectionnez le fichier de règles (`.yaml`) définissant la génération du PDF et du contenu e-mail. Par défaut : `templates/template.yaml`
Fichier de Données Maîtres	Sélectionnez votre liste de clients ou carnet d'adresses (CSV ou Excel). Par défaut : `data/master_data.csv`
Dossier de Sortie PDF	Choisissez où enregistrer les PDF générés. Par défaut : `outputs`

Organisation automatique

Lors de l'exécution d'une tâche, PDF Mail Engine crée automatiquement un sous-dossier dans votre Dossier de Sortie PDF au format NomDuProfil_Date_Heure. Vous n'avez pas besoin de créer manuellement un nouveau dossier à chaque exécution.

Configuration optionnelle

Utilisez ces paramètres si vous travaillez avec des fichiers Excel spécifiques ou si vous devez assurer la compatibilité avec les environnements Excel japonais.

Sélection de la feuille Excel

Si vos données se trouvent dans un fichier Excel (.xlsx), vous pouvez spécifier exactement quelle feuille lire.

Import Sheet Name : Le nom de la feuille Excel contenant vos données transactionnelles (la liste des éléments à traiter).
Master Sheet Name : Le nom de la feuille Excel contenant vos données clients maîtres.

Comportement par défaut

Si vous laissez ces champs vides, PDF Mail Engine lira automatiquement la première feuille de votre fichier Excel.

Paramètres de compatibilité

Add BOM Output : Cochez cette case si vous prévoyez d'ouvrir les fichiers CSV exportés dans Microsoft Excel sous Windows. Cela ajoute un marqueur spécial (BOM) au fichier pour éviter que les caractères japonais ne s'affichent de manière incorrecte (Mojibake).

Détails techniques

Cette section est destinée aux administrateurs système ou aux utilisateurs configurant les profils par édition directe de fichiers.

Logique des fichiers et des chemins

Tous les chemins de fichiers dans la configuration sont relatifs à votre dossier Workspace du Profil. Cela vous permet de copier ou déplacer l'intégralité du dossier de profil vers un autre ordinateur sans casser les liens.

Clé du champ	Clé interne	Valeur par défaut	Remarques
Profile Name	`profile_name`	(Requis)	Max 50 caractères.
Description	`description`	`null`	Notes internes optionnelles.
Template File	`pdf_template_path`	`templates/template.yaml`	Format YAML requis.
Master Data	`master_csv_path`	`data/master_data.csv`	Supporte CSV, XLSX, XLS.
PDF Output	`pdf_output_base_dir`	`outputs`	Crée automatiquement des sous-dossiers.
Import Sheet	`import_sheet_name`	`null` (Première feuille)	Pour les données transactionnelles.
Master Sheet	`master_sheet_name`	`null` (Première feuille)	Pour les données maîtres.
Root Path	`profile_root_path`	(Auto-généré)	Optionnel. Remplace le répertoire de données par défaut pour ce profil.
BOM Output	`csv_export_with_bom`	`false`	Définir `true` pour la compatibilité Excel/Shift-JIS.