Commande DIRECTORY

Génère une liste de fichiers et de dossiers dans le répertoire spécifié.

Syntaxe

DIRECTORY <spéc_fichier> <SUPPRESS> <SUBDIRECTORY> <APPEND> <TO nom_table|nom_fichier>

Paramètres

Nom Description
spéc_fichier

optionnel

Dossier Windows ou fichiers à afficher et pour lesquels les informations doivent être affichées.

Vous pouvez utiliser le caractère générique astérisque (*) pour obtenir les noms de tous les fichiers qui ont une extension spécifique, de tous les fichiers qui commencent par une chaîne particulière, ou de tous les fichiers d'un répertoire. Par exemple :

  • *.fil : répertorie tous les noms de fichiers avec l'extension .fil (fichiers de données Analytics)
  • Inv*.* : inclut tous les fichiers commençant par « Inv », quelle que soit l'extension de fichier.
  • Résultats\* ou Résultats\*.* permet d'obtenir les noms de tous les fichiers du répertoire Résultats.

Pour restreindre le nombre de fichiers répertoriés dans un dossier particulier, vous pouvez spécifier un chemin d'accès relativement au dossier de projet Analytics ou spécifier un chemin d'accès complet. Par exemple :

  • Résultats\*.* : affiche le contenu du sous-répertoire Résultats dans le dossier du projet Analytics
  • C:\ACL Data\Résultats\*.* : affiche le contenu du dossier spécifié

Remarque

Le caractère générique ne peut pas être utilisé dans les niveaux intermédiaires d'un chemin de fichier spécifié. Il peut être uniquement utilisé au dernier niveau du chemin, comme indiqué ci-dessus.

Les chemins d'accès ou noms de fichiers contenant des espaces doivent être entourés de doubles guillemets.

Si vous utilisez spéc_fichier, ce paramètre doit être placé avant n'importe quel autre paramètre. Si spéc_fichier s'affiche à une autre place, la commande DIRECTORY n'est pas traitée et une erreur est générée.

Si vous ignorez spéc_fichier, vous obtenez les noms de tous les fichiers du dossier contenant le projet Analytics. Vous ne pouvez utiliser aucun des autres paramètres si vous ignorez spéc_fichier.

SUPPRESS

optionnel

Supprime les informations sur le chemin d'accès dans la sortie, en laissant uniquement les noms de fichier et les propriétés.

SUBDIRECTORY

optionnel

Inclut le contenu des sous-répertoires dans la liste des fichiers du répertoire.

Par exemple, si spéc_fichier indique Résultats\*.fil, les fichiers .fil sont recherchés dans le dossier Résultats et dans tous les sous-répertoires du dossier Résultats.

Selon le nombre de sous-répertoires et de fichiers à rechercher, l'utilisation de SUBDIRECTORY peut ralentir l'analyse des sous-répertoires. Analytics affiche une boîte de dialogue qui indique la progression de la commande.

APPEND

optionnel

Ajoute la sortie de commande à la fin d'un fichier existant au lieu de remplacer ce fichier.

Remarque

Vous devez vous assurer que la structure de la sortie de la commande et du fichier existant est identique :

  • les mêmes champs
  • le même ordre des champs
  • les champs correspondants ont la même longueur
  • les champs correspondants ont le même type de données

Analytics ajoute la sortie à un fichier existant sans tenir compte de sa structure, ce qui peut désordonner les données si la structure de la sortie et du fichier existant ne correspond pas.

TO nom_table | nom_fichier

optionnel

Emplacement vers lequel envoyer les résultats de la commande :

  • nom_table enregistre les résultats dans une table Analytics

    Indiquez nom_table sous forme de chaîne entre guillemets avec une extension de fichier .FIL. Par exemple : TO "Sortie.FIL"

    Par défaut, le fichier de données de table (.FIL) est enregistré dans le dossier contenant le projet Analytics.

    Utilisez un chemin de fichier absolu ou relatif pour enregistrer le fichier de données dans un autre dossier existant :

    • TO "C:\Sortie.FIL"
    • TO "Résultats\Sortie.FIL"

    Remarque

    La longueur des noms des tables est limitée à 64 caractères alphanumériques, sans l'extension .FIL. Le nom peut inclure le caractère de soulignement ( _ ), mais aucun autre caractère spécial ni espace. Le nom ne peut pas commencer par un chiffre.

  • nom_fichier enregistre les résultats dans un fichier

    Indiquez nom_fichier sous forme de chaîne entre guillemets avec l'extension de fichier appropriée. Par exemple : TO "Sortie.TXT"

    Par défaut, le fichier est enregistré dans le dossier contenant le projet Analytics.

    Utilisez un chemin de fichier absolu ou relatif pour enregistrer le fichier dans un autre dossier existant :

    • TO "C:\Sortie.TXT"
    • TO "Résultats\Sortie.TXT"

Si vous ignorez TO, la liste des fichiers du répertoire s'affiche dans la zone d'affichage Analytics.

Exemples

Différentes options pour dresser la liste des fichiers

Il est utile d'avoir une liste de fichiers pour des enquêtes ponctuelles et pour les intégrer à un script.

Un certain nombre d'options différentes permettant de dresser une liste de fichiers avec la commande DIRECTORY apparaît ci-dessous.

Lister tous les fichiers

Liste tous les fichiers du dossier contenant le projet Analytics :

DIRECTORY

Lister tous les fichiers d'un type spécifique

Liste tous les fichiers .fil (fichiers de données Analytics) du dossier contenant le projet Analytics :

DIRECTORY *.fil

Utiliser des caractères génériques pour lister des fichiers

Liste tous les noms de fichiers commençant par "Inv" dans le dossier contenant le projet Analytics :

DIRECTORY Inv*.*

Lister tous les fichiers d'un sous-répertoire relatif au dossier de projet Analytics

Liste tous les fichiers du sous-répertoire Résultats dans le dossier contenant le projet Analytics :

DIRECTORY "Résultats\*"

Lister tous les fichiers dans un dossier spécifié

Liste tous les fichiers dans le sous-répertoire Résultats :

DIRECTORY "C:\ACL Data\Résultats\*"

Lister tous les fichiers d'un type spécifique à un emplacement indiqué

Liste tous les fichiers .fil (fichiers de données Analytics) du dossier spécifié ainsi que tous les sous-répertoires :

DIRECTORY "C:\ACL Data\Résultats\*.fil" SUBDIRECTORY

Lister tous les fichiers dans un dossier spécifié et sortir la liste dans une table Analytics

Liste tous les fichiers du dossier Résultats et sort la liste dans une table Analytics dans le dossier contenant le projet Analytics :

DIRECTORY "C:\ACL Data\Résultats\*" TO Contenu_Dossier_Résultats.fil

La nouvelle table Contenu_Dossier_Résultats est ajoutée au projet ouvert.

Lister tous les fichiers dans un dossier et sortir la liste dans une table Analytics d'un autre dossier

Liste tous les fichiers du dossier ACL Data\Résultats et sort la liste dans une table Analytics dans le dossier GL Audit 2014\Résultats :

DIRECTORY "C:\ACL Data\Résultats\*" TO "C:\ACL Projects\GL Audit 2014\Résultats\Contenu_Dossier_Résultats.fil"

La nouvelle table Contenu_Dossier_Résultats est ajoutée au projet ouvert. Le fichier de données associé (Contenu_Dossier_Résultats.fil) est créé dans le dossier de sortie spécifié, qui peut être ou non le dossier contenant le projet Analytics.

Remarques

Propriétés affichées par DIRECTORY

La commande DIRECTORY est semblable à la commande DIR de Windows. En plus d'obtenir les noms des fichiers et des sous-répertoires dans un dossier, la commande DIRECTORY permet également d'afficher les propriétés de fichiers et de répertoires suivantes :

  • Taille du fichier
  • Attributs
  • Date de création
  • Heure de création
  • Date d'accès
  • Heure d'accès
  • Date de modification
  • Heure de modification
  • le nombre total de fichiers et de répertoires qui correspondent aux critères spécifiés

Utilisations de DIRECTORY dans un script

Lorsqu'elle est utilisée dans un script, la commande DIRECTORY donne la possibilité d'examiner le système de fichiers. Par exemple, vous pourriez utiliser DIRECTORY en association avec d'autres commandes pour détecter la présence ou l'absence de fichiers, vérifier la taille d'un fichier ou prendre des décisions en fonction d'autres propriétés de fichiers.

Sortie des résultats de DIRECTORY

Vous pouvez exécuter la commande à partir de la ligne de commande pour afficher une liste de fichiers contenus dans un répertoire à l'écran, ou sauvegarder la liste dans une table Analytics ou un fichier .txt.

Comment ouvrir les résultats de table de DIRECTORY

La commande DIRECTORY n'inclut pas le paramètre OPEN. Si vous utilisez la commande dans un script et que vous envoyez les résultats vers une table Analytics, et que vous souhaitez ouvrir la table créée, suivez la commande DIRECTORY de la commande OPEN. Par exemple :

DIRECTORY "C:\ACL Data\Résultats\*" TO Contenu_Dossier_Résultats.fil 
OPEN Contenu_Dossier_Résultats
Guide de création de scripts ACL 14.1