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.

Prerequisites

Requirement

Detail

Designer Version

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

  • File partitioning is available for 2025.2 Patch 5 or later.

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

リリースノート

コネクタ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

Box入力ツール(バージョン2.5.6)で、JWT認証のあるDCM接続を使用して[ドライランを有効にする]を選択すると、エラーになる。

TPM-4984

Boxコネクタバージョン2.5.7でYXDBファイルが認識されない。

TPM-4948

Boxツールを使用してファイルをアップロードするとエラーになる。

TPM-4853

Boxツールの手動プロキシサーバーを設定するとき、プロキシパスワードに特殊文字が含まれているとエラーになる。

TPM-4782

BoxツールのDesigner HTML開発者ツールで、返される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で、日時フィールドに余分な10進数の値が追加される。

TPM-3832

SharePoint入力ツールバージョン2.6.2で、「Python intが大きすぎてC longに変換できません」というエラーが返される。

TPM-3334

SDKバージョン2.4.0にアップグレードすると、Boxツールの使用時に、Nullの日時値がCSVファイルに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

大きなXLSXファイルを書き込むと、Box出力ツールがエラーを返す。

TPM-3758

Box出力ツールで、選択したフィールドが想定どおりに保持されない。

TPM-3634

ブラウザを使用してBoxサーバーからファイルを削除しても、ファイルパスが更新されない。

TPM-3479

Boxバージョン2.5.5 (Python 3.8)で、[後で処理するためにファイルをローカルにダウンロード]機能を使用しても、空または無効な場所では想定どおりに動作しない。

TPM-3477

Boxブラウザで表示すると、INTデータ型が浮動小数点数型としてアップロードされる。

TPM-3435

Box出力ツールで、XLSXファイルの誤ったデータ型がマッピングされる。

TPM-2871

Box DCM接続で、24時間後に無効なアクセストークンエラーが返される。

TPM-2792

Box入力ツールで、検証中に「通信エラー: メッセージにコントロールを書き込むことができませんでした」というメッセージが返される。

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

  • JSON Web Tokenが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出力が、入力フィールドを使用して1つ以上の出力ファイルに動的に名前を付けるように構成されている場合に、ワークフローが失敗する問題を修正しました。 (TPM-1980)

  • Box設定パネルを長時間開いたままにすると、断続的にエラーが表示される問題を修正しました。 (TFLN-1210)

既知の問題

  • Box出力でfixedDecimalデータ型をYXDBファイルに書き込むことができない。 (TPM-2111)

Alteryx Server には、SDKアクセスモード設定の すべて許可 値が必要です。

v2.5.1

  • Alteryx DesignerおよびServer 2021.4.2パッチ6、2022.1パッチ4以降と互換性があります。

  • AMP Engineが必要です。

  • ユーザーが [ファイルパス] フィールドでEnterキーを押したときに [ファイルを設定] タブが再送信される問題を修正しました。 (TFLN-1209)

  • Null値を持つXLSXファイルを読み取るとエラーが発生する問題を修正しました。 (TDCE-92)

  • JWT認証を使用してBoxコネクタで実行するワークフローが、暗号化 または 無効なアクセストークン エラーで1日後に実行できなくなる問題を修正しました。 (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が必要です。

  • 追加のシート1枚のみを上書きするオプションが追加されました。

  • シート名およびファイル名フィールドの動作を書き込みデータから除外するように変更しました。シート名とファイル名フィールドを保持するオプションが追加されました。

  • SSL/TLS検証がWindows証明書ストアに対して実行されるようになりました。

  • FIPS対応。

  • ファイルの動的な名前付けに関する問題を修正しました。 (TPM-1688)

既知の問題

  • Alteryx Server には、SDKアクセスモード設定の すべて許可 値が必要です。

v2.4.0

  • Alteryx Designerバージョン2021.4.2以降と互換性があります。

  • [付加] および [上書き] オプションでは、古いファイルを削除して新しいファイルを作成するのではなく、新しいバージョンのファイルを作成するようになりました。これにより、ファイルのバージョン履歴と共有リンクが保持されます。

  • 1つのフォルダーからダウンロードできるファイル数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コネクタを使用して、Boxワークスペースに保存されているファイルを利用することで、Designerからワークフローの実行、スケジュール設定、公開を行います。サポートされているファイルの種類はXLSX、CSV、YXDBです。

注意

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

データ接続マネージャー

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. 新しい開発者トークンを生成するには、[取り消し] を選択して、[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
このセクションの内容: