UC00109 - Configurações de envio de e-mail

Objetivo

• Manter configurações de envio de e-mail.

Atores

• Usuário
• Servidor (externo) de envio de e-mail

Pré-requisitos

• Considerar documento Padrões de desenvolvimento.
• Ajustar o sistema para que não considere mais as configurações de e-mail contidas no arquivo spring-resource.xml. Dependendo da rotina que está enviando e-mail, considerar as respectivas configurações propostas neste documento.
• Criar no cadastro de filiais uma nova aba chamada Configurações de envio de e-mail que utilize o template mencionado neste caso de uso e salve as configurações em questão por filial.
• Criar no cadastro de compradores uma nova aba chamada Configurações de envio de e-mail que utilize o template mencionado neste caso de uso e salve as configurações em questão por comprador.

Resultado esperado

• Configurar envio de e-mail no sistema.
• Testar envio de e-mail.
• Enviar e-mail.

Diagrama de classes

Fluxo de eventos

Fluxos principais

Fluxo 1: Usuário acessa, no cadastro de compradores ou no cadastro de filiais, a aba Configurações de envio de e-mail.

• Sistema exibe campos para configurar envio de e-mails conforme regra de negócio RN01.

Fluxo 2: Usuário informa dados de configuração de envio de e-mail incluindo o destinatário de teste e aciona o botão [Testar envio].

• Sistema envia um e-mail de teste para o destinatário informado para comprovar que as configurações informadas são válidas.

Fluxo 3: Após configurar e testar o envio de e-mail, usuário aciona o botão [Salvar].

• Sistema salva para a entidade em questão (comprador, filial e etc) as configurações de envio de e-mail.

Fluxos alternativos

Fluxo 1: Usuário informa configurações de envio de e-mail, não testa o envio e aciona o botão [Salvar].

• Antes de salvar os dados sistema emite ao usuário a seguinte mensagem de confirmação: Não foi enviado e-mail de teste para validar as configurações informadas. Deseja realmente salva-las?

Fluxo 2: Usuário informa as configurações de envio de e-mail e aciona o botão [Testar envio], mas o sistema não consegue enviar o e-mail.

• Uma mensagem de alerta é emitida ao usuário informando que houve problemas ao enviar o e-mail de teste e exibindo a mensagem de erro/exceção, exemplo: Não foi possível enviar o e-mail de teste, motivo: MOTIVO_OU_EXCEÇÃO.

Fluxos de exceção

Fluxo 1: Usuário preenche configurações de e-mail deixando um ou mais campos obrigatórios (de acordo com quadro de dados) em branco acionando o botão [Salvar] em seguida.

• Sistema aborta operação e emite ao usuário a seguinte mensagem de alerta: Para salvar as configurações é necessário que todos os campos obrigatórios (*) estejam preenchidos.

Regras de negócio

RN01 - Descrição dos campos e funcionalidades das configurações de envio de e-mail

Deverá ser criado no sistema um template de configurações de envio de e-mail que poderá ser utilizado pelas rotinas que precisarem de tal funcionalidade.

O template terá os seguintes campos:

1. Servidor de envio: Campo onde deverá ser informado o nome/endereço do servidor (de envio) de e-mail. Por padrão o campo deverá ser preenchido com o seguinte texto:Exemplo: smtp.google.com. Quando o foco passar sobre o campo em questão, o texto padrão deverá ser removido.
2. Porta: Campo onde deverá ser informada a porta de conexão do servidor de e-mail em questão. Por padrão este campo deverá ser preenchido com o seguinte texto: Exemplo: 25. Quando o foco passar sobre o campo em questão o texto padrão deverá ser removido.
3. Servidor requer autenticação: Parâmetro que define se o envio de e-mails deverá ser (ou não) autenticado com usuário e senha no servidor.
4. Usuário: Campo onde deverá ser informado o nome de usuário para envio de e-mails. Por padrão este campo deverá ser preenchido com o seguinte texto: Exemplo: usuario@gmail.com. Quando o foco passar sobre o campo em questão o texto padrão deverá ser removido.
5. Senha:Campo onde deverá ser informada a senha para envio de e-mails.
6. E-mail destinatário para teste: Campo onde poderá ser informado um endereço de e-mail para o qual será enviado um e-mail de teste para validar as configurações feitas. Neste e-mail o assunto será Teste de envio de e-mail e no corpo será exibido o texto E-mail enviado com sucesso!
7. Botão [Testar envio]: Quando acionado, este botão enviará um e-mail de teste para o destinatário em questão com as configurações feitas.

Quadro de dados

NOME	OBRIGATÓRIO	TIPO DE ENTRADA	VALORES POSSÍVEIS	TAMANHO	VALOR PADRÃO	OBSERVAÇÃO
Servidor de envio	Sim	Input	Alfanuméricos	100	Vazio
Porta	Sim	Input	Inteiros		Vazio
Servidor requer autenticação	Não	Checkbox	Marcado/Desmarcado
Usuário	Sim	Input	Alfanuméricos	100	Vazio
Senha	Sim	Input	Alfanuméricos	100	Vazio
E-mail destinatário para teste	Não	Input	Alfanuméricos	100	Vazio