Consulta Geral de Convênios

Este caso de uso serve para permitir a consulta de convênios através de diversos filtros de busca. O caso de uso poderá ser utilizado pelos usuários habilitados à realizarem manutenção de convênios firmados com a instituição.

Descrição do Caso de Uso

O caso de uso se inicia com a busca pelos convênios e pode ser filtrada pelas seguintes opções:

Número/Ano: Formato - 9999/AAAA, Tipo - NUMÉRICO. Número e Ano do convênio.
Tipo: Tipo - TEXTO. Indica o tipo do convênio. Por exemplo: Descentralizado, Termo de Cooperação, Termo de Parceria, etc.
Classificação: Tipo - TEXTO. Referente a classificação do convênio. Por exemplo: Cooperação, Despesa, Estágio, Receita, etc.
Assinatura entre: Formato - DD/MM/AAAA a DD/MM/AAAA, Tipo - DATA. Período em que foi assinado o convênio.
Vigência entre: Formato - DD/MM/AAAA a DD/MM/AAAA, Tipo - DATA. Período de vigência do convênio.
Valor (R$) entre: Formato - DD/MM/AAAA a DD/MM/AAAA, Tipo - DATA. Faixa de valor do convênio.
Status: Tipo - TEXTO. Cancelado, Inativo, Estornado, Cadastrado e Registrado.
Coordenador: Formato - NOME(CPF/CNPJ), Tipo - AUTOCOMPLETE, Entrada de Dados - NOME. Coordenador do convênio.
Convenente: Formato - NOME(CPF/CNPJ), Tipo - AUTOCOMPLETE, Entrada de Dados - NOME. Participantes de um determinado convênio
Descrição: Tipo - TEXTO. No caso da descrição, a busca é feita com caracteres ASCII. (RN02)
Objetivos: Tipo - TEXTO. No caso dos objetivos, a busca é feita com caracteres ASCII. (RN02)
Responsável: Formato - NOME(CPF/CNPJ), Tipo - TEXTO. Responsável pelo convênio.
Unidade Interessada: Formato - NOME(CÓDIGO), Tipo - TEXTO, Entrada de Dados - NOME/CÓDIGO. Refere-se a unidade que tem interesse pelo convênio.
Ordenado por: Tipo - TEXTO. Opções: CONVÊNIO, CADASTRO, VIGÊNCIA e VALOR.
Exportar Dados para o Excel. Tipo - LÓGICO

Caso exista algum convênio com os parâmetros de busca informados, os mesmos serão exibidos numa listagem com os seguintes dados:

Convênio: Formato - 9999/AAAA, Tipo - NUMÉRICO.
Cadastro: Formato - 99/AAAA, Tipo - NUMÉRICO.
Status: Tipo - TEXTO.
Descrição: Tipo - TEXTO.
Objetivos do Convênio: Tipo - TEXTO.
Convenentes: Formato - NOME, Tipo - TEXTO.
Vigência: Formato - DD/MM/AAAA, Tipo - DATA.
Valor: Formato - 99,99, Tipo - NUMÉRICO.

Os convênios exibidos após a busca podem ser visualizados ou impressos de forma detalhada. Os dados exibidos são:

Dados Gerias do Convênio:
- Número do Convênio: Formato 99/AAAA, Tipo - NUMÉRICO.
- Código SIAFI: Formato 99999, Tipo - NUMÉRICO.
- Tipo: Tipo - TEXTO. Por exemplo: CONVÊNIO, PORTARIA, DESCENTRALIZAÇÃO.
- Data de Assinatura: Formato DD/MM/AAAA, Tipo - DATA.
- Valor do Convênio: Formato - 99,99, Tipo - NUMÉRICO.
- Status: Tipo - TEXTO.
- Número de Cadastro do Convênio: Formato - 99/AAAA, Tipo - NUMÉRICO. Campo obrigatório.
- Descrição: Tipo - TEXTO.
- Objetivos do Convênio: Tipo - TEXTO. Campo obrigatório.
- Classificação: Tipo - TEXTO. Por exemplo: DESPESA, RECEITA, ESTÁGIO. Campo obrigatório.
- Tipo de Documento: Tipo - TEXTO. Por exemplo: CONVÊNIO, PORTARIA, DESCENTRALIZAÇÃO. Campo obrigatório.
- Objetivos do Convênio: Tipo - TEXTO.
- Observações: Tipo - TEXTO.
- Número de Cadastro: Formato - 99/AAAA, Tipo - NUMÉRICO.
- Origem Recursos: Tipo - TEXTO.
- Classificação: Tipo - TEXTO. Por exemplo: DESPESA, RECEITA, ESTÁGIO.
- Vigência: Formato - DD/MM/AAAA, Tipo - DATA.
As Unidades Interessadas
Os Partícipes Inseridos
Os Partícipe e Tipos de Partícipes Associados

O usuário também poderá gerar o resultado da busca em formato de relatório. No caso do relatório, o usuário terá ainda a opção de exporta-lo em formato xls. Os dados exibidos tanto na busca normal quanto nos relatórios (Excel ou html) serão os dados gerais do convênio:

Número/Ano: Formato - 9999/AAAA, Tipo - NUMÉRICO.
Data de Cadastro: Formato DD/MM/AAAA, Tipo - DATA.
Convenentes: Formato - NOME, Tipo - TEXTO.
Vigência: Formato - DD/MM/AAAA, Tipo - DATA.
Valor: Formato - 99,99, Tipo - NUMÉRICO.
Status: Tipo - TEXTO.
Descrição: Tipo - TEXTO.
Objetivos do Convênio: Tipo - TEXTO. Campo obrigatório.

Formato do relatório:

Listagem de Convênios

Convênio	Cadastro	Convenentes	Vigência	Valor
	Informações
2/2005	1/2005	ASPOFERN UNIVERSIDADE FEDERAL DO RIO GRANDE DO NORTE	09/09/2009	R$ 99,99
	Status: STATUS DE TESTE
	Descrição: DESCRICAO DE TESTE
	Objetivos: OBJETIVOS DE TESTE

Principais Regras de Negócio

Um convênio pode não ter número de cadastro, número de convênio, valor ou vigência, pois em algumas entradas do banco de dados, esses ítens não estão presentes.
Na busca utilizando os filtros de objetivo e descrição, só é preciso informar uma palavra chave.

Classes Persistentes e Tabelas Envolvidas

Classe	Tabela
br.ufrn.sipac.convenios.dominio.Convenio	administrativo.convenios.convenio
br.ufrn.sipac.convenios.dominio.ClassificacaoConvenio	administrativo.convenios.classificacao_convenio
br.ufrn.sipac.convenios.dominio.TipoDocConvenio	administrativo.convenios.tipo_documento_convenio
br.ufrn.sipac.cadastro.dominio.Unidade	administrativo.comum.unidade
br.ufrn.sipac.cadastro.dominio.Pessoa	administrativo.comum.pessoa
br.ufrn.sipac.convenios.dominio.ConvenenteTipoConvenente	administrativo.convenios.convenente_tipo_convenente

Plano de Teste

Sistema: SIPAC

Módulo: Projetos

Link(s): Projetos → Convênios → Consultas/Relatórios → Consulta Geral de Convênios

Usuário: afnd

Papel que usuário deve ter: SipacPapeis.GESTOR_CONVENIO

Cenários de Teste

Verificar se os dados estão sendo ordenados corretamente após a consulta.

Dados para o Teste

Para realizar o teste, é necessário usarmos os dados de convênios válidos. Para conseguir esses dados, pode-se usar o caso de uso:

Projetos → Convênios → Consultas/Relatórios → Listar Convênios.