跳转到主要内容
Box 端口支持从 Box 云存储服务上传和下载文件。

​
核心功能

  • 基于 OAuth 的云存储集成，支持令牌自动刷新
  • 从连接的 Box 存储账户上传和下载，支持递归子目录
  • 文件过滤、覆盖保护和递归子文件夹支持
  • 为企业网络环境提供全面代理支持
  • 可选的缓存功能，确保仅下载新增或更新的文件

​
总览

每个 Box 端口都连接到指定的 Box 存储账户。在远程存储中，上传目标只允许设置为单个文件夹，下载目标可以设置为一个文件夹列表。 在 知行之桥 工作流中，到达 Box 端口的文件会上传到上传目标文件夹；下载目标文件夹中的文件会被下载并进入 知行之桥 工作流。端口支持上传和下载过滤器，以便仅发送和接收特定文件名和/或文件扩展名。 账户身份验证使用 OAuth，因此端口首次连接时必须在外部站点门户中输入账户凭据。外部门户会生成端口用于连接的 OAuth 令牌，之后端口会自动处理令牌刷新。

​
端口配置

本节包含所有可配置的端口属性。

​
设置

​
授权

设置描述
端口 Id端口的静态、唯一标识符。
端口类型显示端口类型及其用途的描述。
端口描述一个可选字段，用于提供端口及其在流中的角色的自由格式描述。
首次使用时，点击连接按钮可通过存储服务对端口进行身份验证。系统会将您重定向到站点登录门户。提供账户凭据后，身份验证令牌会返回到 知行之桥 并保存以供重复使用。

​
上传

上传到远程存储时的相关设置。

​
下载

从远程存储下载时的相关设置。

​
缓存

与在多次下载之间缓存和比较文件相关的设置。

知行之桥会自动清理资源缓存。此过程在每次接收周期的后台运行，删除远程服务器上已不存在的文件对应的过期缓存条目。这使得缓存大小始终保持在可管理范围内，无需任何手动操作。

默认情况下，文件保留 30 天，但您可以在高级选项卡的其他设置字段中使用 ResourceCacheRetentionDays 设置来调整保留时间以适应您的环境。例如，ResourceCacheRetentionDays=15 表示文件保留 15 天后将被删除。

When you enable caching, the file names are case-insensitive. For example, the connector cannot distinguish between TEST.TXT and test.txt.

​
高级页面 (Advanced Tab)

​
高级设置

未包含在先前类别中的设置。

​
代理设置

这是一组用于识别连接所经代理并对其进行身份验证的设置。默认情况下，本节使用 安全设置 页面的 代理设置 部分中的全局设置。清除此复选框可为您的端口提供特定的设置。

设置描述
代理类型基于代理的防火墙使用的协议。
代理主机基于代理的防火墙的名称或 IP 地址。
代理端口基于代理的防火墙的 TCP 端口。
代理用户用于通过基于代理的防火墙进行身份验证的用户名。
代理密码用于对基于代理的防火墙进行身份验证的密码。
身份验证方案保留默认值 None 或选择以下身份验证方案之一：Basic、Digest、Proprietary 或 NTLM。

​
消息

消息设置确定端口如何搜索消息并在处理后管理它们。

设置描述
保存到已发送文件夹选中此项可将端口处理的文件复制到该端口的“已发送”文件夹中。
已发送文件夹方案端口根据选定的时间间隔对 已发送 文件夹中的文件进行分组。例如，Weekly 选项指示端口每周创建一个新的子文件夹，并将本周发送的所有文件存储在该文件夹中。空白设置告诉端口将所有文件直接保存在 已发送 文件夹中。对于处理许多事务的端口，使用子文件夹可以帮助保持文件有序并提高性能。

​
日志

用于管理日志创建和存储的设置。

设置描述
日志级别指定要记录在端口日志目录中的信息类型：
  • None - 不创建任何日志。
  • Error - 仅当端口遇到错误时才创建日志。
  • Warning - 仅当端口发出警告时才创建日志。
  • Info - 记录工作流的一般信息，包括任何错误和警告（如果适用）。
  • Debug - 记录成功和失败工作流的详细调试信息。
  • Trace - 记录成功和失败工作流的详细跟踪信息。
请注意：Debug 和 Trace 级别的日志可能会记录敏感信息，包括消息内容和 SSL 证书。尽管连接属性（例如密码）被屏蔽了，但在与您的组织外部共享它们之前，请查看此级别的日志以避免泄漏敏感信息。
日志文件夹结构指示端口根据选定的时间间隔将日志文件夹中的文件分组。例如，Weekly 选项指示端口每周创建一个新的子文件夹，并将该周的所有日志存储在该文件夹中。空白设置告诉端口将所有日志直接保存在日志文件夹中。对于处理许多事务的端口，使用子文件夹有助于保持日志的有序性并提高性能。
保留消息副本指示端口在日志目录中保存最新消息副本的切换。请注意，端口每个子文件夹只保留一个消息，并且端口在再次运行时会覆盖以前保存的消息。

​
其他设置

特殊设置适用于特定用例。

设置描述
其他设置允许在以分号分隔的列表中配置隐藏的端口设置，例如 setting1=value1;setting2=value2。正常的端口用例和功能不需要使用这些设置。

​
自动化页面 (Automation Tab)

​
自动化设置

与端口文件自动化处理有关的设置。

​
性能

与端口资源分配相关的设置。

设置描述
最大工作线程数此端口上处理文件时从线程池中消耗的最大工作线程数。如果设置，则会覆盖 高级设置 页面的 性能设置 部分的默认设置。
最大文件数分配给端口的每个线程发送的最大文件数。如果设置，则会覆盖 高级设置 页面的 性能设置 部分的默认设置。

​
通知选项卡

​
SLA 选项卡

​
建立连接

要与 Box 端口建立连接，请使用设置上的连接按钮跳转到登录门户网站。在此门户中输入账户凭据后，它会向端口返回身份验证令牌。仅在端口首次连接到存储服务时需要执行此过程。

​
上传和下载

​
上传

要上传文件，请将设置页面中上传部分的远程文件夹设置为文件应上传到的文件夹。每个 Box 端口只上传到单个文件夹位置。 使用覆盖远程文件选项指示应覆盖还是跳过容器中已存在的文件。 配置完成后，放置在端口交易选项卡中的文件会上传到远程存储。如果启用了发送自动化，上传会自动进行；否则，可以从交易选项卡发送单个文件。

​
下载

要下载文件，请将设置页面中下载部分的远程文件夹设置为应下载文件的文件夹。使用逗号分隔列表可指定多个文件夹。 使用文件掩码设置 glob 过滤器（例如 *.txt），将下载限制为匹配过滤器的文件。要指定多个过滤器，请使用高级选项卡上的接收过滤器选项。 使用删除指定是否从远程存储中移除已成功下载的文件。 配置完成后，文件会根据接收自动化设置下载，也可以在交易选项卡上手动点击接收按钮。

​
宏

​
示例