Skip to main content

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.

发行说明

连接器 1.0.0 发行说明 (Python)

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

ID

描述

v3.0.0

  • The same DCM Connection can be used in both Input and Output tool.

  • Test Connection button has been added to all DCM authentication types to validate the credentials before saving it.

  • You can edit Scope for Built-in, Custom app.

  • You can edit Redirect URI for Custom app.

  • Box tool can render all platform-supported file formats, including CSV, XLSX, Avro, and JSON.

  • File Partitioning has been added for xlsx file format in Box Output.

  • Parquet file support in Box is available from Designer 2026.2 and above.

Prerequisites

Requirement

Detail

Designer Version

  • 2025.1 Patch 5, 2025.2 Patch 3, 2026.1 or later.

  • File partitioning is available starting with 2025.2 Patch 5.

  • Workflow Migration tool is supported for 2025.2 Patch 3 or later.

Install the Connector

You can easily install the latest version of the Box connector from Designer via the Add-Ons. This is the recommended installation method that allows you to browse, install, and update connectors without leaving Designer or visiting the Alteryx Marketplace.

To install the connector…

  1. In Designer, go to Add-Ons > Manage Marketplace Add-Ons. You will see a list of available connectors.

  2. Select Box Tools Connector and select Install. Designer downloads and installs the package. Designer might require a restart to complete the installation.

  3. After installation and setup are complete, the Box connector is available from the Input Data and Output Data tools.

Set Up a Connection

To connect to Box connector using DCM...DCM - Designer

  1. Drag the Input Data or Output Data tool to the canvas, and select Connect to Data.

  2. In the Connector Setup, select Create or Browse a Data Connection.

    If you've created a Box connection before, you can select the connection from the Recents tab.

  3. Select + New. From the list of technologies, select Box.

  4. Select Quick Connect and then select Setup Connection. The Connections window opens.

  5. Select +New.

  6. Specify the connection name and the data source name.

  7. In the Credentials section, select your authentication method, enter the credential name, and specify the access token.

  8. Select Save.

  9. Select Connect. Box may request authentication.

  10. Select the file to read from or write to in the file browser window.

  11. Select the read or write configuration in the Options window.

  12. Select Confirm to create a connection to the file. You can continue building your workflow.

注册 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

Box Standalone Connectors

2025 年 12 月 8 日

ID

描述

TPM-5038

  • Fixed an issue where the Box connector version 2.5.7 failed with multiple Box Input tools on Server 25.1 when workflows run in parallel and returned the error Failed to find DCM connection values.

TPM-5006

  • Designer displays a clear warning message when users enter an invalid sheet number, sheet name, or sheet range.

  • The Box connector defaults Time and DateTime precision to milliseconds to avoid extra trailing zeros, while still supporting nanosecond resolution when required by the workflow.

  • Fixed an issue where newly created files in the Box tools inherit the previously selected filename when saved with any extension.

  • Fixed an issue where selecting Enable Dry Run in the Box Input tool (version 2.5.6) using a DCM connection with JWT authentication causes an error.

  • Fixed an issue the Box connector version 2.5.7 doesn’t recognize YXDB files.

  • Fixed an error that occurs when uploading a file using the Box tools.

  • Fixed an issue where special characters in the proxy password cause an error when setting up a manual proxy server for the Box tools.

  • Fixed an issue where secret values were exposed in the returned JSON in the Designer HTML Developer Tools for the Box tools.

TPM-4984

  • 与 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)

用于连接的 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 功能的潜力。

本节内容如下: