~~ODT~~

<PHP>
echo "<div style='display:block;float:right;'>"; 
echo "Última atualização: ";
ver('', false);
echo "</div>";
</PHP>
====== Relatório de Total de Empenhos Emitidos ======

Este caso de uso é utilizado pelos executores de convênios com a finalidade de totalizar os empenhos emitidos pela gestora do usuário logado no ano orçamentário selecionado, agrupados por **Natureza de Despesa**. 


Pré-condições: O usuário deve possuir um perfil de Executor de Convênios, Executor de Orçamento Local ou Global.

===== 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 -> Empenhos -> Total de Empenhos Emitidos //.>


Para a geração do relatório, é necessário que o usuário realize primeiramente uma consulta dos empenhos emitidos, através dos seguintes campos:

  * **Programa de Trabalho Resumido:** Tipo AUTOCOMPLETE, formato: NOME PROGRAMA DE TRABALHO (CÓDIGO DO PROGRAMA DE TRABALHO), entrada de dados: NOME ou CÓDIGO.
  * **Natureza de Despesa:** Tipo AUTOCOMPLETE, formato: NOME NATUREZA (CÓDIGO NATUREZA), entrada de dados: NOME ou CÓDIGO.
  * **Fonte de Recurso:**  Tipo AUTOCOMPLETE, formato: NOME FONTE DE RECURSO (CÓDIGO FONTE DE RECURSO), entrada de dados: NOME ou CÓDIGO.
  * **Esfera:** Tipo AUTOCOMPLETE, formato: NOME ESFERA (CÓDIGO ESFERA), entrada de dados: NOME ou CÓDIGO.
  * **Plano Interno:** Tipo AUTOCOMPLETE, formato: NOME PLANO INTERNO (CÓDIGO PLANO INTERNO), entrada de dados: NOME ou CÓDIGO.

Será então exibido um relatório ([[#Principais_regras_de_negócio|RN01]])  conforme o modelo:


**Total de Empenhos Emitidos**

**__Unidade Gestora__:** Formato: UNIDADE (CÓDIGO), tipo TEXTO.

**__Programa de Trabalho__:** 	PROGRAMA (CÓDIGO)

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

**__Natureza da Despesa__:** 	NATUREZA (CÓDIGO)

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

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

^Natureza de Despesa^	Total Emitido ^
| CÓDIGO NATUREZA - NOME NATUREZA |  R$ 99.99|
|**Total** |  R$ 99.99|

Os campos: Programa de Trabalho, Fonte de Recurso, Natureza da Despesa, Esfera e Plano Interno são exibidos quando selecionados na pesquisa.

A coluna **Total**, corresponde a soma dos valores da coluna **Total Emitido**.

O caso de uso é finalizado.

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

  * **RN01** - O relatório será agrupado pela Natureza de Despesa e totalizado pelo valor total de empenhos emitidos por Natureza de Despesa.


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

Não se aplica.

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

^ Classe ^ Tabela |
|br.ufrn.sipac.orcamento.dominio.CelulaOrcamentaria | administrativo.sco.celula_orcamentaria |
|br.ufrn.sipac.orcamento.dominio.Esfera | administrativo.sco.esfera |
|br.ufrn.sipac.orcamento.dominio.FonteRecurso | administrativo.sco.fonte_recurso |
|br.ufrn.sipac.orcamento.dominio.ElementoDespesa | administrativo.sco.elemento_despesa |
|br.ufrn.sipac.orcamento.dominio.PlanoInterno | administrativo.sco.plano_interno |
|br.ufrn.sipac.orcamento.dominio.ProgramaTrabalho | administrativo.sco.programa_trabalho |

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

Sistema: SIPAC

Módulo: Orçamento

Link(s): Orçamento -> Relatórios -> Empenhos -> Total de Empenhos Emitidos

Usuário: larrubia2

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

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

Executar este relatório e não informando nenhum parâmetro. No resultado escolher uma Natureza de Despesa e buscar no Relatório de Despesas por Natureza da Despesa pela Natureza escolhida, a Unidade de Direito informada deverá ser a Unidade Gestora do usuário. Consultar o total da coluna Empenhado da Unidade de Direito. Os valores devem coincidir.

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

Utilizar um usuário que possua um dos papéis especificados acima. 

Para visualizar se as informações exibidas no relatório estão corretas é possível comparar as informações do Relatório SCO -> Relatórios -> Despesas -> Despesas por Natureza da Despesa