Box Advancedコネクター

はじめに

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

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

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

ベストプラクティス

Box Advancedコネクターのベストプラクティスは、データから始まります。ファイルにきちんと名前が付けられており、適切なフォルダーに保存されていることを確認します。さらに、詳細設定を正確に行えるよう、データファイルをよく確認しておきます。ヘッダーの開始行、データの開始場所、日付列の形式などを確認します。

必要条件

BoxアカウントにアクセスしてDataSetを作成するには、Boxのアカウントへのログイン時に使用するメールアドレスとパスワードが必要です。

Boxアカウントに接続する

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

［認証情報］ペイン

DomoのBoxコネクターは、接続にOAuthを使用します。このため、Domo内での認証情報の入力は必要ありません。［接続］をクリック（またはDomoに既存のBoxアカウントがある場合は［アカウントを追加］を選択）して、BoxのOAuth画面を開き、Boxアカウントに紐付いたメールアドレスとパスワードを入力します。  

有効なBox認証情報を一度入力しておくと、いつでも同じアカウントを使用して新しいBox DataSetを作成できます。コネクターアカウントは、Data Centerの［アカウント］タブで管理できます。このタブについて詳しくは、「コネクターのユーザーアカウントを管理する」を参照してください。

［詳細］ペイン

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

［高度］ペイン

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

その他のペイン

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

トラブルシューティング

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

• Boxは世界中で使用されているアプリケーションです。ファイルをアップロードすると、サーバーはこれらの変更をグローバルに同期します。このため、そのファイルをすぐに使用できる場合もあれば、Domoでそのファイルをダウンロードできるようになるまでに最大30分かかる場合もあります。コネクター経由でファイルを取得する20～40分前にアップロードしておくことをお勧めします。

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

• そのほかのよくある問題：認証情報の問題（パスワードの変更）、誤ったフォルダーからの選択、ファイル名を誤って入力（.xslxを入力し忘れるなど）。

よくある質問

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

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

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

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

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

DomoのBoxに対する公開APIキーは、wmiawbgvombfafa0jj4dgvmvq5ivq83m​です。

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

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

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

使えます。

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

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

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

ありません。