Configuración de perfil
Cómo configurar perfiles para definir el procesamiento de datos, la generación de PDF y las reglas de correo.
Los perfiles son el corazón de PDF Mail Engine. Un Perfil crea un conjunto de reglas reutilizable para leer sus datos, generar PDFs y enviar correos electrónicos. Puede crear múltiples perfiles para diferentes propósitos, como "Facturas Mensuales", "Entradas de Eventos" o "Recordatorios de Pago".
Configuración principal
Al crear o editar un perfil, la sección de Configuración Principal gestiona los ajustes esenciales necesarios para comenzar a generar archivos.
| Ajuste | Descripción |
|---|---|
| Nombre del Perfil | Asigne un nombre único a su perfil (ej., "Facturas_2024"). Este nombre se usa para organizar sus archivos y registros. |
| Descripción | Agregue una nota privada sobre el propósito de este perfil. Es opcional y solo para su referencia. |
| Archivo de Plantilla | Seleccione el archivo de reglas (.yaml) que define cómo se genera su contenido de PDF y correo. Predeterminado: templates/template.yaml |
| Archivo de Datos Maestros | Seleccione su lista de clientes o libreta de direcciones (CSV o Excel). Predeterminado: data/master_data.csv |
| Carpeta de Salida PDF | Elija dónde se guardarán los PDFs generados. Predeterminado: outputs |
Organización automática
Al ejecutar un trabajo, PDF Mail Engine crea automáticamente una subcarpeta dentro de su Carpeta de Salida PDF con el formato NombrePerfil_Fecha_Hora. No necesita crear carpetas nuevas manualmente para cada ejecución.
Configuración opcional
Use estos ajustes si trabaja con archivos Excel específicos o necesita garantizar la compatibilidad con entornos Excel japoneses.
Selección de hoja Excel
Si sus datos están en un archivo Excel (.xlsx), puede especificar exactamente qué hoja leer.
- Nombre de hoja de importación: El nombre de la hoja Excel que contiene sus datos de transacciones (la lista de elementos a procesar).
- Nombre de hoja maestra: El nombre de la hoja Excel que contiene sus datos maestros de clientes.
Comportamiento predeterminado
Si deja estos campos vacíos, PDF Mail Engine leerá automáticamente la primera hoja de su archivo Excel.
Ajustes de compatibilidad
- Agregar BOM a la salida: Marque esta casilla si planea abrir archivos CSV exportados en Microsoft Excel en Windows. Esto agrega un marcador especial (BOM) al archivo para evitar que los caracteres japoneses aparezcan como texto ilegible (Mojibake).
Detalles técnicos
Esta sección es para administradores de sistemas o usuarios que configuran perfiles mediante edición directa de archivos.
Lógica de archivos y rutas
Todas las rutas de archivo en la configuración son relativas a la carpeta de su Espacio de Trabajo del Perfil. Esto le permite copiar o mover toda la carpeta del perfil a otro equipo sin romper los enlaces.
| Campo | Clave interna | Valor predeterminado | Notas |
|---|---|---|---|
| Nombre del Perfil | profile_name | (Obligatorio) | Máx. 50 caracteres. |
| Descripción | description | null | Notas internas opcionales. |
| Archivo de Plantilla | pdf_template_path | templates/template.yaml | Espera formato YAML. |
| Datos Maestros | master_csv_path | data/master_data.csv | Soporta CSV, XLSX, XLS. |
| Salida PDF | pdf_output_base_dir | outputs | Crea subcarpetas automáticamente. |
| Hoja de Importación | import_sheet_name | null (Primera Hoja) | Para datos de transacciones. |
| Hoja Maestra | master_sheet_name | null (Primera Hoja) | Para datos maestros. |
| Ruta Raíz | profile_root_path | (Autogenerado) | Opcional. Anula el directorio de datos predeterminado para este perfil. |
| Salida BOM | csv_export_with_bom | false | Establecer true para compatibilidad con Excel/Shift-JIS. |