EnviaEmail

Esta função envia um e-mail conforme os parâmetros informados, permitindo inclusive anexar arquivos.

Esse função respeita a configuração Permite alterar remetente disponível na Central de Configuração (SeniorConfigCenter).

Sintaxe: EnviaEMail(Alfa RmtEma, Alfa DstEma, Alfa CcpEma, Alfa CcoEma, Alfa AssEma, Alfa TxtEma, Alfa AnxEma, Numero aPapelCarta);

Parâmetros:

Nome Tipo Descrição
RmtEma Alfa Endereço Eletrônico padrão do Remetente do e-mail.
DstEma Alfa Endereço Eletrônico padrão do Destinatário do e-mail (Obrigatório). Se houver mais de um, devem ser separados por ponto e vírgula (;).
CcpEma Alfa Endereço Eletrônico padrão do Destinatário da cópia do e-mail. Se houver mais de um, devem ser separados por ponto e vírgula (;).
CcoEma Alfa Endereço Eletrônico padrão do Destinatário da cópia oculta do e-mail. Se houver mais de um, devem ser separados por ponto e vírgula (;).
AssEma Alfa Assunto padrão do e-mail.
TxtEma Alfa Texto padrão do e-mail.
AnxEma Alfa Caminho padrão dos arquivos anexos do e-mail.
aPapelCarta Numérico Indica se será utilizado o texto de papel de carta. Valores: 0 (Não) e 1 (Sim).

Tipo de retorno: Se a função possui destinatários inválidos, retorna 1. Caso contrário, retorna 0. Observação: para a rotina, um endereço inválido é aquele que não possui, pelo menos, um ponto e o sinal de arroba (@).

Exemplo 1: 

x = EnviaEMail("","ads fas dfas@ aaa", "", "", "", "");

Neste caso o x é igual a 1.

Exemplo 2:

EnviaEmail("Ana Luiza",
           "ana.luiza@senior.com.br;maria.eduarda@senior.com.br",
           "jose.carlos@senior.com.br;ana.claudia@senior.com.br",
           "chefia@senior.com.br",
           "Envio de E-Mail Automático",
           "Esta linha vai aparecer no corpo do E-Mail recebido",
           "c:\\temp\\teste.txt;c:\\temp\\teste2.txt", 1);

Exemplo 3:

EnviaEmail ("nrr@senior.com.br", "", "", "",
            "Finalização de Requisição", xMsg,
            "c:\\svcl2.txt;\\\\servidorRH\\usuarios\\NRR\\Teste Email\\Teste x.pdf");

Utilização: Gerador de relatórios, regras e telas de SGI.

Observações: Quando entre os e-mails dos destinatários (nos campos Para, Com cópia ou Com cópia oculta) há um e-mail inválido, a função possui comportamentos diferentes. Observe os cenários possíveis:

Cenário 1 - Envio de e-mail para endereços corretos:

  1. Deseja-se enviar um e-mail para joao@senior.com.br.
  2. A rotina envia o e-mail sem problemas.
  3. joao@senior.com.br recebe o e-mail.

Cenário 2 - Envio de e-mail para endereços corretos, porém com no mínimo um endereço incorreto de outro servidor:

  1. Deseja-se enviar um e-mail para os endereços: joao@senior.com.br (existe) e maria@teste.com.br (não existe).
  2. A rotina envia o e-mail para o endereço que existe - joao@senior.com.br recebe o e-mail.
  3. O provedor teste.com.br está programado para retornar um aviso ao remetente informando que maria@teste.com.br não existe.
  4. O remetente recebe o aviso.

Alguns provedores podem estar programados para não retornar o aviso, logo o remetente não o receberá.

Cenário 3 - Envio de e-mail para endereços corretos, porém com no mínimo um endereço incorreto do próprio domínio:

  1. Usuário Pedro utiliza o domínio de e-mails da Senior (senior.com.br).
  2. Deseja-se enviar um e-mail para os endereços: jose.silva@senior.com.br (existe) e jose@senior.com.br (não existe).
  3. O servidor da Senior retorna um código maior que 400, que caracteriza erro, informando que jose@senior.com.br é um usuário inexistente.
  4. A rotina entra em uma exceção e não finaliza o envio do e-mail - ninguém recebe.

Cenário 4 - Envio de e-mail para endereços corretos, porém com no mínimo um endereço inválido:

  1. Para a rotina, um endereço inválido é aquele que não possui pelo menos um ponto e o sinal de @.
  2. Deseja-se enviar um e-mail para os endereços: joao@senior.com.br (existe), joaoteste.com.br (inválido) e jose (inválido).
  3. A rotina valida esses endereços (antes de enviar os comandos de endereços de e-mail ao servidor).
  4. Uma exceção é gerada e o envio não é finalizado - ninguém recebe.

Cenário 5 - Envio de e-mail para endereços corretos, porém com no mínimo um endereço de domínio que não existe:

  1. Deseja-se enviar um e-mail para os endereços: jose.silva@senior.com.br (existe) e jose@ceniorinv.com.br (servidor não existe).
  2. A rotina envia o e-mail para o endereço que existe - jose.silva@senior.com.br recebe o e-mail.
  3. O remetente recebe o aviso de que o servidor ceniorinv.com.br não existe.

Alguns provedores podem estar programados para não retornar o aviso, logo o remetente não o receberá.

Este artigo ajudou você?