FTP
使用 FTP 操作组上传和下载文件以及操作 FTP 服务器上的目录。
要建立 FTP 连接，请使用打开 FTP 连接操作。 以下示例具有指定的主机、端口和凭据。 此外，如果未按时建立连接，设置的超时会使操作失败。
使用从 FTP 下载文件操作下载文件。 以下示例显示了正在使用的连接变量和选定的目标文件夹。 还指定了远程文件，并将其设置为覆盖同一位置中的现有文件。
通过使用将文件上传到 FTP 操作并指定文件和远程位置上传文件。
打开 FTP 连接
此操作将与远程 FTP 服务器建立特定连接，并将该连接存储为变量以供日后使用。
| 参数 |
可选 |
接受 |
默认值 |
说明 |
| Host |
否 |
文本值 |
|
在此处输入 FTP 服务器地址。 |
| Port |
是 |
数值 |
21 |
在此处输入 FTP 服务器端口。 |
| Active mode |
不适用 |
布尔值 |
假 |
指定连接的模式 |
| Username |
否 |
文本值 |
|
指定要使用的 FTP 帐户的用户名 |
| 密码 |
是 |
直接加密的输入或文本值 |
|
指定要使用的 FTP 帐户的密码 |
| 超时 |
是 |
数值 |
10 |
设置您希望在操作失败之前等待连接建立的时间(以秒为单位) |
生成的变量
| 参数 |
类型 |
说明 |
| FTPConnection |
FTP 连接 |
FTP 连接 |
异常
| 例外 |
描述 |
| 登录失败错误 |
指示登录失败 |
| 连接错误 |
指示连接出现问题 |
列出 FTP 目录
此操作返回 FTP 连接的当前目录中包含的子目录和文件。
| 参数 |
可选 |
接受 |
默认值 |
说明 |
| Connection |
否 |
FTP 连接 |
|
FTP 连接 |
| Path |
是 |
文本值 |
|
要列出的路径。 |
生成的变量
异常
| 例外 |
说明 |
| 列表错误 |
指示无法执行文件夹的列表 |
| 未连接错误 |
指示 FTP 服务器没有打开的连接 |
| 目录不存在错误 |
指示找不到目录 |
打开安全 FTP 连接
此操作将建立与远程 FTP 服务器的特定安全连接，并将该连接存储为变量以供日后使用。
| 参数 |
可选 |
接受 |
默认值 |
说明 |
| Host |
否 |
文本值 |
|
在此处输入 FTP 服务器地址。 |
| Port |
是 |
数值 |
22 |
在此处输入 FTP 服务器端口。 |
| Active mode |
不适用 |
布尔值 |
真 |
指定连接的模式 |
| Secure FTP Protocol |
不适用 |
SFTP、显式 FTPS、隐式 FTPS |
SFTP |
选择希望用于加密连接的 FTP 协议 |
| Authentication method |
不适用 |
用户名和密码、私钥、私钥和密码 |
用户名和密码 |
选择您希望用于在 FTP 服务器上对自己进行身份验证的方法 |
| User name |
否 |
文本值 |
|
指定要使用的 FTP 帐户的用户名 |
| 密码 |
是 |
直接加密的输入或文本值 |
|
指定希望使用的 FTP 帐户的密码 |
| Path to private key |
否 |
文本值 |
|
输入用于身份验证的私钥的文件路径 |
| 私钥密码 |
是 |
直接加密的输入或文本值 |
|
在此处输入包含私钥密码的变量 |
| Timeout |
是 |
数值 |
10 |
设置您希望在操作失败之前等待连接建立的时间(以秒为单位) |
生成的变量
| 参数 |
类型 |
说明 |
| SftpConnection |
FTP 连接 |
SFTP 连接 |
异常
| 例外 |
描述 |
| 登录失败错误 |
指示登录失败 |
| 连接错误 |
指示连接出现问题 |
关闭连接
此操作将关闭打开的 FTP 连接。
| 参数 |
可选 |
接受 |
默认值 |
说明 |
| Connection |
否 |
FTP 连接 |
|
FTP 连接 |
生成的变量
此操作不会生成任何变量。
异常
| 例外 |
说明 |
| 未连接错误 |
指示 FTP 服务器没有打开的连接 |
更改工作目录
此操作可设置 FTP 连接的当前工作目录。
| 参数 |
可选 |
接受 |
默认值 |
说明 |
| Connection |
否 |
FTP 连接 |
|
FTP 连接 |
| Set working directory to |
否 |
文本值 |
|
设置要设为工作目录的路径 |
生成的变量
此操作不会生成任何变量。
异常
| 例外 |
说明 |
| 未连接错误 |
指示 FTP 服务器没有打开的连接 |
| 目录不存在错误 |
指示找不到目录 |
| 无法更改工作目录错误 |
指示无法更改工作目录 |
从 FTP 下载文件
从 FTP 服务器下载一个或多个文件。
| 参数 |
可选 |
接受 |
默认值 |
说明 |
| FTP connection |
否 |
FTP 连接 |
|
要使用的 FTP 连接。 必须在打开 FTP 连接操作中预先指定此变量 |
| Download into folder |
否 |
文件夹 |
|
所要下载的文件的目标文件夹 |
| 要下载的文件 |
否 |
FTP 文件列表 |
|
要下载的文件 |
| 传输类型 |
不适用 |
自动、二进制、ASCII |
自动 |
输入 ASCII 或二进制数据以指定下载单个文件的方式。 如果不确定文件类型或下载了多个文件，请选择“自动”以遵循选项中指定的传输规则 |
| If file exists |
不适用 |
覆盖、不下载、使用唯一名称下载 |
覆盖 |
指定文件已存在时要执行的操作。 覆盖原始文件上的内容，以便不再访问，“下载时使用唯一名称”并在末尾添加下划线和序列号 |
生成的变量
此操作不会生成任何变量。
异常
| 例外 |
说明 |
| 未连接错误 |
指示 FTP 服务器没有打开的连接 |
| 远程文件不存在错误 |
指示 FTP 服务器上不存在文件 |
| 目录不存在错误 |
指示找不到目录 |
| FTP 连接中止错误 |
指示 FTP 连接已中止 |
| 无法下载文件错误 |
指示无法下载文件 |
从 FTP 下载文件夹
从 FTP 服务器下载一个或多个文件夹。
| 参数 |
可选 |
接受 |
默认值 |
说明 |
| FTP connection |
否 |
FTP 连接 |
|
要使用的 FTP 连接。 必须在打开 FTP 连接操作中预先指定此变量 |
| Folder(s) to download |
否 |
FTP 目录列表 |
|
要下载的文件夹路径或 FTP 文件夹名称 |
| Download into local folder |
否 |
文件夹 |
|
您下载的 FTP 文件夹的完整目标路径 |
生成的变量
此操作不会生成任何变量。
异常
| 例外 |
说明 |
| 未连接错误 |
指示 FTP 服务器没有打开的连接 |
| 远程目录不存在错误 |
指示 FTP 服务器上不存在目录 |
| 目录不存在错误 |
指示找不到目录 |
| FTP 连接中止错误 |
指示 FTP 连接已中止 |
| 无法下载目录错误 |
指示无法下载目录 |
将文件上传到 FTP
将一个或多个文件上传到 FTP 服务器。
| 参数 |
可选 |
接受 |
默认值 |
说明 |
| FTP connection |
否 |
FTP 连接 |
|
要使用的 FTP 连接。 必须在打开 FTP 连接操作中预先指定此变量 |
| File(s) to upload |
否 |
文件列表 |
|
要上传的文件 |
| Remote location |
是 |
文本值 |
|
文件应上传到的位置 |
| Transfer type |
不适用 |
自动、二进制、ASCII |
自动 |
输入 ASCII 或二进制数据以指定下载单个文件的方式。 如果不确定文件类型或下载了多个文件，请选择“自动”以遵循选项中指定的传输规则 |
| If file exists |
不适用 |
覆盖、不下载、使用唯一名称下载 |
覆盖 |
指定文件已存在时要执行的操作。 覆盖原始文件上的内容，以便不再访问，“下载时使用唯一名称”将在末尾添加下划线和序列号 |
生成的变量
此操作不会生成任何变量。
异常
| 例外 |
说明 |
| 未连接错误 |
指示 FTP 服务器没有打开的连接 |
| 找不到文件错误 |
指示找不到文件 |
| FTP 连接中止错误 |
指示 FTP 连接已中止 |
| 上传文件错误 |
指示无法上传文件 |
将文件夹上传到 FTP
将一个或多个文件夹上传到 FTP 服务器。
| 参数 |
可选 |
接受 |
默认值 |
说明 |
| FTP connection |
否 |
FTP 连接 |
|
要使用的 FTP 连接。 必须在打开 FTP 连接操作中预先指定此变量 |
| Folder(s) to upload |
否 |
文件夹列表 |
|
要上载的文件夹。 要上传的文件夹不应已存在于 FTP 服务器的 Active Directory 中 |
| Remote location |
否 |
文本值 |
|
文件夹应上传到的位置 |
生成的变量
此操作不会生成任何变量。
异常
| 例外 |
说明 |
| 未连接错误 |
指示 FTP 服务器没有打开的连接 |
| 远程目录不存在错误 |
指示 FTP 服务器上不存在目录 |
| FTP 连接中止错误 |
指示 FTP 连接已中止 |
| 上传目录错误 |
指示无法上传目录 |
删除 FTP 文件
从 FTP 服务器中删除一个或多个文件。
| 参数 |
可选 |
接受 |
默认值 |
说明 |
| FTP connection |
否 |
FTP 连接 |
|
要使用的 FTP 连接。 必须在打开 FTP 连接操作中预先指定此变量 |
| 要删除的文件 |
否 |
FTP 文件列表 |
|
要删除的文件 |
生成的变量
此操作不会生成任何变量。
异常
| 例外 |
说明 |
| 未连接错误 |
指示 FTP 服务器没有打开的连接 |
| 找不到文件错误 |
指示找不到文件 |
| 无法删除文件错误 |
指示无法删除文件 |
重命名 FTP 文件
对位于 FTP 服务器上的文件进行重命名。
| 参数 |
可选 |
接受 |
默认值 |
说明 |
| FTP connection |
否 |
FTP 连接 |
|
要使用的 FTP 连接。 必须在打开 FTP 连接操作中预先指定此变量 |
| 要重命名的文件 |
否 |
FTP 文件 |
|
要重命名的文件 |
| 新文件名 |
否 |
文本值 |
|
文件的新名称。 输入包含文件将移动至的路径的名称。 如果该位置不存在，此操作将引发异常 |
生成的变量
此操作不会生成任何变量。
异常
| 例外 |
说明 |
| 未连接错误 |
指示 FTP 服务器没有打开的连接 |
| 无法重命名文件错误 |
指示无法重命名文件 |
| 找不到文件错误 |
指示找不到文件 |
创建 FTP 目录
在 FTP 服务器上创建目录。
| 参数 |
可选 |
接受 |
默认值 |
说明 |
| FTP connection |
否 |
FTP 连接 |
|
要使用的 FTP 连接。 必须在打开 FTP 连接操作中预先指定此变量 |
| New directory |
否 |
FTP 目录 |
|
新目录。 如果指定了路径，系统将创建指向此新目录的所有新文件夹 |
生成的变量
此操作不会生成任何变量。
异常
| 例外 |
说明 |
| 拒绝访问错误 |
指示此帐户无权执行某项操作 |
| 文件存在错误 |
指示该文件已存在 |
| 创建目录错误 |
指示无法创建目录 |
| 目录不存在错误 |
指示找不到目录 |
| 未连接错误 |
指示 FTP 服务器没有打开的连接 |
删除 FTP 目录
从 FTP 服务器中删除目录。
| 参数 |
可选 |
接受 |
默认值 |
说明 |
| FTP connection |
否 |
FTP 连接 |
|
要使用的 FTP 连接。 必须在打开 FTP 连接操作中预先指定此变量 |
| Directory to delete |
否 |
FTP 目录 |
|
要删除的文件夹。 文件夹中的所有内容也都会删除 |
生成的变量
此操作不会生成任何变量。
异常
| 例外 |
说明 |
| 删除目录错误 |
指示无法删除目录 |
| 远程目录不存在错误 |
指示 FTP 服务器上不存在目录 |
| 工作目录更改错误 |
指示工作目录无法更改 |
| 未连接错误 |
指示 FTP 服务器没有打开的连接 |
调用 FTP 命令
在服务器上调用给定的文字 FTP 命令。
| 参数 |
可选 |
接受 |
默认值 |
说明 |
| FTP connection |
否 |
FTP 连接 |
|
要使用的 FTP 连接。 必须在打开 FTP 连接操作中预先指定此变量 |
| FTP command |
否 |
文本值 |
|
与任何参数一起运行的命令。 例如，您可以在这里运行 FEAT 或 CHMOD |
| Valid reply code(s) |
是 |
文本值 |
|
可通过命令返回的代码，使用分号分隔。 如果 FTP 命令返回未在此处输入的代码，此操作将引发异常。 仅适用于简单 FTP 或 FTPS 连接 |
生成的变量
| 参数 |
类型 |
说明 |
| ReplyCode |
文本值 |
返回的实际代码。 仅适用于简单 FTP 或 FTPS 连接 |
| ReplyText |
文本值 |
FTP 服务器返回的文本 |
异常
| 例外 |
说明 |
| 调用命令错误 |
指示调用 FTP 命令时出错 |
| 未连接错误 |
指示 FTP 服务器没有打开的连接 |
同步目录
将给定文件夹的文件和子目录与给定的远程 FTP 目录进行同步。
| 参数 |
可选 |
接受 |
默认值 |
说明 |
| FTP connection |
否 |
FTP 连接 |
|
要使用的 FTP 连接。 必须在打开 FTP 连接操作中预先指定此变量 |
| Synchronization direction |
不可用 |
远程 -> 本地(下载)、本地 -> 远程(上载) |
远程 -> 本地(下载) |
同步方法的方向。 本地文件夹是否将同步到远程目录（下载），或远程目录是否将同步到本地文件夹（上载） |
| Files to sync |
不适用 |
所有文件、仅限与文件筛选器匹配的文件、仅限与文件筛选器不匹配的文件 |
所有文件 |
选择是要同步所有文件，还是使用文件筛选器来包含或排除特定的文件集 |
| 文件夹筛选器 |
否 |
文本值 |
* |
用于控制包含或排除哪些文件的文件名称模式。 此选项允许使用通配符，如“.txt”或“document?.doc”。此选项还允许多个筛选器，并使用逗号作为分隔符，例如，“.txt,*.pdf,document?” |
| Local folder |
否 |
文件夹 |
|
要同步的本地文件夹的名称 |
| FTP directory |
是 |
FTP 目录 |
/ |
要同步的 FTP 目录的名称 |
| Delete if source is absent |
不适用 |
布尔值 |
错误 |
此选项将删除目标目录而非源目录中存在的文件或文件夹。 |
| Include subdirectories |
不适用 |
布尔值 |
真 |
此选项将在同步过程中包含子目录。 |
| Time difference in hours |
是 |
数值 |
0 |
远程服务器在不同时区运行时的时差(以小时为单位)。 |
| Time difference in minutes |
是 |
数值 |
0 |
远程服务器在不同时区运行时的时差(以分钟为单位)。 |
| Time difference ahead |
不适用 |
布尔值 |
真 |
指定服务器的时区是否提前。 |
生成的变量
| 参数 |
类型 |
说明 |
| FtpFilesAdded |
FTP 文件列表 |
最初存在于源中，但在同步过程之后添加到目标的 FTP 文件列表。 |
| FtpFilesModified |
FTP 文件列表 |
最初存在于源中和目标中，但在同步过程之后添加到目标的 FTP 文件列表。 |
| FtpFilesDeleted |
FTP 文件列表 |
最初存在于目标目录中，但在同步过程之后删除的 FTP 文件列表。 |
| FilesAdded |
文件列表 |
最初存在于源中，但在同步过程之后添加到目标的文件列表。 |
| FilesModified |
文件列表 |
最初存在于源中和目标中，但在同步过程之后添加到目标的文件列表。 |
| FilesDeleted |
文件列表 |
最初存在于目标目录中，但在同步过程之后删除的文件列表。 |
异常
| 例外 |
说明 |
| 列表错误 |
指示无法执行文件夹的列表 |
| 未连接错误 |
指示 FTP 服务器没有打开的连接 |
| 找不到文件错误 |
指示找不到文件 |
| FTP 连接中止错误 |
指示 FTP 连接已中止 |
| 上传文件错误 |
指示无法上传文件 |
| 远程文件不存在错误 |
指示 FTP 服务器上不存在文件 |
| 无法下载文件错误 |
指示无法下载文件 |
| 删除目录错误 |
指示无法删除目录 |
| 同步失败错误 |
指示由于发生意外错误导致同步过程失败。 |