Skip to main content

Box

连接类型

Alteryx 工具。最新版本可从 Alteryx Marketplace 获得。

支持类型

读取和写入

发行说明

连接器 1.0.0 发行说明 (Python)

与 Designer 的兼容性（待讨论）

已修复的问题

已修复

连接器发行版本 xxxx.x.x.xxxxx

ID

描述

TPM-5081

The Box connector version 2.5.7 fails with multiple Box Input tools on Server 25.1 when workflows run in parallel and returns a “Failed to find DCM connection values” error.

已取消的问题

已取消

连接器发行版本 xxxx.x.x.xxxxx

ID

描述

TPM-4180

The authentication window doesn’t open when refreshing OAuth credentials in the Box tools.

TPM-2621

The Box connector fails to read files larger than 1.9 GB.

2025 年 12 月 8 日

Box 版本 2.5.7

新增功能

  • 当用户输入无效的工作表编号、工作表名称或工作表范围时，Designer 会显示一条明确的警告消息。

  • Box 连接器将时间和日期时间精度默认设为毫秒，以避免末尾出现多余的零，但若工作流有需求，仍支持纳秒级分辨率。

行为变化

  • 我们在 Designer 中禁用了 Box 工具的右键上下文菜单，以防止误操作。

已修复的问题

已修复

Box 版本 2.5.7

ID

描述

TPM-5038

在 Box 工具中，新创建的文件在以任意扩展名保存时会继承先前选定的文件名。

TPM-5006

在使用带 JWT 身份验证的 DCM 连接时，在 Box 输入工具（版本 2.5.6）中选择“启用试运行”会导致错误。

TPM-4984

Box 连接器版本 2.5.7 无法识别 YXDB 文件。

TPM-4948

使用 Box 工具上传文件时会发生错误。

TPM-4853

在为 Box 工具设置手动代理服务器时，代理密码中的特殊字符会导致错误。

TPM-4782

在 Designer HTML 开发工具中，Box 工具返回的 JSON 中会暴露私密密钥值。

TPM-4754

Box 输入工具返回“列表索引超出范围”错误。

TPM-4645

Box DCM 连接在 24 小时后返回访问令牌无效错误。

TPM-4396

Box 输入工具在与 DCM 一起使用时无法正常工作。

TPM-4239

SharePoint 输入工具（版本 2.4.2）和 Box 输入工具（版本 2.5.2）不会为仅包含标题行的 YXDB 文件返回元数据。

TPM-4192

在 Box UI 中，文件名面包屑导航显示不正确。

TPM-4191

在 Python 3.10 上运行的 Box 输入工具版本 2.5.6 会为日期时间字段添加额外的小数值。

TPM-3832

SharePoint 输入工具版本 2.6.2 返回“Python 整数太大，无法转换为 C long”错误。

TPM-3334

升级到 SDK 版本 2.4.0 后，使用 Box 工具生成的 CSV 文件中，Null 日期时间值显示为 NaT。

TPM-3266

SharePoint 输入工具（版本 2.4.2）和 Box 输入工具（版本 2.5.2）不会为仅包含标题行的 CSV 和 XLSX 文件返回元数据。

已知问题

已知

Box 版本 2.5.7

ID

描述

TPM-2621

Box 连接器未能读取大于 1.9 GB 的文件。

已取消的问题

已取消

Box 版本 2.5.7

ID

描述

TPM-4190

Box 输入工具版本 2.5.6 中的试运行功能无法正常工作。

TPM-4049

Box 输出工具在写入大型 XLSX 文件时返回错误。

TPM-3758

Box 输出工具不能按预期保留选定的字段。

TPM-3634

使用浏览器从 Box 服务器删除文件时，文件路径不会更新。

TPM-3479

在 Box 版本 2.5.5（Python 3.8）中，当“将文件下载到本地以备稍后处理”功能使用空或无效位置时，均无法按预期工作。

TPM-3477

在 Box 浏览器中查看时，INT 数据类型会以 FLOAT 类型显示。

TPM-3435

Box 输出工具为 XLSX 文件映射了错误的数据类型。

TPM-2871

Box DCM 连接在 24 小时后返回访问令牌无效错误。

TPM-2792

Box 输入工具在验证过程中返回“通信错误：写入 Control In 消息失败”。

TPM-2267

如果字段为日期时间数据类型，Box 输出工具会写入一个空的 YXDB 文件。

TPM-2246

Box 输出工具在处理无效 CSV 文件时显示不清晰的错误消息。

TPM-2133

Box 工具中字段名称不会自动语音播报。

TPM-1568

当用户点击离开 Box 工具时，会出现明显的滞后。

版本

描述

v2.5.6

  • 与 Alteryx Designer 和 Server 2021.4.2 补丁 6、2022.1 补丁 4 及更高版本兼容。

  • 需要 AMP Engine。

  • 修复了当 Excel 列中有两种数据类型的数据时，Box 输入无法读取数据的问题。(TPM-4135)

  • 修复了 JSON Web 令牌在 Box 工具中不起作用的问题。(TPM-4115, TDCE-520)

  • 修复了 Python SDK 未报告 DCM 错误的问题。(TPM-3929)

  • 修复了 Box 输入无法保留日期类型的数据类型的问题。(TDCE-537)

  • 修复了 Box 输出将数字转换为文本的问题。(TDCE-453)

v2.5.5

  • 与 Alteryx Designer 和 Server 2021.4.2 补丁 6、2022.1 补丁 4 及更高版本兼容。

  • 需要 AMP Engine。

  • 移除了对 .shiv 文件夹的使用。

  • 增加了对 Alteryx Designer 和 Server 2024.1 的支持。

  • 修复了 Box 输入在配置为读取空数据集时无限期运行的问题。(TPM-2453)

  • 修复了 Box 工具无法与新生成的 JWT 令牌连接的问题。(TFLN-1855)

v2.5.4

  • 与 Alteryx Designer 和 Server 2021.4.2 补丁 6、2022.1 补丁 4 及更高版本兼容。

  • 需要 AMP Engine。

  • 修复了 Box 输出无法将 fixedDecimal 数据类型写入 YXDB 文件的问题。(TPM-2111)

  • 修复了 Box 输出无法覆盖某些大型 Excel 文件的问题。 (TPM-2169)

v2.5.2

  • 与 Alteryx Designer 和 Server 2021.4.2 补丁 6、2022.1 补丁 4 及更高版本兼容。

  • 需要 AMP Engine。

  • 对于“Box 输入”，添加了一个选项，以在使用通配符搜索、将文件下载到本地或用户选择处理文件为时包含子文件夹。

  • 修复了在 Box 输入中使用通配符搜索时的性能问题。(TPM-2027)

  • 修复了第一次运行工作流时通配符搜索返回错误的问题。(TPM-1847)

  • 修复了 Box 输出无法将各种数字和日期时间数据类型写入 YXDB 文件的问题。（TDCE-96、TPM-1958）

  • 修复了将 Box 输出配置为使用传入字段动态命名一个或多个输出文件时工作流失败的问题。(TPM-1980)

  • 修复了 Box 配置面板在长时间打开时显示间歇性错误的问题。(TFLN-1210)

已知问题

  • Box 输出无法将 fixedDecimal 数据类型写入 YXDB 文件。(TPM-2111)

Alteryx Server 需要将“SDK 访问模式”设置设为 AllowAll 值。

v2.5.1

  • 与 Alteryx Designer 和 Server 2021.4.2 补丁 6、2022.1 补丁 4 及更高版本兼容。

  • 需要 AMP Engine。

  • 修复了当用户在“文件路径”字段中按 Enter 键时重新发送配置文件选项卡的问题。(TFLN-1209)

  • 修复了读取具有 Null 值的 XLSX 文件会导致错误的问题。(TDCE-92)

  • 修复了使用 JWT 身份验证通过 Box 连接器运行的工作流在一天后无法运行的问题，并出现加密或访问令牌无效错误。(TPM-1802)

  • 修复了在数据含有带引号的分隔符时无法由 Box 输出附加的问题。(TDCE-28)

  • 修复了 Box 输出无法写入日期和日期时间数据类型或将日期更改为未来 70 年的问题。(TPM-1902)

已知问题

  • Box 输出无法将各种数字和日期时间数据类型写入 YXDB 文件 (TDCE-96)。解决方法是将数据输出为 CSV 或 XLSX。

v2.5.0

  • 与 Designer 2021.4.2 补丁 4、2022.1 补丁 2 及更高版本兼容。

  • 需要 AMP Engine。

  • 添加了对 DCM 的支持。

    • 在 Alteryx Server 中运行此连接器需要 DCM。

  • 添加了选项，用于仅覆盖添加的一个工作表。

  • 更改了从写入数据中排除的工作表和文件名字段的行为。添加了用于保留工作表和文件名字段的选项。

  • 现在会针对 Windows 证书存储执行 SSL/TLS 验证。

  • 符合 FIPS 标准。

  • 修复了文件动态命名的问题。(TPM-1688)

已知问题

  • Alteryx Server 需要将“SDK 访问模式”设置设为 AllowAll 值。

v2.4.0

  • 与 Alteryx Designer 2021.4.2 及更高版本兼容。

  • 附加和覆盖选项现在创建文件的新版本，而不是删除旧文件并创建新文件。这将保留文件的版本历史记录和共享链接。

  • 取消了从单个文件夹最多只能下载 100 个文件的限制。

v2.3.0

  • 使用用户的浏览器而不是 Designer 中的嵌入式 CEF 进行身份验证，以符合现代安全策略。

  • 小型漏洞修复。

v2.2.0

  • 添加了一个选项，可将列信息（列名称和数据类型）传递到连接的工具，而无需运行工作流。

  • 添加了动态输出

  • 添加了使用 Box 输出将本地文件上传到 Box 的选项。

  • “写入标题”复选框现在默认启用。

  • 小型漏洞修复。

v2.1.1

  • 修复了在 Designer 2021.3.2.54175 中进行身份验证时出现空白屏幕的问题。请注意，您还需要更新到 Designer 21.3.3.63061 或更高版本。更新后，需要在您的 Box 应用程序中添加一个白名单标头。

v1.0.0

  • 支持 OAuth (包括 SSO) 和访问令牌身份验证方法

  • 允许用户将文件夹和文件下载到本地。

  • 需要 Alteryx Designer 2021.3 及更高版本

用于连接的 Alteryx 工具

box “Box 输入”工具

box Box 输出工具

有了 Box 连接器，即可在 Designer 中使用存储在 Box 工作区中的文件运行、计划和发布工作流。支持的文件类型包括 XLSX、CSV 和 YXDB。

小心

此连接器不支持桌面自动化（计划程序）。

数据连接管理器

Box 工具 2.5.0 版及更高版本支持数据连接管理器，以便更轻松、更安全地存储凭证。创建到 Box 的连接，并在包含 Box 工具的工作流中轻松重复使用存储的凭证。Alteryx Server 需要存储的凭证才能成功运行已发布的工作流。

启用 AMP Engine

确保您为包含 Box 工具 2.5.0 版及更高版本的工作流启用了 AMP Engine，以充分利用 Designer 功能的潜力。

注册 Box 应用程序

  1. 使用您的 Box 凭证登录 https://alteryx.app.box.com/developers/console。

  2. 选择创建新应用程序。

  3. 选择自定义应用程序。

  4. 在身份验证方法中，选择用户身份验证 (OAuth 2.0)。输入应用程序名称并选择创建应用程序。

  5. 在应用程序范围的配置选项卡上，选择写入存储在 Box 中的所有文件和文件夹以向应用程序提供权限。

  6. 选择保存更改。

  7. 要生成新的开发人员令牌，请选择撤销，然后选择生成开发人员令牌。

  8. 您可以使用 OAuth 2.0 凭证中的客户端 ID 和客户端密码进行身份验证。

自定义应用程序设置

要避免在使用具有 OAuth 身份验证或访问令牌和 JWT 的应用程序时出现 Box CORS 问题，请使用自定义配置：

  1. 具有 OAuth 身份验证的 Box 应用程序：

    1. 添加重定向 URI https://cef.alteryx.com/designer/oauthcallback 以解决 CEF 窗口 CORS 问题。

      BoxOAuth

    2. 为允许的来源输入 file://*。

      BoxOAuthCORS

  2. 具有访问令牌和 JWT 身份验证的 Box 应用程序：

    1. 为允许的来源输入 file://*。

      BoxTokensCORS
本节内容如下: