Box
The Box connector lets you connect to Box tools in Designer. Box is available as a data source in the Input Data and Output Data tool.
重要
New Connector Version in Designer
The Box connector is now part of the Alteryx One connectors experience. Review the information on this page carefully to ensure you're using the appropriate tools correctly.
If you want to update the Box connector in your Designer workflows, you can use the workflow migration utility.
Prerequisites
Requirement | Detail |
|---|---|
Designer Version |
|
连接器 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 |
|
v2.5.5 |
|
v2.5.4 |
|
v2.5.2 |
已知问题
Alteryx Server 需要将“SDK 访问模式”设置设为 AllowAll 值。 |
v2.5.1 |
已知问题
|
v2.5.0 |
已知问题
|
v2.4.0 |
|
v2.3.0 |
|
v2.2.0 |
|
v2.1.1 |
|
v1.0.0 |
|
用于连接的 Alteryx 工具
有了 Box 连接器，即可在 Designer 中使用存储在 Box 工作区中的文件运行、计划和发布工作流。支持的文件类型包括 XLSX、CSV 和 YXDB。
小心
此连接器不支持桌面自动化（计划程序）。
数据连接管理器
Box 工具 2.5.0 版及更高版本支持数据连接管理器，以便更轻松、更安全地存储凭证。创建到 Box 的连接，并在包含 Box 工具的工作流中轻松重复使用存储的凭证。Alteryx Server 需要存储的凭证才能成功运行已发布的工作流。
启用 AMP Engine
确保您为包含 Box 工具 2.5.0 版及更高版本的工作流启用了 AMP Engine，以充分利用 Designer 功能的潜力。
注册 Box 应用程序
使用您的 Box 凭证登录 https://alteryx.app.box.com/developers/console。
选择创建新应用程序。
选择自定义应用程序。
在身份验证方法中，选择用户身份验证 (OAuth 2.0)。输入应用程序名称并选择创建应用程序。
在应用程序范围的配置选项卡上，选择写入存储在 Box 中的所有文件和文件夹以向应用程序提供权限。
选择保存更改。
要生成新的开发人员令牌，请选择撤销，然后选择生成开发人员令牌。
您可以使用 OAuth 2.0 凭证中的客户端 ID 和客户端密码进行身份验证。
自定义应用程序设置
要避免在使用具有 OAuth 身份验证或访问令牌和 JWT 的应用程序时出现 Box CORS 问题，请使用自定义配置：
具有 OAuth 身份验证的 Box 应用程序：
添加重定向 URI https://cef.alteryx.com/designer/oauthcallback 以解决 CEF 窗口 CORS 问题。
为允许的来源输入
file://*。
具有访问令牌和 JWT 身份验证的 Box 应用程序：
为允许的来源输入
file://*。