~~ODT~~

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

====== Associar Unidades a Unidades de Custo ======

Esse caso de uso é utilizado pelos gestores de contrato com a finalidade de associar uma unidade de custo à determinada unidade associada. A unidade de custo é aquela de onde sai o orçamento para custear o benefício com o contrato. Uma unidade pode se beneficiar do contrato, porém não ser dela os recursos financeiros para custear os gastos. Portanto, é possível associar as unidades que se beneficiam, mas que não custeiam os gastos com a respectiva unidade que custeia. 

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

O caso de uso se inicia quando o usuário acessa a opção: SIPAC -> Módulo Contratos -> Aba Geral -> Associações -> Associar Unidades a Unidades de Custo.

Para associar uma unidade a unidade de curso, é necessário selecionar o contrato, informando os parâmetros ([[#Principais Regras de Negócio|RN01]]): 

  * **Número***: Tipo NUMÉRICO.
  * **Ano do Contrato**: Tipo NUMÉRICO, formato: AAAA.
  * **Contrato Externo?**: Tipo LÓGICO.

Efetuada a busca, o sistema exibe os contratos encontrados para que o Gestor de Contratos possa escolher o que deseja. Os contratos exibem os seguintes campos:
  ***__Número - Gestora__**: Tipo TEXTO, formato: 9... - DENOMINAÇÃO UNIDADE GESTORA.
  ***__Empresa__**:  Tipo TEXTO.
  ***__Tipo__**:  Tipo TEXTO.
  ***__Cadastro__**: Tipo DATA, formato: DD/MM/AAAA.
  ***__Login Cadastro__**:  Tipo TEXTO, formato: LOGIN USUÁRIO.

Ao selecionar o contrato desejado, o sistema exibe os seguintes dados do contrato:

  ***__Número do Contrato__**: Tipo NUMÉRICO, formato: 9.../AAAA.
  ***__Tipo do Contrato__**: Tipo TEXTO.
  ***__SubTipo do Contrato__**: Tipo TEXTO.
  ***__Contratado__**: Tipo TEXTO, formato: CPF ou CNPJ - DENOMINAÇÃO CONTRATADO.
  * **Unidade de Custo:*** Tipo TEXTO, formato: DENOMINAÇÃO UNIDADE (CÓDIGO UNIDADE).
  * **Unidade Associada:*** Tipo TEXTO, formato: DENOMINAÇÃO UNIDADE (CÓDIGO UNIDADE).

Ao confirmar a associação de unidades, o sistema exibe o histórico dos dados:
  * **__Unidade de Custo:__** Tipo TEXTO, formato: DENOMINAÇÃO UNIDADE (CÓDIGO UNIDADE).
  * **__Unidade Associada__**: Tipo TEXTO, formato: DENOMINAÇÃO UNIDADE (CÓDIGO UNIDADE).

O sistema disponibiliza a opção para remover um registro já inserido, mediante confirmação.

O caso de uso então é finalizado.

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

  ***RN01** - A operação não é permitida para contratos do tipo RECEITA.


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

"Não se Aplica".  


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

^ Classe ^ Tabela |
| br.ufrn.sipac.contratos.dominio.AssociacaoUnidadeContrato | administrativo.contratos.associacao_unidade  |
| br.ufrn.sipac.contratos.dominio.Contrato                  | administrativo.contratos.contrato            |
| br.ufrn.sipac.contratos.dominio.UnidadeBeneficiada        | administrativo.contratos.unidade_beneficiada |

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

Sistema: SIPAC

Módulo: Contratos

Link(s): SIPAC → Módulo Contratos → Aba Geral → Associações → Associar Unidades a Unidades de Custo.

Usuário: rcsl

Papel que usuário deve ter: GESTOR_CONTRATO (manipular contratos)

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

Realizar a associação entre as unidades e remove-las.

SIPAC → Módulo Contratos → Aba Geral → Associações → Associar Unidades a Unidades de Custo. 

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

Não se aplica.