Comando NOTIFY
Envia uma mensagem de notificação por e-mail.
Sintaxe
NOTIFY USER nome_do_usuário <PASSWORD senha> MAILBOX nome_do_caminho ADDRESS destinatário <CC destinatário_cc> <BCC destinatário_cco> <SUBJECT assunto> MESSAGE mensagem <ATTACHMENT nome_do_caminho>
Parâmetros
| Nome | Descrição |
|---|---|
| USER nome_do_usuário |
O endereço de e-mail do remetente. |
| PASSWORD senha opcional |
A senha do servidor de e-mail. |
| MAILBOX nome_do_caminho |
O nome do servidor SMTP a ser usado para enviar a mensagem de e-mail. Por exemplo: MAILBOX "mailserver.example.com" |
| ADDRESS destinatário |
O endereço de e-mail de um ou mais destinatários. Separe vários endereços de e-mail com vírgula. Insira no máximo 1.020 caracteres. |
| CC destinatário_cc opcional |
O endereço de e-mail de um ou mais destinatários de cópia. Separe vários endereços de e-mail com vírgula. Insira no máximo 1.000 caracteres. |
| BCC recipientes_cco opcional |
O endereço de e-mail de um ou mais destinatários de cópia oculta. Separe vários endereços de e-mail com vírgula. |
| SUBJECT assunto opcional |
A linha de assunto da mensagem de e-mail. |
| MESSAGE mensagem |
O texto do corpo da mensagem de e-mail. A mensagem usa texto simples e não permite HTML. Se você quiser inserir uma quebra de linha na mensagem, use dois caracteres de circunflexo: ^^. |
| ATTACHMENT nome_do_caminho opcional |
O caminho e o nome do arquivo de um ou mais anexos. Deve ser uma cadeia entre aspas. Especifique vários anexos, inserindo uma lista separada por vírgula de arquivos para nome_do_caminho: ATTACHMENT "resultado1,resultado2" |
Exemplos
Envio de um e-mail de relato de erro
Você está executando um script e deseja enviar um e-mail de notificação em caso de falha do script. Use NOTIFY para definir a mensagem de e-mail e incluir dois anexos:
- o arquivo de log
- um arquivo .fil contendo os erros registrados
NOTIFY USER "support@company.com" MAILBOX "mail.company.com" ADDRESS "script_admin@example.com" SUBJECT "Relatório de erros" MESSAGE "Falha ao processar script. Detalhes em anexo." ATTACHMENT "Erros.fil,ACL_Demo.log"
Observações
Destinatários e anexos
O comando NOTIFY pode ser utilizado para enviar mensagens de notificação por meio de e-mail para um ou mais destinatários. As mensagens podem incluir arquivos de dados anexados e projetos do Analytics.
O comando NOTIFY pode ser usado para notificar os funcionários apropriados quando um script falhar inesperadamente.
Protocolos e portas
O comando pode ser utilizado com qualquer servidor de e-mail que ofereça suporte a SMTP (Simple Mail Transfer Protocol), utilizado pelo Microsoft Exchange e diversos outros servidores de e-mail. O comando NOTIFY pode também ser usado com aplicativos mais antigos de e-mail, da Microsoft e de outros, que enviam e-mail localmente.
O NOTIFY usa a porta 25. Portanto, essa porta deve estar aberta no servidor de e-mail, caso contrário, o comando falhará. O número da porta usada pelo comando não é configurável. Se o NOTIFY falhar com uma mensagem de erro, entre em contato com o seu departamento de TI para saber se a porta 25 está bloqueada na sua rede.
Tratamento de erros
Caso o Analytics não consiga se conectar ao servidor de e-mail, ele realiza mais cinco tentativas de conexão, com uma pausa de 10 segundos entre cada tentativa. Caso todas as tentativas resultem em falha, o comando NOTIFY é cancelado com o registro de uma mensagem no log mas o script continua em processamento.
O comando SET pode ser usado para alterar esse comportamento. Um outro número de tentativas de conexão e de tempo entre conexões pode ser especificado, ou as tentativas adicionais de conexão podem ser desabilitadas. Também é possível instruir que o Analytics interrompa o processamento de um script caso um comando NOTIFY seja cancelado. Para obter mais informações, consulte Comando SET.
Um destinatário inválido de e-mail não constitui uma falha no comando NOTIFY e não causa a interrupção do script independentemente da configuração associada.
