1. 概述
1.1 版本
| FineDataLink 版本 | 功能说明 |
|---|---|
| 4.1.5.5 | - |
1.2 应用场景
简道云/API附件移动：用户想要将简道云/API接口中的附件做数据归档，下载附件同步至FTP服务器或本地或其他业务系统（API接口）；
FTP/本地间文件移动：FTP文件读取后移动至FTP其他文件夹做备份。
注：简道云附件需要首先使用简道云输入节点获取附件下载 URL 在进行文件传输，详情参见本文第四章最佳实践。
1.3 功能简介
FineDataLink 支持使用「文件传输」节点，进行多种类型的下载/上传文件：API下载/上传、本地、FTP/SFTP服务器。
注：仅对文件流本身做同步，而非取文件内容数据。
注：该节点不受脏数据阈值的控制，遇到脏文件就报错。
| 支持传输的文件类型 |
|---|
| 文件类型支持 Excel ，可填写后缀名：.xls、.xlsx、.XLS、.XLSX |
文件类型支持 CSV 时，可填写后缀名：csv、CSV、txt、TXT、tsv、log、dt（csv 和 xml 混合格式）/dbf 等。 |
| 自定义文件类型：可读取 xml、json、png、mp4 等后缀的文件类型。 |
2. 前提条件
若需要使用服务器本地目录或者FTP/SFTP作为文件来源或者去向，需要首先新建数据连接，详情参见：配置服务器本地目录数据连接、配置FTP/SFTP数据连接
3. 功能说明
3.1 文件来源
3.1.1 API
数据源选择 API，则可以获取 API 接口附件。该方式默认为下载文件，不限制文件后缀类型，若 API 不是下载文件则运行后端报错。
3.1.2 FTP/SFTP
数据源选择文件输入-FTP/SFTP，则可以获取服务器下的文件。
读取方式支持：「文件读取」和「文件夹读取」
当读取方式选择为「文件读取」，「文件地址」支持使用参数。
注1：读取文件后缀不区分大小写，根据用户手动输入文件后缀读取文件，支持写多种格式，以逗号为分隔符（自动获取（FTP/SFTP）/手动上传(本地)），跳过路径下非该格式文件。
注2：「读取文件后缀」中不限制文件后缀类型。
当读取方式选择为「文件夹读取」，「文件夹地址」支持指定文件夹读取，同时也支持使用参数。
| 配置项 | 说明 |
|---|---|
| 文件夹地址 | 可选择有权限的文件夹，支持使用参数，使用方法与文件输入相同。 |
| 读取子文件夹 | 勾选时，读取时包括子文件夹中的文件。 不勾选，读取时忽略子文件夹中的文件。 |
| 文件筛选条件 | 在选择「文件夹读取」时显示。 允许配置筛选条件过滤文件夹下的多个文件，获取符合要求的部分文件进行读取。 文件筛选条件仅在配置文件夹的情况下生效。 支持添加条件，支持为文件名（包含后缀）、文件修改时间指定筛选条件：
支持通过参数筛选，判断逻辑说明详情参见：条件判断逻辑说明 |
注：勾选「读取子文件」按钮后，子文件不同路径下重名，例如文件夹a下有以下路径：
文件夹a/子文件b/文件c
文件夹a/子文件b/文件d
文件夹a/文件c
此时处理方式为：传输的文件名称默认命名为b_c，b_d，c，在「文件去向」Tab 中遵循文件上传重名策略。
3.1.3 本地服务器目录
数据源选择文件输入-本地服务器目录，则可以获取 FineDataLink 本地服务器下的文件。
读取方式支持：「文件读取」和「文件夹读取」，且允许使用参数。
指定文件夹方式：仅允许选择数据连接自身文件夹及其子文件夹。
注：「读取文件后缀」中不限制文件后缀类型。
3.2 文件去向
3.2.1 API输出
数据源选择 API，则可以上传附件到 API 接口。和API输出算子配置保持一致，但是 body 中仅支持 binary 类型。
| 配置项 | 说明 |
|---|---|
| 请求方式 | 请求方式支持POST、PUT、DELETE、PATCH |
| URL | 默认为空，支持输入参数 |
| Headers | 对应的Content-Type默认为：application/octet-stream，限制不可更改 |
| 其他说明 | 配置默认为：获取前置文件下载值 只允许传入值有一行值，超过1行时，运行报错；若用户要上传多个文件，则需要使用循环容器节点。 一般用来上传文件，由于没有键值，所以一次只能上传一个文件。 |
3.2.2 FTP/SFTP
数据源选择文件输出-FTP/SFTP，则可以将文件上传至指定服务器。
输入文件夹地址，并设置上传后的文件名以及上传文件的重名策略，如下图所示：
| 配置项 | 说明 |
|---|---|
| 文件夹地址 | 填写文件输出目录，将以「数据连接」中所选路径作为写入目录。 文件目录支持使用参数和直接选择两种方式：
|
| 文件名 |
|
| 文件重名策略 | 提供写入服务器时文件重名时的处理策略
|
3.2.3 本地服务器目录
除文件夹地址必须选择数据连接自身文件夹及其子文件夹，其余与 FTP/SFTP 相同。
