Submeter Interface de Visualização

1 Descrição

Depois que uma interface tiver sido renderizada para o usuário, o sistema terá encerrado um ciclo, e ficará aguardando o recebimento de alguma ação endereçada para a camada controller. O usuário do sistema tem a opção de descartar esta interface e selecionar outra ação de menu do sistema, ou então poderá preencher os dados da interface e clicar em algum componente que submete os dados para o sistema.

2 Atores

1. Usuários da aplicação
2. Navegador do usuário

3 Pré-condições

Ter executado o UC Exibir Interface de Visualização.

4 Eventos

1. Usuário preenche os campos da interface
2. Usuário aciona evento de um componente da interface com ação vinculada a método da camada de negócio.
3. Sistema valida cada um dos componentes da interface, segundo suas propriedades, utilizando Javascript. {A1}{E1}
4. Sistema invoca função de dispatch que submete os dados para a camada controller.
5. Sistema executa a ação conforme o UC Executar Rotina.
6. Navegador recebe o retorno de dados da camada controller.
7. Navegador executa função javascript que trata os dados recebidos.

5 Eventos Alternativos

{A1} Valida somente os dados do componente selecionado caso o mesmo seja um componente que não submete a interface completa.

6 Tratamento de Erros

{E1} Caso sejam encontrados erros com os dados da interface, exibe mensagens padronizadas {M1}...{Mn}

7 Mensagem

{M1} Campo <nome do campo> é obrigatório.

{M2} Campo <nome do campo> deve conter um valor numérico.

{M3} Selecione uma opção para o campo <nome do campo>

{M4} Data inválida para o campo <nome do campo>

8 Pós-condições

Interface modificada.

9 Regras de Negócio

Todas as requisições da interface devem ser feitas por Ajax.

Ao submeter a requisição, a função de dispatch deverá montar um array com os dados da interface, e anexar também o identificador da aplicação e o identificador da ação.

Para cada componente que invoque ação da camada model, deverá existir uma função javascript (handler de sucesso), codificada pelo usuário, que tratará os dados recebidos, modificando a interface conforme desejado. Antes da chamada da função de tratamento do usuário, será invocada uma função javascript padrão da interface, que verificará se os dados retornados são mensagens, erros ou html. Nos dois primeiros casos, a função javascript deverá popular região da interface própria para isso. Caso seja html, a função javascript deverá popular o componente da interface definido nas propriedades do componente chamador. Caso seja Xml deverá será tratado pela função handler de sucesso.

Deverá existir em qualquer interface uma função para tratamento de erros do framework Ajax (handler de erro), que produzirá uma mensagem padrão na interface, caso ocorraram erros imprevistos.

10 Telas Envolvidas

11 Notas