Comando NOTIFY

Información de concepto

Enviar notificaciones por correo electrónico desde Analytics

Envía un mensaje de notificación por correo electrónico saliente al servidor de correo electrónico SMTP para retransmitirlo a los destinatarios.

Sintaxis

Sintaxis de comando autenticado

NOTIFY SMTP SMTPUSER nombre_cuenta_SMTP PORT número_puerto <ENABLESSL> USER correo_electrónico_remitente PASSWORD contraseña_cifrada MAILBOX nombre_servidor_SMTP ADDRESS correo_electrónico_destinatario <CC correo_electrónico_destinatario_cc> <BCC correo_electrónico_destinatario_bcc> SUBJECT línea_asunto MESSAGE texto_mensaje <ATTACHMENT ruta_archivo>

Sintaxis de comando sin autenticar

Nota

Esta versión anterior del comando NOTIFY está diseñada para usarla con sistemas locales de correo electrónico o servidores de correo SMTP que no requieran autenticación. No funciona con sistemas de correo electrónico modernos que suelen requerir autenticación.

NOTIFY USER correo_electrónico_remitente <PASSWORD contraseña_cifrada> MAILBOX nombre_servidor_SMTP ADDRESS correo_electrónico_destinatario <CC correo_electrónico_destinatario_cc> <BCC correo_electrónico_destinatario_bcc> SUBJECT línea_asunto MESSAGE texto_mensaje <ATTACHMENT ruta_archivo>

Parámetros

Nombre Descripción
SMTP

Especifica que se realiza un envío autenticado a un servidor SMTP (servidor Simple Mail Transfer Protocol).

  • Especifique SMTP el servidor SMTP requiere conexiones autenticadas

  • No especifique SMTP está usando un servidor SMTP abierto y se conecta mediante el puerto 25 o un sistema de correo local que no requiere autenticación

Nota

Prácticamente todos los sistemas de correo electrónico modernos que usan SMTP requieren autenticación.

Debe especificar SMTP para habilitar los parámetros siguientes:

  • SMTPUSER

  • PORT

  • ENABLESSL

SMTPUSER nombre_cuenta_SMTP

El nombre de la cuenta de usuario que sirve para la autenticación y para acceder al servidor SMTP.

Si omite el parámetro SMTPUSER, se utiliza la dirección de correo electrónico del remitente especificada por USER para acceder al sistema local de correo electrónico o a un servidor de correo SMTP que no requiera autenticación.
PORT número_puerto

El número de puerto que se va a usar para acceder al servidor SMTP.

Es posible que tenga que contactarse con su Departamento de TI para saber qué puerto debe usar. Entre los números de puerto comunes de servidores SMTP se incluyen:

  • 587
  • 2525
  • 465

Si usa SMTPUSER, debe usar PORT. Si omite SMTPUSER, puede omitir PORT; se utilizará el puerto predeterminado 25.

ENABLESSL

opcional

Especifica el acceso al servidor SMTP mediante una conexión SMTP/SSL segura.

Es posible que tenga que contactarse con su departamento de sistemas para saber si su servidor SMTP requiere una conexión SSL. También puede enviar correos de prueba con y sin el parámetro ENABLESSL especificado.
USER correo_electrónico_remitente

Define la dirección de correo electrónico de un remitente para las notificaciones por correo electrónico a través del servidor SMTP.

Nota

En función de la configuración de su servidor SMTP, USER y SMTPUSER pueden ser o no la misma cuenta.
PASSWORD contraseña_cifrada

La contraseña de la cuenta de usuario del servidor SMTP. La contraseña debe proporcionarse en forma de cadena cifrada.

Si desea obtener más información, consulte Generación de una contraseña cifrada.

Es posible que no se requiera una contraseña para acceder al sistema local de correo electrónico o a un servidor SMTP de correo que no requiera autenticación.
MAILBOX nombre_servidor_SMTP

El nombre del dominio del servidor SMTP que se usa para enviar el mensaje de correo electrónico. Por ejemplo:

MAILBOX "smtp.example.com"
ADDRESS correo_electrónico_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 correo_electrónico_destinatario_cc

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 correo_electrónico_destinatario_bcc

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 línea_asunto La línea de asunto del mensaje de correo electrónico.
MESSAGE texto_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 ruta_archivo

opcional

La ruta de acceso y el nombre de archivo de uno o más archivos adjuntos.

Si el archivo está en la misma carpeta que el proyecto de Analytics, no es necesario especificar la ruta del archivo.

Ponga la ruta y el nombre del archivo entre comillas. Especifique varios archivos adjuntos ingresando una lista de archivos separados por coma para ruta_archivo:

ATTACHMENT "resultado1.csv,resultado2.csv"

Nota

Asegúrese de que no haya espacios tras las comas en las listas separadas por comas.

Ejemplos

Envío de un correo electrónico de reporte de errores

Nota

Sintaxis de comando autenticado.

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 SMTP SMTPUSER "correo_admin@ejemplo.com" PORT 587 ENABLESSL USER "soporte@compañía.com" PASSWORD "9QZC2524830864..." MAILBOX "smtp.compañía.com" ADDRESS "admin_script@compañía.com" SUBJECT "Reporte de errores" MESSAGE "No se logró procesar el script. Se adjuntan detalles." ATTACHMENT "Errores.fil;ACL_Demo.log"

Envío de un correo electrónico de reporte de errores

Nota

Sintaxis de comando sin autenticar.

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 "admin_script@compañía.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.

Un uso común del comando NOTIFY es para notificar al personal apropiado cuando un script falla inesperadamente.

Servidores SMTP compatibles

El comando NOTIFY se puede utilizar con cualquier servidor de correo compatible con SMTP (Simple Mail Transfer Protocol) y debe funcionar con una amplia variedad de servidores SMTP que requieren conexiones autenticadas. Sin embargo, no funciona con todos los servidores o servicios SMTP. Por ejemplo, NOTIFY no funciona con Gmail. Para que las aplicaciones de terceros se conecten a una cuenta de Google, se necesita una configuración de seguridad que vaya más allá del nombre de usuario y la contraseña que admite NOTIFY.

En general, tenga en cuenta que, para usar correctamente NOTIFY a fin de enviar correos electrónicos salientes a un servidor SMTP, se necesita una configuración compatible en Analytics y también en el servidor SMTP. Si NOTIFY no se conecta y no envía correctamente los correos electrónicos, trabaje con su departamento de sistemas para asegurarse de que haya una configuración de conexión compatible entre Analytics y el servidor.

Generación de una contraseña cifrada

Nota

Al especificar o introducir una contraseña de perfil de servidor, de perfil de base de datos o de servidor de correo electrónico, Analytics admite una longitud máxima de 30 caracteres. Cuando se especifica un valor de contraseña que supera la longitud especificada, la contraseña se trunca y se genera un fallo de conexión.

Debe proporcionar un valor de contraseña cifrada con el parámetro PASSWORD en el comando NOTIFY. Para cifrar correctamente una contraseña a fin de usarla con NOTIFY, debe introducir la contraseña en el cuadro de diálogo Notificar de la interfaz de usuario de Analytics.

  1. Opcional. En Analytics, en la línea de comandos, ingrese SET NOTIFYRETRYATTEMPTS TO 0

    Si desactiva temporalmente los reintentos de NOTIFY, se acelerará la generación de la contraseña cifrada.

  2. Desde el menú principal de Analytics, seleccione Herramientas > Notificar por correo electrónico.Analytics

  3. En el cuadro de diálogo Notificar, complete los campos obligatorios y los campos opcionales que sean necesarios:

    Remitente correo_electrónico_remitente Requerido
    Contraseña

    La contraseña de la cuenta de usuario del servidor SMTP con texto claro.

    Nota

    Si la contraseña supera los 30 caracteres, el comando NOTIFY fallará.

    		 Requerido
    Ruta buzón nombre_servidor_SMTP Requerido
    En correo_electrónico_destinatario Requerido
    CC correo_electrónico_destinatario_cc Opcional
    BCC correo_electrónico_destinatario_bcc Opcional
    Asunto línea_asunto Requerido
    Texto texto_mensaje Requerido
    Adjunto ruta_archivo Opcional

  4. Haga clic en Aceptar.

    Si está intentando conectarse a un servidor SMTP que requiere autenticación, el intento de conexión fallará aunque el comando NOTIFY aparezca como correcto, pero es algo normal.

  5. Copie el comando NOTIFY del log y péguelo en un script.

    El comando NOTIFY incluye ahora un valor cifrado para PASSWORD.

  6. En el script, agregue los siguientes parámetros al comando NOTIFY que copió y proporcione los valores adecuados del parámetro.

    Puede insertar los parámetros inmediatamente después de la palabra clave NOTIFY.

    • SMTP

    • SMTPUSER nombre_cuenta_SMTP

    • PORT número_puerto

    • ENABLESSL (si es necesario)

  7. Si anteriormente definió el número de reintentos de NOTIFY en 0, ingrese SET NOTIFYRETRYATTEMPTS TO 5 en la línea de comandos.

    Si al principio tenía un número de reintentos diferente especificado en lugar de 5, ingrese el número correspondiente.

  8. Ejecute el script para probar el comando NOTIFY.

    Si todos los valores obligatorios están correctamente configurados para funcionar con el servidor SMTP de correo electrónico, el comando NOTIFY debería ejecutarse sin problemas.

Cómo responde Analytics a los intentos de conexión fallidos

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. Esta funcionalidad de reintentos automáticos se centra en las situaciones en las que el servidor de correo no está disponible momentáneamente.

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 que contiene el comando se continúa procesando.

Puede utilizar el comando SET para cambiar este comportamiento de reintento predeterminado. Puede especificar:

  • un número diferente de intentos de conexión

  • que no haya intentos de conexión adicionales

  • una cantidad diferente de tiempo entre intentos

  • un fallo de script si el comando NOTIFY no se puede conectar y se cancela

Si desea obtener información adicional sobre el comando SET, consulte Comando SET.

Sintaxis del comando SET Ejemplos y observaciones

SET NOTIFYRETRYATTEMPTS <TO> núm

 
SET NOTIFYRETRYATTEMPTS TO 10

Configuración predeterminada: 5 intentos

Especifica la cantidad de veces que el comando NOTIFY intentará enviar un mensaje de correo electrónico si el intento inicial no se completa correctamente. Escriba un número del 0 al 255. Si escribe 0, no se realizan más intentos después del primer error.

Una posible causa para que el comando NOTIFY no pueda enviar un correo electrónico es que el servidor de correo electrónico no esté disponible.

SET NOTIFYRETRYINTERVAL <TO> segundos

 
SET NOTIFYRETRYINTERVAL TO 30

Configuración predeterminada: 10 segundos

Especifica la cantidad de tiempo, en segundos, entre NOTIFYRETRYATTEMPTS. Escriba un número del 1 al 255.

SET NOTIFYFAILSTOP {ON | OFF}

 
SET NOTIFYFAILSTOP ON

Configuración predeterminada: OFF

  • NOTIFYFAILSTOP está en OFF Analytics permite que el script continúe aun cuando un comando NOTIFY del script falle.Analytics
  • NOTIFYFAILSTOP está en ON Analytics deja de procesar un script y escribe un mensaje en el registro si un comando NOTIFY del script falla. El script se detiene después del primer error, o después de la cantidad especificada de NOTIFYRETRYATTEMPTS, si ninguno de los intentos se completa correctamente.

Nota

Un destinatario de correo electrónico no válido no se considera un error del comando NOTIFY y no hace que el script se detenga, sin importar cuál sea la configuración de NOTIFYFAILSTOP.