Box

接続タイプ	Alteryxツール。最新のバージョンは、Alteryx Marketplace から入手できます。
サポートのタイプ	読み取りと書き込み

リリースノート

コネクタ1.0.0リリースノート(Python)

Designerとの互換性(検討中)

新機能

最新機能!
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.

動作の変更

We've disabled the right-click context menu in Designer for the Box tools to prevent unintended actions.

解決済みの問題

解決済みコネクタリリースバージョンxxxx.x.x.xxxxx
ID	説明
TPM-5038	Newly created files in the Box tools inherit the previously selected filename when saved with any extension.
TPM-5006	Selecting Enable Dry Run in the Box Input tool (version 2.5.6) using a DCM connection with JWT authentication causes an error.
TPM-4984	The Box connector version 2.5.7 doesn’t recognize YXDB files.
TPM-4948	An error occurs when uploading a file using the Box tools.
TPM-4853	Special characters in the proxy password cause an error when setting up a manual proxy server for the Box tools.
TPM-4782	Secret values are exposed in the returned JSON in the Designer HTML Developer Tools for the Box tools.
TPM-4754	The Box Input tool returns a "list index out of range" error.
TPM-4645	The Box DCM connection returns an invalid access token error after 24 hours.
TPM-4396	The Box Input tool doesn’t function properly with DCM.
TPM-4239	The SharePoint Input (version 2.4.2) and Box Input (version 2.5.2) tools don’t return metadata for YXDB files that contain only a heading row.
TPM-4192	File name breadcrumbs don’t appear correctly in the Box UI.
TPM-4191	The Box Input tool version 2.5.6 on Python 3.10 adds extra decimal values to datetime fields.
TPM-3832	The SharePoint Input tool version 2.6.2 returns a "Python int too large to convert to C long" error.
TPM-3334	After upgrading to SDK version 2.4.0, null datetime values appear as NaT in CSV files using the Box tools.
TPM-3266	The SharePoint Input (version 2.4.2) and Box Input (version 2.5.2) tools don’t return metadata for CSV and XLSX files that contain only a heading row.

既知の問題

既知コネクタリリースバージョンxxxx.x.x.xxxxx
JIRA-ID	問題の説明

既知

コネクタリリースバージョンxxxx.x.x.xxxxx

説明

JIRA-ID

問題の説明

キャンセルされた問題

キャンセルされましたコネクタリリースバージョンxxxx.x.x.xxxxx
ID	説明
TPM-4190	The dry run feature doesn’t work in the Box Input tool version 2.5.6.
TPM-4049	The Box Output tool returns errors when writing large XLSX files.
TPM-3758	The Box Output tool doesn’t retain selected fields as expected.
TPM-3634	File paths don’t update when files are deleted from the Box server using a browser.
TPM-3479	In Box version 2.5.5 (Python 3.8), using the 'Download file locally for later processing' feature with an empty or invalid location doesn’t work as expected in either scenario.
TPM-3477	INT data types upload as FLOAT types when viewed in the Box browser.
TPM-3435	The Box Output tool maps incorrect data types for XLSX files.
TPM-2871	The Box DCM connection returns an invalid access token error after 24 hours.
TPM-2792	The Box Input tools return a "Communication error: Failed to write Control In message" during validation.
TPM-2267	The Box Output tool writes an empty YXDB file if a field is of the DateTime data type.
TPM-2246	The Box Output tool displays an unclear error message for invalid CSV files.
TPM-2133	Field names are not automatically voiced in the Box tools.
TPM-1568	The Box tools experience a significant lag when users click away from the tool.

バージョン	説明
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ワークスペースに保存されているファイルを利用することで、Designerからワークフローの実行、スケジュール設定、公開を行います。サポートされているファイルの種類はXLSX、CSV、YXDBです。

注意

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

データ接続マネージャー

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に格納されているすべてのファイルとフォルダーの書き込み] を選択して、アプリに権限を付与します。
[変更を保存] を選択します。
新しい開発者トークンを生成するには、[取り消し] を選択して、[Generate Developer Token] を選択します。
認証には、OAuth 2.0資格情報 から クライアントID と クライアントシークレット を使用できます。

カスタムアプリケーションのセットアップ

OAuth 認証またはアクセストークンと JWT でアプリを使用する際、Box CORS の問題を回避するには、カスタム設定を使用します。

OAuth 認証を使用する Box アプリ:
1. リダイレクト URI https://cef.alteryx.com/designer/oauthcallbackを追加して、CEFウィンドウのCORSの問題を解決します。
2. [許可する送信元] には「file://*」を入力します。
アクセストークンと JWT 認証を使用する Box アプリ:
1. [許可する送信元] には「file://*」を入力します。

このセクションの内容:

Box