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 (RN01 e RN02).
Prioridade: Tipo NUMÉRICO. (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

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 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.