文件传输与归档

适用版本：1.0.0。任务 → 新增/编辑 → 插件 FILE_TRANSFER。

入口与准备

使用 ADMIN 创建、配置和保存任务；ADMIN 或 OPERATOR 可以执行已发布定义，详细日志和输入输出变量由 ADMIN 查看。资源必须启用并可被执行节点访问。任务公共超时、重试和版本规则见任务，角色动作见权限矩阵。

字段说明

“默认值”指 1.0.0 新建表单的初始值；空表示尚未填写，不表示必填项可以省略。显示条件决定当前分支中是否出现字段。“条件必填”只在对应分支启用时要求填写。

传输与写入

• 传输模式：选择仅读取或读取后上传到目标。
• 源文件资源：提供要读取的源文件位置与访问方式。
• 目标文件资源：提供上传目标位置与访问方式。
• 源目录（可选）：在源资源允许的路径内选择读取目录。
• 目标目录（可选）：在目标资源允许的路径内选择写入目录。
• 文件匹配：筛选要读取或传输的文件。
• 递归目录：开启后包含子目录中的匹配文件。
• 下载后解压：选择下载后的解压方式。
• 上传前压缩：选择上传前的压缩方式。
• 远端发布方式：选择直接写入或临时文件完成后重命名；能力取决于目标协议。
• 覆盖同名文件：控制是否覆盖目标同名文件。
• 成功后删除源文件：成功后删除源文件；跨系统复制与删除不具备整体事务。
• 压缩包名称（可选）：指定归档输出文件名；仅适用于对应压缩格式。
• 压缩级别：设置 ZIP 压缩级别。

执行限制

• 最大扫描深度：递归扫描的最大目录深度，0–64。
• 扫描条目上限：一次任务最多扫描的目录和文件条目，1–100000。
• 源单文件上限（字节）：单个源文件的字节上限，1–1073741824。
• 源总量上限（字节）：源文件累计字节上限，不小于单文件上限，最多10737418240。
• 临时空间上限（字节）：暂存数据的累计字节上限，1–21474836480。
• 解压条目上限：最多解压条目数，1–100000。
• 解压单项上限（字节）：单个解压条目的字节上限，1024–1073741824。
• 解压总量上限（字节）：解压累计字节上限，不小于单条目上限，最多10737418240。
• 最大压缩比：允许的最大解压压缩比，1–1000。

使用边界

• READ_ONLY不上传且不能删除源文件。
• TEMP_RENAME的完成方式取决于目标协议，不保证所有目标均具备原子发布。
• deleteSource=true时源目标不能为同一资源；跨系统复制与删除不是一笔事务。

新建表单的远端发布方式为 TEMP_RENAME；旧配置缺少 remotePublishMode 时兼容补值为 DIRECT。请按目标协议明确选择，并检查失败时临时文件和最终文件的状态。

典型配置：复制独立目录中的 CSV

按下表填写界面，资源名称需替换为自己的已启用资源。这是配置说明，不是可直接导入的 JSON。完整数据准备与执行步骤见本节末尾教程。

在源目录准备CSV文件，目标为单独空目录；两个LOCAL目录都必须由实际执行Worker访问。

预期结果： 目标存在对应文件，内容/哈希相同，源文件保留。

跟做完整教程。保存定义后再手动执行；实例状态与业务结果分别核对。

真实界面

技术字段对照

以下键名用于导入配置、接口或排障。规则中的 [] 表示集合元素；不需要把这些键名填入界面标签。

相关页面

任务与版本 · 参数与表达式 · 场景教程