~~ODT~~

<PHP>
echo "<div style='display:block;float:right;'>"; 
echo "Última atualização: ";
ver('', false);
echo "</div>";
</PHP>

====== Atualizar/Listar Obras ======

Este caso de uso serve para listar as [[desenvolvimento:especificacoes:sipac:infra_estrutura:casos_de_uso:obras:obras:obras:cadastrar_obras|obras cadastradas]] a partir de alguns parâmetros, onde além de poder listar e alterar as obras possuem algumas outras funcionalidades. Este caso de uso é encontrado no menu de infra-estrutura e deve ser utilizado pelo gestor de obras da instituição.
===== Descrição do Caso de uso =====

Este caso de uso inicia quando o usuário acessa a opção: SIPAC -> Infraestrutura -> Aba Obras -> Obras -> Obras -> Atualizar/Listar Obras.

O Usuário faz a busca utilizando os parâmetros especificados em: [[desenvolvimento:especificacoes:sipac:fluxos:fluxo_busca_requisicao_obra| Busca de Obras]].


O Sistema lista as obras encontradas exibindo as atributos ([[#Principais Regras de Negócio|RN01]]):
  * **__Licitação__**: Tipo - TEXTO. Formato - MODALIDADE - 9.../AAAA - ORIGEM.
  * **__Empresa__**: Tipo - TEXTO.
  * **__Período__**: Tipo - DATA. Formato - DD/MM/AAAA - DD/MM/AAAA.
  * **__Status__**: Tipo - TEXTO.
  * **__Valor Contratado__**: Tipo - NUMÉRICO.
  * **__Valor Total da Obra__**: Tipo - NUMÉRICO.
  * **__Fiscal de obras:__** Tipo - Texto.
  * **__Descrição:__** Tipo - Texto.
 
  


O Sistema exibe para cada obra os casos de uso:

  * [[Adicionar Pagamento a Obra]]: Utilizado para cadastrar o pagamento a obra. Inserido apenas caso já tenha sido cadastrado um cronograma físico. 
  * [[desenvolvimento:especificacoes:sipac:infra_estrutura:casos_de_uso:atualizar_status_obra|Atualizar Status]]: Utilizado para realizar a alteração e atualização de uma obra.
  * [[Despacho da Obra]]: Emite um despacho da obra.
  * [[desenvolvimento:especificacoes:sipac:infra_estrutura:casos_de_uso:livro_ocorrencia|Livro Ocorrência]]: Lista as alterações de status que a obra sofreu.
  * [[desenvolvimento:especificacoes:sipac:infra_estrutura:casos_de_uso:orcamento:planilhas_orcamentarias:planilhas_orcamentarias|Planilha Orçamentaria]]: Exibe a planilha orçamentária de uma obra.
  * [[desenvolvimento:especificacoes:sipac:infra_estrutura:casos_de_uso:projetos:projetos:consultar_projetos|Projetos]]: Lista os projetos de uma obra.
  * [[desenvolvimento:especificacoes:sipac:infra_estrutura:casos_de_uso:obras:obras:fotografias:visualizar_album_de_fotos|Álbum de Fotografias]]
  * [[desenvolvimento:especificacoes:sipac:contratos:casos_de_uso:consultas_relatorios:gerais:contrato_detalhado|Contrato da Obra]]: Exibe o contrato relacionado com a obra.
  * [[desenvolvimento:especificacoes:sipac:infra_estrutura:casos_de_uso:obras:notificacoes:visualizar_notificacao_empresa|Consultar Notificação]]
  * [[desenvolvimento:especificacoes:sipac:infra_estrutura:casos_de_uso:obras:relatorios:relatorio_de_andamento_da_obra | Andamento da Obra]]
  * [[desenvolvimento:especificacoes:sipac:infra_estrutura:casos_de_uso:obras:obras:portarias:buscar_portaria_de_recebimento|Portarias]]: Exibe as portarias cadastradas para a obra.
  * [[desenvolvimento:especificacoes:sipac:infra_estrutura:casos_de_uso:remover_obra|Remover a Obra]]
  * [[desenvolvimento:especificacoes:sipac:infra_estrutura:casos_de_uso:obras:obras:obras:atualizar_listar_obras| Atualizar Obras]] (É acessado através do caso de uso Atualizar/Listar Obras).
  * [[desenvolvimento:especificacoes:sipac:infra_estrutura:casos_de_uso:obras:cronograma_fisico:imprimir_cronograma|Cronogramas Fisicos]]: Lista os cronogramas físicos cadastrados para a obra.
  * [[desenvolvimento:especificacoes:sipac:infra_estrutura:casos_de_uso:empenho|Empenho]]: lista os empenhos de uma obra.
  * [[desenvolvimento:especificacoes:sipac:infra_estrutura:casos_de_uso:obras:obras:ordem_de_servico:visualizar_ordem_de_servico|Ordem de Serviço]]: Lista as ordens de serviço de uma obra.
  * [[desenvolvimento:especificacoes:sipac:infra_estrutura:casos_de_uso:lista_de_processos_da_obra|Processos]]: Lista os processos relacionados com a obra.


O Sistema exibe opção para imprimir todas as obras encontradas na pesquisa. Modelo:

**Quadro de Controle Financeiro e Prazo de Obras e Serviços**

**Status:** <DESCRIÇÃO DO STATUS>

^Obra/ Licitação  ^ Empresa  ^ Contrato/ Data  ^ Ordem de Serv./ Data  ^ Valor do Contrato  ^ Valor Empenhado  ^ Valor a Empenhar  ^ Valor dos Serv. Extr.  ^ Valor dos Serv. Exced.  ^ Dias ^Início ^Término ^Aditivo ^Término   ^ Rec. Prov./ Def.   ^ Fiscais de Obra  ^ Valor Pago  ^ Saldo  ^
|MODALIDADE 9.../AAAA - UFRN  | <NOME DA EMPRESA> | 9.../AAAA DD/MM/AAAA  | 2.000,00  | 9,99  | 9,99 | 9,99  | 9,99  | 9,99  | 99| DD/MM/AAAA| DD/MM/AAAA | 1º - 0 | DD/MM/AAAA | -   | <NOME DO FISCAL>  | 9,99  | 9,99  |



O caso de uso é finalizado.


===== Principais Regras de Negócio =====


  * **RN01** - Na consulta por fiscal, o sistema não deve exibir no resultado da consulta as obras em que o fiscal informado não for fiscal.
  

==== Resoluções/Legislações Associadas ====

Não se Aplica.

===== Classes Persistentes e Tabelas Envolvidas =====

^ Classe ^ Tabela |
| br.ufrn.sipac.supinfra.acompanhamento.dominio.Obra | administrativo.infra.obra |
| br.ufrn.sipac.supinfra.acompanhamento.dominio.EmpenhoObra | adiministrativo.infra.obra_empenho |
| br.ufrn.sipac.supinfra.acompanhamento.dominio.PagamentoObra | adiministrativo.infra.obra_pagamento |
| br.ufrn.sipac.supinfra.acompanhamento.dominio.ProjetosObra | adiministrativo.infra.obra_projeto_pesquisa |
| br.ufrn.sipac.supinfra.acompanhamento.dominio.FonteRecursoObra | adiministrativo.infra.fonte_recurso_obra | 
| br.ufrn.sipac.contratos.dominio.Contrato | adiministrativo.contratos.contrato |
| br.ufrn.sipac.supinfra.acompanhamento.dominio.MovimentoObra | adiministrativo.infra.movimento_obra |
| br.ufrn.sipac.supinfra.acompanhamento.dominio.Medicao | adiministrativo.infra.medicoes |


===== Plano de Teste =====

Os principais aspectos que devem ser testados são os filtros de busca se os mesmos estão funcionando corretamente, se eles estão de acordo com o que eles se propõem a fazer.

Sistema: SIPAC 

Módulo: Infraestrutura

Link(s): Obras -> Obras -> Atualizar/Listar Obras.

Usuário: lane(Gestora de obras),gustavo (superintendente)

Papel que usuário deve ter:   * SipacPapeis.GESTOR_OBRAS,   SipacPapeis.GESTOR_SISTEMA_INFRA_ESTRUTURA,  SipacPapeis.FISCAL_OBRA

===== Cenários de teste =====

Informar pelo menos um dos campos no formulário de Buscar Requisição e clicar no botão Buscar, então serão listadas todas as obras relacionadas com o campo informado. Caso não informe nenhum campo e clicar no botão buscar, serão mostradas todas as obras cadastradas.

Na obra desejada, basta selecionar o ícone de Visualizar o Menu e serão mostradas as operações citadas anteriormente. 

===== Dados para o teste =====

Não se aplica.