DIRECTORY 命令

生成指定目录中的文件和文件夹的列表。

语法

DIRECTORY <文件说明> <SUPPRESS> <SUBDIRECTORY> <APPEND> <TO 表名称|文件名>

参数

名称 描述
文件说明

可选

要列出和显示其信息的 Windows 文件夹或文件。

您可以使用星号通配符 (*) 来列出所有具有特定扩展名的文件、所有以特定字符串开头的文件或某个文件夹中的所有文件。 例如：

  • *.fil – 列出所有具有 .fil 扩展名的文件（Analytics 数据文件）
  • Inv*.* – 列出所有以“Inv”开头的文件，而无论它们的文件扩展名是什么
  • 结果\* 或结果\*.* — 列出“结果”文件夹中的所有文件

要将列出的文件限制到特定文件夹，您可以指定一个相对于 Analytics 项目文件夹的路径，或者指定一个完整路径。 例如：

  • 结果\*.* – 显示 Analytics 项目文件夹中的“结果”子文件夹的内容
  • C:\ACL Data\结果\*.* – 显示指定文件夹的内容

说明

在指定文件路径的中间级别不能使用通配符。 只能在该路径的最终级别使用它，如上所示。

包含空格的路径或文件名必须放在双引号中。

如果您使用文件说明，则必须将其放在任何其他参数之前。 如果文件说明出现在任何其他位置，则不会处理 DIRECTORY 命令，并且会生成错误。

如果您省略文件说明，则包含该 Analytics 项目的文件夹中的所有文件都被列出。 如果您省略文件说明，则不能使用任何其他参数。

SUPPRESS

可选

在输出中省略路径信息，仅保留文件名和属性。

SUBDIRECTORY

可选

将子文件夹的内容包括在目录列表中。

例如，如果文件说明指定 Results\*.fil，则将在 Results 文件夹中和该文件夹包含的所有子文件夹中搜索 .fil 文件。

根据需要列出的子文件夹和文件的数目的不同，使用 SUBDIRECTORY 可能导致在搜索子文件夹时发生延迟。 Analytics 会显示一个对话框，表示命令进度。

APPEND

可选

将命令输出附加到现有文件的末尾，而不是覆盖现有文件。

说明

您必须确保命令输出的结构和现有文件完全相同：

  • 相同的域
  • 相同的域顺序
  • 匹配的域具有相同的长度
  • 匹配的域具有相同的数据类型

Analytics 将输出附加到现有文件，而无论其结构如何。 如果输出的结构和现有文件不匹配，则可能生成混乱的、不完整的或不准确的数据。
TO 表名称 | 文件名

可选

要将命令结果发送到的位置：

  • 表名将结果保存到一个 Analytics 表

    请将表名指定为具有 .FIL 文件扩展名的带引号的字符串。 例如：TO "Output.FIL"

    默认情况下，表数据文件 (.FIL) 被保存到包含 Analytics 项目的文件夹。

    请使用绝对或相对文件路径将该数据文件保存到另外的现有文件夹：

    • TO "C:\Output.FIL"
    • TO "Results\Output.FIL"

    说明

    表名称被限制为不超过 64 个字母数字字符（不包括 .FIL 扩展名）。 该名称可以包括下划线字符 ( _ )，但不能包括其他特殊字符或任何空格。 该名称不能以数字开头。

  • 文件名将结果保存至文件

    请将文件名指定为具有适当文件扩展名的带引号的字符串。 例如：TO "Output.TXT"

    默认情况下，该文件被保存到包含 Analytics 项目的文件夹。

    请使用绝对或相对文件路径将该文件保存到另外的现有文件夹：

    • TO "C:\Output.TXT"
    • TO "Results\Output.TXT"

如果您省略 TO，则目录清单会出现在 Analytics 显示区域。

示例

列出文件的不同选项

列出文件的能力对于临时调查很有用，并且可以融入到编写脚本的过程中。

下面显示了使用 DIRECTORY 命令列出文件的一些不同选项。

列出所有文件

列出包含 Analytics 项目的文件夹中的所有文件：

DIRECTORY

列出特定类型的所有文件

列出包含 Analytics 项目的文件夹中的所有 .fil 文件（Analytics 数据文件）：

DIRECTORY *.fil

使用通配符列出文件

列出包含 Analytics 项目的文件夹中所有以 "Inv" 开头的文件名：

DIRECTORY Inv*.*

列出相对于 Analytics 项目文件夹的子文件夹中的所有文件

列出包含 Analytics 项目的文件夹中的结果子文件夹中的所有文件：

DIRECTORY "结果\*"

列出指定文件夹中的所有文件

列出结果子文件夹中的所有文件：

DIRECTORY "C:\ACL Data\结果\*"

列出指定位置中特定类型的所有文件

列出指定文件夹和任何子文件夹中的所有 .fil 文件（Analytics 数据文件）：

DIRECTORY "C:\ACL Data\结果\*.fil" SUBDIRECTORY

列出指定文件夹中的所有文件并且将该列表输出至 Analytics 表

列出结果文件夹中的所有文件，并且将该列表输出至包含该 Analytics 项目的文件夹中的一个 Analytics 表：

DIRECTORY "C:\ACL Data\结果\*" TO 结果文件夹内容.fil

新表Results_Folder_Contents被添加到打开的项目中。

列出一个文件夹中的所有文件并且将该列表输出至另一个文件夹中的 Analytics 表

列出 ACL Data\结果文件夹中的所有文件，并且将该列表输出至 GL Audit 2014\结果文件夹中的一个 Analytics 表：

DIRECTORY "C:\ACL Data\结果\*" TO "C:\ACL Projects\GL Audit 2014\结果\结果文件夹内容.fil"

新表Results_Folder_Contents被添加到打开的项目中。 将在指定的输出文件夹中创建关联的数据文件 (Results_Folder_Contents.fil)，该文件夹可能是或不是包含 Analytics 项目的文件夹。

备注

DIRECTORY 显示的属性

DIRECTORY 命令类似于 Windows 中的 DIR 命令。 除了列出文件夹中的文件和子文件夹以外，DIRECTORY 命令还显示以下文件和文件夹属性：

  • 文件大小
  • 属性
  • 创建日期
  • 创建时间
  • 访问日期
  • 访问时间
  • 修改日期
  • 修改时间
  • 符合指定标准的文件和文件夹的总数量

DIRECTORY 在脚本中的用途

当在脚本中使用时，DIRECTORY 命令提供检查文件系统的能力。 例如，您可以将 DIRECTORY 与其他命令结合使用，以检测文件是否存在，检查文件的大小，或者根据其他文件属性进行决策。

输出 DIRECTORY 的结果

您可以从命令行运行该命令，以便在屏幕上显示目录列表，或者将该列表保存到 Analytics 表或 .txt 文件。

如何打开 DIRECTORY 的基于表的结果

DIRECTORY 命令不包括 OPEN 参数。 如果您在脚本中使用该命令并且将结果输出到 Analytics 表，而且您想要打开产生的表，请在 DIRECTORY 命令后使用 OPEN 命令。 例如：

DIRECTORY "C:\ACL Data\结果\*" TO 结果文件夹内容.fil 
OPEN 结果文件夹内容