task_history_event list_worktime#

Description#

タスク履歴イベントから作業時間の一覧を出力します。「作業中状態から休憩状態までの作業時間」など、タスク履歴より詳細な作業時間の情報を出力します。

Examples#

基本的な使い方#

$ annofabcli task_history_event list_worktime --project_id prj1 --output out.csv

出力結果#

CSV出力#

$ annofabcli task_history_event list_worktime --project_id prj1 --output out.csv

out.csv

JSON出力#

$ annofabcli task_history_event list_worktime --project_id prj1 --format pretty_json --output out.json

out.json#

[
{
    "project_id": "prj1",
    "task_id": "task1",
    "phase": "annotation",
    "phase_stage": 1,
    "account_id": "user1",
    "user_id": "user1",
    "username": "user1",
    "worktime_hour": 0.6420147222222222,
    "start_event": {
        "task_history_id": "17724ca4-6cdd-4351-86e6-16c19d50233e",
        "created_datetime": "2021-05-20T13:37:52.281+09:00",
        "status": "working"
    },
    "end_event": {
        "task_history_id": "c22ec069-a6a9-42f9-8438-53bd6145b91f",
        "created_datetime": "2021-05-20T14:16:23.534+09:00",
        "status": "on_hold"
    }
},
{
    "project_id": "prj1",
    "task_id": "task1",
    "phase": "annotation",
    "phase_stage": 1,
    "account_id": "user1",
    "user_id": "user1",
    "username": "user1",
    "worktime_hour": 0.02437027777777778,
    "start_event": {
        "task_history_id": "02d7dd4f-5c8c-4182-b6e8-cdf10b5be4ab",
        "created_datetime": "2021-06-08T17:51:41.218+09:00",
        "status": "working"
    },
    "end_event": {
        "task_history_id": "dfa073bd-6fe1-429f-9e65-d7062a64907d",
        "created_datetime": "2021-06-08T17:53:08.951+09:00",
        "status": "complete"
    }
}
]

Usage Details#

タスク履歴イベントから作業時間の一覧を出力します。タスク履歴より詳細な作業時間の情報を出力します。

usage: annofabcli task_history_event list_worktime [-h] [--yes]
                                                   [--endpoint_url ENDPOINT_URL]
                                                   [--annofab_user_id ANNOFAB_USER_ID]
                                                   [--annofab_password ANNOFAB_PASSWORD]
                                                   [--logdir LOGDIR]
                                                   [--disable_log] [--debug]
                                                   -p PROJECT_ID
                                                   [-t TASK_ID [TASK_ID ...]]
                                                   [-u USER_ID [USER_ID ...]]
                                                   [--task_history_event_json TASK_HISTORY_EVENT_JSON]
                                                   [-f {csv,json,pretty_json}]
                                                   [-o OUTPUT]
                                                   [--csv_format CSV_FORMAT]

Named Arguments#

-p, --project_id

対象のプロジェクトのproject_idを指定します。

-t, --task_id

対象のタスクのuser_idを指定します。 file:// を先頭に付けると、task_idの一覧が記載されたファイルを指定できます。

-u, --user_id

絞り込み対象のユーザのuser_idを指定します。 file:// を先頭に付けると、user_idの一覧が記載されたファイルを指定できます。

--task_history_event_json

タスク履歴イベント全件ファイルパスを指定すると、JSONに記載された情報を元にタスク履歴イベント一覧を出力します。指定しない場合は、タスク履歴イベント全件ファイルをダウンロードします。 JSONファイルは $ annofabcli task_history_event download コマンドで取得できます。

-f, --format

Possible choices: csv, json, pretty_json

出力フォーマットを指定します。

Default: "csv"

-o, --output

出力先のファイルパスを指定します。未指定の場合は、標準出力に出力されます。

--csv_format

CSVのフォーマットをJSON形式で指定します。 --format が csv でないときは、このオプションは無視されます。 file:// を先頭に付けると、JSON形式のファイルを指定できます。指定した値は pandas.DataFrame.to_csv の引数として渡されます。

global optional arguments#

--yes

処理中に現れる問い合わせに対して、常に yes と回答します。

--endpoint_url

Annofab WebAPIのエンドポイントを指定します。

Default: "https://annofab.com"

--annofab_user_id

Annofabにログインする際のユーザーID

--annofab_password

Annofabにログインする際のパスワード

--logdir

ログファイルを保存するディレクトリを指定します。

Default: .log

--disable_log

ログを無効にします。

--debug

HTTPリクエストの内容やレスポンスのステータスコードなど、デバッグ用のログが出力されます。