MDD DD ATMH MCU

(1)

Projeto do Sistema ATMH

MDD - DD

Versão 1.0

(2)

Histórico da Revisão

Data Versão Descrição Autor

23/05/2009 0.1 Confecção inicial do documento Gabriel P. S. Brenner

24/05/2009 0.2 Revisão dos Casos de Uso, e formatação

inicial do documento

Jedson Zendron Figueiredo

26/05/2009 0.3 Revisão do Texto Gabriel P. S. Brenner

26/05/2009 1.0 Revisão Final Gabriel P. S. Brenner,

Jedson Zendron Figueiredo, Luciene Fernandes de Oliveira

(3)

Índice Analítico

1. Introdução 9

2. Listagem dos Atores 9

3. Listagem dos Casos de Uso 9

4. Diagrama de Casos de Uso 11

5. Especificações dos Casos de Uso 12

5.1 Identificador / Nome do Caso de Uso 12

5.2 Breve descrição 12

5.3 Ator Primário 12

5.4 Ator (es) Secundário (s) 12

5.5 Pré-Condição (ões) 12

5.6 Fluxo de Eventos 12

5.6.1 Fluxo Básico 12

5.6.2 Fluxo (s) Alternativo (s) 12

5.6.2.1 Fluxo Alternativo (4): Inclusão 12

5.6.2.2 Fluxo Alternativo (4): Remoção 13

5.6.2.3 Fluxo Alternativo (4): Alteração 13

5.6.3.4 Fluxo Alternativo (4): Consulta 13

5.7 Pontos de Extensão 13

5.8 Pós-Condição (ões) 13

(4)

(5)

5.29 Pré-Condição (ões) 18 5.30 Fluxo de Eventos 18 5.30.1 Fluxo Básico 18 5.30.2 Fluxo (s) Alternativo (s) 18 5.31 Pontos de Extensão 18 5.32 Pós-Condição (ões) 18

5.38.2.1 Fluxo Alternativo (2): Usuário sem permissão para acessar os dados 19

(6)

(7)

(8)

5.78.2.1 Fluxo Alternativo (5): Mudança de Tipo de Serviço 26

(9)

Modelo de Casos de Uso

1. Introdução

O objetivo deste documento é apresentar um modelo das funcionalidades pretendidas e o ambiente de execução para o Aplicativo de Software Setorial - Difusão de Dados (MDD-DD) referente ao Projeto do Sistema de Aquisição, Tratamento, Monitoramento e Difusão de Dados Hidrológicos (Sis ATMH). Este documento representa uma espécie de contrato entre o cliente e os desenvolvedores, sendo a principal entrada para as atividades de análise, projeto e testes.

2. Listagem dos Atores

A tabela a seguir apresenta a lista de Atores do Subsistema.

Ator Descrição

ANA Gestores da Agência Nacional de Águas (ANA), que possuem permissão de

executar todas as funcionalidades do sistema.

Órgãos Externos Órgãos envolvidos com o gerenciamento dos recursos hídricos, com permissões

limitadas.

Órgãos Públicos Setores públicos, estaduais, municipais e universidades hídricos, com permissões

limitadas.

Usuários Hídricos Usuários dos recursos hídricos e em eventos associados, com permissões limitadas.

3. Listagem dos Casos de Uso

A tabela a seguir apresenta a lista dos Casos de Uso definidos para o protótipo de Sistema MDD-DD.

Caso de Uso Descrição

CDU01 – Manter Tipos de Serviços.

Este Caso de Uso faz a manutenção dos Tipos de Serviços, que classificam os Serviços de Dados do protótipo de sistema MDD-DD. Essa classificação facilitará a divisão e modularização dos serviços disponíveis, permitindo facilidades nas consultas, na atribuição ou remoção de permissões de acesso.

CDU02 – Manter Serviços de Dados.

Este Caso de Uso faz a manutenção dos Serviços de Dados. Os Serviços de Dados criados serão distribuídos pelas consultas WEB, XML e pelo Web-Service.

CDU03 – Manter Arquivos de Dados.

Este Caso de Uso faz a manutenção dos arquivos de modelo de dados que servirão para distribuir a informação. Os modelos de dados serão associados a um serviço de dados e servirão para auxiliar a formatação da informação em XML.

CDU 04 – Consultar Dados via WEB.

Este Caso de Uso recebe o Serviço de Dados e os parâmetros de seleção e responde com os dados consultados, que estão formatados em uma tabela no módulo WEB do protótipo do Sistema MDD - DD.

(10)

(WEB-Services SERVICE), o Serviço de Dados e o período de seleção dos dados

(opcional) e responde os dados selecionados em formato XML através de um retorno do método acionado.

CDU06 – Consumir Dados via XML

Este Caso de Uso recebe, através de parâmetros passados via post

http, o Serviço de Dados e o período, e responde os dados

selecionados em formato XML, como resposta HTTP.

CDU07 – Autenticar Usuários WEB Este Caso de Uso autentica o usuário WEB, onde fará uso da

consulta Web no protótipo de Sistema MDD - DD. CDU08 – Manter Dados dos Usuários

Este Caso de Uso faz a manutenção das informações dos usuários que podem acessar o Protótipo MDD-DD e somente usuários pré-cadastrados poderão acessar os seus recursos..

CDU09 – Manter Permissões dos Usuários

Este Caso de Uso faz a manutenção dos Tipos de Serviços e Serviços de Dados que os usuários poderão acessar ao se autenticarem no sistema.

CDU10 – Consultar Dados Gerreferenciados

Este Caso de Uso utilizará a ferramenta ArcGIS (ESRI) para visualização das informações georreferenciadas.

Os casos de uso foram gerados a partir da integração dos Módulos do Sistema de Difusão de Dados, da seguinte forma:

1) Disponibilização de Dados via Web Services - DWS CDU05 – Consumir dados via Web Services

2) Gerenciamento de Difusão de Dados via Web Server - GDD CDU07 – Autenticar Usuários WEB

CDU 04 – Consultar dados via WEB CDU06 – Consumir dados via XML

3) Padronização da Difusão de Dados via XML - PDD CDU01 – Manter Tipos de Serviços

CDU02 – Manter serviços de dados CDU03 – Manter arquivos de dados

4) Difusão de Informações Georreferenciadas - DIG CDU10 – Consultar dados Georreferenciados

Para acessar a Difusão de Dados, aplicável aos quatro módulos, foi idealizado um controle de permissão e acesso, com os seguintes Casos de Uso:

CDU08 – Manter dados dos Usuários CDU09 – Manter permissões dos Usuários

(11)

4. Diagrama de Casos de Uso

Na Figura 1 pode ser visualizado o Diagrama de Casos de Uso do subsistema MDD-DD, elaborado na ferramenta Java and UML Developers Environment (JUDE).

(12)

5. Especificações dos Casos de Uso 5.1 Identificador / Nome do Caso de Uso

CDU01 – Manter Tipos de Serviços 5.2 Breve descrição

Através deste caso de uso, o ator ANA faz a manutenção dos Tipos de Serviços que poderão possuir Serviços de Dados configurados no protótipo de Sistema MDD - DD.

5.3 Ator Primário ANA.

5.4 Ator (es) Secundário (s) N/A.

5.5 Pré-Condição (ões)

Ator estar identificado no Sistema. 5.6 Fluxo de Eventos

5.6.1 Fluxo Básico

[1]. O ator ANA requisita fazer manutenção de dados de Tipos de Serviços.

[2]. O Sistema apresenta as operações que podem ser realizadas: a inclusão de um novo Tipo de Serviço, a alteração dos dados de um Tipo de Serviço, a exclusão de um Tipo de Serviço e a consulta de Tipo de Serviços.

[3]. O ator ANA indica a opção a realizar ou opta por finalizar o Caso de Uso.

[4]. O ator ANA seleciona a operação desejada: Inclusão, Exclusão, Alteração ou Consulta.

[5]. Caso o ator ANA deseja continuar com a manutenção, o caso de uso retorna ao passo b, caso contrário, o caso de uso termina.

5.6.2 Fluxo (s) Alternativo (s)

5.6.2.1 Fluxo Alternativo (4): Inclusão

a) O ator ANA requisita a inclusão de um Tipo de Serviço.

b) O Sistema apresenta um formulário em branco para que os detalhes do Tipo de Serviço sejam incluídos.

c) O ator ANA fornece os detalhes do novo Tipo de Serviço.

d) O Sistema verifica a validade dos dados. Se os dados forem válidos, inclui o novo Tipo de Serviço; caso contrário, o sistema reporta o fato através de uma mensagem na tela, solicita novos dados e repete a verificação.

(13)

5.6.2.2 Fluxo Alternativo (4): Remoção

a) O ator ANA seleciona um Tipo de Serviço e requisita que o remova.

b) Caso o Tipo de Serviço possa ser removido, o sistema realiza a remoção; caso contrário o sistema reporta o fato através de uma mensagem na tela.

5.6.2.3 Fluxo Alternativo (4): Alteração

a) O ator ANA altera um ou mais detalhes sobre o Tipo de Serviço e requisita a sua atualização. b) O Sistema verifica a validade dos dados e, caso eles sejam válidos, altera os dados na lista de Tipo

de Serviço.

5.6.3.4 Fluxo Alternativo (4): Consulta

a) O ator ANA solicita a realização de uma consulta sobre da lista de Tipo de Serviços.

b) O Sistema apresenta uma lista com os códigos de todos os Tipos de Serviços, permitindo que o usuário selecione ou insira o código do Tipo de Serviço desejado.

c) O ator ANA seleciona ou insere o código do Tipo de Serviço. d) O Sistema apresenta os detalhes do Tipo de Serviço.

5.7 Pontos de Extensão N/A.

5.8 Pós-Condição (ões)

(14)

5.9 Identificador / Nome do Caso de Uso CDU02 – Manter Serviços de Dados

5.10 Breve descrição

Através deste caso de uso o ator ANA faz manutenção dos dados dos serviços que serão disponibilizados para difusão dos dados.

5.11 Ator Primário

ANA.

5.12 Ator (es) Secundário (s)

N/A.

5.13 Pré-Condição (ões)

Ator estar identificado no Sistema.

5.14 Fluxo de Eventos

5.14.1 Fluxo Básico

[1]. O ator ANA requisita fazer manutenção dos serviços de dados.

[2]. O Sistema apresenta as operações que podem ser realizadas: a inclusão de novos serviços de dados, a alteração dos dados de serviços de dados, a exclusão de serviços de dados e a consulta de serviços de dados.

[3]. O ator ANA indica a opção a realizar ou opta por finalizar o caso de uso.

[5]. Caso o ator ANA continue a manutenção, o caso de uso retorna ao passo b, caso contrário, o caso de uso termina.

5.14.2 Fluxo (s) Alternativo (s) 5.14.2.1 Fluxo Alternativo (4): Inclusão

a) O ator ANA requisita a inclusão de um serviço de dados.

b) O Sistema apresenta um formulário em branco para que os detalhes do serviço de dados sejam incluídos.

c) O ator ANA fornece os detalhes do novo serviço de dados.

d) O Sistema verifica a validade dos dados. Caso os dados sejam válidos, inclui o novo serviço de dados; caso contrário, o sistema reporta o fato através de uma mensagem na tela, solicita novos dados e repete a verificação.

(15)

a) O ator ANA seleciona um serviço de dados e requisita que o remova.

b) Caso o serviço de dados possa ser removido, o sistema realiza a remoção; caso contrário o sistema reporta o fato através de uma mensagem na tela.

a) O ator ANA altera um ou mais detalhes sobre o serviço de dados e requisita a sua atualização. b) O Sistema verifica a validade dos dados e, se eles forem válidos, altera os dados na lista de serviço

de dados.

a) O ator ANA solicita a realização de uma consulta sobre da lista de serviço de dados.

b) O Sistema apresenta uma lista com os códigos de todos os serviços de dados, permitindo que o usuário selecione o serviço de dados desejado.

c) O ator ANA seleciona um serviço de dados.

d) O Sistema apresenta os detalhes do serviço de dados.

5.15 Pontos de Extensão

N/A.

5.16 Pós-Condição (ões)

(16)

5.17 Identificador / Nome do Caso de Uso CDU03 – Manter Arquivos de Dados

Através deste caso de uso o ator ANA fará a manutenção dos Arquivos de Dados XML que serão disponibilizados para difusão dos dados.

ANA.

N/A.

Ator estar identificado no sistema.

[1]. O ator ANA requisita fazer manutenção de dados dos Arquivos. [2]. O Sistema Solicita o Tipo de Serviço e o Serviço de Dados [3]. O ator ANA seleciona o Tipo de Serviço e o Serviço de Dados.

[4]. O Sistema apresenta as operações que podem ser realizadas: a inclusão de um novo arquivo, a alteração dos dados de arquivo, a exclusão de um arquivo e a consulta de arquivos.

[5]. O ator ANA indica a opção a realizar ou opta por finalizar o caso de uso.

[7]. Caso o ator ANA continue com a manutenção, o caso de uso retorna ao passo 2, caso contrário, o caso de uso termina.

a) O ator ANA requisita a inclusão de um arquivo de dados.

b) O Sistema apresenta um formulário em branco para que os detalhes do arquivo sejam incluídos. c) O ator ANA fornece os detalhes do novo arquivo.

d) O Sistema verifica a validade dos dados. Se os dados forem válidos, inclui o novo arquivo; caso contrário, o sistema reporta o fato através de uma mensagem na tela, solicita novos dados e repete a verificação.

(17)

a) O ator ANA seleciona um arquivo e requisita que o remova.

b) Caso o arquivo possa ser removido, o sistema realiza a remoção; caso contrário o sistema reporta o fato.

a) O ator ANA altera um ou mais detalhes sobre o arquivo e requisita a sua atualização.

b) O Sistema verifica a validade dos dados e, se eles forem válidos, altera os dados na lista de arquivos.

a) O ator ANA solicita a realização de uma consulta sobre da lista de arquivos de dados.

b) O Sistema apresenta uma lista com os códigos de todos os arquivos de dados, permitindo que o usuário selecione o arquivo desejado.

c) O ator ANA seleciona um arquivo.

d) O Sistema apresenta os detalhes do arquivo.

N/A.

(18)

5.25 Identificador / Nome do Caso de Uso CDU04 – Consultar Dados via WEB

Através deste caso de uso o ator Usuários Hídricos consultará os dados hidrológicos.

Usuários Hídricos.

N/A.

Ator estar identificado no sistema.

[1]. O ator Usuários Hídricos, requisita consultar dados.

[2]. O Sistema exibe a lista de Tipos de Serviços e o Serviço de Dados que o ator tem permissão de acessar.

[3]. O ator Usuários Hídricos seleciona o Tipo de Serviço e o Serviço de Dados. [4]. O Sistema solicita um filtro de seleção dados (período de geração dos dados).

[5]. O ator Usuários Hídricos indica o período para geração dos dados e confirma a consulta. [6]. O Sistema gera os dados e o caso de uso se encerra.

5.30.2 Fluxo (s) Alternativo (s) N/A.

N/A.

(19)

5.33 Identificador / Nome do Caso de Uso CDU05 – Consumir Dados via Web Services

Através deste caso de uso o ator Órgãos Externos consumirá os dados hidrológicos via Web Services.

Órgãos Externos.

N/A.

Ator estar identificado (autenticado) no sistema.

a) O ator Órgãos Externos, requisita os dados através do Web Services, passando o Tipo de Serviço, Serviço de Dados e período desejado.

b) Caso o ator Órgãos Externos tenha permissão no Tipo de Serviço e no Serviço de Dados desejado, o Sistema retorna os dados no formato XML como resultado do método e o caso de uso encerra. 5.38.2 Fluxo (s) Alternativo (s)

5.38.2.1 Fluxo Alternativo (2): Usuário sem permissão para acessar os dados

a) O Sistema retorna um XML indicando que o ator não tem permissão para consultar o serviço indicado.

N/A.

(20)

5.41 Identificador / Nome do Caso de Uso CDU06 – Consumir Dados via XML

Através deste caso de uso o ator Órgãos Públicos consumirá os dados hidrológicos gerados no Web Site em XML.

Órgãos Públicos.

N/A.

Ator estar identificado no sistema

[1]. O ator Órgãos Públicos requisita gerar os dados em XML através do Web Site.

[2]. O Sistema exibe a lista de Tipos de Serviços que o ator Órgãos Públicos tem permissão. [3]. O ator Órgãos Públicos seleciona o Tipo de Serviço desejado.

[4]. O Sistema carrega a lista de Serviços de Dados do Tipo de Serviço que o ator tem permissão. [5]. O ator Órgãos Públicos seleciona o Serviço de Dados, informa o período desejado e requisita os

dados.

[6]. O Sistema responde com um arquivo no formato XML os serviços desejados contendo os dados do período informado. 5.46.2 Fluxo (s) Alternativo (s) N/A. 5.47 Pontos de Extensão N/A. 5.48 Pós-Condição (ões)

(21)

5.49 Identificador / Nome do Caso de Uso CDU07 – Autenticar Usuários WEB

Através deste caso de uso o ator Usuários Hídricos se autenticará no sistema para consultar os dados no site.

Usuários Hídricos.

N/A.

a) O ator Usuários Hídricos requisita acesso ao Site para consultar informações; b) O Sistema solicita Login e Senha;

c) O ator Usuários Hídricos informa Login e Senha;

d) Caso a autenticação for válida o sistema exibe na janela principal do Site de consulta as informações Hidrológicas, senão, informa o usuário através de uma mensagem “Login ou Senha invalidos” e retorna ao passo b.

5.54.2 Fluxo (s) Alternativo (s) N/A.

N/A.

(22)

5.57 Identificador / Nome do Caso de Uso CDU08 – Manter Dados dos Usuários

Através deste caso de uso o ator ANA faz a manutenção dos dados dos Usuários que possuem permissão para acessar os Serviços de Dados configurados no Sistema.

ANA.

N/A.

[1]. O ator ANA requisita fazer manutenção dos dados dos usuários;

[2]. O Sistema apresenta as operações que possam ser realizadas: a inclusão de um novo usuário, a alteração dos dados de um usuário, a exclusão de um usuário e a consulta de usuário;

[3]. O ator ANA indica a opção a realizar ou opta por finalizar o caso de uso;

[4]. O ator ANA seleciona a operação desejada: Inclusão, Exclusão, Alteração ou Consulta;

[5]. Caso o ator ANA continue com a manutenção, o caso de uso retorna ao passo 2, caso contrário, o caso de uso termina.

a) O ator ANA requisita a inclusão de um usuário;

b) O Sistema apresenta um formulário em branco para que os detalhes do usuário sejam incluídos; c) O ator ANA fornece os detalhes do novo usuário;

d) O Sistema verifica a validade dos dados. Se os dados forem válidos, inclui o novo usuário; caso contrário, o sistema reporta o fato através de uma mensagem na tela, solicita novos dados e repete a verificação.

(23)

b) Caso o usuário possa ser removido, o sistema realiza a remoção; caso contrário o sistema reporta o fato.

a) O ator ANA altera um ou mais detalhes sobre o usuário e requisita a sua atualização;

b) O Sistema verifica a validade dos dados e, se eles forem válidos, altera os dados na lista de usuário.

a) O ator ANA solicita a realização de uma consulta sobre da lista de usuário;

b) O Sistema apresenta uma lista com os códigos de todos os usuários, permitindo que selecione o usuário desejado;

c) O ator ANA seleciona um usuário;

d) O Sistema apresenta os detalhes do usuário.

N/A.

(24)

5.65 Identificador / Nome do Caso de Uso CDU09 – Manter Permissões dos Usuários

Através deste caso de uso o ator ANA faz a manutenção das permissões dos Usuários que acessam os Serviços de Dados configurados no Sistema.

ANA.

N/A.

[1]. O ator ANA requisita a manutenção de permissões dos usuários;

[2]. O Sistema solicita que informe o usuário que terão suas permissões alteradas; [3]. O ator ANA informa o Usuário;

[4]. O Sistema apresenta as operações que serão realizadas: a inclusão de uma nova permissão e a exclusão de uma permissão;

[5]. O ator ANA indica a opção a realizar ou opta por finalizar o caso de uso; [6]. O ator ANA seleciona a operação desejada: Inclusão ou Exclusão;

[7]. Caso o ator ANA continue com a manutenção de permissões, o caso de uso retorna ao passo b, caso contrário, o caso de uso termina;

a) O ator ANA requisita a inclusão de uma nova permissão; b) O Sistema apresenta a lista de Tipos de Serviços existentes; c) O ator ANA seleciona um Tipo de Serviço;

d) O Sistema apresenta a lista de Serviços de Dados desse Tipo de Serviço; e) O ator ANA seleciona um Serviço de Dados e confirma a inclusão;

(25)

f) O Sistema inclui o novo serviço na lista de serviços permitidos de serem acessados por esse usuário.

a) O ator ANA requisita a exclusão de uma nova permissão;

b) O Sistema apresenta a lista de Serviços de Dados que o usuário possui associado a ele; c) O ator ANA seleciona um Serviço de Dados e confirma a exclusão;

d) O Serviço de Dados é removido da lista de Serviços de Dados permitidos para usuário selecionado.

N/A.

(26)

5.73 Identificador / Nome do Caso de Uso CDU10 – Consultar Dados Georreferenciados

Através deste caso de uso o ator Órgãos Públicos visualizará informações georreferenciadas na ferramenta ArcGIS.

Órgãos Públicos.

N/A.

Ator estar identificado (autenticado) no sistema

[1]. O ator Órgão Público solicita consultar dados Georreferenciados;

[2]. O sistema exibe a lista de Tipos de Serviços que o ator Órgão Público tem permissão; [3]. O ator Órgão Público informa um Tipo de Serviço;

[4]. O sistema exibe a lista de Serviços de Dados que o ator Órgão Público tem permissão;

[5]. O ator Órgão Público informa o Serviço de Dados requisitado, o período e confirma a geração de dados;

[6]. O sistema exibe os dados georreferanciados na ferramenta ArcGIS (ESRI). 5.78.2 Fluxo (s) Alternativo (s)

5.78.2.1 Fluxo Alternativo (5): Mudança de Tipo de Serviço

a) O ator Órgão Público altera o Tipo de Serviço e o caso de uso retorna ao passo 4.

N/A.