~~ODT~~

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


====== Associar Contratos à Convênios ======

O convênio é o acordo que tem por partes órgãos, entidades da Administração Pública e organizações particulares. No contrato, o interesse das partes é diverso, pois a Administração objetiva a realização do objeto contratado e ao particular, interessa o valor do pagamento correspondente. Contudo, no convênio os interesses das partes são convergentes; no contrato são opostos. Este Caso de Uso é utilizado pelos gestores de contratos com a finalidade de saber quais contratos terão seu orçamento pago por convênios.


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


O caso de uso é acionado quando o usuário acessa a opção: SIPAC -> Módulo Contratos -> Aba Geral -> Contrato -> Associações -> Associar Contratos a Convênios.

O Gestor efetua a busca informando os campos: ([[#principais_regras_de_negócio|RN01]])
  * **Número**: Formato 9..., Tipo - NUMÉRICO.
  * **Ano do Contrato**: Formato - AAAA, Tipo - NUMÉRICO.
  * **Contrato Externo?**: Tipo - TEXTO. Este campo possui as opções ''SIM'' para caso o contrato desejado seja um contrato externo ou ''NÃO'' para caso seja um contrato interno. 


Efetuada a busca, o sistema exibe os contratos (caso exista mais de um contrato, se não o sistema irá redirecionar para a associação do convênio ao contrato) encontrados para que o Gestor de Contratos possa selecionar. O sistema exibe os campos:
  * **__Número__**: Tipo NUMÉRICO, formato: 9.../AAAA.
  * **__Empresa__**: Tipo TEXTO.
  * **__Tipo__**: ipo TEXTO, este pode ser //Acadêmico//, //Despesa/Global//, //Despesa/Ordinário// ou //Receita//. Para ver os detalhes sobre estes tipos de contrato ver, [[desenvolvimento:especificacoes:sipac:contratos:negocio|documento de negócio de contratos]].
  * **__Cadastro__**: Tipo DATA, formato DD/MM/AAAA.
  * **__Login Cadastro__**: Tipo TEXTO.

Ao selecionar o contrato desejado, o sistema exibe as //informações do contrato// e solicita a //busca de convênio//:
  ***__Número do Contrato__**: Tipo NUMÉRICO, formato: 9.../AAAA.
  ***__Licitação__**: Tipo TEXTO, formato: SIGLA TIPO LICITAÇÃO - 9.../AAAA. 
  ***__Tipo do Contrato__**: Tipo TEXTO.
  ***__Subtipo do Contrato__**: as opções são - //AQUISIÇÃO DE LIVROS//, //LOCAÇÃO DE MÃO-DE-OBRA//, //MANUTENÇÃO DE VEÍCULOS//, //OBRAS E SERVIÇOS DE ENGENHARIA// ou //SERVIÇOS DE LIMPEZA//. Tipo TEXTO.
  ***__Status__**:  Tipo TEXTO.
  ***__Objeto do Contrato__**: Tipo TEXTO.
  ***__Contratado__**: Tipo TEXTO.
  ***__Data de Início__**: Formato DD/MM/AAAA. Tipo DATA.
  ***__Data de Término__**: Formato DD/MM/AAAA. Tipo DATA.
  ***__Data da Publicação__**: Formato DD/MM/AAAA. Tipo DATA.
  ***__Continuado__**: Tipo TEXTO.

    *//Busca do convênio//: O sistema solicita ao Gestor, que os dados da busca do convênio sejam informados ([[#principais_regras_de_negócio|RN01]]).
         * **Número***: Tipo NUMÉRICO.
         * **Ano***: Tipo NUMÉRICO, formato: AAAA.
         * O sistema exibe as opções de //Número de Registro// ou //Número de Cadastro// para seleção.

    *O sistema exibe os dados do convênio:
  ***__Nº. do Convênio__**: Tipo NUMÉRICO.
  ***__Nº de Cadastro__**: Tipo NUMÉRICO.
  ***__Código SIAFI__**: Tipo NUMÉRICO.
  ***__Origem Recursos__**: Tipo TEXTO.
  ***__Tipo__**: Tipo TEXTO.
  ***__Classificação__**: Tipo TEXTO.
  ***__Data de Assinatura__**: Formato DD/MM/AAAA. Tipo DATA.
  ***__Prazo de Vigência__**: Formato DD/MM/AAAA. Tipo DATA.
  ***__Valor__**: Tipo NUMÉRICO.
  ***__Status__**: Tipo TEXTO.
  ***__Descrição__**: Tipo TEXTO.
  ***__Objetivos__**: Tipo TEXTO.

É associado o convêncio ao contrato pesquisado.

O sistema efetua a associação do contrato ao convênio e exibe os dados associados:
  ***__Nº. do Convênio__**: Tipo NUMÉRICO.
  ***__Nº de Cadastro__**:  Tipo NUMÉRICO.
  ***__Objetivos__**: Tipo NUMÉRICO.

O caso de uso então é finalizado.
	

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

  * **RN01** - Caso o perfil do usuário seja GESTOR CONTRATO GLOBAL, o acesso é independente da UG (Unidade Gestora). E quando o perfil do usuário for GESTOR CONTRATOS, o acesso aos contratos é de sua gestora abaixo. Não é permitido ao GESTOR DE CONTRATOS acessar os contratos de uma UG diferente da sua.

==== Resoluções/Legislações Associadas ====
Não se aplica.

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

^ Classe ^ Tabela |
| br.ufrn.sipac.contratos.dominio.AcompanhamentoContrato | administrativo.contratos.acompanhamento_contrato |
| br.ufrn.sipac.contratos.dominio.ContratoConvenio       | administrativo.contratos.acompanhamento_contrato |
| br.ufrn.sipac.convenios.dominio.Convenio               | administrativo.convenios.convenio                |

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

Sistema: SIPAC

Módulo: Contratos

Link(s): SIPAC → Módulo Contratos → Aba Geral → Contrato → Associações → Associar Contratos a Convênios. 

Usuário: rcsl

Papel que usuário deve ter: GESTOR_CONTRATO, GESTOR_CONVENIO e GESTOR_CONTRATO_FUNDACAO.

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

Realizar a busca por um contrato que deseja-se associar um convênio, após a buscar efetuar a busca do convênio e associa-lo.

  - Se o convênio estiver cancelado o sistema deve criticar com a mensagem "//O convênio foi cancelado//."
  - Se o convêncio não possuir número de cadastro, o sistema deve criticar com a mensagem "//O convênio ainda não possui número de cadastro. O convênio deve ser cadastrado//."
  - Se o convêncio informado não existir, o sistema deve criticar com a mensagem: "//Nenhum convênio existente para os parâmetros informados.//"

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

Para efetuar a associação o testador deve buscar os dos de um contrato e o convênio. Segue abaixo os respectivos locais para consuta dessas informações:

SIPAC -> Contratos -> Aba Consulta/Relatórios -> Gerais -> Listar Contratos 

SIPAC -> Convênios -> Aba Convênios -> Consultas/Relatórios -> Listar Convênios