はじめに
このコネクターを使うと、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を追加する」を参照してください。
主な使用事例 |
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の[アカウント]タブで管理できます。このタブについて詳しくは、「コネクターのユーザーアカウントを管理する」を参照してください。
[詳細]ペイン
このペインには以下のフィールドとメニューが含まれています。
メニュー |
説明 |
---|---|
ファイル名 |
取得するBoxファイルの名前(まはた名前の一部)を入力します。 コネクターは、[日付フィールド]メニューで選択した内容に基づき、名前が一致するものから、最後に作成または変更したファイルを返します。 |
マッチタイプ |
取得するファイルのファイル名が[ファイル名]で入力した名前から始まるのか、それともファイル名にその名前が含まれるのかを指定します。 |
ファイルタイプ |
取得するデータファイルのファイルタイプを選択します。 |
日付フィールド |
ファイルを作成日または最終変更日のどちらで取得するかを指定します。 |
フォルダー名またはID |
完全なフォルダー名(大文字小文字の区別なし)、またはBoxフォルダーIDを入力して、ファイル検索を特定フォルダーのルートコンテンツに限定します。 サブフォルダーは無視されます。これを空白にすると、検索はアクセスできるすべてのフォルダーのすべてのファイルを対象とします。 |
シート名 |
指定したスプレッドシートから取得するシート名を入力します。 |
[高度]ペイン
このペインには以下のフィールドとメニューが含まれています。
メニュー |
説明 |
---|---|
ヘッダー開始 |
DataSetのヘッダー行の番号を入力します。 |
データ開始行 |
DataSetの最初のデータ行の番号を入力します。 |
フッター |
DataSetの最後にスキップする行数を入力します。例えば、最後の2行をスキップするには、2と入力します。 |
空白行 |
空白行があった場合にどう処理するかを指定します。 |
空白の列ヘッダー |
空白の列ヘッダーがあった場合にどう処理するかを指定します。 |
日付形式 |
日付列の変換に使用する日付形式を選択します。 |
区切り文字 |
CSVファイルの解析に使用する区切り文字を選択します。 |
引用文字 |
CSVファイルの解析に使用する引用文字を選択します(CSVの標準は二重引用符です)。 |
その他のペイン
スケジュール設定、再試行、更新に関するオプションなど、コネクターインターフェースのその他のペインに表示されるオプションについては、「データコネクターを使用して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制限はありますか?
ありません。
コメント
0件のコメント
サインインしてコメントを残してください。