【Domo】Box Analyticsの接続方法
はじめに
クラウドストレージとしてBOXを活用されている企業では、BOXの使用量や誰がどれだけアクセスしたか等のアクティビティログを可視化したいニーズがあるかと思います。
DomoにはBox Analyticsコネクターがあり、それらの情報を取得することが可能です。
＜例 アクティブユーザ数やストレージ使用量＞
解説
まず、「データ」タブから「データを接続」＞「コネクタ」をクリックします。
次に「Box Analytics」で検索すると2つのコネクタが表示されます。
BOX AnalyticsコネクタとBOX Analytics Advancedコネクタの2つがありますが、
2つとも取得できるデータは同じになります。
Advancedコネクタはデータ取得時のフィルター設定が可能なので、日付範囲を指定してデータを取得したい場合などにご活用ください。
コネクタをクリックしてDataSet作成画面にうつります。
初めて接続する場合は、まず「接続」をクリックします。
（過去に接続したことがある場合はアカウントが表示されているはずなのでアカウントを選択して次にすすみましょう。）
「接続」をクリックすると新しいウィンドウでBOXの承認画面を開きます。
メールアドレスとパスワードを入力して「承認」ボタンをクリックします。
つぎにBOXへのアクセスを承認する画面が表示するので「BOXへのアクセスを許可」をクリックします。
クリックすると、Domoの画面に戻ります。
アカウントが追加されているはずなので、「次へ」をクリックします。
次に出力するレポートを選択する画面に遷移します。
出力できるレポートは4種類あります。
ファイルとフォルダレポート
| ヘッダー | 内容 |
| type | ファイル化フォルダか |
| id | |
| etag | |
| sequence_id | |
| can_non_owners_invite | |
| content_created_at | 作成日時 |
| content_modified_at | 編集日時 |
| created_at | |
| created_by_type | |
| created_by_id | |
| created_by_name | 作成ユーザ名 |
| created_by_login | |
| description | |
| folder_upload_email | |
| has_collaborations | |
| is_externally_owned | |
| item_status | |
| modified_by_type | |
| modified_by_id | |
| modified_by_name | 編集ユーザ名 |
| modified_by_login | |
| name | ファイルかフォルダ名 |
| owned_by_type | |
| owned_by_id | |
| owned_by_name | 所有者 |
| owned_by_login | |
| parent_type | |
| parent_id | |
| parent_sequence_id | |
| parent_etag | |
| parent_name | 親ディレクトリ名 |
| path_collection_total_count | |
| permissions_can_download | |
| permissions_can_upload | |
| permissions_can_rename | |
| permissions_can_delete | |
| permissions_can_share | |
| permissions_can_invite_collaborator | |
| permissions_can_set_share_access | |
| purged_at | |
| shared_link | |
| size | ファイルのデータ容量 |
| sync_state | |
| trashed_at | |
| watermark_info_is_watermarked | |
| allowed_invitee_roles_allowed_invitee_roles | |
| allowed_shared_link_access_levels_allowed_shared_link_access_levels | |
| path_collection_entries_type | |
| path_collection_entries_id | |
| path_collection_entries_sequence_id | |
| path_collection_entries_etag | |
| path_collection_entries_name | |
| permissions_can_preview | |
| permissions_can_comment | |
| permissions_can_annotate | |
| permissions_can_view_annotations_all | |
| permissions_can_view_annotations_self | |
| permissions_can_create_annotations | |
| permissions_can_view_annotations |
ユーザレポート
| ヘッダー | 内容 |
| type | user |
| id | ユーザID (数値) |
| name | ユーザ名 |
| login | ログインID |
| created_at | 作成日時 |
| modified_at | 編集日時 |
| language | 言語 |
| timezone | タイムゾーン |
| space_amount | 使用容量上限 |
| space_used | 使用中のデータ容量 |
| max_upload_size | アップロード容量上限 |
| status | ステータス |
| job_title | 役職 |
| phone | 電話番号 |
| address | 住所 |
| avatar_url | アバターURL |
| notification_email |
エンタープライズイベントレポート
対象の環境内のイベントログ
| ヘッダー | 中身 |
| source_type | |
| source_id | |
| source_name | (ログインなどのイベントの場合)ユーザ名 |
| source_login | |
| created_by_type | |
| created_by_id | |
| created_by_name | イベントを発生させたユーザ名 |
| created_by_login | |
| action_by | |
| created_at | イベント発生時刻 |
| event_id | |
| event_type | イベントログの種類(ログイン, 閲覧, アップロード, ダウンロード等) |
| ip_address | |
| type | |
| session_id | |
| additional_details | |
| additional_details_service_id | |
| additional_details_service_name | |
| source_item_type | ファイルかフォルダか |
| source_item_id | |
| source_item_name | ファイルやフォルダ名 |
| source_parent_type | |
| source_parent_name | 対象のファイルやフォルダが保存されているディレクトリ名 |
| source_parent_id | |
| source_owned_by_type | |
| source_owned_by_id | |
| source_owned_by_name | ファイルなどの所有者 |
| source_owned_by_login | |
| additional_details_size | ファイルなどのデータ容量 |
| additional_details_ekm_id | |
| additional_details_access_token_identifier | |
| additional_details_version_id | |
| additional_details_shared_link_id |
シングルユーザイベントレポート
接続したアカウントのイベントログ（ログインなどは含まれない）
| ヘッダー | 内容 |
| type | |
| event_id | |
| created_by_type | |
| created_by_id | |
| created_by_name | 対象のユーザ名 |
| created_by_login | |
| created_at | イベント時刻 |
| recorded_at | |
| event_type | イベントログの種類( 閲覧, アップロード, ダウンロード等) |
| session_id | |
| source_type | ファイルかフォルダか |
| source_id | |
| source_file_version_type | |
| source_file_version_id | |
| source_file_version_sha1 | |
| source_sequence_id | |
| source_etag | |
| source_sha1 | |
| source_name | ファイルやフォルダ名 |
| source_description | |
| source_size | ファイルのデータ容量 |
| source_path_collection_total_count | |
| source_path_collection_entries | |
| source_created_at | ファイル作成日時 |
| source_modified_at | ファイル編集日時 |
| source_trashed_at | ゴミ箱に移動した日時 |
| source_purged_at | 消去した日時 |
| source_content_created_at | |
| source_content_modified_at | |
| source_created_by_type | |
| source_created_by_id | |
| source_created_by_name | 作成ユーザ名 |
| source_created_by_login | |
| source_modified_by_type | |
| source_modified_by_id | |
| source_modified_by_name | 編集ユーザ名 |
| source_modified_by_login | |
| source_owned_by_type | |
| source_owned_by_id | |
| source_owned_by_name | 所有者 |
| source_owned_by_login | |
| source_shared_link | |
| source_parent_type | |
| source_parent_id | |
| source_parent_sequence_id | |
| source_parent_etag | |
| source_parent_name | 対象のファイルやフォルダが保存されているディレクトリ名 |
| source_item_status | |
| source_synced | |
| additional_details_original_item_type | |
| additional_details_original_item_id | |
| additional_details_original_item_name | |
| source_folder_upload_email |
Advancedコネクタでは、フォルダのID指定・出力するフィールドの選択・日付範囲の指定など詳細な設定が可能です。
出力するレポートやフィールドを選択したら「次へ」をクリックします。
以降は他のコネクタと同様にスケジュールの設定・DataSetの名前入力の画面を経て、DataSet作成完了です。
さいごに
BOXをお使いの方は使用量のモニタリングなどに活用できるので、ぜひ試してみてください。
・会社のデータをもっと有効活用をしたい
・Domoに取り込みたいデータソースがある
・Domoの効果的な可視化についてもっと知りたい
・組織においてのDomoの定着化をもっと推進したい
・新しいKPIを作りたいが、自信がない
アタラにはDomoを含むBIツールのエキスパートが在籍しております。
このような課題をお持ちの方は、ぜひお気軽にこちらまでご相談ください。
この記事をシェアする