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á.
English
Español
