Explorador de arquivos

Possibilita a visualização, importação e exportação de arquivos do sistema de arquivos virtual (VFS). Também é possível corrigir eventuais inconsistências nos arquivos como arquivos órfãos por exemplo.

Ao acessar o processo que fica em “Administração do sistema > Classes de dados > Explorador de arquivos”, são exibidas duas grades. A grade “Diretórios” mostra a hierarquia de diretórios da VFS e a grade “Arquivos” mostra os arquivos existentes no diretório atualmente selecionado.

Esse processo também pode ser acessado pelo menu “Desenvolvimento > Virtual File System > Explorador de arquivos”.

Importante: Este processo não permite a alteração da estrutura de diretórios do sistema. Para criar, remover ou alterar diretórios deve ser utilizado o processo Explorador de classes.

Visualizando arquivos

Para visualizar o conteúdo de um arquivo, selecione o diretório desejado na grade de diretórios e depois selecione o registro do arquivo desejado na grade de arquivos e clique no botão “Visualizar”. O conteúdo do arquivo será exibido em uma nova aba do sistema. Apenas arquivos de conteúdo textual (como arquivos de código-fonte) ou imagens podem ser exibidos. Também só podem ser exibidos arquivos com tamanho de até 1MB. Se o arquivo desejado for de um tipo ou tamanho que não possa ser exibido ele pode ser baixado para a máquina do usuário para poder ser visualizado.

Importando arquivos

É possível importar novos arquivos para a VFS utilizando o botão “Importar arquivo” da grade de arquivos. Ao clicar no botão são apresentadas as opções para envio do arquivo via upload a partir da máquina local do usuário ou via leitura de arquivos em disco no servidor do Engine.

Importante: arquivos textuais importados para a VFS devem ser previamente codificados no formato “windows-1252”, que é o formato padrão utilizado pelo Engine.

Importando via upload

Essa é a opção padrão quando o usuário clica no botão “Importar arquivo”. Ao selecionar essa opção é apresentado ao usuário a janela padrão de upload. É permitida a seleção de até 100 arquivos por importação. Após selecionar os arquivos e clicar em “Enviar”, o sistema mostra uma grade de pre-visualização onde é exibido o diretório de destino selecionado e abaixo dele os arquivos selecionados para importação. O usuário pode então clicar no botão “Confirmar” para efetivar a gravação dos arquivos selecionados no diretório de destino.

Importando do servidor

A segunda opção de importação é ler os arquivos de uma pasta no servidor onde o Engine está instalado. Essa opção pode ser utilizada, por exemplo, quando se deseja importar uma hierarquia de pastas e arquivos para a VFS.

Ao selecionar essa opção o sistema exibe uma grade de parâmetros com o título “Informe o arquivo ou diretório”. O usuário deve informar o caminho completo do arquivo ou pasta que deseja importar e o diretório de destino na VFS. Por padrão o diretório selecionado na grade de diretórios na tela inicial do processo vem preenchido como diretório de destino nos parâmetros da importação.

Há ainda opções para indicar quais extensões de arquivos devem ser ignoradas durante a importação, se os diretórios vazios devem ser importados e se os arquivos e diretórios não existentes devem ser excluídos.

Exportando arquivos

Na grade de arquivos existe o botão “Exportar arquivo” que permite baixar cópias dos arquivos da VFS. Um ou mais arquivos podem ser selecionados na grade e baixados. Se forem selecionados mais de um arquivo o sistema irá baixar um arquivo ZIP contendo todos os arquivos selecionados na grade.

Importante: arquivos textuais exportados e baixados da VFS estarão codificados no padrão “windows-1252”.

Movendo arquivos

Para movimentar arquivos entre diretórios o usuário deve utilizar o botão “Mover arquivos”. Ao clicar no botão é apresentada uma tela com 3 grades. A primeira é uma grade de parâmetros com o titulo “Opções para movimentação de arquivos” contendo campos para informar os diretórios de origem e destino da movimentação. As outras duas grades exibem os arquivos do diretório de origem e do diretório de destino respectivamente.

Após informar os diretórios de origem e destino, devem ser selecionados os arquivos que devem ser movimentados na grade “Arquivos do diretório de origem” e em seguida deve ser pressionado o botão “Confirmar”. A mensagem “Arquivos movidos com sucesso” confirmará a movimentação dos arquivos e a tela inicial do processo será exibida.

Corrigindo inconsistências

Eventualmente arquivos da VFS podem apresentar inconsistências como arquivos órfãos ou com alguma inconsistência nos seus metadados. Esse tipo de situação pode ocorrer quando os arquivos são manipulados diretamente por processos customizados sem a utilização das APIs apropriadas do sistema.

O botão “Verificar integridade” pode ser utilizado para detectar e corrigir automaticamente essas inconsistências. Ao clicar no botão serão feitas as verificações e correções e ao final será exibida uma relação das correções realizadas e os números de versão das gravações realizadas.