task reject#

Description#

タスクを差し戻します。 ただし作業中状態のタスクに対しては差し戻せません。 休憩中状態や保留中状態のタスクは、デフォルトではスキップします。

実行できるロール#

--comment を指定し、--cancel_acceptance を指定しない場合は、チェッカーロールまたはオーナーロールのユーザーが実行できます。 検査コメントを付与せずに差し戻す場合や、--cancel_acceptance で受入完了を取り消す場合は、オーナーロールが必要です。

Examples#

基本的な使い方#

--task_id に操作対象タスクのtask_idを指定してください。

task_id.txt#
task1
task2
...

以下のコマンドは、--task_id に指定したタスクを差し戻します。差し戻したタスクは教師付フェーズになり、担当者は最後の教師付フェーズを担当したユーザになります。

$ annofabcli task reject --project_id prj1 --task_id file://task_id.txt

受入取り消しと差し戻しを同時に行う場合は、--cancel_acceptance を指定してください。

$ annofabcli task reject --project_id prj1 --task_id file://task_id.txt  --cancel_acceptance

差し戻す際に検査コメントを付与する場合は、--comment を指定してください。 検査コメントの付与する場所は、--comment_data で指定できます。後述を参照してください。

$ annofabcli task reject --project_id prj1 --task_id file://task_id.txt \
 --comment "weather属性を見直してください。"

検査コメントの位置や区間を指定する#

--comment_data に、検査コメントの位置や区間をJSON形式で指定することができます。

$ annofabcli task reject --project_id prj1 --task_id file://task_id.txt \
 --comment "weather属性を見直してください。" \
 --comment_data '{"x":10,"y":10,"_type":"Point"}'

--comment_data に渡す形式は、 comment create_inspection_simply コマンドを参照してください。

--comment_data を指定しない場合は、以下の検査コメントが付与されます。

  • 画像プロジェクト： 点。先頭画像の左上に位置する。

  • 動画プロジェクト： 区間。動画の先頭に位置する。

  • カスタムプロジェクト（標準3Dエディタ）： 辺が1の立方体。先頭フレームの原点に位置する。

対応するカスタムエディタと廃止したオプションについては 検査コメント作成に対応するカスタムエディタ を参照してください。 標準外エディタでも、--comment を指定しない差し戻しは実行できます。

差し戻したタスクの担当者を指定する#

差し戻したタスクの担当者は、デフォルトでは最後の教師付フェーズを担当したユーザになります。 担当者を指定する場合は、--assigned_annotator_user_id に担当させたいユーザのuser_idを指定してください。

$ annofabcli task reject --project_id prj1 --task_id file://tasks.txt \
--assigned_annotator_user_id user1

担当者を割り当てない場合は --not_assign を指定してください。

$ annofabcli task reject --project_id prj1 --task_id file://tasks.txt \
--not_assign

休憩中状態のタスクも差し戻す#

デフォルトでは休憩中状態のタスクはスキップします。休憩中状態のタスクも差し戻す場合は、 --include_break_task を指定してください。

$ annofabcli task reject --project_id prj1 --task_id file://tasks.txt \
--include_break_task

保留中状態のタスクも差し戻す#

デフォルトでは保留中状態のタスクはスキップします。保留中状態のタスクも差し戻す場合は、 --include_on_hold_task を指定してください。

$ annofabcli task reject --project_id prj1 --task_id file://tasks.txt \
--include_on_hold_task

タスクのフェーズやステータスなどで絞り込む#

--task_query を指定すると、タスクのフェーズやステータスなどで、操作対象のタスクを絞り込むことができます。

以下のコマンドは、task_id.txt に記載されているタスクの内、受入フェーズで未着手のタスクを差し戻します。

$ annofabcli task reject --project_id prj1 --task_id file://task_id.txt \
 --task_query '{"phase":"acceptance", "status:"not_started"}'

並列処理#

以下のコマンドは、並列数4で実行します。

$  annofabcli task reject --project_id prj1 --task_id file://task.txt \
--parallelism 4 --yes

補足#

差し戻しタスクを再度教師付フェーズから提出した場合の、抜取受入/抜取検査#

--comment 引数を指定して差し戻したタスクを、再度教師付フェーズから提出した場合、 そのタスクは 抜取受入率 / 抜取検査率 が適用されません。 確認すべき検査コメントが残っているためです。 たとえば抜取受入率/抜取検査率が0%でも、必ずスキップされません。

--comment 引数を指定せずに差し戻したタスクを、再度教師付フェーズから提出した場合は、抜取受入率/抜取検査率が摘要されます。

Usage Details#

タスクを差し戻します。差し戻す際、検査コメントを付与することもできます。作業中状態のタスクに対しては差し戻せません。休憩中状態のタスクは、デフォルトでは差し戻せません。

usage: annofabcli task reject [-h] [--yes] [--endpoint_url ENDPOINT_URL]
                              [--annofab_user_id ANNOFAB_USER_ID]
                              [--annofab_password ANNOFAB_PASSWORD]
                              [--annofab_pat ANNOFAB_PAT] [--logdir LOGDIR]
                              [--disable_log] [--debug] -p PROJECT_ID -t
                              TASK_ID [TASK_ID ...] [-c COMMENT]
                              [--comment_data COMMENT_DATA]
                              [--not_assign | --assigned_annotator_user_id ASSIGNED_ANNOTATOR_USER_ID]
                              [--cancel_acceptance] [--include_break_task]
                              [--include_on_hold_task] [-tq TASK_QUERY]
                              [--parallelism {2,3,4}]

Named Arguments#

-p, --project_id

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

-t, --task_id

対象のタスクのtask_idを指定します。 file:// を先頭に付けると、task_idの一覧が記載されたファイルを指定できます。ファイルを読み込む場合は、ファイル指定を1個だけ渡してください。直接指定するIDや別のファイル指定とは併用できません。

-c, --comment

差し戻すときに付与する検査コメントを指定します。検査コメントはタスク内の先頭画像に付与します。付与する位置は --comment_data で指定できます。 未指定の場合は、検査コメントを付与せずに差し戻します。

--comment_data

検査コメントの種類や付与する位置をJSON形式で指定します。指定方法は https://annofab-cli.readthedocs.io/ja/latest/command_reference/task/reject.html を参照してください。 file:// を先頭に付けると、JSON形式のファイルを指定できます。 デフォルトの検査コメントの種類と位置は以下の通りです。

  • 画像プロジェクト：点。先頭画像の左上

  • 動画プロジェクト：区間。動画の先頭

  • カスタムプロジェクト（標準3Dエディタ）：辺が1の立方体。原点

標準3Dエディタ以外のカスタムプロジェクトへの検査コメント作成はサポートしていません。

--not_assign

差し戻したタスクに担当者を割り当てません。指定しない場合は、最後のannotation phaseの担当者が割り当てられます。

--assigned_annotator_user_id

差し戻したタスクに割り当てるユーザのuser_idを指定します。指定しない場合は、最後の教師付フェーズの担当者が割り当てられます。

--cancel_acceptance

受入完了状態を取り消して、タスクを差し戻します。

--include_break_task

指定した場合、休憩中状態のタスクも差し戻します。指定しない場合、休憩中状態のタスクはスキップします。

--include_on_hold_task

指定した場合、保留中状態のタスクも差し戻します。指定しない場合、保留中状態のタスクはスキップします。

-tq, --task_query

タスクを絞り込むためのクエリ条件をJSON形式で指定します。 file:// を先頭に付けると、JSON形式のファイルを指定できます。 以下のキーを指定できます。

  • task_id

  • phase

  • phase_stage

  • status

  • user_id

  • account_id

  • no_user

--parallelism

Possible choices: 2, 3, 4

使用するプロセス数（並列度）を指定してください。指定する場合は必ず --yes を指定してください。指定しない場合は、逐次的に処理します。

common options (after the subcommand)#

--yes

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

--endpoint_url

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

--annofab_user_id

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

--annofab_password

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

--annofab_pat

Annofabにログインする際のパーソナルアクセストークン

--logdir

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

Default: .log

--disable_log

ログを無効にします。

--debug

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

--comment を指定しない場合は、オーナーロールが必要です。 --cancel_acceptance を指定する場合も、オーナーロールが必要です。 --comment を指定し、--cancel_acceptance を指定しない場合は、チェッカーロールまたはオーナーロールで実行できます。