はじめに
このコネクターを使うと、Boxアカウントからデータファイルを取得し、Domoで利用できます。データファイルは、CSV、JSON、XLS、XLSX、XML、ZIP、GZIPのいずれかのファイルタイプで取得できます。Box API に関する詳細は、 ウェブサイト を参照してください。 このコネクターは、メールで送信された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 | 取得するデータファイルのファイルタイプを選択します。 |
Date Field | ファイルを作成日または最終変更日のどちらで取得するかを指定します。 |
Folder Name or ID | 完全なフォルダー名（大文字小文字の区別なし）、またはBoxフォルダーIDを入力して、ファイル検索を特定フォルダーのルートコンテンツに限定します。 サブフォルダーは無視されます。 |
| Is the provided input a folder id? | 入力したフォルダーIDを持っている場合、 ［Yes］ を選択します。 |
Sheet Name | 指定されたスプレッドシートから取得したいシート名を入力します。 |
Generate the column names | これは、Boxのデータに列名がない場合は［Yes］として選択する必要があります。［Yes］の場合、一般的な列名が自動的にデータに追加されます。デフォルトでは、この値は ［No］ に設定されています。 |
［詳細］ペイン
このペインには以下のフィールドとメニューが含まれています。メニュー | 説明 |
|---|---|
Header Start | DataSetのヘッダー行の番号を入力します。 |
Data Start Row | DataSetの最初のデータ行の番号を入力します。 |
Does your Json text require a line reader? | JSONテキストから複数の行を読み込む場合は、 ［Yes］ を選択します。 |
バックスラッシュは、エスケープする必要がありますか？ | エスケープする必要のあるバックスラッシュがJSONテキストにある場合は、［Yes］を選びます。 |
Enter your header tag | JSONテキストのヘッダーのタグを入力します。 |
Enter your data tag | JSONのデータのタグを入力します。 |
除外するフィールドを入力 | JSONインポートで除外したいフィールドを、カンマ区切りのリストとして指定します。 |
その他のペイン
スケジュール設定、再試行、更新に関するオプションなど、コネクターインターフェースのその他のペインに表示されるオプションについては、「 コネクターを使用してDataSetを追加する 」を参照してください。トラブルシューティング
- ファイルをBoxからダウンロードし、Excelまたはファイルタイプに適したアプリケーションで開くことで、Boxにアップロードしたときにファイルが破損していないことを確認します。
- Boxは世界中で使用されているアプリケーションです。ファイルをアップロードすると、サーバーはこれらの変更をグローバルに同期します。このため、そのファイルをすぐに使用できる場合もあれば、Domoでそのファイルをダウンロードできるようになるまでに最大30分かかる場合もあります。コネクター経由でファイルを取得する20～40分前にアップロードしておくことを推奨します。
- Boxによって速度制限が行われる場合があります。DomoのBoxコネクターはこの状況を認識し、速度制限の状況から回復しようとしますが、同時に実行するDataSetが多すぎると、コネクターは回復できなくなり、失敗する可能性があります。その場合は、時間をずらしてDataSetを実行してください。
- その他のよくある問題：認証情報の問題（パスワードの変更）、誤ったフォルダーからの選択、ファイル名を誤って入力（.xslxを入力し忘れるなど）。
よくある質問
# box.com にファイルをアップロードした直後にファイルを取得しようとすると、Boxコネクターにファイルが存在しないと表示されました。どうすればよいですか？
# box.com にファイルをアップロードした直後にファイルを取得しようとすると、Boxコネクターにファイルが存在しないと表示されました。どうすればよいですか？
# 有効な認証情報を使っても box.com に接続できない場合はどうすればよいですか？
# 有効な認証情報を使っても box.com に接続できない場合はどうすればよいですか？
# BoxコネクターとBox Advancedコネクターの違いは何ですか？
# BoxコネクターとBox Advancedコネクターの違いは何ですか？
# 同一のBoxアカウントを複数のDataSetに使用できますか？
# 同一のBoxアカウントを複数のDataSetに使用できますか？
# データ更新の頻度はどのくらいですか？
# データ更新の頻度はどのくらいですか？
# 注意すべきAPI制限はありますか？
# 注意すべきAPI制限はありますか？