~~ODT~~ echo "
"; echo "Última atualização: "; ver('', false); echo "
"; ====== Listar/Alterar Localidade ====== Este caso de uso é utilizado para consultar ou até mesmo alterar as localidades de uma instituição, devido a alguma mudança de dado, ou erro durante o cadastro. Os gestores do patrimônio da instituição e os das unidades gestoras são os usuários que têm acesso ao [[desenvolvimento:especificacoes:sipac:patrimonio_movel:casos_de_uso:cadastros:localidade:cadastrar| cadastro de localidades]]. ===== Descrição do Caso de Uso ===== Este caso de uso é acessado através de //SIPAC -> Patrimônio -> Cadastros -> Localidade -> Listar/Alterar//. ===Passo 1=== Para consultar e/ou alterar um localidade cadastrada ([[#Principais Regras de Negócio|RN01 e RN02]]) é necessário que sejam fornecidos os seguintes dados para a consulta, conforme combinação de filtros desejada pelo usuário: ***Nome**: Tipo - TEXTO. ***Responsável**: Tipo AUTOCOMPLETE, formato: NOME DO SERVIDOR (9999999 - CARGO), entrada de dados: NOME DO SERVIDOR OU MATRÍCULA. ***Unidade Responsável**: Tipo AUTOCOMPLETE, formato: NOME DA UNIDADE (CÓDIGO DA UNIDADE), entrada de dados: NOME ou CÓDIGO. ***Incluir Unidades Vinculadas à Unidade Responsável**: Formato: CHECKBOX, Tipo - LÓGICO. ***Unidade Gestora**: Tipo AUTOCOMPLETE, formato: NOME DA UNIDADE GESTORA (CÓDIGO DA UNIDADE GESTORA). ***Código**: Formato - LETRAS EM MAIÚSCULO E NÚMEROS. Tipo - TEXTO. ***Data de Vigência**: Formato: DD/MM/AAAA a DD/MM/AAAA, Tipo - DATA. ([[#Principais Regras de Negócio|RN03]]) ***Apenas Ativas**: Tipo - LÓGICO. ***Localidades com Divergência de Responsabilidade**: Tipo - LÓGICO. ***Formato de Saída**: Tipo LÓGICO. ([[#Principais Regras de Negócio|RN06, RN07]]) ===Passo 2=== Após a consulta, é exibida uma listagem das localidades encontradas com as seguintes informações: ***__Localidade__**: Formato - 'CÓDIGO - NOME'. Tipo - TEXTO. ***__Unidade Responsável__**: Formato - NOME DA UNIDADE (CÓDIGO DA UNIDADE). Tipo - TEXTO. ***__Unidade Gestora__**: Tipo - TEXTO. ***__Responsável__**: Tipo - TEXTO. ***__E-mail do Responsável__**: Tipo - TEXTO. ([[#Principais Regras de Negócio|RN05]]) ***__Unidade de Lotação do Resp.__**: Tipo - TEXTO. ([[#Principais Regras de Negócio|RN05]]) ***__Início da Vigência__**: Tipo - DATA. ***__Término da Vigência__**: Tipo - DATA. Para cada localidade encontrada é possível alterar todos os dados informados no [[desenvolvimento:especificacoes:sipac:patrimonio_movel:casos_de_uso:cadastros:localidade:cadastrar|Cadastro]]. Caso o usuário deseje alterar os dados da localidade([[desenvolvimento:especificacoes:sipac:patrimonio:casos_de_uso:cadastros:localidade:listar_alterar#Principais Regras de Negócio|RN04]]), então ao usuário é exibido um formulário contendo os dados da localidade e do responsável, com os seguintes campos: * **__Código__**: Tipo TEXTO. * **__Nome__**: Tipo TEXTO. * **__Unidade Responsável__**: Formato - NOME DA UNIDADE (CÓDIGO DA UNIDADE). Tipo - TEXTO. * **__Ativo__**: Tipo TEXTO. Caso o usuário deseje alterar as informações do responsável será exibida uma tela com as informações da localidade: * **__Código__**: Tipo TEXTO. * **__Nome__**: Tipo TEXTO. * **__Unidade Responsável__**: Formato - NOME DA UNIDADE (CÓDIGO DA UNIDADE). Tipo - TEXTO. * **__Ativo__**: Tipo TEXTO. E uma listagem contendo os seguintes dados dos responsáveis encontrados: * **__Responsável__**: Tipo TEXTO, formato: NOME DO SERVIDOR. * **__Data Inicial de Vigência__**: Tipo DATA, formato: DD/MM/AAAA. * **__Data Final de Vigência__**: Tipo DATA, formato: DD/MM/AAAA. * **__Ativo__**: Tipo TEXTO. Ao selecionar o usuário para alteração um formulário para fins de inserção será exibido com os seguintes campos: * **Responsável**: Tipo AUTOCOMPLETE, formato: NOME DO SERVIDOR (MATRÍCULA), entrada de dados: NOME ou MATRÍCULA. * **Data Inicial de Vigência**: Tipo DATA, formato: DD/MM/AAAA. * **Data Final de Vigência**: Tipo DATA, formato: DD/MM/AAAA. * **Observação**: Tipo TEXTO. * **Arquivo**: Tipo UPLOAD. Adicionalmente, é disponibilizada uma opção que lista o histórico de todos os responsáveis da localidade em questão, com os seguintes dados da unidade: * **Código**: Tipo TEXTO. Formato - CÓDIGO DA UNIDADE. * **Nome**: Tipo TEXTO. Formato - NOME DA UNIDADE. * **Unidade Responsável**: Formato - NOME DA UNIDADE (CÓDIGO DA UNIDADE). Tipo - TEXTO. * **Ativo**: Tipo TEXTO. E com os seguintes dados dos responsáveis: * **Responsável**: Tipo TEXTO. * **Data Inicial da Vigência**: Tipo DATA. * **Data Final da Vigência**: Tipo DATA. * **Ativo**: Tipo LÓGICO. O caso de uso é finalizado. ===== Principais Regras de Negócio ===== == Perfil: Gestor De Patrimônio Da Instituição == ***RN01** - O usuário com permissões de Gestor do Patrimônio da Intituição pode listar e/ou alterar Localidades de qualquer Unidade da Instituição. == Perfil: Gestor De Patrimônio De Unidade Gestora == ***RN02** - O usuário com permissões de Gestor do Patrimonio de uma Unidade Gestora pode listar e/ou alterar Localidades apenas de Unidades subordinadas a sua Unidade Gestora. === === ***RN03** - É possível consultar apenas pela data inicial, caso a data final da vigência não tenha sido determinada. ***RN04** - Não é possível alterar a unidade responsável da localidade, caso a mesma contenha bens associados. ***RN05** - Essa coluna só estará disponível ao se realizar uma consulta utilizando o filtro "Localidades com Responsável de Unidade Externa". ***RN06** - A listagem de localidades pode ser gerada em tela, gerada em formato de impressão ou gerada em planilha no formato XLS. ***RN07** - No caso do usuário emitir uma planilha XLS com o filtro "Localidades com Divergência de Responsabilidade" marcado, algumas colunas a mais aparecerão na planilha. As colunas em questão são: e-mail (e-mail do responsável) e unidade de lotação atual do responsável. ==== Resoluções/Legislações Associadas ==== Não se aplica. ===== Classes Persistentes e Tabelas Envolvidas ===== ^ Classe ^ Tabela | | br.ufrn.sipac.patrimonio.comuns.dominio.LocalBem | administrativo.patrimonio.local_bem | | br.ufrn.sipac.patrimonio.comuns.dominio.ResponsavelLocalBem | administrativo.patrimonio.responsavel_local_bem | ====== Plano de Teste ====== Sistema: SIPAC Módulo: PATRIMONIO Link(s): SIPAC -> Patrimônio -> Cadastros -> Localidade -> Listar/Alterar Papel que usuário deve ter: SipacPapeis.GESTOR_PATRIMONIO_GLOBAL, SipacPapeis.GESTOR_UNIDADE_GESTORA Usuário: diretordmp (global), adaildo (unidade gestora) ===== Cenários de Teste ===== Realizar o [[desenvolvimento:especificacoes:sipac:patrimonio:desenvolvimento:especificacoes:sipac:patrimonio_movel:casos_de_uso:cadastros:localidade:cadastrar| cadastro de localidade]] e depois veriricar neste caso de uso se o cadastro foi realizado. ===== Dados para o Teste ===== Não se aplica!