メインコンテンツへスキップ

​
はじめに

Box Inc.は、ビジネス用オンラインファイル共有とパーソナルクラウドコンテンツ管理サービスです。このコネクターを使うと、Boxアカウントからデータファイルを取得し、Domoで利用できます。データファイルは、CSV、JSON、XLS、XLSXのいずれかのファイルタイプで取得できます。 Box file watchを使うと、Boxアカウントからデータファイルを取得し、Domoで利用できます。データファイルは、CSV、XLS、XLSX、XML、ZIP、GZIPのいずれかのファイルタイプで取得できます。Box APIの詳細については、ウェブサイト（ https://developers.box.com/ ）を参照してください。 このコネクターは、メールで送信されたExcelやCSVレポートからデータを取り出す際に、特に便利です。レポートをメールでBoxフォルダーにアップロードしておき、その後DomoのBoxコネクターを使用して必要なレポートをフォルダーから取得できます。 Boxアカウントには、Data Centerから接続します。このトピックでは、Box Advancedコネクターのユーザーインターフェースに固有のフィールドとメニューについて説明します。DataSetの追加や更新スケジュールの設定、DataSet情報の編集に関する一般的な情報は、「 コネクターを使用してDataSetを追加する 」を参照してください。

主な使用事例

DomoのBox Advancedコネクターは、2つ以上のヘッダーまたはフッター行のある複雑なファイルの解析に最適です。このコネクターは、ヨーロッパの日付形式、パイプやハットのようなカスタム区切り文字、その他のカスタム設定をデータファイルで使用する際に便利です。

主なメトリクス

該当なし

社内における主な権限

該当なし

平均導入時間

構成設定にもよりますが、10～20分かかります。

使いやすさ（1～10の段階。1が「最も使いやすい」）

4

​
ベストプラクティス

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

​
必要条件

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

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

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

​
［認証情報］ペイン

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

​
［詳細］ペイン

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

メニュー

説明

File Name

取得するBoxファイルの名前（または名前の一部）を入力します。

コネクターは、 ［Date Field］ メニューで選択した内容にもとづき、名前が一致するものから、最後に作成または変更したファイルを返します。

Match Type

取得するファイルのファイル名が ［File Name］ で入力した名前から始まるのか、それともファイル名にその名前が含まれるのかを指定します。

File Type

取得するデータファイルのファイルタイプを選択します。

Sheet Name

指定されたスプレッドシートから取得したいシート名を入力します。

Would you like to choose a file from the folder

フォルダから特定のファイルを選択できます。

​
［詳細］ペイン

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

メニュー

説明

Header Start

DataSetのヘッダー行の番号を入力します。

Data Start Row

DataSetの最初のデータ行の番号を入力します。

Footer

DataSetの最後にスキップする行数を入力します。例えば、最後の2行をスキップするには、「 2 」と入力します。

Empty Column Headers

空白の列ヘッダーが見つかった場合にどうするかを指定します。
［Add blank columns］ を選択した場合、新規の列には列名が自動的に生成されます。

Data Format

日付列の変換に使用する日付形式を選択します。

Delimiter

CSVファイルの解析に使用する区切り文字を選択します。

Quote Character

CSVファイルの解析に使用する引用文字を選択します（CSVの標準は二重引用符です）。

Manually Enter Encoding

エンコーディングを手動で入力する際に選択します。

Escape Character

文字をエスケープする際に選択します。

​
その他のペイン

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

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

  • ファイルをBoxからダウンロードし、Excelまたはファイルタイプに適したアプリケーションで開くことで、Boxにアップロードしたときにファイルが破損していないことを確認します。
  • Boxは世界中で使用されているアプリケーションです。ファイルをアップロードすると、サーバーはこれらの変更をグローバルに同期します。このため、そのファイルをすぐに使用できる場合もあれば、Domoでそのファイルをダウンロードできるようになるまでに最大30分かかる場合もあります。コネクター経由でファイルを取得する20～40分前にアップロードしておくことを推奨します。
  • Boxによって速度制限が行われる場合があります。DomoのBoxコネクターはこの状況を認識し、速度制限の状況から回復しようとしますが、同時に実行するDataSetが多すぎると、コネクターは回復できなくなり、失敗する可能性があります。その場合は、時間をずらしてDataSetを実行してください。
  • その他のよくある問題：認証情報の問題（パスワードの変更）、誤ったフォルダーからの選択、ファイル名を誤って入力（.xslxを入力し忘れるなど）。

​
よくある質問

すべてのコネクター設定がファイルと一致していて、入力ミスがないか確認してください。ファイルをアップロードした後、最大30分間、Box API経由でファイルを利用できない場合があります。ファイルが少なくとも30分間Boxにあることを確認してから、再度DataSetを実行してみてください。
この問題は、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コネクターでは、ファイルの名前とタイプのほかに、データのフォーマットの詳細を指定できる高度なセクションが追加されています。
はい。
必要に応じて行われます。
ありません。