Gestão de Pessoas - Manual do Usuário > Customizações > Funções > EnviaEMail

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:

Deseja-se enviar um e-mail para joao@senior.com.br.
A rotina envia o e-mail sem problemas.
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:

Deseja-se enviar um e-mail para os endereços: joao@senior.com.br (existe) e maria@teste.com.br (não existe).
A rotina envia o e-mail para o endereço que existe - joao@senior.com.br recebe o e-mail.
O provedor teste.com.br está programado para retornar um aviso ao remetente informando que maria@teste.com.br não existe.
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:

Usuário Pedro utiliza o domínio de e-mails da Senior (senior.com.br).
Deseja-se enviar um e-mail para os endereços: jose.silva@senior.com.br (existe) e jose@senior.com.br (não existe).
O servidor da Senior retorna um código maior que 400, que caracteriza erro, informando que jose@senior.com.br é um usuário inexistente.
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:

Para a rotina, um endereço inválido é aquele que não possui pelo menos um ponto e o sinal de @.
Deseja-se enviar um e-mail para os endereços: joao@senior.com.br (existe), joaoteste.com.br (inválido) e jose (inválido).
A rotina valida esses endereços (antes de enviar os comandos de endereços de e-mail ao servidor).
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:

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).
A rotina envia o e-mail para o endereço que existe - jose.silva@senior.com.br recebe o e-mail.
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á.