FTP 接收

FTP 接收是一个制作程序,可从 (S)FTP 站点下载工作,并将工作注入流程。语法和提交层次结构语法类似。

若您的系统环境要求 (S)FTP 连接通过代理服务器,您需填写 FTP 代理首选项,将代理服务器的配置详情提供给 Switch。请参阅Switch 首选项:FTP 代理

关键字

若在流程元素窗格顶部的搜索字段输入以下任一关键词,FTP 接收元素显示在列表中:

连接

FTP 接收不支持传入连接。

FTP 接收将文件夹过滤器属性注入到输出连接中,从而将传入工作文件夹中的特定子文件夹添加到特定连接或从特定连接中排除。请参阅下文的"跳过文件夹"属性。

属性

属性

描述

名称

画布中显示的流程元素名称。

描述

画布中显示的流程元素描述。将光标悬停在流程元素上方时出现的工具提示中也会显示此描述

服务器类型 选择 FTPSFTP
  • 若您选择 FTP,您须设置下级属性被动模式(见下文)。
  • 若您选择 SFTP,您须设置首选认证方法(见下文)。
被动模式

仅在服务器类型为 FTP 时可用

若设置为,FTP 接收使用被动模式和 FTP 服务器通信;否则使用主动模式。

认证方法

仅在服务器类型为 SFTP 时可用

您有两种选择:
  • 密码:Switch 使用下方填写的用户名和密码登录服务器。
  • 公钥:Switch 使用密钥对(公钥+私钥)登录服务器,密钥对可由 PuTTY 密钥生成器生成。

    公钥为服务器上使用的密钥。必须配置公钥才可使用公钥配置功能。

    私钥为 Switch 使用的密钥。您须设置以下下级属性:
    • 证书保存类型:密钥保存的格式。
      注: 若您想将 PGP 文件(即 PuTTY 密钥文件)作为 SFTP 服务器的密钥文件,需先将文件转换成 PEM 文件(Switch FTP 工具支持的文件类型)。您可使用 PuTTY 密钥生成器转换文件:在工具中打开 PuTTY 密钥文件并使用主目录项 转换 > 导出 OpenSSH 密钥导出文件。
    • 证书保存路径:证书文件的完整路径,包含了密钥。
    • 证书保存密码:用来保存和编码生成的密钥的密码。如未使用密码,该域为空。
注: 另外,您可在选择 FTP 目录时设置认证方法(参阅 FTP 目录属性:单击选择 FTP 目录)。

用户名

(S)FTP 服务器的登录名。匿名登录使用"anonymous"作为用户名。

注: 若您使用(S)FTP 代理协议,在常规的用户名后加上 @ 符号和目标 (S)FTP 站点地址 (域或 IP 地址)("<ftpserverusername>@<ftpserveraddress>")。
密码 (S)FTP 服务器的密码。匿名使用则输入电子邮箱地址作为密码。

SFTP 服务器认证方式选择公钥时,该属性不可用。

FTP 服务器地址

从中检索工作的(S)FTP 服务器 URL 或 IP 地址。

注: 若您使用(S)FTP 代理协议,该属性应为代理服务器的 URL 或 IP 地址。

端口

(S)FTP 服务器所使用的端口。

FTP 目录

从中检索工作的(S)FTP 站点上的目录。

若路径以正斜杠"/"开头,则路径对应用户的主目录。若路径以双斜杠开头,则路径对应(S)FTP 站点的系统根目录。仅在用户有访问(S)FTP 站点完整的文件系统的权限时才可用。

原稿保留在服务器上

若设置为,传入工作在 FTP 站点上不作修改;Switch 不会写入站点,所以只读访问权限已满足需求;更多详情,请参阅原稿留在原地

若设置为(默认),传入工作从 FTP 站点上移除;Switch 需要完整的访问权限重命名、创建和移除 FTP 站点上的文件和文件夹。

忽略更新

仅在原稿保留在服务器上设置为时才可用忽略更新选项。

若设置为,工作只处理一次,不管文件大小或修改日期是否发生改变。该选项只适用于输入工作被处理结果替代的工作流程,以避免触发死循环。

若设置为,该工作会在文件大小或修改日期改变时被重新处理。该选项允许处理跟之前提交的工作有相同文件名的工作。

最小文件大小(KB)

用于在 Switch 拾取文件或文件夹前设置最小的文件大小(KB)。若无限制,则不设置该属性。

每(分钟)检查

检查 FTP 目录是否收到新工作的频率。

时间-日窗口

若设置为,此工具仅在一天的某个时间段(由次级属性指定)内检查新到达的工作。

允许从(小时:分钟)

在时间-天窗口的时间内检查新到达的工作;数值的结构是"hh:mm"(小时:分钟),表示 24 小时制某一天的时间;空值表示午夜;两个相同的数值表示此连接始终检测工作。

允许到(小时:分钟)

日-周窗口

若设置为,此工具仅在一周的某几天(由次级属性指定)内检查新到达的工作。

允许从

每周检查新到达工作的天数(星期一、星期二、星期三、星期四、星期五、星期六及星期日);两个相同的值表示工具只在指定的那天检查新到达的工作。

允许到

天-月窗口

如设置为,此工具仅在一个月的某一天(由次级属性指定)内检查新到达的工作。

在此月的这天中检查新到达工作,数字在 [1 ..31] 范围内;默认值 1 表示这个月的第一天或最后一天(视以下属性而定)。

相对于

决定这个月的这一天是对应月初还是月末

子文件夹等级

视为常用文件夹(和工作文件夹相对)的嵌套子文件夹的等级数。也可参阅前文子文件夹的描述。

处理这些文件夹

定义一组应被处理的初始文件夹。该组文件夹可通过在次级属性中定义规则进行调整。

采用(规则 1)到(规则 5)调整

该属性通过包含或排除匹配或不匹配文件夹名称的文件夹进行定义调整要处理的文件夹的规则。可使用不同规则,按照指定的顺序处理规则。

规则的附加属性有:

  • 文件夹名称,用于匹配。

  • 级别,用于限制规则应用的子文件夹的级别范围。

  • 限制,基于文件夹的父级或祖级文件夹名称。若文件夹 Y 包含子文件夹 X,Y 是 X 的父级文件夹。若文件夹 Z 包含子文件夹 Y,Z 是 X 的祖级文件夹之一。包含文件夹 Z 的文件夹同样是文件夹 X 的祖级文件夹之一。之后同理。

  • 嵌套:定义规则是否适用于目标文件夹的子文件夹,子文件夹位于层次结构中比定义的级别范围更深层处。匹配规则同样应用于这些子文件夹。

    选项:

    • 还排除/包含嵌套子文件夹
    • 不排除/包含嵌套子文件夹

添附层次结构信息

若设置为,(部分)工作的提交地址将在流程中提交时添附到层次结构位置路径;更多详情,请参阅使用层次结构信息

包括 FTP 名称

仅在添附层次结构信息启用时才可用。

若设置为,流程元素的名称包含在记忆位置路径的顶部。

包括子文件夹层

确认层次结构信息中的层次结构片段数量。

保存顶部子文件夹

若设置为,最顶层的子文件夹记忆在位置路径中;否则记忆最底层的子文件夹。

添附电子邮件信息

工作插入流程时,编辑器为该属性指定的电子邮箱地址和正文添加到各工作的电子邮件信息中;添加的信息区别取决于工作位于的子文件夹;更多详情,请参阅在 Switch 中使用电子邮件

允许子文件夹清除

若设置为,从下一个属性(在此层开始)定义的级别开始移除常用文件夹中空的子文件夹。
注: 该选项在处理这些文件夹设置为无文件夹(见上文)时可用,因为在这种情况下,只从 FTP 获取文件,(空)文件夹被留下。

在此层开始

应开始文件夹清除的文件夹级别(常用文件夹内):
  • 级别 1 为删除常用文件夹中所有空的子文件夹
  • 级别 2 为删除常用文件夹的子文件夹中所有空的子文件夹
  • 等等
在下例中,常用文件夹(Input(level 2))中空的子文件夹会被移除。