~~ODT~~
Este guia de implantação tem por objetivo abordar os diversos aspectos que devem ser preenchidos para o correto funcionamento do sistema. Serão abordados os parâmetros envolvidos, papéis dos usuários e as tabelas que devem ser preenchidas para o correto funcionamento do sistema.
Para a compreensão deste módulo é importante a consulta dos seguintes artefatos:
(Quadro 1 - Parâmetros do Sistema Relativos ao SIPAC - Patrimônio)
Tarefas assíncronas são aquelas executadas sem que haja uma necessidade de resposta imediata. Diversas operações dos sistemas institucionais devem ser feitas assincronamente, por exemplo, enviar email diariamente para o gestor de patrimônio com dados dos termos de acautelamento em atraso. Uma tarefa assíncrona é representada por uma classe br.ufrn.arq.task.TarefaTimer, representada por uma Thread. No momento em que se desejar criar uma tarefa assíncrona nos sistemas, deve-se criar uma classe quer herda TarefaTimer e inserir um registro na tabela INFRA.REGISTRO_TIMER (Banco SISTEMAS_COMUM) que possuirá informações sobre a periodicidade que a tarefa assíncrona e em que servidor será executada.
No caso do módulo de patrimônio, existem os as seguintes classes timers:
Algumas exibições de propriedades na camada de visão são controladas pelo arquivo terminologia.properties situado no pacote br.ufrn.sipac.arq.util do projeto SIPAC, contendo no total quatro parâmetros:
Utilizado para definir o nome do documento que é criado no ato de tombamento de bens patrimoniais. Ex: “Termo de Responsabilidade”, “Nota de Recebimento”.
Utilizado para definir o nome do documento que é criado após as movimentações de bens, tais como transferência, recolhimento, empréstimo/ devolução. Ex: “Termo de Transferência”, “Termo de Responsabilidade”.
Utilizado para definir a nomenclatura utilizada no sistema para a denominação do elemento de despesa detalhado (conceito contábil) . Ex: “Grupo de Material”, “Elemento de Despesa Detalhado”.
Utilizado para especificar mais ainda a catalogação de material, atualmente é necessário para cadastrar um material vinculá-lo a um elemento de despesa detalhado (grupo do material), mas tem-se a opção de vinculá-lo a um destes e em seguida vinculá-lo a um subelemento de despesa (subgrupo de material) associado ao elemento de despesa detalhado. Ex: “Subgrupo de Material”, “Subelemento de Despesa”.
Este tópico descreve os procedimentos para ETL, no nosso caso Carga do Banco de Dados do módulo de patrimônio, citaremos as principais entidades envolvidas, seus pré-requisitos, dependências, os relacionamentos; serão descritos no decorrer deste tópico através de Diagramas Modelo Relacional, de todo o módulo através do Anexo B, além dos atributos destas entidades. Uma visão geral de todo o módulo de patrimônio, poderá ser vislumbrada através do dicionário de dados no Anexo A Quadro 1 e Quadro 2 e do Diagrama Modelo Relacional de todo o módulo, encontrado no Anexo B. Tomamos por SGBDR base, onde serão importados os dados, o PostgreSQL versão 8.3.
As entidades envolvidas nesta parte do módulo de patrimônio são usadas nos vários módulos existentes no SIPAC. É a base para todo o módulo de patrimônio, a figura 2 mostra o modelo relacional desta parte.
(Figura 2 - Modelo Relacional Cadastro de Material, Grupo, Subgrupo e Descritores)
A entidade comum.grupo_material armazena os grupos de materiais e indica um relacionamento 1 x N entre a entidade comum.material. Um grupo_material pode ter vários materiais ou nenhum. A Figura 2 apresenta o modelo relacional da entidade comum.grupo_material e Figura 3 apresenta um exemplo de preenchimento desta entidade.
(Figura 3 - Exemplo de preenchimento da entidade comum.grupo_material.)
Para que a entidade comum.grupo_material conforme exemplo citada na figura 3, seja populada, é necessário que entidade sco.elemento_despesa esteja povoada com a qual ela mantém relacionamento através do atributo id_elemento_despesa que é chave estrangeira para entidade grupo_material. Abaixo segue descrição da entidade que necessita ser populada antes. Entidade sco.elemento_despesa (Entidade que armazena os elementos de despesas.)
A entidade comum.unidade_medida armazena as unidade de medidas de materiais e indica um relacionamento 1 x N entre a entidade comum.material. Uma unidade de medida pode ter apenas vários materiais e um material só pode ter uma unidade de medida. A Figura 4 apresenta o modelo relacional da tabela comum.unidade_medida.
(Figura 4 - Exemplo de preenchimento da entidade comum.unidade_medida.)
Não existem.
A entidade comum.sub_grupo_material armazena os subgrupos de materiais e indica um relacionamento N x 1 entre a entidade comum.grupo_material. Um subgrupo só pertence a um grupo de material e um grupo de material pode ter vários subgrupos. A Figura 5 apresenta o modelo relacional da tabela comum.sub_grupo_material.
(Figura 5 - Exemplo de preenchimento da entidade comum.sub_grupo_material.)
Para que a entidade comum.sub_grupo_material seja populada, é necessário que esteja populada a entidade comum.grupo_material com a qual ela mantém relacionamento através do atributo id_gupo_material que é chave estrangeira para a entidade grupo_material. Abaixo segue descrição da entidade que necessita ser populada antes. Entidade comum.grupo_material (Entidade que armazena os grupos materiais.)
A entidade comum.material armazena os materiais. O quadro abaixo mostra o dicionário de dados desta entidade.
(Quadro 3 - Dicionário de dados da entidade comum.material.)
Para que a entidade comum.material seja preenchida é recomendável o preenchimento prévio destas entidades.
As entidades abaixo, usadas nos catálogo de materiais, são opcionais caso não use catálogo de material, é recomendável o preenchimento via sistema: comum.descritor_grupo_valor (Armazena o valor de um descritor para um determinado material) comum.descritor_grupo_material (Armazena os Descritores disponíveis para associação com Materiais de acordo com seu Grupo.) comum.descritor_grupo_opcao_valor (Entidade que representa a listagem dos valores dos descritores de materiais do tipo LISTA) comum.descritor_sub_grupo (Representa um descritor associado a determinado subgrupo de material).
As principais entidades que envolvem a parte de tombamento do patrimônio representam todo o ciclo de tombamento de um bem. A Figura 6 mostra o modelo relacional das entidades que compõem a parte de Tombamento. As entidades envolvidas nesta parte do módulo de patrimônio são usadas nos vários módulos existentes no SIPAC. É a base para todo o módulo de patrimônio e de alguns módulos do SIPAC como um todo, no Anexo A, Quadro 2 encontra-se o dicionário de dados desta entidades, a figura 5 mostra o modelo relacional desta parte. É de extrema importância que o parâmetro ESTRATEGIA_TOMBAMENTO, cujo código é 1_600_62 esteja com o caminho da classe que representa a estratégia de tombo. A estratégia de tombamento é responsável pela geração do tombo, exibição e impressão de etiquetas. Atualmente existem três tipos de estratégias:
Por ex: 0000000001 , 0000000100
Por ex: 2010000001, 2009000001
a partir do ano agregado com a seqüência adicionado da sigla da unidade gestora de tombamento. A junção de duas colunas da entidade patrimônio.bem (num_tombamento + id_ug_tombamento) . Sempre zerando a seqüência quando o ano muda ou a gestora de tombamento é diferente das demais que já tombaram. Por ex: 2010000001UFRN, 2010000001BCZM, 2010000002UFRN
Os descritores globais são entidades com as propriedades de um descritor comum, mas por ser global, o sistema os trará para preenchimento (a depender do seu destino “Bem” ou “Material” ou “Ambos”.) , independente do grupo de material do bem ou material selecionado. Por exemplo: Tenho um descritor do tipo Memória do grupo 5235 e um descritor global Número Antigo para o grupo 5200, ao tombar um bem do grupo 5235 , ele trará o descritor Memória , como também trará os descritores globais, no caso aí Número Antigo. Para cadastrar descritores globais, é necessário colocar um grupo de material como global. Para isso basta solicitar o comando abaixo: –SETANDO O GRUPO 5200 COMO GLOBAL UPDATE COMUM.GRUPO_MATERIAL SET GRUPO_GLOBAL = TRUE WHERE CODIGO = 5200; Com o grupo 5200 atualizado como grupo global, todos os descritores cadastrados para o tal, serão considerados globais. Para cadastrar um descritor para armazenar o número de tombo do sistema legado, ir em: SIPAC → Portal Administrativo → Requisições → Material → Catálogo → Gestão do Catálogo → Cadastrar Descritor de Material.
Exemplo para preenchimento de dados:
As entidades:
Compõem as entidades de tipos, isto é, auxiliares, conforme figura 5, não existem relacionamentos obrigatórios, mas é recomendável que sejam previamente preenchidas, segue exemplos destas entidades conforme figuras 7, 8, 9, 10, 11,12,13,14.
(Figura 7 - Exemplo de preenchimento da entidade patrimonio.tipo_documento_tombamento)
(Figura 8 - Exemplo de preenchimento da entidade patrimonio.indisponibilidade_bem.)
(Figura 9 - Exemplo de preenchimento da entidade patrimonio.tipo_entrada_bem.)
(Figura 10 - Exemplo de preenchimento da entidade patrimonio.finalidade_bem.)
(Figura 11 - Exemplo de preenchimento da entidade patrimonio.tipo_alienacao.)
(Figura 12 - Exemplo de preenchimento da entidade patrimonio.tipo_finalidade_levantamento.)
(Figura 13 - Exemplo de preenchimento da entidade patrimonio.tipo_chamado_patrimonial.)
(Figura 14 - Exemplo de preenchimento da entidade patrimonio.finalidade_movimentacao.)
Não existem.
A entidade patrimonio.bem armazena os bens propriamente dito, e indica uma entidade central dentro do contexto de patrimônio e se relaciona com quase todas as entidades do mesmo. O Anexo B mostra um Diagrama Modelo Relacional do módulo de patrimônio no qual está envolvida a entidade patrimonio.bem e no Anexo A, Quadro 2 encontra-se o dicionário de dados desta entidade e das demais que compõem o módulo supra citado, na figura 15 é mostrado um exemplo resumo de preenchimento desta entidade e no quadro 3 é mostrado o dicionário de dados desta mesma entidade.
(Figura 15 - Exemplo de preenchimento da entidade patrimonio.bem.)
(Quadro 4 - Dicionário de Dados da entidade patrimonio.bem.)
Para que a entidade patrimonio.bem seja populada com sucesso, basicamente é necessário prévio preenchimento destas entidades abaixo relacionadas:
comum.marca_produto comum.material comum.pessoa comum.unidade comum.usuario liquidacao.item_nota_fiscal patrimonio.bem patrimonio.doador patrimonio.finalidade_bem patrimonio.indisponibilidade_bem patrimonio.local_bem patrimonio.termo_responsabilidade patrimonio.tipo_documento_tombamento patrimonio.tipo_entrada_bem
É recomendável também o preenchimento prévio das tabelas auxiliares, isto é, tabela de tipos citadas no tópico 4.2.1 .
As entidades envolvidas dizem respeito, a transferência de bens do patrimônio; que neste caso é a transferência do domínio de um bem para outrem, mudança de responsabilidade, podendo ser empréstimo ou não; são ilustradas através do Diagrama Modelo Relacional conforme figura 16; faz necessário o preenchimento prévio da entidade patrimonio.bem.
Responsável pelo registro de movimentação de bens do patrimônio . Em diversas operações do patrimônio utiliza-se essa entidade como base do histórico de determinado bem
Não existem, porém recomenda-se o povoamento da entidade patrimonio.bem.
As entidades envolvidas dizem respeito, a alienação de um bem de patrimônio, que neste caso, é quando um bem entra no desuso, isto é, o bem deixa de ser útil, conforme mostrado na figura 17; faz necessário o preenchimento prévio da entidade patrimonio.bem.
A entidade patrimonio.alienacao armazena as alienações de bens de patrimônio, na figura 18 ilustra um exemplo de preenchimento desta entidade.
(Figura 18 - Exemplo de preenchimento da entidade patrimonio.alienacao)
Não existem, entretanto recomenda-se o povoamento prévio das entidades auxiliares designadas no tópico 4.2.1 Entidades auxiliares, tipos, em particular a entidade patrimonio.tipo_alienacao. Entidade patrimonio.tipo_alienacao (Entidade que armazena os tipos de alienações um bem.)
A entidade patrimonio.item_aliencao armazena os itens de alienações de bens de patrimônio e indica um relacionamento obrigatório 1 x N com a entidade patrimonio.alienacao.
(Figura 19 - Exemplo de preenchimento da entidade patrimonio.item_alienacao)
Entidade entidade patrimonio.alienacao (Entidade que armazena as alienações de um bem.)
A entidade patrimonio.local_bem armazena os locais designados de uma unidade tipo: salas, divisões, escritórios, etc., podendo ser as divisões de uma planta de um imóvel, indica o local onde um bem pode está, a figura 20 apresenta um exemplo de preenchimento desta entidade.
(Figura 20 - Exemplo de preenchimento da entidade patrimonio.local_bem.)
Entidade comum.unidade (id_unidade) (Entidade que armazena as unidades de uma intituição)
As entidades envolvidas dizem respeito, a movimentação temporária de bens do patrimônio. Define-se como movimentações temporárias as transferências de bens para unidades externas, não vinculadas a instituição, geralmente bens que saem da instituição com data marcada para voltar, conserto de um bem por exemplo; um Diagrama Modelo Relacional é apresentado conforme figura 21.
A entidade patrimonio.movimentacao_temporaria armazena as transferências de bens para unidades externas, não vinculadas a instituição .
Entidade patrimonio.movimentacao_temporaria_bem; (Entidade que armazena as movimentações temporárias de um bem)
A entidade patrimonio.movimentacao_temporaria_bem armazena as transferências de bens para unidades externas, não vinculadas a instituição e indica um relacionamento 1 x N entre a entidade patrimonio.movimentacao_temporaria e relacionamento 1 x N entre a entidade patrimonio.bem.
Entidade patrimonio.movimentacao_temporaria; (Entidade que armazena as movimentações temporárias de um bem) Entidade patrimonio.bem; (Entidade que armazena os bem de patrimônio) Entidade patrimonio.finalidade_movimentacao; (Entidade que armazena o tipo de movimentação temporária)
As entidades envolvidas dizem respeito, a cautela de bens do patrimônio. Define-se como cautela de bens a responsabilidade de um ou mais bens para determinado servidor (funcionário público), que guardará o(s) bem(ns) com cautela e precaução ; um Diagrama Modelo Relacional é apresentado conforme figura 22, no Anexo A, Quadro 2 encontra-se o dicionário de dados desta entidades.
A entidade patrimonio.cautela armazena as cautelas dos servidores (funcionários públicos) responsável por um determinado bem de patrimônio, a figura 23 apresenta um exemplo de preenchimento desta entidade.
(Figura 23 - Exemplo de preenchimento da entidade patrimonio.cautela.)
Entidade comum.usuario; (Entidade que armazena os usuário, logins, senha dos usuários cadastrado no sistema) Entidade rh.servidor; (Entidade que armazena os servidores (funcionário públicos) registrados na instituição) Entidade comum.unidade; (Entidade que armazena as unidades de uma instituição)
A entidade patrimônio.item_cautela armazena os itens da cautela (detalhes) dos servidores (funcionários públicos) responsável por um determinado bem de patrimônio, a figura 24 apresenta um exemplo de preenchimento desta entidade.
(Figura 24 - Exemplo de preenchimento da entidade patrimônio.item_cautela.)
Entidade patrimonio.bem; (Entidade que armazena os bens de patrimônios) Entidade patrimonio.cautela; (Entidade que armazena as cautelas dos servidores (funcionários públicos)
As entidades envolvidas dizem respeito, ao chamado patrimonial de bens do patrimônio. Define-se como chamado patrimonial; um Diagrama Modelo Relacional é apresentado conforme figura 25, no Anexo A, Quadro 2 encontra-se o dicionário de dados desta entidades.
As entidades envolvidas dizem respeito, ao levantamento patrimonial de bens do patrimônio. Define-se como levantamento patrimonial o processo de se levantar os bens de determinado setor para saber quais bens de patrimônio estão lá; um Diagrama Modelo Relacional é apresentado conforme figura 26, no Anexo A, Quadro 2 encontra-se o dicionário de dados desta entidades.
As entidades envolvidas estão nos Diagramas Modelo Relacional e é apresentado conforme figuras 27, 28, 29, no Anexo A, Quadro 2 encontra-se o dicionário de dados desta entidades.
(Figura 27 - Modelo Relacional Termo de Responsabilidade.)
(Figura 28 - Modelo Relacional Protocolo de Documento Termo Nota.)
A entidade envolvida é patrimonio.unidade_conciliacao, define-se como unidades de conciliação, determinadas unidades criadas com a finalidade de alocar bens que não possuem destino definido ou em caso de desconhecimento da localização de um bem. Os bens cuja localização é desconhecida são transferidos para essa unidade a fim de que possa identificar quais e quantos bens estão nessa situação para averiguação física. No Diagrama Modelo Relacional e é apresentado esta entidade conforme figura 30, no Anexo A, Quadro 2 encontra-se o dicionário de dados desta entidades.
As entidades envolvidas refletem um cenário em que os bens de patrimônio, são localizados por salas, sub-salas departamentos, e seus responsáveis; no Diagrama Modelo Relacional é apresentado conforme figura 31, no Anexo A, Quadro 2 encontra-se o dicionário de dados desta entidades.
(Figura 31 - Modelo Relacional Localidade.)
(Quadro 5 - Dicionário de dados da entidade patrimônio.local_bem)
Entidade comum.registro_entrada; Entidade comum.unidade;
A entidade patrimonio.local_bem armazena os locais de bens, mantém um relacionamento não obrigatório com patrimonio.responsavel_local_bem e obrigatório com comum.unidade
(Figura 32: Exemplo de preenchimento da entidade patrimonio.local_bem)
Entidade patrimonio.local_bem; (Entidade que armazena os locais dos bens de patrimônio) Entidade comum.unidade (Entidade que armazena as unidades de uma instituição)
A entidade patrimonio.responsavel_local_bem armazena o vínculo da localização do bem junto com o servidor (funcionário público) responsável pelo local.
(Figura 33: Exemplo de preenchimento da tabela patrimonio.responsavel_local_bem)
Entidade rh.servidor (Entidade que armazena os servidores (funcionário públicos) de uma instituição)
Desde o momento do tombamento de um bem, já é gerado um registro na entidade movimentacao_bem, dentre outras operações. É de grande importância que ao se migrar a entidade patrimonio.bem , também migrar a entidade movimentacao_bem. As operações que envolve criação de tuplas nessa entidade são representadas pela classe de constantes br.ufrn.sipac.patrimonio.movimentacao.dominio.TipoMovimentacao persistindo na coluna tipo_movimentacao: