English
Español
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:<div class="Code"><p>x = EnviaEMail("","ads fas dfas@ aaa", "", "", "", "");<br></br></p></div>
Neste caso o x é igual a 1.
Exemplo 2:<div class="Code"><p>EnviaEmail("Ana Luiza",<br></br> "ana.luiza@senior.com.br;maria.eduarda@senior.com.br",<br></br> "jose.carlos@senior.com.br;ana.claudia@senior.com.br",<br></br> "chefia@senior.com.br",<br></br> "Envio de E-Mail Automático",<br></br> "Esta linha vai aparecer no corpo do E-Mail recebido",<br></br> "c:\\temp\\teste.txt;c:\\temp\\teste2.txt", 1);</p></div>
<div class="Code"><p>EnviaEmail ("nrr@senior.com.br", "", "", "", <br></br> "Finalização de Requisição", xMsg, <br></br> "c:\\svcl2.txt;\\\\servidorRH\\usuarios\\NRR\\Teste Email\\Teste x.pdf");</p></div>
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.
- 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.
- 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.
- 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
