> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-openapi-sync-dataflows.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Box

## はじめに

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

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

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

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

<table class="mt-responsive-table" data-aura-rendered-by="33:195;a"><tbody><tr><td class="mt-noheading" colspan="1" rowspan="1"><p><b> 主な使用事例 </b></p></td><td class="mt-noheading" colspan="1" rowspan="1"><p> データファイルをBoxから取得してDomoで利用する </p></td></tr><tr><td class="mt-noheading" colspan="1" rowspan="1"><p><b> 平均導入時間 </b></p></td><td class="mt-noheading" colspan="1" rowspan="1"><p> ファイルがBoxにアップロードされた後、数分もあれば設定が完了します。 </p></td></tr><tr><td class="mt-noheading" colspan="1" rowspan="1"><p><b> 使いやすさ（1～10の段階。1が「最も使いやすい」） </b></p></td><td class="mt-noheading" colspan="1" rowspan="1"><p> 2 </p></td></tr></tbody></table>

## 必要条件

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

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

## Boxアカウントに接続する

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

## ［認証情報］ペイン

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

## ［詳細］ペイン

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

<table class="mt-responsive-table" data-aura-rendered-by="33:195;a"><thead><tr><th colspan="1" rowspan="1"><p><span class="s1"><b> メニュー </b></span></p></th><th colspan="1" rowspan="1"><p><span class="s1"><b> 説明 </b></span></p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p><span class="s1"> File Name </span></p></td><td colspan="1" rowspan="1"><p><span class="s1"> 取得するBoxファイルの名前（または名前の一部）を入力します。 </span></p></td></tr><tr><td colspan="1" rowspan="1"><p><span class="s1"> File Type </span></p></td><td colspan="1" rowspan="1"><p><span class="s1"> 取得するデータファイルのファイルタイプを選択します。 </span></p></td></tr></tbody></table>

### その他のペイン

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

## トラブルシューティング

* ファイルをBoxからダウンロードし、Excelまたはファイルタイプに適したアプリケーションで開くことで、Boxにアップロードしたときにファイルが破損していないことを確認します。
* Boxは世界中で使用されているアプリケーションです。ファイルをアップロードすると、サーバーはこれらの変更をグローバルに同期します。このため、そのファイルをすぐに使用できる場合もあれば、Domoでそのファイルをダウンロードできるようになるまでに最大30分かかる場合もあります。
* Boxによって速度制限が行われる場合があります。DomoのBoxコネクターはこの状況を認識し、速度制限の状況から回復しようとしますが、同時に実行するDataSetが多すぎると、コネクターは回復できなくなり、失敗する可能性があります。その場合は、時間をずらしてDataSetを実行してください。

## よくある質問

<AccordionGroup>
  <Accordion title="# Boxコネクターを作成するにはどのような認証情報が必要ですか？">
    Boxのユーザー名とパスワードが必要です
  </Accordion>

  <Accordion title="# box.com にファイルをアップロードした直後にファイルを取得しようとすると、Boxコネクターにファイルが存在しないと表示されました。どうすればよいですか？">
    すべてのコネクター設定がファイルと一致していて、入力ミスがないか確認してください。ファイルをアップロードした後、最大30分間、Box API経由でファイルを利用できない場合があります。ファイルが少なくとも30分間Boxにあることを確認してから、再度DataSetを実行してみてください。

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

  <Accordion title="# 有効な認証情報を使っても box.com に接続できない場合はどうすればよいですか？">
    この問題は、Boxのオプション設定に原因がある可能性があります。 [box.com](http://box.com) の用語では、Domoは未公開のアプリケーションです。Boxがユーザーに提供しているオプションの1つに、未公開のアプリケーションをデフォルトで無効にするオプションがあります。このため、顧客がこのオプションを使用している場合、Domoユーザーは、BoxからDomoにデータをインポートする際に認証できない、あるいはBoxに接続できないことがあります。

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

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

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

  <Accordion title="# 同一のBoxアカウントを複数のDataSetに使用できますか？">
    はい。
  </Accordion>

  <Accordion title="# データ更新の頻度はどのくらいですか？">
    必要に応じて行われます。
  </Accordion>

  <Accordion title="# 注意すべきAPI制限はありますか？">
    ありません。
  </Accordion>
</AccordionGroup>
