Boxコネクター

はじめに

このコネクターを使用して、データファイルをBoxアカウントから取得し、Domoで利用できます。データファイルは、CSV、XLS、XLSX、XML、ZIP、GZIPのいずれかのファイルタイプで取得できます。Box APIについて詳しくは、Webサイト（https://developers.box.com/）を参照してください。

このコネクターは、メールで送信されたExcelやCSVレポートなどからデータを収集する際に特に役立ちます。レポートをメールでBoxフォルダーにアップロードしておき、その後DomoのBoxコネクターを使用して必要なレポートをフォルダーから取得できます。

Boxコネクターは「ファイル」コネクターです。つまり、サードパーティツールからファイルを取得してDomoに出力します。Data Centerでこのコネクターやほかのファイルコネクターのページにアクセスするには、ウィンドウ上部のツールバーで［ファイル］をクリックします。

Boxアカウントには、Data Centerから接続します。このトピックでは、Boxコネクターのユーザーインターフェースに固有のフィールドとメニューについて説明します。DataSetの追加や更新スケジュールの設定、DataSet情報の編集に関する一般的な情報は、「データコネクターを使用してDataSetを追加する」を参照してください。

必要条件

Boxアカウントに接続してDataSetを作成するには、以下が必要です。

• Boxアカウントへのログインに使用するメールアドレス

• Boxアカウントへのログインに使用するパスワード

Boxアカウントに接続する

このセクションでは、［Boxコネクター］ページの［認証情報］および［詳細］ペインのオプションについて説明します。このページのほかのペインの項目にある［スケジュール設定］や［DataSetの名前を付け説明を入力］に関しては、ほとんどのタイプのコネクターで共通しています。詳細については、「データコネクターを使用してDataSetを追加する」を参照してください。

［認証情報］ペイン

Domo Boxコネクターは接続にOAuthを使用しており、Domo内で認証情報を入力する必要はありません。［接続する］をクリック（またはDomoにBoxアカウントがある場合は［アカウントを追加する］を選択）して、BoxのOAuth画面を開き、Boxアカウントに関連したメールアドレスとパスワードを入力します。有効なBox認証情報を一度入力しておくと、いつでも同じアカウントを使用して新しいBox DataSetを作成できます。コネクターアカウントは、Data Centerの［アカウント］タブで管理できます。このタブについて詳しくは、「コネクターのユーザーアカウントを管理する」を参照してください。

［詳細］ペイン

このペインには以下のフィールドとメニューが含まれています。

その他のペイン

スケジュール設定、再試行、更新に関するオプションなど、コネクターインターフェースのその他のペインに表示されるオプションについては、「データコネクターを使用してDataSetを追加する」を参照してください。  

トラブルシューティング

• ファイルをBoxからダウンロードし、Excelまたはファイルタイプに適したアプリケーションで開くことで、Boxにアップロードしたときにファイルが破損していないことを確認します。

• Boxは世界中で使用されるアプリケーションです。ファイルをアップロードすると、サーバーはこれらの変更をグローバルに同期します。このため、そのファイルをすぐに使用できる場合もあれば、Domoでそのファイルをダウンロードできるようになるまでに最大30分かかる場合もあります。

• Boxによって速度制限が行われる場合があります。DomoのBoxコネクターはこの状況を認識し、速度制限の状況から回復しようとしますが、同時に実行するDataSetが多すぎると、コネクターは回復できなくなり、失敗する可能性があります。その場合は、時間をずらしてDataSetを実行してください。

よくある質問

box.comにファイルをアップロードした直後にファイルを取得しようとすると、Boxコネクターにファイルが存在しないと表示されました。どうすればよいですか？

すべてのコネクター設定がファイルと一致していて、入力ミスがないか確認してください。ファイルをアップロードした後、最大30分間、Box API経由でファイルを利用できない場合があります。ファイルが少なくとも30分間Boxにあることを確認してから、再度DataSetを実行してみてください。

多くのユーザーは、ファイルが30分間Boxにある場合でも、Box内の検索フィールドを使用してファイルを見つけることができないと報告しています。この問題は、BoxのSearch APIに原因があります。これは、アカウントがまだ最新ファイルと同期されておらず、API経由で利用できないことを意味します。

有効な認証情報を使ってもbox.comに接続できない場合はどうすればよいですか？

この問題は、Boxのオプション設定に原因がある可能性があります。box.comの用語では、Domoは未公開のアプリケーションです。Boxがユーザーに提供しているオプションの1つに、未公開のアプリケーションをデフォルトで無効にするオプションがあります。したがって、顧客がこのオプションを使用している場合、Domoユーザーは、BoxからDomoにデータをインポートする際に認証できない、またはBoxに接続できないことがあります。

Boxでは、未公開のアプリケーションで顧客のBoxインスタンスを使用できるようにするオプションを提供しています。これは、ほとんどの顧客がBoxアカウント設定で有効にしているようです。一部の顧客は、未公開のアプリケーションをすべて有効にしたくはないが、DomoでBoxを使用したいと考えています。この場合、Boxでは例外を許可するオプションも提供しています。Domoに対する例外を有効にするには、DomoのBoxに対する公開APIキーを例外リストに追加する必要があります。 

未公開のアプリケーションを許可しないオプションを設定している場合は、APIキー「p8zmzltrnjrkwqywbs18z3lqekzbq1jh」をホワイトリストに登録する必要があります。  

BoxコネクターとBox Advancedコネクターの違いは何ですか？

Boxコネクターでは、ファイルの名前とタイプを指定してデータを取得できます。Box Advancedコネクターでは、ファイルの名前とタイプのほかに、データのフォーマットの詳細を指定する高度なセクションが追加されています。

同一のBoxアカウントを複数のDataSetに使用できますか？

はい。

データ更新の頻度はどのくらいですか？

必要に応じて行われます。

注意すべきAPI制限はありますか？

ありません。