~~ODT~~

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

====== Cadastrar Unidade Central de Empenho ======

Esse caso de uso é utilizado pelos gestores de orçamento local e global com a finalidade de cadastrar unidades da instituição como **unidade central de empenho**. 

A **Unidade central de empenho** é utilizada quando não se sabe especificamente a qual unidade será atribuído um empenho cadastrado. Sendo temporariamente debitado dessa unidade central, até a definição a ser realizada na liquidação de despesa, quando finalmente esse montante é debitado da unidade real de onde sairá o recurso.

Pré-condições: 
   * Para cadastrar a unidade central de empenho as unidades devem estar cadastrados;
   * O gestor deve está com perfil executor de orçamento ou executor de orçamento global para executar esta funcionalidade.

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

Este caso de uso inicia quando o usuário acessa a opção: //SIPAC → Orçamento → Aba Cadastros → Unidade Central de Empenho -> Cadastrar//.

O usuário precisa informar:

  * **Unidade**: Tipo AUTOCOMPLETE, formato: UNIDADE (CÓDIGO UNIDADE), entrada de dados: NOME UNIDADE ou CÓDIGO UNIDADE ([[#principais_regras_de_negócio|RN01 e RN02]]).
  * **Prioridade**: Tipo NUMÉRICO. ([[#principais_regras_de_negócio|RN03]]).

Caso um **empenho** tenha mais de uma unidade associada a ele, o campo prioridade define qual a unidade deve ser considerada como a central. Quanto menor o valor do campo prioridade, maior prioridade a unidade terá. Neste mesmo campo é sugerida a próxima prioridade disponível, já que não podem haver duas unidades com a mesma prioridade.

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

  * **RN01** - A unidade gestora no cadastro é a mesma do usuário logado.
  * **RN02** - O usuário só pode cadastrar uma unidade como unidade central de empenho se esta fizer parte da hierarquia da unidade gestora.
  * **RN03** - Não deve existir duas ou mais unidades vinculadas a uma mesma unidade gestora com a mesma prioridade.

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


^ Classe ^ Tabela |
| br.ufrn.sipac.orcamento.dominio.UnidadeCentralEmpenho | administrativo.sco.unidade_central_empenho |
| br.ufrn.sipac.orcamento.dominio.UnidadeCentralEmpenho | sistemas_comum.comum.unidade |

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

Sistema: SIPAC

Módulo: Orçamento

Link(s): Orçamento -> Cadastros -> Unidade Central de Empenho -> Cadastrar

Login(s): larrubia2, daliasaraiva


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

===== Cenários de Teste =====
Não se aplica.

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

Verificar os dados cadastrados no caso de uso de [[desenvolvimento:especificacoes:sipac:orcamentario:casos_de_uso:Cadastros:Unidade_Central_de_Empenho:Listar_Alterar|Listar Unidade Central de Empenho]].

Quando logado no Sistema observar o número que aparece entre parênteses ao lado do nome "SUPERINTENDÊNCIA DE INFORMÁTICA". Ele servirá para descobrir qual a unidade gestora do usuário logado. O código utilizado para verificar será este número sem o '.'.

Consultas para testar as regras de negócio:

  * select id_gestora from comum.unidade as u where codigo_unidade = código
//Busca o id da unidade gestora da unidade do usuário logado a partir do seu codigo.//

  * select hierarquia from comum.unidade as ug where ug.id_unidade = 
	(select id_gestora from comum.unidade as u where codigo_unidade = código)

//Busca a unidade gestora da unidade do usuário logado a partir do seu código//

  *  select uf.nome, uf.codigo_unidade from comum.unidade as uf where uf.unidade_orcamentaria = true and uf.hierarquia like '' || (select hierarquia from comum.unidade as ug where ug.id_unidade = (select id_gestora from comum.unidade as u where codigo_unidade = 1100)) || '%' order by nome 

//Obtem todas as unidades (orçamentárias) filhas da unidade gestora o código passado.//