Executar Rotina

1 Descrição

A execução de uma rotina é a forma como o sistema de aplicações executa uma tarefa. O cliente faz uma requisição http para o endereço onde está a aplicação que atende as requisições, camada Controler, que recupera as informações de execução. Estas informações devem conter o nome da rotina e a ação a ser executada, qualquer outro parâmetro é opcional. A camada também tem que ser capaz de reconhecer o usuário, e seus perfis, que está executando a solicitação e validar se este pode realmente executar a rotina solicitada.

Após as validações básica a rotina de controle o ambiente é preparado para ser executado em modo protegido ou não. Uma rotina que rode no modo desprotegido pode acessar métodos das bibliotecas do sistema cadastrados como protegidos. Esta funcionalidade está sempre disponível para rotinas do módulo do sistema.

Com o ambiente preparado para execução o modulo de controle inclui o código da camada de modelo e chama a execução da aplicação utilizando as informações rotina e ação, recuperadas da requisição http, e passa a executar a aplicação do cliente. Quando a aplicação conclui sua tarefa deve retornar um objeto cujas propriedades serão serializadas em formato xml pela camada de controle e devolvidas ao cliente que fez a solicitação.

2 Atores

• 1. Sistema Cliente
• 2. Aplicação Cliente

3 Pré-condições

• Ter executado a rotina de login com sucesso.

4 Eventos

• 1. Aplicativo cliente envia requisição HTTP.
• 2. Servidor recebe a requisição e chama a camada controler para processar a requisição.
• 3. Camada controler recupera as informações de rotina e atividade e valida acesso conforme informações do perfil do usuário logado. {A1}
• 4. Busca informações sobre a rotina no banco de dados e define a classe de segurança no modo de proteção habilitado. {A2}
• 6. Chama a aplicação default da camada de negócios que armazena os parâmetros da solicitação http em uma lista e em seguida executa o método default desta aplicação.{A3}
• 5. Aplicação desenvolvida pelo cliente executa suas tarefas e retorna objeto.{A4}
• 6. Controler transforma objeto em xml e retorna via http para o cliente {A5}

5 Eventos Alternativos

• 1. Usuário da sessão não tem permissão de execução da rotina ou ação, levanta erro para ser tratado pela camada de controle que retorna xml de erro. {E1}
• 2. No caso da solicitação ao banco de dados retornar que a aplicação deve ser desprotegida define a classe de segurança no modo de proteção desabilitado.
• 3. Se uma ação foi passada para a rotina, obtida na recuperação da url, executa o método correspondente ao nome da ação.
• 4. Aplicação do cliente retorna erro, retorna erro para a camada de controle.
• 5. Converte o erro para xml de erro e retorna para o cliente.

6 Tratamento de Erros

• E1 Monta mensagem de erro "Rotina solicitada não existe ou usuário não tem permissão de acesso" .

7 Mensagem

Não relevante

8 Pós-condições

• Xml enviado para o cliente.

9 Regras de Negócio

Não relevante.

10 Telas Envolvidas

Não relevante.

11 Notas