layout | title | lang |
---|---|---|
command |
コマンド |
ja |
複数ユーザーのアクティビティを一括取得します
watermint toolbox
は認証情報をファイルシステム上に保存します. それは次のパスです:
OS | パス |
---|---|
Windows | %HOMEPATH%\.toolbox\secrets (e.g. C:\Users\bob.toolbox\secrets) |
macOS | $HOME/.toolbox/secrets (e.g. /Users/bob/.toolbox/secrets) |
Linux | $HOME/.toolbox/secrets (e.g. /home/bob/.toolbox/secrets) |
これらの認証情報ファイルはDropboxサポートを含め誰にも共有しないでください. 不必要になった場合にはこれらのファイルを削除しても問題ありません. 認証情報の削除を確実にしたい場合には、アプリケーションアクセス設定または管理コンソールからアプリケーションへの許可を取り消してください.
方法は次のヘルプセンター記事をご参照ください:
説明 |
---|
Dropbox Business: チームのアクティビティログの閲覧 |
Dropbox Business: チームメンバーの確認 |
Dropbox Business: 名前、ユーザー数、チーム設定など、チームの基本的な情報を確認 |
最初の実行では、tbx
はあなたのDropboxアカウントへの認可を要求します.
リンクをブラウザにペーストしてください. その後、認可を行います. 認可されると、Dropboxは認証コードを表示します. tbx
にこの認証コードをペーストしてください.
watermint toolbox xx.x.xxx
==========================
© 2016-2022 Takayuki Okazaki
オープンソースライセンスのもと配布されています. 詳細は`license`コマンドでご覧ください.
1. 次のURLを開き認証ダイアログを開いてください:
https://www.dropbox.com/oauth2/authorize?client_id=xxxxxxxxxxxxxxx&response_type=code&state=xxxxxxxx
2. 'Allow'をクリックします (先にログインしておく必要があります):
3. 認証コードをコピーします:
認証コードを入力してください
最新リリースからコンパイル済みのバイナリをダウンロードしてください. Windowsをお使いの方は、tbx-xx.x.xxx-win.zip
のようなzipファイルをダウンロードしてください. その後、アーカイブを解凍し、デスクトップ フォルダに tbx.exe
を配置します.
watermint toolboxは、システムで許可されていれば、システム内のどのパスからでも実行できます. しかし、説明書のサンプルでは、デスクトップ フォルダを使用しています. デスクトップ フォルダ以外にバイナリを配置した場合は、パスを読み替えてください.
このドキュメントは"デスクトップ"フォルダを例として使用します.
Windows:
cd $HOME\Desktop
.\tbx.exe team activity batch user -file /path/to/file.csv
macOS, Linux:
$HOME/Desktop/tbx team activity batch user -file /path/to/file.csv
macOS Catalina 10.15以上の場合: macOSは開発者情報を検証します. 現在、tbx
はそれに対応していません. 実行時の最初に表示されるダイアログではキャンセルします. 続いて、”システム環境設定"のセキュリティーとプライバシーから一般タブを選択します.
次のようなメッセージが表示されています:
"tbx"は開発元を確認できないため、使用がブロックされました。
"このまま開く"というボタンがあります. リスクを確認の上、開いてください. 2回目の実行ではダイアログに"開く”ボタンがありますので、これを選択します
オプション | 説明 | デフォルト |
---|---|---|
-category |
一つのイベントカテゴリのみを返すようなフィルター条件. このフィールドはオプションです. | |
-end-time |
終了日時 (該当同時刻を含まない). | |
-file |
メールアドレスリストのファイル | |
-peer |
アカウントの別名 | default |
-start-time |
開始日時 (該当時刻を含む) |
オプション | 説明 | デフォルト |
---|---|---|
-auth-database |
認証データベースへのカスタムパス (デフォルト: $HOME/.toolbox/secrets/secrets.db) | |
-auto-open |
成果物フォルダまたはURLを自動で開く | false |
-bandwidth-kb |
コンテンツをアップロードまたはダウンロードする際の帯域幅制限(Kバイト毎秒). 0の場合、制限を行わない | 0 |
-budget-memory |
メモリの割り当て目標 (メモリ使用量を減らすために幾つかの機能が制限されます) | normal |
-budget-storage |
ストレージの利用目標 (ストレージ利用を減らすためログ、機能を限定します) | normal |
-concurrency |
指定した並列度で並列処理を行います | プロセッサー数 |
-debug |
デバッグモードを有効にする | false |
-experiment |
実験的機能を有効化する | |
-extra |
追加パラメータファイルのパス | |
-lang |
表示言語 | auto |
-output |
出力書式 (none/text/markdown/json) | text |
-proxy |
HTTP/HTTPS プロクシ (hostname:port). プロキシの設定を省略したい場合はDIRECT を指定してください |
|
-quiet |
エラー以外のメッセージを抑制し、出力をJSONLフォーマットに変更します | false |
-retain-job-data |
ジョブデータ保持ポリシー | default |
-secure |
トークンをファイルに保存しません | false |
-skip-logging |
ローカルストレージへのログ保存をスキップ | false |
-verbose |
現在の操作を詳細に表示します. | false |
-workspace |
ワークスペースへのパス |
メンバーのアクティビティを一括取得するためのデータファイル.
列 | 説明 | 例 |
---|---|---|
ユーザーのメールアドレス | john@example.com |
最初の行はヘッダ行です. プログラムは、ヘッダのないファイルを受け入れます.
email
john@example.com
作成されたレポートファイルのパスはコマンド実行時の最後に表示されます. もしコマンドライン出力を失ってしまった場合には次のパスを確認してください. [job-id]は実行の日時となります. このなかの最新のjob-idを各委任してください.
OS | パスのパターン | 例 |
---|---|---|
Windows | %HOMEPATH%\.toolbox\jobs\[job-id]\reports |
C:\Users\bob.toolbox\jobs\20190909-115959.597\reports |
macOS | $HOME/.toolbox/jobs/[job-id]/reports |
/Users/bob/.toolbox/jobs/20190909-115959.597/reports |
Linux | $HOME/.toolbox/jobs/[job-id]/reports |
/home/bob/.toolbox/jobs/20190909-115959.597/reports |
このレポートはDropbox Businessのアクティビティログとほぼ互換性のあるアクティビティレポートを出力します.
このコマンドはレポートを3種類の書式で出力します. combined.csv
, combined.json
, ならびに combined.xlsx
.
列 | 説明 |
---|---|
timestamp | このアクションが実行されたDropbox側でのタイムスタンプ. |
member | ユーザーの表示名 |
member_email | ユーザーのメールアドレス |
event_type | 実行されたアクションのタイプ |
category | 監査ログイベントのカテゴリー |
access_method | アクションが実行された方法. |
ip_address | IPアドレス. |
country | 国 |
city | 市町村 |
involve_non_team_members | 1名以上のチーム外のユーザーがこのアクションに関連した場合はTrue |
participants | このアクションによって影響を受けたユーザーまたはグループ |
context | アクターがアクションを実行したユーザーまたはチーム |
assets | アクションに関連したコンテンツ資産. |
other_info | このタイプのアクションに適用可能な可変イベントスキーマ. |
-budget-memory low
オプションを指定した場合、レポートはJSON形式のみで生成されます
レポートが大きなものとなる場合、.xlsx
フォーマットのファイルは次のようにいくつかに分割されて出力されます; combined_0000.xlsx
, combined_0001.xlsx
, combined_0002.xlsx
, ...
このレポートはDropbox Businessのアクティビティログとほぼ互換性のあるアクティビティレポートを出力します.
このコマンドはレポートを3種類の書式で出力します. user.csv
, user.json
, ならびに user.xlsx
.
列 | 説明 |
---|---|
timestamp | このアクションが実行されたDropbox側でのタイムスタンプ. |
member | ユーザーの表示名 |
member_email | ユーザーのメールアドレス |
event_type | 実行されたアクションのタイプ |
category | 監査ログイベントのカテゴリー |
access_method | アクションが実行された方法. |
ip_address | IPアドレス. |
country | 国 |
city | 市町村 |
involve_non_team_members | 1名以上のチーム外のユーザーがこのアクションに関連した場合はTrue |
participants | このアクションによって影響を受けたユーザーまたはグループ |
context | アクターがアクションを実行したユーザーまたはチーム |
assets | アクションに関連したコンテンツ資産. |
other_info | このタイプのアクションに適用可能な可変イベントスキーマ. |
-budget-memory low
オプションを指定した場合、レポートはJSON形式のみで生成されます
レポートが大きなものとなる場合、.xlsx
フォーマットのファイルは次のようにいくつかに分割されて出力されます; user_0000.xlsx
, user_0001.xlsx
, user_0002.xlsx
, ...
プログラムはシステム設定から自動的にプロクシ設定情報を取得します. しかしながら、それでもエラーが発生する場合には明示的にプロクシを指定することができます. -proxy
オプションを利用します, -proxy ホスト名:ポート番号
のように指定してください. なお、現在のところ認証が必要なプロクシには対応していません.