Banco de dados GED - Armazenar layouts de relatorios no banco de dados

1 - Objetivo

Orientar os usuários do sistema Consultor’s na configuração e compreensão do processo que permite armazenar layouts de relatórios no banco de dados GED (Gerenciamento Eletrônico de Documentos).
Atualmente existem dois tipos de layouts de relatórios que fazem parte deste processo:

• Layouts RTM: para utilização em relatórios que usam o Report.exe. Os layouts são arquivos com extensão *.rtm, que ficam localizados no diretório ?:\progress\usuario\relatorios\.
• Layouts Caracter: são arquivos criados/editados no bloco de notas, onde basicamente são informadas as variáveis, as quebras e totalizadores. Um exemplo de relatório que utiliza layout Caracter é o programa cap007 -> cap007r. Estes arquivos de layout ficam localizados em ?:\progress\usuario\<modulo>\.

2 – Instrução/Orientações

O primeiro passo é criar o novo banco de dados GED, sendo que este banco de dados irá operar em paralelo ao banco de dados CGIBDA e tem como sua principal função armazenar arquivos do sistema operacional como: arquivos de layouts, arquivos de anexos e arquivos de imagens, assim os arquivos não ficam mais nos diretórios do sistema operacional e passam a ficar armazenados no banco de dados. Além de armazenar arquivos, outra função do banco de dados é gerenciar o versionamento de arquivos de layouts, ou seja, quando um layout for alterado a versão anterior continua armazenada no banco de dados e esta versão poderá ser resgatada a qualquer momento.
A News Banco de dados GED - Tudo oque é preciso saber para criar o banco de dados orienta em como proceder na criação e gerenciamento do banco GED.

O próximo passo e muito importante é realizar um backup dos arquivos de layout que estão no sistema operacional. É necessário fazer fazer backup no diretório ?\progress\usuario\ e todas as suas subpastas. Este backup deve ser guardado por tento indeterminado.

Em seguida é possível configurar o Consultor's para que os programas de relatórios comecem a armazenar os layouts no banco de dados. Para isso, verifique se os programas ged001, ged002, ged003, ged004, ged005, ged006, ged007 e ged008 estão no diretório ?\progress\ged, se não estiverem, solicite estes a CGI. Em seguida deve-se executar o programa ger283d e marcar a opção Armazenar arquivos de layouts no banco de dados GED.


Esta configuração é a única necessária para que a armazenação dos layouts em banco de dados passe a funcionar de forma automática.

Como os arquivos de layouts vão para banco de dados GED ?
Ao acionar o botão Ok de qualquer programa de relatório que utiliza layout, o sistema realiza as seguintes etapas:

• 1ª) Verifica se o layout informado no programa de relatório se encontra no diretório no sistema operacional (Se for Layouts RTM no diretório ?:\progress\usuario\relatorios\. Se for Layouts Caracter no ?:\progress\usuario\<modulo>\). Se o sistema encontrar o arquivo, cadastra o layout no banco de dados GED e deleta o arquivo de layout do diretório no sistema operacional.
• 2ª) Encontra o layout no banco de dados GED e gera o relatório usando o layout que está no banco de dados.

Desta forma nas próximas execuções deste programa de relatório somente a 2ª etapa será realizada, porque o layout não se encontra mais no diretórios do sistema operacional.

Quando a 1ª etapa for realizada nos domínios da CGI (na rede interna da CGI), os arquivos de layout não são apagados do sistema operacional. Os programas do módulo GED tem um mecanismo de segurança para fazer este controle. Na CGI os arquivos devem permanecer nos diretórios ?:\progress\usuario\relatorios\ ou ?:\progress\usuario\<modulo>\, para fácil localização e envio para clientes. Este parágrafo deve ser considerado apenas para consultores / desenvolvedores da CGI. Os demais leitores devem desconsiderar este parágrafo.

Atualização de Layout
Quando a CGI envia um arquivo de layout para ser atualizado, o arquivo deve ser colocado em seu respectivo diretório (Se for Layouts RTM no diretório ?:\progress\usuario\relatorios\. Se for Layouts Caracter no ?:\progress\usuario\<modulo>\). Em seguida deve-se executar o relatório, assim a 1ª etapa será realizada cadastrando o arquivo no banco de dados GED e apagando o layout do sistema operacional. Se o layout já estiver cadastrado no banco de dados GED, uma nova versão do layout será criada. Se o conteúdo do arquivo for igual ao conteúdo do layout no banco de dados, não será criado uma nova versão, porém o arquivo será apagado do sistema operacional.

Edição de layout RTM
A grande maioria dos relatórios que utilizam layout RTM tem opção para Editar Layout. Ao marcar esta opção e acionar o botão Ok do programa de relatório, o Report é aberto em mode de edição e o layout RTM pode ser modificado. Ao salvar a alteração do layout e fechar o Report, o sistema identifica que existiu a alteração e cria uma nova versão para o layout no banco de dados GED de forma automática. As versões anteriores continuam armazenadas no banco de dados GED.

Programa de Manutenção de Layouts Cadastrados no Banco de Dados GED
Depois de marcada a opção Armazenar arquivos de layouts no banco de dados GED no programa ger283d, ao acionar o zoom em qualquer programa de relatório no campo Layout será aberto a tela de zoom de layout.

Se o zoom for realizado em um campo de layout Layouts RTM será aberto o programa de zoom ger285.


Outra forma de executar o programa de manutenção de Layouts RTM é informando o programa ger285m a partir do Rodar Programa. A tela será aberta é do programa ger285.


Acionando o botão Altera no programa ger285, permite alterar os dados do registro do layout selecionado. A tela ger285d será aberta.


Campos da tela e funcionalidades:

• Layout: Nome do layout RTM.
  
• Descrição: Descrição do layout.
  
• Versão: Versão do layout que está sendo utilizada na emissão dos relatórios. Quando um layout possuir mais de uma versão é possível selecionar por exemplo, uma versão mais antiga do layout para gerar um relatório. As versões disponíveis para o layout podem ser melhor detalhadas visualizando o browser: Versões do Layout.
  
• Ativo: Ao executar um relatório informando um layout que está cadastrado como inativo, uma mensagem será mostrada informando que o layout está inativo e não será permitido a execução do relatório informando este layout.
  
• Autorizador Execução: é a lista de usuários do Consultor's que podem executar um relatório informando este layout. Desta forma se um usuário tentar executar um relatório informando um layout sem permissão de execução, uma mensagem será mostrada avisando que o usuário não tem permissão para utilizar o layout.
• Autorizador Edição: é a lista de usuários do Consultor's que podem executar um relatório informando este layout e marcando a opção Editar Layout. Esta opção está presente na grande maioria dos relatórios que utilizam layout RTM. Desta forma se um usuário marcar a opção Editar Layout e tentar executar um relatório informando um layout sem permissão de edição, uma mensagem será mostrada avisando que o usuário não tem permissão para editar o layout.
  
• Observações: Utilizado para informar observações diversas.

O browser "Versão de Layout" tem os seguintes campos:

• Versão: Número da versão que é sequencial.
  
• Dt/Hr Criação: Data e hora de criação da versão do layout.
  
• Usuário: Usuário que criou a versão do layout.
  
• Observação: mostra qual foi a origem da versão do layout.

Botões:

• Criar Nova Versão a Partir da versão ???: Permite selecionar uma versão mais antiga e criar uma nova versão. Esta nova versão será a de maior sequencia, portanto a última.
  
• Baixar a Versão ??? em Disco: Salva no sistema operacional o arquivo de layout do registro selecionado e abre para edição.

Se o zoom for realizado em um campo de layout Layouts Caracter será aberto o programa de zoom ger286.


É possível Alterar o layout caracter clicando no Alterar:


Selecione a versão do layout que deseja alterar e clique no botão Baixar a Versão XX em Disco:


Se o layout caracter já existir no diretório ??\progress\usuário\MODULO, o programa não irá baixar a versão solicitada, será aberta a versão que já está em disco:


Se o layout caracter não existir no diretório padrão, a versão selecionada será baixada:


Em seguida será aberto o layout para edição, após salvar o mesmo e emitir o relatório o layout será importado para o banco GED:


Outra forma de executar o programa de manutenção de Layouts Caracter é informando o programa ger286m a partir do Rodar Programa. A tela será aberta é do programa ger286.

Acionando o botão Altera no programa ger286, permite alterar os dados do registro do layout selecionado. A tela ger286d será aberta.


Campos da tela e funcionalidades:

• Modulo: Modulo do layout Caracter.
  
• Layout: Nome do layout Caracter.
  
• Descrição: Descrição do layout.
  
• Versão: Versão do layout que está sendo utilizada na emissão dos relatórios. Quando um layout possuir mais de uma versão é possível selecionar por exemplo, uma versão mais antiga do layout para gerar um relatório. As versões disponíveis para o layout podem ser melhor detalhadas visualizando o browser Versões do Layout.
  
• Ativo: Ao executar um relatório informando um layout que está cadastrado como inativo, uma mensagem será mostrada informando que o layout está inativo e não será permitido a execução do relatório informando este layout.
  
• Autorizador Execução: é a lista de usuários do Consultor's que podem executar um relatório informando este layout. Desta forma se um usuário tentar executar um relatório informando um layout sem permissão de execução, uma mensagem será mostrada avisando que o usuário não tem permissão para utilizar o layout.
• Observações: Utilizado para informar observações diversas.

O browser "Versão de Layout" tem os seguintes campos:

• Versão: Número da versão que é sequencial.
  
• Dt/Hr Criação: Data e hora de criação da versão do layout.
  
• Usuário: Usuário que criou a versão do layout.
  
• Observação: mostra qual foi a origem da versão do layout.

Botões:

• Criar Nova Versão a Partir da versão ???: Permite selecionar uma versão mais antiga e criar uma nova versão. Esta nova versão será a de maior sequencia, portanto a última.
  
• Baixar a Versão ??? em Disco: Salva no sistema operacional o arquivo de layout do registro selecionado.

3 - Lista de relatórios que fazem uso do banco de dados GED.

[G:\doctocgi\clientes\cgi\ged\lista_relatorios_ged.txt Lista de Programas]