自 2021 年 1 月起，经典文件类型不再可用。您可以转换经典文件或下载 PDF 文件。了解更多

Workiva 支持中心

文件实用程序命令

文件实用程序命令

  • 上次更新
<!-- display page content -->

要在基于 Microsoft Windows® 和 Linux® 的操作系统上作为链的一部分访问和处理文件，请使用文件实用工具连接命令添加一个步骤。

要启用这些命令，IT 管理员首先 创建文件实用程序连接。 

校验和

要验证文件是否已损坏或与原始文件不同，请使用 Checksum 命令。可以在多个文件上运行该命令，然后比较它们返回的哈希值，以确定这些文件是否相同。

属性

摘要信息 详细信息
输入文件 输入要检查的文件名。要匹配多个文件，请使用通配符 * 或 ?
校验类型

选择要在输入文件上运行的校验类型。

选项：

  • SHA-256
  • SHA-512
  • CRC32

输出

输出 输出类型
校验和散列值 字串

退出代码

代码 类型 详细信息
0 成功 成功
1 错误 命令失败

整洁的换行

要删除表格文件单元格中多余的换行符，例如在从一个系统输出到另一个系统的过程中，可使用 Clean Line Breaks 命令。

属性

摘要信息 详细信息
来源文件 输入要清理的断线表格文件。
分隔符号 选择 源文件中使用的分隔符。

输出

输出 输出类型
已清理文件 文件

退出代码

代码 类型 详细信息
0 成功 成功
1 错误 命令失败

复制

要复制文件和目录，请使用 Copy 命令。

属性

摘要信息 详细信息
来源 输入要移动的文件或目录的名称。要匹配多个文件或目录，请使用通配符 * 或 ?。
目的地 输入文件或目录的新位置。
覆写 要覆盖现有文件，请选中该复选框。

输出

没有任何

退出代码

代码 类型 详细信息
0 成功 成功
1 错误 无效参数
14 错误 未找到源文件
15 错误 写入目标文件失败
16 错误 无法写入目标文件，因为另一个文件与之同名

创建文件

要创建新文件，请使用 Create File 命令。

属性

摘要信息 详细信息
文本 输入要添加到文件中的文本。
文件路径 输入创建文件的路径。如果将文件作为链中另一条命令的输出，则为可选项。
覆写 要覆盖文件路径上存在的另一个文件，请选中该复选框。

输出

输出 输出类型
创建文件 文件

退出代码

代码 类型 详细信息
0 成功 成功
1 错误 无效参数
15 错误 无效目的地
16 错误 无法写入目标文件，因为另一个文件与之同名

删除

要删除文件或目录，请使用 Delete 命令。

属性

摘要信息 详细信息
文件名称 输入要删除的文件或目录的名称。要匹配多个文件或目录，请使用通配符 * 或 ?。

输出

没有任何

退出代码

代码 类型 详细信息
0 成功 成功
1 错误 无效参数
14 错误 没有发现要删除的文件
17 错误 删除指定文件失败

删除目录

要删除一个或多个目录，请使用 Delete directory 命令。

属性

摘要信息 详细信息
路径 输入要删除的目录名称。要匹配多个目录，请使用通配符 * 或 ?。
递归 要递归删除目录中的文件或文件夹，请选中此复选框。

输出

没有任何

退出代码

代码 类型 详细信息
0 成功 成功
17 错误 删除指定目录失败

查找

要在一个文件或一组文件中搜索文本字符串，请使用 Find 命令。

属性

摘要信息 详细信息
文件 输入要搜索的文件或文件集。
图案 输入要查找的文本字符串。
模式语法 选择对模式使用精确匹配还是 正则表达式 (regex) 语法。
区分大小写 要在搜索模式时考虑字符的大小写，请选中此复选框。
逆 要查找 与模式不 匹配的所有行，请选中该复选框。

输出

输出 输出类型
文件结果 文件
结果 行数 整数

退出代码

代码 类型 详细信息
0 成功 成功
1 错误 无效参数
2 错误 任务失败
14 错误 找不到文件
18 错误 未找到模式

寻找与取代

要在文件中执行查找和替换，请使用 查找和替换 命令。

属性

摘要信息 详细信息
来源 输入要搜索的文件名。
目的地 指定输出原始文件还是副本：
  • 要输出带有更新列值的原始文件，请输入与 Source相同的文件。
  • 要输出包含更新列值的原始文件副本，请输入新文件的名称。
覆写 要覆盖现有目标文件，请选中此框。
查找 输入要查找的文本字符串。
取代 输入要插入匹配位置的文本字符串。
查找语法 选择是使用完全匹配还是 正则表达式 (regex) 语法进行 查找。
区分大小写 要在搜索 查找 模式时考虑字符的大小写，请选中此复选框。

输出

输出 输出类型
替换结果 文件

退出代码

代码 类型 详细信息
0 成功 成功
1 错误 无效参数
2 错误 任务失败
14 错误 找不到文件
15 错误 无效目的地
16 错误 重写错误
18 错误 未找到模式

获取文件

要从本地文件系统检索文件，请使用 Get File 命令。

属性

摘要信息 详细信息
输入文件 输入要检索和创建作为输出的文件。
数据类型 选择 输入文件的内容类型。

输出

输出 输出类型
文件信息 JSON
文件 文件

退出代码

代码 类型 详细信息
0 成功 成功
1 错误 未找到文件

获取文件/文件夹信息

要检索文件或文件夹的文件系统信息，请使用 Get File/Folder Info 命令。

属性

摘要信息 详细信息
文件/文件夹 输入要检索信息的文件或文件夹。

输出

输出 输出类型
文件/文件夹信息 JSON

例如{ "absPath": "/tmp", "name": "tmp", "size"：4096，"mode"：2148532735，"modTime"："2018-09-27T19:31:52Z"，"isDir"：true，"exists"：true }

退出代码

代码 类型 详细信息
0 成功 成功
注： 该命令总是成功执行。如果找不到文件或文件夹， exists 属性将为 false。

Gunzip 文件

要使用 gunzip解压缩 GZIP 压缩包，请使用 Gunzip File 命令。例如，使用此命令解压缩从 Oracle® Hyperion Financial Management (HFM)输出的文件。

属性

摘要信息 详细信息
输入文件 输入要解压缩的 GZIP 压缩包。

输出

输出 输出类型
被压缩的文件 文件

退出代码

代码 类型 详细信息
0 成功 成功
1 错误 命令失败

Gzip 文件

要使用 gzip压缩文件，请使用 Gzip File 命令。

属性

摘要信息 详细信息
输入文件 输入要压缩的文件。

输出

输出 输出类型
压缩文件 文件

退出代码

代码 类型 详细信息
0 成功 成功
1 错误 命令失败

列表目录

要列出一个目录的内容，请使用 List Directory 命令。

属性

摘要信息 详细信息
路径 输入要列出的目录路径。
输出格式 选择输出格式。要包含标题和摘要信息，请选择 "完整"。

输出

输出 输出类型
找到的文件列表 阵列
结果文件 CSV
注意：找到的文件列表 输出限于 500 个项目；对于较大的操作，应使用 结果文件 输出。

退出代码

代码 类型 详细信息
0 成功 成功
1 错误 无效参数
14 错误 未找到目录

列出文件内容

要列出文件内容，请使用 List File Content 命令。

注意： 该命令不能返回大于 64KB 的单行。

属性

摘要信息 详细信息
文件名称 输入要检查的文件名。
预览线 对于大文件，请输入要预览的文件行数。您可以使用 Offset 字段设置预览的起始线。

要预览文件， ，在监视器屏幕上查看命令输出。
偏移 开始预览的行号。该值为 0，因此要从文件开头打印，请使用 0。


范例

下图显示 5 预览行，偏移量为 5。请注意，由于偏移量从 0 开始，因此显示的第一行实际上是 6。

Snag_1767227.png
Outputs

输出 输出类型
文件 文件
文件文本 字串

退出代码

代码 类型 详细信息
0 成功 成功
1 错误 无效参数
14 错误 找不到文件
20 警告 文件过大或非人工可读

制作目录

要创建目录，请使用 Make Directory 命令。

属性

摘要信息 详细信息
目录 输入要创建的目录名称。

输出

没有任何

退出代码

代码 类型 详细信息
0 成功 成功
1 错误 无效参数
15 错误 创建目录失败
16 警告 远程目录已存在

移动

要移动文件或目录，请使用 Move 命令。

属性

摘要信息 详细信息
来源 输入要移动的文件或目录的名称。要匹配多个文件或目录，请使用通配符 * 或 ?。
目的地 输入文件或目录的新位置。
覆写 要覆盖现有文件，请选中该复选框。

输出

没有任何

退出代码

代码 类型 详细信息
0 成功 成功
1 错误 无效参数
2 错误 任务失败
14 错误 未找到源文件

分割文件

要根据字节大小、行数或 正则表达式 (RegExp) 分隔符将文件分割成多个文件块，请使用 Split File 命令。例如，使用此命令并行处理较小的文件，以帮助提高性能

属性

摘要信息 详细信息
输入文件 输入要分割成多块的文件。
分体式 按字节、行或 RegExp 选择分割输入文件的方式
值 根据 Split type输入分割输入文件的值：
  • 如果是字节，请输入文件块的最大文件大小。
  • 如果是行，请输入要包含在文件块中的最大行数。
  • 如果是 RegExp，请输入表示何时创建新块的正则表达式。
包含 RegExp 匹配 如果 分割类型 为 RegExp，则选择是否在生成的块中包含与 值 匹配的行。

输出

输出 输出类型
分割文件块 文件
文件数量 整数

退出代码

代码 类型 详细信息
0 成功 成功
1 错误 无效参数

堆栈文件

要将多个非对称文件堆叠在一起，请使用 Stack Files 命令。

注意： 使用 表格转换 连接器，可以使用 堆叠文件 命令堆叠列数相同的对称文件。

属性

摘要信息 详细信息
输入文件 输入要堆叠的文件。

输出

输出 输出类型
堆叠文件 文件

退出代码

代码 类型 详细信息
0 成功 成功
1 错误 无效参数

带状线

要根据提供的行号删除文件中的行，请使用 Strip Lines 命令。

属性

摘要信息 详细信息
来源文件 输入要删除行数的文件。
剥线 输入要剥离的单行或范围行列表。例如，范围为 3:10 会删除文件中的第 3 行至第 10 行。

输出

输出 输出类型
脱行输出文件 文件

退出代码

代码 类型 详细信息
0 成功 成功
1 错误 无效参数
2 错误 一般故障

柏油

要创建磁带存档 (TAR) 文件，请使用 Tar 命令。

属性

摘要信息 详细信息
档案名称 输入要创建的 TAR 文件的名称。
源文件 输入要添加到 TAR 文件的文件或目录的名称。要指定多个文件或目录，请使用逗号或通配符。
覆写 要覆盖现有 TAR 文件，请选中该复选框。

输出

输出 输出类型
TAR 档案 文件

退出代码

代码 类型 详细信息
0 成功 成功
1 错误 无效参数
16 错误 创建存档失败

UTF-8 编码

要将文件转换为 Unicode Transformation Format-8-bit (UTF-8) 编码，请使用 UTF-8 Encode 命令。

属性

摘要信息 详细信息
来源文件 输入要移动的文件或目录的名称。要匹配多个文件或目录，请使用通配符 * 或 ?。
源编码 输入 源文件的编码，如 uft-16 或 windows-1251。

输出

输出 输出类型
UTF-8 文件 文件

退出代码

代码 类型 详细信息
0 成功 成功
1 错误 无效参数
2 错误 命令失败

乌塔尔

要解压 TAR 文件，请使用 Untar 命令。

属性

摘要信息 详细信息
存档 输入要解压的 TAR 文件的名称。
目的地 输入要解压压缩包的目录名称。
覆写 要在解压缩时覆盖现有文件，请选中此复选框。

输出

没有任何

退出代码

代码 类型 详细信息
0 成功 成功
1 错误 无效参数
2 错误 解压缩失败
14 错误 未找到存档
16 错误 重写错误

解压缩

要解压 ZIP 或 GZIP 压缩包，请使用 Unzip 命令。

注： 该命令需要使用 GroundRunner。

属性

摘要信息 详细信息
存档 输入要解压的压缩包名称。
目的地 输入要解压压缩包的目录名称。
覆写 要在解压缩时覆盖现有文件，请选中此复选框。

输出

没有任何

退出代码

代码 类型 详细信息
0 成功 成功
1 错误 无效参数
2 错误 解压缩失败
14 错误 未找到存档
16 错误 重写错误

压缩

要创建 ZIP、GZIP 或 GZIP+TAR 存档，请使用 Zip 命令。

属性

摘要信息 详细信息
档案名称 输入要创建的存档名称。文件扩展名决定压缩算法：
  • 对于 ZIP， .zip 或 .z
  • 对于 GZIP， .gzip 或 .gz
  • 对于 GZIP+TAR， .tgz
目的地 输入要解压压缩包的目录名称。
覆写 要覆盖现有存档，请选中此框。

输出

输出 输出类型
压缩文件 文件

退出代码

代码 类型 详细信息
0 成功 成功
1 错误 无效参数
16 错误 创建存档失败
这篇文章有帮助吗？
1 人中有 1 人觉得有帮助
<!-- display page content --> 要在基于 Microsoft Windows® 和 Linux® 的操作系统上作为链的一部分访问和处理文件，请使用文件实用工具连接命令添加一个步骤。 要启用这些命令，IT...