====== 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. ([[desenvolvimento:especificacoes:sipac:convenios:casos_de_uso:convenios:consultas_relatorios:consulta_geral_de_convenios#principais_regras_de_negócio|RN02]]) ***Objetivos**: Tipo - TEXTO. No caso dos objetivos, a busca é feita com caracteres ASCII. ([[desenvolvimento:especificacoes:sipac:convenios:casos_de_uso:convenios:consultas_relatorios:consulta_geral_de_convenios#principais_regras_de_negócio|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.//**