~~ODT~~

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

====== Relatório de Saldos Anuais por Unidade ======

Este caso de uso tem a finalidade de exibir um relatório com o total de saldos agrupados por unidade e/ou suas filhas.

Envolviddos: É utilizado pelos responsáveis pela execução orçamentária.

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

Este caso de uso inicia quando o usuário acessa a opção: //SIPAC → Orçamento → Aba Relatórios → Saldos → Saldos Anuais por Unidade//.

===Passo 1===
O caso de uso inicia solicitando:

  * **Período***: Formato - DD/MM/AAAA a DD/MM/AAAA, Tipo - DATA.
e qualquer combinação dos seguintes filtros:
    * **Unidade**: Tipo - AUTOCOMPLETE, formato - NOME UNIDADE (CÓDIGO), entrada de dados: NOME ou CÓDIGO.
  * **Considerar Unidades Vinculadas**: Tipo - LÓGICO.
  * **Programa de Trabalho Resumido**: Tipo - AUTOCOMPLETE, formato - NOME PLANO (CÓDIGO), entrada de dados: NOME ou CÓDIGO.
  * **Natureza de Despesa**: Tipo - AUTOCOMPLETE, formato - NOME NATUREZA (CÓDIGO), entrada de dados: NOME ou CÓDIGO.
  * **Fonte de Recurso**: Tipo - AUTOCOMPLETE, formato - NOME NATUREZA (CÓDIGO), entrada de dados: NOME ou CÓDIGO.
  * **Esfera**: Tipo - AUTOCOMPLETE, formato - NOME ESFERA (CÓDIGO), entrada de dados: NOME ou CÓDIGO.
  * **Plano Interno**: Tipo - AUTOCOMPLETE, formato - NOME PLANO INTERNO (CÓDIGO), entrada de dados: NOME ou CÓDIGO.

===Passo 2===
Confirmando os parâmetros informados no passo anterior, sistema exibe relatório, conforme modelo:

**Relatório de Saldos Anuais por Unidade**

**__Período__:** AAAA a AAAA.

**__Unidade__:** UNIDADE (CÓDIGO).

**__Programa Trabalho Resumido__:** PROGRAMA (CÓDIGO).

**__Natureza de Despesa__:** NATUREZA (CÓDIGO).

**__Fonte de Recurso__**: FONTE (CÓDIGO).

**__Esfera__**: ESFERA (CÓDIGO).

**__Plano Interno__**: PLANO (CÓDIGO).

Sistema apresenta gráfico de Saldo Anuais pelo Total de Despesas: No eixo X são mostrados os **anos** e no Y o **Total de Despesas**.

^ Unidade ^ ANO INICIAL DO PERÍODO  ^ ANO ... ^ ANO FINAL DO PERÍODO ^
| UNIDADE (CÓDIGO) |     R$ 99,99 |    R$ 99,99 |     R$ 99,99 |
| UNIDADE (CÓDIGO) |     R$ 99,99 |    R$ 99,99 |     R$ 99,99 |
| **Total** |     **R$ 99,99** |    **R$ 99,99** |    **R$ 99,99** |


Observação: os atributos **Programa Trabalho Resumido**, **Natureza de Despesa**, **Fonte de Recurso**, **Esfera** e **Plano Interno** são exibidos no relatório se escolhidos pelo usuário.

O caso de uso é finalizado.
  

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

Não se aplica.

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

^ Classe ^ Tabela |
|br.ufrn.sipac.orcamento.dominio.CelulaOrcamentaria |administrativo.sco.celula_orcamentaria|

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

Sistema: SIPAC

Módulo: SCO

Link(s): Menu SCO -> Relatórios -> Saldos -> Saldos Anuais por Unidade

Usuário: larrubia2

Papel que usuário deve ter: ScoPapeis.EXECUTOR_ORCAMENTO, ScoPapeis.EXECUTOR_ORCAMENTO_GLOBAL, ScoPapeis.EXECUTOR_CONVENIO

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

  * Realizar operações em que ocorram alteração no saldo, por exemplo, restituição, empenhos, reforços e etc (estas podem ser encontradas em SCO -> Aba Movimentações -> Movimentações Orçamentárias / SCO -> Aba Movimentações -> Empenhos). 
  * Ao realizar estas operações as mesmas deverão estar aparecendo no relatório no ano em que foram realizadas. Também realizar operações com [[desenvolvimento:especificacoes:sipac:orcamentario:orcamento_convenio|Convênios]]

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

Não se aplica.