O utilitário visa criar uma estrutura de subpastas a partir da pasta principal do sistema, facilitando a leitura, navegação, rotinas de backup, entre outros. A necessidade de uma estrutura de pasta organizada, em especial quando a pasta possui uma quantidade consideravelmente grande de arquivos presentes, é essencial, evitando até mesmo o travamento da tread do sistema opercional correspondente a exibição dos arquivos no diretório.

GTSOFT-FILE-ORGANIZER

Este artefato deve ser utilizado a partir da versão 2.0.7.9 do GT Soft nas situações onde se deseja reestruturar a pasta de upload dos arquivos, reorganizando os arquivos numa estrutura de pastas e subpastas, facilitando a navegação e listagem dos diretórios, bem como rotinas de backup.

Por meio de consulta no banco de dados este executável procura os códigos dos arquivos com data de inclusão preenchida e associados nas tabelas de pendências dos documentos:

• periodos_documentos_pessoas
• periodos_documentos_empresas
• periodos_documentos_materiais
• periodos_documentos_veiculos

A nova organização da pasta de upload acontece levando em conta o ano, mês e dia de inclusão de cada documento. Ou seja, caso um dos arquivos retornados possua data de inclusão em 15/06/2021, o processo criará no diretório de upload as pastas “\2021\06\15”, com o arquivo sendo movido para dentro de “15” do final da estrutura.

No final da execução, o diretório de upload estará similar ao exemplo abaixo:

C:\diretorioUpload\2021\06\15\1234.pdf
C:\diretorioUpload\2021\06\15\84657.pdf
C:\diretorioUpload\2021\04\17\3453.pdf
C:\diretorioUpload\2021\01\14\1934.pdf
C:\diretorioUpload\2020\12\14\1934.pdf
C:\diretorioUpload\OUTROS\2543.pdf

Poderá haver pastas com mais de um documento assim como aquelas onde há apenas um. Outro detalhe é que o nome dos arquivos (arquivos_pontos.cod_arquivo no banco de dados) continuam o mesmo além de haver a pasta OUTROS.
A pasta OUTROS tem como função armazenar todos os arquivos que, por alguma razão, ainda estejam na raiz da pasta de upload. Esses arquivos que sobraram são aqueles onde já não se tem mais referência direta com o banco de dados (periodos_documentos_xxxx.cod_arquivo), sendo apenas mantidos por questões de segurança.

Condições

• Essa aplicação deve ser utilizada somente nos clientes que possuam o GT Soft na versão 2.0.7.9+. Isso se dá pela modificação feita no GT Soft onde pode-se configurá-lo para utilizar a mesma estruturação de ano, mês e dia durante upload ou download de documentos;
• Parar o GT Soft antes da execução;
• Executar o jar gtsoft-file-organizer;
• Alterar a Config.groovy do GT Soft incluíndo a nova propriedade de configuração;
• Subir o GT Soft.

Artefato utilizado

O gtsoft-file-organizer é um .jar a ser movido, pelo responsável da implantação, para o mesmo servidor onde encontra-se o diretório de upload do GT Soft.
O .jar está localizado na rede interna da Insoft em O:\Sistemas_Java\GTSoft\Deploy\GtsoftFileOrganizer.

Preparar arquivo de configuração da aplicação

É necessário disponibilizar no mesmo caminho do .jar o arquivo config.properties.
Em seu conteúdo deve estar previsto os atributos:

baseDados.usuario=abcd 
baseDados.senha=abdc 
baseDados.url=jdbc:oracle:thin:@insoft-lnx4:1521:desenvx 
diretorioUpload=D:\\Temp 
log.somenteSevero=true

As primeiras 4 (quatro) configurações acima estão presentes no Config.groovy do GT utilizado no cliente. Deve ser utilizado os mesmos valores.

log.somenteSevero (true ou false). Caso true, o arquivo log gerado no processo exibirá somente erros críticos (falha na conexão com banco). Caso false, exibe os avisos previstos no decorrer da aplicação (indicam o que está sendo executado em cada fase do processo). Recomendável manter com o valor false.

Executar a aplicação

Após a preparação conforme etapa anterior, parar o GT Soft para impedir que os arquivos sejam acessados pelos usuários.
Abrir o terminal apontando para o local onde o .jar foi movido. Inserir o comando:

java -jar gtsoft-file-organizer.jar #nome do jar pode variar conforme versão

Caso a propriedade log.somenteSevero=false o terminal exibirá informações relativas a execução, para acompanhamento. A aplicação encerrará no final do processamento e o terminal poderá ser fechado. É recomendável a conferência da movimentação dos arquivos nas novas supbastas criadas no nível abaixo da pasta de upload. Ao final do processo também será gerado um arquivo .log, que também pode ser analisado.

Ajustar Config.groovy do GT Soft

Após execução da aplicação, deve-se ajustar o Config.groovy do GT Soft para utilizar a nova estrutura de pastas. No contexto global do arquivo Config.groovy externalizado, adicionar o atributo:

 uploadEstruturado=true

Após isso, pode-se subir o GT Soft novamente. A partir deste momento todos os uploads e visualizações de documentos levarão em conta a nova estruturação de pastas.