Sub-sistema para armazenar preferências de configurações

Índice

Configuração de e-mail

RTPREF.CFG_MAIL

Descrição

Interface que permite configurar e testar o envio de e-mail a partir da aplicação. Define os parâmetros a serem utilizados, tais como endereço do servidor de SMTP, nome de usuário de autenticação, etc.

O e-mail de teste é inicialmente populado com o e-mail do usuário da sessão corrente. O usuário pode alterar este e-mail temporariamente para executar o teste, mas essa informação não é salva no sistema (a próxima vez que entrar volta o e-mail do usuário).

Ver também:

Campos:

Nome ou IP do servidor de SMTP a ser utilizado para o envio de mensagens. P.ex. smtp.locaweb.com.br
Porta do serviço do servidor de e-mails. O padrão é 25, mas pode ser utilizada outra porta (p.ex.: a Locaweb utiliza a porta 587). No caso do gmail, é utiilizada a porta 465.
Usuário (login) utilizado para autenticação e conexão ao servidor de e-mails SMTP.
Senha do usuário informado no campo "Usuário de autenticação do SMTP" para conexão ao servidor SMTP.
Define quando a conexão utiliza o protocolo de segurança SSL (Secure Socket Layer).
No caso do gmail, deve estar ativado.
Define quando a conexão utiliza o protocolo de segurança TLS (Transport Layer Security).
No caso do gmail, é utiilizada a porta 465.
Nome ou IP do servidor local exigido na conexão SMTP.

Deve ser preenchido com o nome do equipamento/serviço que identifique quem que está enviando o e-mail. Deve distinguir a origem do e-mail.
Este nome é utilizado na abertura da conversação do SMTP onde a estação que irá enviar o e-mail se "apresenta" para o servidor de mail e irá aparecer nos headers completos da mensagem, como por exemplo: 
Received: from SERVIDOR-ELIGO (unknown [189.114.74.45])
(Authenticated sender: erro@prd.inf.br)
by bart0135.correio.pw (Postfix) with ESMTPA id C2136808D8
for ; Mon, 19 May 2014 17:27:31 -0300 (BRT) 
Date: Mon, 19 May 2014 17:27:31 -0300 (BRT)
From: Eligo <erro@prd.inf.br>
To: suporte@prd.inf.br
Message-ID: <2666994.51400531252566.JavaMail.tomcat7@prd-84>
Subject: Teste de e-mail
...
Nome e endereço do remetente padrão a ser utilizado, caso nenhum outro seja informado.
Quando informado, configura o servidor para incluir uma cópia oculta em TODOS os e-mails enviados pelo servidor.
E-mail para resposta. Quando informado, o cabeçalho de e-mail recebe o header "reply-to" que deve ser utilizado pelo cliente de e-mail como o endereço para onde as repostas devem ser enviadas.

Define se deve ser requerido do destinatário a confirmação de leitura do e-mail
Estabelece o nível de severidade das mensagens do sistema a serem enviadas por e-mail para o suporte. P.ex. Caso seja informado "Warning", serão enviados e-mails da mensagens dos níveis "Warning" e níveis superiores, no caso, "Unknown", "Panic" e "Critical".
  • Warning - Mensagens de "alerta" ou "cuidado". Não impede e não interrompe o processamento em andamento.
  • Error - Mensagem de "erro", com interrupção do processamento, pois é necessária intervenção do usuário para ajustes nos dados ou o procedimento possui algum impedimento que não permite a sua execução.
  • Unknown - Mensagem "sem identificação", ou seja, o sistema identificou uma situação anômala, mas não conseguiu interpretar a causa ou origem da interrupção.
  • Critical - Mensagem de erro "crítico" para o sistema, interrompendo totalmente o processamento do sistema ou rotina.
  • Panic - Mensagem de "pânico", o que implica em problema gravíssimo, impedindo por completo o uso do sistema. P.ex.: espaço em disco indisponível no servidor do sistema.
Endereço de e-mail do destinatário dos e-mails das mensagens do sistema. P.ex.: erro@prd.inf.br
Endereço de e-mail utilizado para identificar o "remetente" dos e-mails enviados para o suporte com as mensagens do sistema, podendo ser informado com "nome do remetente" e "endereço de e-mail do remetente". P.ex.: PRD Tecnologia
Corpo dos e-mails das mensagens do sistema.
Utilizam-se macro expressões para captura de informações do contexto do sistema e identificação da mensagem a serem apresentadas ao destinatário.
P.ex.: 
${userName} = login do usuário da sessão
${errorsReport} = mensagem de erro apresentada para o usuário
${parameters} = parâmetros da sessão
${sessionLog} = log da sessão
Endereço de e-mail do destinatário dos testes de envio de e-mails do sistema. Pode ser qualquer conta de e-mail, independente do domínio. P.ex.: se for informado suporte@prd.inf.br, os e-mails de teste serão enviados somente para este endereço.

Este campo é preenchido pela preferência RTPREF.CFG_MAIL.SQL_EMAIL_TESTE.

Operações

Topo

Custom

Tela para consultar e alterar os parâmetros de configuração para o envio de e-mail.
Comportamento:Topo

Salvar configurações

Método que salva as configurações informadas.
Topo

Testar configurações

Executa o teste de envio de um e-mail para o endereço informado, reportando qualquer erro encontrado.

Dúvidas frequentes

  • Como corrigir o envio de e-mails pelo sistema quando aparece a mensagem "Erro não esperado ao tentar enviar e-mail from: envio@prd.inf.br, to: suporte@prd.inf.br. 501 Syntax: HELO hostname"?

    • Configurações

    RTPREF.CFG_MAIL.SQL_EMAIL_TESTE

    SQL e-mail para teste

    Define um SQL para retornar um e-mail de teste padrão. Pode-se utilizar os parâmetros de contexto, tais como:

    Parâmetro Descrição
    [USER_ID] ID do usuário da sessão.
    [PERSON_ID] ID da pessoa do usuário da sessão.

    É necessário informar uma consulta SQL com apenas uma coluna e uma linha de resultado.

    Recomenda-se utilizar o SQL: 

    select ende.endereco from 
enderecos ende
join tipos_enderecos tien on tien.id = ende.tipo_endereco_id
join pessoas pess on pess.id = ende.pessoa_id
left join usuarios usu on usu.pessoa_id = pess.id
where tien.tipo_endereco like 'EMAIL%' 
 and usu.id = [USER_ID]
order by ende.sequencia limit 1

    Tipo: SOURCE_CODE

    Regras

    Ler as configurações

    Lê as preferencias preparando o formulário para consulta e/ou alteração.
    Eventos que disparam esta regra:
    • Antes de apresentar uma tela formulário "Custom"

    Veja também