Comando DIRECTORY
Gera uma lista de arquivos e pastas no diretório especificado.
Sintaxe
DIRECTORY <espec_arquivo> <SUPPRESS> <SUBDIRECTORY> <APPEND> <TO nome_tabela|nome_arquivo>
Parâmetros
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:
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:
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:
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:
Se você omitir TO, a listagem de diretórios será exibida na área de exibição do Analytics. |
Exemplos
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.
Observações
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:
|
|
|
|
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