Envía un mensaje de notificación por correo electrónico.
Sintaxis
NOTIFY USER nombre_de_usuario <PASSWORD contraseña> MAILBOX nombre_de_ruta ADDRESS destinatario <CC cc_destinatario> <BCC bcc_destinatario> <SUBJECT asunto> MESSAGE mensaje <ATTACHMENT nombre_de_ruta>
Parámetros
| Nombre | Descripción |
|---|---|
| USER nombre_de_usuario |
La dirección de correo electrónico del remitente. |
| PASSWORD contraseña opcional |
La contraseña para el servidor de correo. |
| MAILBOX nombre_de_ruta |
El nombre del servidor SMTP que se utilizará para enviar el mensaje de correo electrónico. Por ejemplo: MAILBOX "mailserver.ejemplo.com"
|
| ADDRESS destinatario |
La dirección de correo electrónico de uno o más destinatarios. Separe las diferentes direcciones de correo electrónico con una coma. Introduzca un máximo de 1020 caracteres. |
| CC cc_destinatario opcional |
La dirección de correo electrónico de uno o más destinatarios con copia. Separe las diferentes direcciones de correo electrónico con una coma. Introduzca un máximo de 1000 caracteres. |
| BCC cco_destinatario opcional |
La dirección de correo electrónico de uno o más destinatarios con copia oculta. Separe las diferentes direcciones de correo electrónico con una coma. |
| SUBJECT asunto opcional |
La línea de asunto del mensaje de correo electrónico. |
| MESSAGE mensaje |
El cuerpo del mensaje de correo electrónico. El mensaje es texto sin formato y no admite HTML. Si desea insertar un salto de línea en el mensaje, use dos caracteres de acento circunflejo: ^^. |
| ATTACHMENT nombre_de_ruta opcional |
La ruta de acceso y el nombre de archivo de uno o más archivos adjuntos. Debe ser una cadena entre comillas. Especifique varios archivos adjuntos ingresando una lista de archivos separados por coma para nombre_de_ruta: ATTACHMENT "resultado1,resultado2"
|
Ejemplos
Envío de un correo electrónico de reporte de errores
Está ejecutando un script y desea enviar un correo de notificación si el script no se completa correctamente. Por medio del uso de NOTIFY, define el mensaje de correo electrónico e incluye dos archivos adjuntos:
- el archivo de log
- un archivo .fil que contiene los errores registrados
NOTIFY USER "soporte@compañía.com" MAILBOX "mail.compañía.com" ADDRESS "script_admin@ejemplo.com" SUBJECT "Reporte de errores" MESSAGE "No se logró procesar el script. Se adjuntan detalles." ATTACHMENT "Errores.fil;ACL_Demo.log"
Observaciones
Destinatarios y adjuntos
Puede utilizar el comando NOTIFY para enviar mensajes de notificación por correo electrónico a uno o más destinatarios. Los mensajes pueden incluir archivos de datos adjuntos y proyectos de Analytics.
El comando NOTIFY se puede utilizar para notificar al personal apropiado cuando un script falla inesperadamente.
Protocolos y puertos
El comando se puede utilizar con cualquier servidor de correo que admita SMTP (Protocolo simple de transferencia de correo), que es el protocolo utilizado por Microsoft Exchange y muchos otros servidores de correo. El comando NOTIFY también se puede utilizar con aplicaciones de correo electrónico más antiguas, de Microsoft y otros proveedores, que envían correo localmente.
NOTIFY utiliza el puerto 25; por lo tanto, este puerto debe estar abierto en el servidor de correo. De lo contrario, el comando no se podrá ejecutar. No es posible configurar el número de puerto utilizado por el comando. Si no se puede completar NOTIFY y recibe un mensaje de error, comuníquese con el departamento de sistemas para averiguar si el puerto 25 está bloqueado en su red.
Manejo de los errores
Si Analytics no puede conectarse con el servidor de correo, realiza cinco intentos adicionales de conexión, con una pausa de 10 segundos entre cada intento. Si ninguno de los intentos de conexión tiene éxito, se cancela el comando NOTIFY y se escribe un mensaje en el log, pero el script se continúa procesando.
Puede utilizar el comando SET para cambiar este comportamiento predeterminado. Puede especificar una cantidad diferente de intentos de conexión y una cantidad diferente de tiempo entre cada intento, o puede desactivar los intentos de conexión adicionales. También puede especificar que Analytics deje de procesar un script si se cancela el comando NOTIFY. Si desea obtener más información, consulte Comando SET.
Un destinatario de correo electrónico no válido no se considera un error del comando NOTIFY y el script no se detiene, sin importar cuál sea el ajuste escogido.
