~~ODT~~

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

====== Consultar Provisão Orçamentária ======

Este caso de uso tem a finalidade apresentar as transferências orçamentárias entre células de unidades gestoras que não estão ligadas a dotação do orçamento.

Esse caso de uso é utilizado pelos executores orçamentários locais e globais, executores de convênio e ainda pelos gestores de dotação orçamentária com a finalidade de realizar consultas às [[desenvolvimento:especificacoes:sipac:orcamentario:casos_de_uso:movimentacoes:movimentacoes_orcamentarias:provisao_orcamentaria|Provisões Orçamentárias]] realizadas através do sistema. 

Pré-condição: O usuário deve possuir um perfil de GESTOR DE DOTAÇÃO, EXECUTOR DE CONVÊNIOS OU EXECUTOR DE ORÇAMENTO GLOBAL.

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

Este caso de uso inicia quando o usuário acessa a opção: //SIPAC → Orçamento → Aba Consultas → Transferência → Provisão Orçamentária//. 

**PASSO 1**

O sistema exibe opções para consulta. O ator pode escolher mais de uma opção de consulta:  ([[#Principais Regras de Negócio|RN01]]):

  ***Número do Documento**: Tipo - NUMÉRICO. Caso esta opção de pesquisa seja selecionada, o Intervalo de data e valores serão desabilitados.
  ***Intervalo de Data**: Formato - DD/MM/AAAA a DD/MM/AAAA, Tipo - DATA. ([[#Principais Regras de Negócio|RN02]])
  ***Intervalo de Valores**: Tipo - NUMÉRICO.

**PASSO 2**

O sistema exibe dados da transferência:

  * __**Nome da Transferência**__: Tipo - Texto.
  * __**Nº do Documento**__: Tipo - Numérico.
  * __**Valor**__: Tipo - Numérico.
  * __**Data**__: Formato - DD/MM/AAAA, Tipo - DATA.
  * __**Movimentador**__: Formato - (CÓDIGO) - NOME DO MOVIMENTADOR (LOGIN), Tipo - Texto. Sistema apresenta opção e exibe os atributos **__Login__**, **__Nome__**,  **__Unidade__**, **__Email__**, **__Telefone__** e **__Ramal__** associados ao movimentador.
  * __**Tipo**__: Tipo - Texto. 
  * __**Processo**__: Formato - NUMÉRO DO PROCESSO/AAAA (INSTITUIÇÃO), Tipo - Numérico.
  * __**Código do Evento SIAFI**__: Tipo - Numérico.
  * __**Descrição do Evento SIAFI**__: Tipo - Texto.
  * __**Origem de Lançamento**__: Tipo - Texto.
  * __**Número do documento SIAFI**__: Tipo - Texto.
  * __**Observações**__: Tipo - Texto.

O sistema exibe informações da origem e destino da transferência com atributos:

  * __**Código da Célula de Origem**__: Tipo - Numérico.
  * __**Unidade Orçamentária**__: Formato - NOME DA UNIDADE (CÓDIGO), Tipo - Texto.
  * __**Programa de Trabalho Resumido**__: Formato - NOME DO PTRES(CÓDIGO), Tipo - Texto.
  * __**Natureza da Despesa**__: Formato - NOME DA NATUREZA DE DESPESA (CÓDIGO), Tipo - Texto.
  * __**Fonte de Recurso**__: Formato - NOME DA FONTE DO RECURSO (CÓDIGO), Tipo - Texto.
  * __**Esfera**__: Formato - NOME DA ESFERA (CÓDIGO), Tipo - Texto.
  * __**Plano Interno**__: Formato - NOME DO PI (CÓDIGO), Tipo - Texto.  
  * __**Convênio**__: Tipo - Texto.


  * __**Código da Célula de Destino**__:
  * __**Unidade Orçamentária**__: Formato - NOME DA UNIDADE (CÓDIGO), Tipo - Texto.
  * __**Programa de Trabalho Resumido**__: Formato - NOME DO PTRES(CÓDIGO), Tipo - Texto.
  * __**Natureza da Despesa**__: Formato - NOME DA NATUREZA DE DESPESA (CÓDIGO), Tipo - Texto.
  * __**Fonte de Recurso**__: Formato - NOME DA FONTE DO RECURSO (CÓDIGO), Tipo - TEXTO.
  * __**Esfera**__: Formato - NOME DA ESFERA (CÓDIGO), Tipo - Texto.
  * __**Plano Interno**__: Formato - NOME DO PI (CÓDIGO), Tipo - Texto.  
  * __**Convênio**__: Tipo - Texto.


O caso de uso é finalizado.


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

  ***RN01** - A unidade gestora da unidade da dotação deve ser igual a unidade gestora do usuário logado ou a unidade do convênio, no caso da execução orçamentária ser de convênio.
  ***RN02** - A provisão orçamentária deve ter seu ano igual ao ano orçamentário em execução.

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

^ Classe ^ Tabela |
|br.ufrn.sipac.orcamento.movimentacoes.dominio.Transferencia | administrativo.sco.transferencia |
|br.ufrn.sipac.orcamento.movimentacoes.dominio.MovimentacaoOrcamentaria | administrativo.sco.movimentacao_orcamentaria |

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

Sistema: SIPAC

Módulo: Orçamento

Link(s): Orçamento -> Consultas -> Transferência ->  Provisão Orçamentária

Usuário: joice

Papel que usuário deve ter: SipacPapeis.EXECUTOR_CONVENIO, SipacPapeis.EXECUTOR_ORCAMENTO, 
SipacPapeis.EXECUTOR_ORCAMENTO_GLOBAL, SipacPapeis.DIRETORES
===== Cenários de Teste =====

Cadastrar Provisões Orçamentárias através do caso de uso Orçamento → Movimentações → Movimentações Orçamentárias → Provisão Orçamentária, e verificar se estão sendo exibidos no relatório. Também testar as regras de negócio.

Testar o relatório também para os casos de Convênios.


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

Não se aplica.