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. 新しい開発者トークンを生成するには、[取り消し] を選択して、[Generate Developer Token] を選択します。

  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列に2つのデータ型のデータがある場合、Box入力がデータを読み取れない問題を修正しました。(TPM-4135)

  • JSON Web TokenがBoxツールで動作しない問題を修正しました。(TPM-4115、TDCE-520)

  • Python SDKがDCMエラーを報告しない問題を修正しました。(TPM-3929)

  • Box入力が日付型のデータ型を保持しない問題を修正しました。(TDCE-537)

  • Box出力が数値をテキストに変換する問題を修正しました。(TDCE-453)

接続に使用する Alteryx ツール

box Box 入力ツール

box Box 出力ツール

Boxコネクタを使用して、Boxワークスペースに保存されているファイルを利用することで、Designerからワークフローの実行、スケジュール設定、公開を行います。サポートされているファイルの種類はXLSX、CSV、YXDBです。

注意

Desktop Automation (スケジューラー)はこのコネクタではサポートされていません。

データ接続マネージャー

Boxツールバージョン2.5.0以降では、データ接続マネージャー をサポートしているため、資格情報をより簡単かつ安全に保存できます。Boxへの接続を作成し、Boxツールを含むワークフローで保存された資格情報を簡単に再利用できます。Alteryx Serverで公開ワークフローを正常に実行するには、保存された資格情報が必要です。

AMP Engineの有効化

Boxツールバージョン2.5.0以降を含むワークフローで AMP Engine が有効になっていることを確認し、Designerの機能を最大限に活用してください。

このセクションの内容: