~~ODT~~

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

====== Consultar Contratos por Período ======

Este caso de uso é utilizado pelos gestores de contrato com a finalidade de criar um relatório contendo todos os contratos relacionados de um determinado período.

===== Descrição do Caso de Uso =====

O caso de uso é acionado quando o usuário acessa a opção: SIPAC -> Módulo Contratos -> Aba Consultas/Relatórios -> Gerais -> Contratos por Período.

A fim de que o relatório citado seja confeccionado, se faz necessário, primeiramente que o usuário selecione um período com o qual deseja-se trabalhar, para isso: 

  * **Contratos com data de término no período de***: Tipo DATA, formato: DD/MM/AAAA a DD/MM/AAAA. 
    * Determina o período no qual os contratos que terão seu período de vigência finalizados serão relacionados no relatório.
  * **Sub-tipo**: Tipo TEXTO. Pode ser ''AQUISIÇÃO DE LIVROS'', ''LOCAÇÃO DE MÃO-DE-OBRA'', ''MANUTENÇÃO DE VEÍCULOS'', ''OBRAS E SERVIÇOS DE ENGENHARIA'', ''MANUTENÇÃO DE MATERIAIS'', ''REFORMA DE EDIFÍCIOS E EQUIPAMENTOS'' ou ''SERVIÇOS DE LIMPEZA''.
  * **Ordenar por**: Tipo TEXTO, são apresentadas as opções: 'NÚMERO', 'TIPO', 'LICITAÇÃO', 'DATA DE INÍCIO', 'DATA DE TÉRMINO' e 'VALOR'.
  * **Tipo de Ordenação**: Tipo TEXTO, são apresentadas as opções 'ASCENDENTE' e 'DESCENDENTE'

O sistema então exibe um relatório conforme o modelo:

**RELATÓRIO DE CONTRATOS POR PERÍODO**

**Período:** DD/MM/AAAA à DD/MM/AAAA

^ Número ^ Tipo ^ Licitação ^ Data de Início ^ Data de Término ^ Valor ^ 
| 9.../AAAA | TIPO CONTRATO | SIGLA LICITAÇÃO - 9.../AAAA | DD/MM/AAAA | DD/MM/AAAA | R$ 99,99 |
| **Contratado**: DENOMINAÇÃO CONTRATADO - (DOCUMENTO CONTRATADO) ||||||
| **Objeto**: OBJETO CONTRATO ||||||

**Total de Contratos**: Tipo NUMÉRICO.

O caso de uso então é finalizado.

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

Não se aplica.

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

Não se Aplica.  

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

^ Classe ^ Tabela |
| br.ufrn.sipac.contratos.dominio.Contrato | administrativo.contratos.contrato |


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

Sistema: SIPAC

Módulo: Contratos

Link(s): Aba Consultas/Relatórios → Gerais → Contratos por Período. 

Usuário: rcsl

Papel que usuário deve ter: GESTOR_CONTRATO_GLOBAL ou GESTOR_CONTRATO.

===== Cenários de Teste =====

Realizar diferentes combinações de período para verificar diferentes resultados.

Se a data do início do período for maior do que a data fim, o sistema deve alertar o usuário informando o erro.

Caminho para a realização do teste:

SIPAC → Módulo Contratos → Aba Consultas/Relatórios → Gerais → Contratos por Período. 

===== Dados para o Teste =====

Não se aplica.