Plantillas de ejecución, SMTP y políticas de notificación
Separar las tres capas
El contenido de un correo, su transporte SMTP y la política que decide enviarlo son configuraciones diferentes. Execution email template define asunto y cuerpos; Email delivery configura transporte de plataforma; Notifications selecciona eventos, canales y condiciones. Un preview correcto no prueba entrega y una conexión SMTP correcta no demuestra que un evento cumpla la política.
Las rutas de plantillas y preferencias conservan permisos etl.notifications.view o etl.notifications.manage según lectura o modificación. Guardar y probar transporte SMTP requiere Platform Administrator. Verifique también tenant y, para plantillas con alcance de carpeta, el contexto aplicable. No use una cuenta de plataforma para simular permisos de un operador limitado.
Campos y eventos de plantilla
El contrato acepta enabled, events, subject, preheader, htmlBody, textBody e inheritTenant. Los eventos de ejecución permitidos son succeeded, failed y cancelled; debe elegirse al menos uno. El cuerpo de texto no es opcional: permite una alternativa legible al HTML.
| Campo/límite | Contrato revisado |
|---|---|
| Subject | Obligatorio, hasta 160 caracteres, sin saltos de línea |
| Preheader | Hasta 180 caracteres, sin saltos de línea |
| Text body | Obligatorio, hasta 20.000 caracteres |
| HTML | Sanitizado y acotado a 1.500.000 bytes |
| Imágenes | Hasta 5 en total. Sólo las imágenes embebidas data: tienen límite de 256 KiB por imagen y 1 MiB total; para las remotas se valida HTTPS, sin afirmar un tamaño de descarga medido |
No interprete estos máximos como recomendación de diseño. Un correo corto con enlaces pertinentes es más útil que incorporar logs completos o información sensible en el cuerpo.
Variables válidas
Las variables se escriben como %NOMBRE%. El catálogo incluye:
| Grupo | Variables |
|---|---|
| Identidad | TENANT_NAME, TENANT_ID, WORKFLOW_NAME, WORKFLOW_ID, RUN_ID |
| Estado y tiempo | STATUS, STARTED_AT, COMPLETED_AT, DURATION |
| Métricas | INPUT_ROWS, OUTPUT_ROWS, FILTERED_ROWS, REJECTED_ROWS, SESSION_COUNT |
| Ejecución | WORKER_NAMES, FILE_NAMES, LOCATIONS, FAILURE_REASON, EXECUTION_CONTEXT, TRIGGER, ENVIRONMENT |
| Presentación/enlace | DOVA_LOGO_URL, CLOUDATA_LOGO_URL, EXECUTION_URL |
Ejemplo de contenido sintético, no petición a producción:
Asunto: Resultado %STATUS% de %WORKFLOW_NAME%
Ejecución: %RUN_ID%
Filas de salida: %OUTPUT_ROWS%
Detalle autorizado: %EXECUTION_URL%
Variables desconocidas se rechazan. No utilice sintaxis inventada ni trate el cuerpo como código ejecutable. El sanitizador permite un subconjunto de HTML y estilos, bloquea construcciones activas y controla enlaces/imágenes. El editor representa imágenes remotas de forma segura; su ausencia en preview no autoriza relajar CSP.
Procedimiento de edición
- Abra Preferences → Notifications → Execution email template.
- Revise alcance e herencia antes de editar. No sobrescriba una plantilla compartida pensando que sólo cambia un correo.
- Seleccione eventos, escriba asunto y preheader e inserte variables del catálogo.
- Mantenga equivalencia útil entre HTML y texto. Compruebe contraste, títulos, enlaces y lectura estrecha en preview.
- Guarde y vuelva a cargar para verificar persistencia. Pruebe después el correo en un buzón de laboratorio autorizado.
Transporte SMTP
En Email delivery revise enabled, host, port, security, username, password, from name, from email y reply-to. El destinatario de prueba debe estar bajo su control. No use emails de clientes para verificar configuración. La contraseña se proporciona por el flujo seguro disponible, nunca en capturas o ejemplos públicos.
Un test fallido puede deberse a conexión, autenticación, seguridad o política del servidor remoto. Conserve el mensaje seguro; no cambie simultáneamente todas las opciones. Una prueba de mensaje debe comprobar recepción y legibilidad, además de la aceptación inicial del transporte.
Notificaciones y POC
Configure canales, eventos, severidades, roles destinatarios, umbrales, deduplicación, digest y horario silencioso con zona horaria. Observe Delivery history: sent, failed, suppressed y acknowledged no son equivalentes. Un evento suprimido por política no debe diagnosticarse automáticamente como fallo SMTP.
En fixture local genere una ejecución ficticia fallida, renderice ambas versiones del cuerpo y pruebe una variable desconocida. En sandbox separado envíe a un buzón controlado y compruebe asunto, texto, enlace y ausencia de datos sensibles. Documente cada resultado por separado. Ningún ejemplo debe incluir claves SMTP, endpoints secretos, tokens ni datos de ejecuciones reales.