wiki:WF/definiraplicacao

Version 14 (modified by viani, 13 years ago) (diff)

--

Definir Aplicação

1 Descrição

O módulo de aplicação oferece uma interface para cadastramento de aplicações. Esta interface é acessada na tela de aplicações, clicando no ícone configurar aplicação que está disponível junto aos demais ícones de aplicações, e está disponível para os administradores do módulo ou usuários que possuam perfil de administrador em alguma das aplicações do módulo. Uma aplicação somente estará disponivel para acesso quando configurada pelo sistema de definição de aplicações.

Como o módulo de configuração das aplicações é também uma aplicação do módulo de aplicações, as tabelas utilizadas para o cadastro devem ser populados na instalação do módulo ou no primeiro acesso ao mesmo. O usuários administradores de sistema ou administradores do módulo terão acesso à aplicação de configuração.

Para uma aplicação ser executada é necessário a configuração de um conjunto de parâmetros que são utilizados como balizadores e validadores de uma execução. Todas as ações que são executadas pela aplicação tem que ser cadastradas nos campos adequados bem como o nome da aplicação, os perfis dos usuários no sistema, os usuários que farão parte dos perfis também tem que ser cadastrados como membros destes.

2 Atores

  1. Administrador do Sistema
  2. Administrador do Módulo

3 Pré-condições

Ter executado o UC Criar Tela de Aplicações.

4 Eventos

  1. Administrador clica sobre o ícone de manutenção de aplicações.
  2. Executa o UC Executar Rotina
  3. Administrador do módulo insere o nome da nova aplicação, o ícone por ele utilizado e o caminho onde serão armazenados os arquivos fonte da aplicação {A1}{A2}
  4. Administrador cadastra parâmetros da aplicação que são apresentados conforme cadastrados em repositório que armazena os tipos de parâmetros da aplicação, exceto a ação padrão da aplicação.
  5. Administrador cadastra os perfis que terão acesso a aplicação, inserindo o nome de cada um dos perfis.{A3}
  6. Administrador cadastra os usuários que tem acesso a aplicação no perfil adequado. A pesquisa de usuários é feita na base ldap e os dados inseridos em uma tabela cache do módulo.
  7. Administrador cadastra as ações do sistema informando o nome do arquivo php a classe a ser instânciada e método que será executado pela ação.{A4}
  8. Administrador cadastra perfis que tem permissão de execução da ação.{A5}
  9. Administrador cadastra a ação padrão da aplicação, a partir do conjunto de ações cadastradas.
  10. Administrador cadastra as mensagens da aplicação.
  11. Administrador clica no botão salvar alterações.
  12. Aplicação cliente verifica se os campos obrigatórios estão preenchidos e são consistentes. {E1}
  13. Sistema inicia a transação de banco de dados.
  14. Sistema persiste os dados da aplicação.{A6}{E2}
  15. Sistema persiste os parâmetros da aplicação. {E2}
  16. Sistema persiste os profiles da aplicação. {E2}
  17. Sistema persiste as ações da aplicação. {E2}
  18. Sistema persiste as relações entre profiles e ações, e as relações entre profiles e usuários. {E2}
  19. Sistema persiste a ação padrão da aplicação.{E2}
  20. Sistema escreve os dados no banco de dados.
  21. Sistema escreve as mensagens da aplicação, em arquivo texto, na pasta config da aplicação.

5 Eventos Alternativos

{A1}. Administrador do módulo ou administrador do sistema seleciona uma das aplicações em que dá manutenção e altera o nome da aplicação, o ícone por ele utilizado e/ou o caminho onde serão armazenados os arquivos fonte da aplicação.

{A2}. Administrador clica sobre o ícone excluir aplicação.

{A2a} Sistema exibe pedido de confirmação e caso seja confirmada o sistema marca a aplicação como excluida e esta não é mais exibida na tela de applicações.

{A3}. Administrador clica sobre uma dos perfis cadastrados, sistema exibe um campo texto onde o usuário altera o nome do profile, confirma e este é marcado como alterado.

{A4}. Administrador clica sobre uma das ações pré cadastradas, sistema exibe tela com as informações das ações, usuário altera estes dados, clica em confirmar e o sistema marca esta ação como alterada.

{A5}. Administrador remove permissão de perfil para a execução de uma ação.

{A6}. Atualiza a aplicação passando para o status inativa.

6 Tratamento de Erros

{E1}. Se uma campo obrigatrório não foi preenchido exibe mensagem {M1}, coloca foco no campo não preenchido e finaliza o fluxo.

{E2}. Não foi possível inserir informação no banco de dados. Exibe mensagem {M2}, desfaz as modificações da transação e finaliza o fluxo.

7 Mensagem

{M1}. Campo obrigatório não preenchido.

{M2}. Não foi possível salvar as alterações. (+Detalhes) Retorno do erro do banco de dados.

8 Pós-condições

Aplicação configurada.

9 Regras de Negócio

Os campos obrigatórios são:

  1. Nome da aplicação (Texto com mais de 3 caracteres)
  2. Caminho da aplicação (Caminho válido para o sistema operacional)
  3. Parâmetros de conexão com Banco de Dados
  4. No mínimo uma ação cadastrada
    1. Nome da ação
    2. Codigo da ação (único por aplicação)
    3. Nome e caminho do arquivo da ação
    4. Nome do método executado pela ação

  1. No mínimo um profile
  2. No mínimo um usuário no profile.
  3. Ação default da aplicação (Alguma das ações cadastradas para o sistema)

Os campos opcionais para a aplicação são:

  1. Caminho do repositório svn
  2. Url da documentação da aplicação

Os campos opcionais para uma ação são:

  1. Nome do template
  2. Caminho de menu

Cada ação cadastrada no sistema tem que estar ligada a algum profile.

Caso não seja informado template associado a uma ação, o sistema deverá assumir que o retorno é xml, podendo este resultado ser utilizado por um sistema externo ou consumido por uma requisição Ajax.

Caso uma ação tenha caminho de menu, esta será listada como menu da aplicação. O caminho poderá estar segmentado por delimitadores, formando uma estrutura hierárquica de menus e sub-menus.

O relacionamento de usuários com perfis, e estes a ações, irá constituir o controle de acesso da aplicação.

10 Telas Envolvidas

Não relevante.

11 Notas