Guia de scripting do ACL versão 14.1

Comando DIRECTORY

Gera uma lista de arquivos e pastas no diretório especificado.

DIRECTORY <espec_arquivo> <SUPPRESS> <SUBDIRECTORY> <APPEND> <TO nome_tabela|nome_arquivo>
Nome Descrição
espec_arquivo

opcional

A pasta ou arquivos do Windows cujas informações serão exibidas.

Você pode usar o curinga asterisco (*) para listar todos os arquivos com uma determinada extensão, todos os arquivos que começam com uma determinada cadeia ou todos os arquivos em uma pasta. Por exemplo:

  • *.fil – lista todos os arquivos com a extensão .fil (arquivos de dados do Analytics)
  • Inv*.* – lista todos os arquivos que começam com "Inv", independentemente da sua extensão
  • Resultados\* ou Resultados\*.* - lista todos os arquivos da pasta Resultados

Para limitar os arquivos listados a uma determinada pasta, é possível especificar um caminho relativo à pasta do projeto do Analytics ou especificar um caminho completo. Por exemplo:

  • Resultados\*.* – exibe o conteúdo da subpasta Resultados na pasta do projeto do Analytics
  • C:\ACL Data\Resultados\*.* – exibe o conteúdo da pasta especificada

Nota

O caractere curinga não pode ser usado em níveis intermediários de um caminho de arquivo especificado. Ele somente pode ser usado no nível final do caminho, como mostrado acima.

Os caminhos ou nomes de arquivo que contêm espaços devem estar entre aspas.

Se você usar espec_arquivo, ele deve ser posicionado antes de todos os outros parâmetros. Se espec_arquivo aparecer em qualquer outra posição, o comando DIRECTORY não será processado e será gerado um erro.

Se você omitir espec_arquivo, todos os arquivos da pasta que contém o projeto do Analytics serão listados. Não será possível usar nenhum dos outros parâmetros se espec_arquivo for omitido.

SUPPRESS

opcional

Suprime as informações de caminho nos resultados, deixando somente os nomes de arquivo e propriedades.

SUBDIRECTORY

opcional

Inclui o conteúdo das subpastas na listagem de diretórios.

Por exemplo, se espec_arquivo especificar Resultados\*.fil, a pasta Resultados e todas as subpastas contidas na pasta Resultados serão pesquisadas para encontrar arquivos .fil.

Dependendo do número de subpastas e arquivos que precisam ser listados, o uso de SUBDIRECTORY poderá gerar um atraso enquanto as subpastas forem pesquisadas. O Analytics exibe uma caixa de diálogo que mostra o andamento do comando.

APPEND

opcional

Anexa a saída do comando ao final de um arquivo existente, em vez de sobrescrevê-lo.

Nota

Você deve garantir que a estrutura da saída do comando e o arquivo existente são idênticos:

  • os mesmos campos
  • a mesma ordem de campos
  • os campos correspondentes têm o mesmo comprimento
  • os campos correspondentes têm o mesmo tipo de dados

O Analytics anexa a saída a um arquivo existente, seja qual for sua estrutura. Se a estrutura da saída e do arquivo existente não corresponderem, o resultado poderá ser dados misturados, ausentes ou incorretos.
TO nome_tabela | nome_arquivo

opcional

A localização para onde enviar os resultados do comando:

  • nome_tabela salva os resultados em uma tabela do Analytics

    Especifique nome_tabela como uma cadeia entre aspas com uma extensão de arquivo .FIL. For exemplo: TO "Saída.FIL"

    Por padrão, o arquivo de dados da tabela (.fil) é salvo na pasta que contém o projeto do Analytics.

    Use um caminho de arquivo absoluto ou relativo para salvar o arquivo de dados em uma pasta diferente já existente:

    • TO "C:\Saída.FIL"
    • TO "Resultados\Saída.FIL"

    Nota

    Os nomes de tabela são limitados a 64 caracteres alfanuméricos, sem contar a extensão .FIL. O nome pode incluir o caractere de sublinhado ( _ ) mas nenhum outro caractere especial e nenhum espaço. O nome não pode começar com um número.

  • nome_arquivo salva os resultados em um arquivo

    Especifique nome_arquivo como uma cadeia entre aspas com uma extensão de arquivo apropriada. Por exemplo: TO "Saída.TXT"

    Por padrão, o arquivo é salvo na pasta que contém o projeto do Analytics.

    Use um caminho de arquivo absoluto ou relativo para salvar o arquivo em uma pasta diferente já existente:

    • TO "C:\Saída.TXT"
    • TO "Resultados\Saída.TXT"

Se você omitir TO, a listagem de diretórios será exibida na área de exibição do Analytics.

Opções diferentes para listar arquivos

A capacidade de listar arquivos é útil para investigação ad hoc e para incorporação em scripts.

Veja a seguir várias opções diferentes para listar arquivos com o comando DIRECTORY.

Listar todos os arquivos

Lista todos os arquivos da pasta que contém o projeto do Analytics:

DIRECTORY

Listar todos os arquivos de um tipo especificado

Lista todos os arquivos .fil (arquivos de dados do Analytics) da pasta que contém o projeto do Analytics:

DIRECTORY *.fil

Usar curingas para listar arquivos

Lista todos os nomes de arquivos que começam com "Inv" da pasta que contém o projeto do Analytics:

DIRECTORY Inv*.*

Listar todos os arquivos de uma subpasta relativa à pasta do projeto do Analytics

Lista todos os arquivos da subpasta Resultados da pasta que contém o projeto do Analytics:

DIRECTORY "Resultados\*"

Listar todos os arquivos em uma pasta especificada

Lista todos os arquivos da subpasta Resultados:

DIRECTORY "C:\ACL Data\Resultados\*"

Listar todos os arquivos de um tipo específico em um local especificado

Lista todos os arquivos .fil (arquivos de dados do Analytics) na pasta especificada e em todas as suas subpastas:

DIRECTORY "C:\ACL Data\Resultados\*.fil" SUBDIRECTORY

Listar todos os arquivos em uma pasta especificada e gerar a lista em uma tabela do Analytics

Lista todos os arquivos da pasta Resultados e gera a lista em uma tabela do Analytics da pasta que contém o projeto do Analytics:

DIRECTORY "C:\ACL Data\Resultados\*" TO Conteúdo_Pasta_Resultados.fil

A nova tabela Conteúdo_Pasta_Resultados é adicionada ao projeto aberto.

Listar todos os arquivos em uma pasta e gerar a lista em uma tabela do Analytics em outra pasta

Lista todos os arquivos da pasta ACL Data\Resultados e gera a lista em uma tabela do Analytics da pasta Auditoria LR 2014\Resultados:

DIRECTORY "C:\ACL Data\Resultados\*" TO "C:\Projetos ACL\Auditoria LR 2014\Resultados\Conteúdo_Pasta_Resultados.fil"

A nova tabela Conteúdo_Pasta_Resultados é adicionada ao projeto aberto. O arquivo de dados associado (Conteúdo_Pasta_Resultados.fil) é criado na pasta de saída especificada, que pode ou não ser a pasta que contém o projeto do Analytics.

Propriedades exibidas por DIRECTORY

O comando DIRECTORY é semelhante ao comando DIR no Windows. Além de listar arquivos e subpastas de uma pasta, o comando DIRECTORY também exibe as seguintes propriedades de arquivo e pasta:

  • Tamanho do arquivo
  • Atributos
  • Data de criação
  • Hora de criação
  • Data de acesso
  • Hora de acesso
  • Data de alteração
  • Hora de alteração
  • o número total de arquivos e pastas que correspondem aos critérios especificados

Usos de DIRECTORY em um script

Quando usado em um script, o comando DIRECTORY oferece o recurso de examinar o sistema de arquivos. Por exemplo, você pode usar DIRECTORY juntamente com outros comandos para detectar a presença ou ausência de arquivos, verificar o tamanho de um arquivo ou tomar decisões com base em outras propriedades de arquivo.

Saída dos resultados de DIRECTORY

Você pode executar o comando da linha de comando para exibir uma listagem de diretório na tela ou salvar a listagem em uma tabela ou arquivo .txt do Analytics.

Como abrir os resultados baseados em tabela de DIRECTORY

O comando DIRECTORY não inclui o parâmetro OPEN. Se você usa o comando em um script que gera os resultados em uma tabela do Analytics e deseja abrir a tabela resultante, acrescente o comando OPEN após o comando DIRECTORY. Por exemplo:

DIRECTORY "C:\ACL Data\Resultados\*" TO Conteúdo_Pasta_Resultados.fil 
OPEN Conteúdo_Pasta_Resultados

[ Voltar ao início ]