~~ODT~~

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

====== Associar Convênio a Empenho ======
Esta funcionalidade permite os Executores de Convênios associarem convênios aos empenhos para um determinado projeto, assim como alterar e remover as associações já inseridas.

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

O caso de uso é iniciado quando a opção //Sipac -> Projetos/Convênios -> Execução de Convênios -> Execução -> Associar Convênio à Empenho// é acessada.

====Passo 1====

O Sistema solicita ao Usuário que informe //Número//, //Ano do Convênio// e selecione a opção de //Número de Registr//o ou //Número de Cadastro// para busca.


====Passo 2====
O Sistema exibe as informações gerais do convênio:

  * Dados Gerais:
    * **__Nº do Convênio/Ano__**: Tipo NUMÉRICO, formato: ...9/AAAA.
    * **__Nº de Cadastro__**: Tipo NUMÉRICO, formato: ...9/AAAA.
    * **__Data de Assinatura__**: Tipo DATA.
    * **__Prazo de Vigência__**: Tipo DATA.
    * **__Código SIAFI__**: Tipo NUMÉRICO.
    * **__Tipo__**: Tipo TEXTO.
    * **__Valor__**: Tipo NUMÉRICO.
    * **__Status__**: Tipo TEXTO.
    * **__Unidade Orçamentária__**: Tipo TEXTO, Formato - NOME(CÓDIGO).
    * **__Descrição__**: Tipo TEXTO.
    * **__Objetivos__**: Tipo TEXTO.
    * **__Observações__**: Tipo TEXTO.
 
O Sistema solicita que o Usuário informe Número e Ano do Empenho, a Unidade Gestora e o Repasse orçamentário associado([[#Principais Regras de Negócio|RN01]]):

    * **Nº do Empenho/Ano***: Tipo NUMÉRICO, Formato: 9.../AAAA.
    * **Unidade Gestora***: Tipo TEXTO.
    * **__Repasse Orçamentário__**
      * **Repasse Orçamentário***: Tipo TEXTO, Formato - DATA (DD/MM/AAAA) - TEXTO (NOME) - NUMÉRICO. (É exibido se o convênio tiver repasse orçamentário) ([[#Principais Regras de Negócio|RN03]])
  
O Sistema lista as associações cadastradas:

  * **__Empenho (Nº/ano)__**: Tipo NUMÉRICO, Formato - 9.../AAAA.
  * **__Gestora__**: Tipo TEXTO, Formato - SIGLA GESTORA.
  * **__Data do Emepnho__**: Tipo DATA.
  * **__Fonte de Recurso__**: Tipo NUMÉRICO.
  * **__Valor__**: Tipo NUMÉRICO.
  * **__Repasse Orçamentário__***: Tipo TEXTO, Formato - DATA (DD/MM/AAAA) - TEXTO (NOME) - NUMÉRICO.

É possível alterar e remover as associações cadastradas.

O caso de uso é finalizado.
===== Principais Regras de Negócio =====
  * **RN01** - O valor do Empenho associado não deve ultrapassar o valor do repasse orçamentário.  
  * **RN02** - Só é permitido usar o repasse uma vez na associação.
  * **RN03** - Apenas é apresentado o campo e obrigatório escolhe uma opção se o projeto possuir repasse orçamentário cadastrado.
 
==== Resoluções/Legislações Associadas ====
Não se Aplica.


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

^ Classe ^ Tabela |
| br.ufrn.sipac.convenios.dominio.Projeto | administrativo.convenios.convenio_empenho |
| br.ufrn.sipac.convenios.execucao.dominio.ConcedenteProjeto | administrativo.convenios.repasse_orcamentario |
| br.ufrn.sipac.convenios.execucao.dominio.ConcedenteProjeto | administrativo.convenios.projeto_convenio |
| br.ufrn.sipac.convenios.execucao.dominio.TipoConcedenteProjeto | administrativo.sco.empenho |

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

Sistema: SIPAC

Módulo: Projetos/Convênios

Link(s): Aba Execução de Convênios -> Execução -> Associar convênio a Empenho

Usuário: teotonio

Papel que usuário deve ter: SipacPapeis.EXECUTOR_CONVENIOS_FUNPEC

===== Cenários de Teste =====
Verificar se as operações de cadastro, alteração e remoção das associações de covênio a empenho estão sendo feitas de forma correta.

===== Dados para o Teste =====
  Não se aplica.