task change_operator#

Description#

タスクの担当者を変更します。 作業中状態、完了状態のタスクは、担当者を変更できません。 保留中状態のタスクは、デフォルトでは担当者を変更できません。

Examples#

基本的な使い方#

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

task_id.txt#
task1
task2
...

--user_id に担当させたいユーザのuser_idを指定することができます。

以下のコマンドは、タスクの担当者を user1 に変更します。

$ annofabcli task change_operator --project_id prj1 --task_id file://task_id.txt \
--user_id user1

タスクの担当者を未割当にする場合は、--not_assign を指定してください。

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

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

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

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

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

保留中状態のタスクの担当者を変更する#

保留中状態のタスクは、デフォルトでは担当者を変更できません。 --include_on_hold_task を指定すると、保留中状態のタスクも担当者を変更できます。

$ annofabcli task change_operator --project_id prj1 --task_id t1 t2 \
 --user_id user1 --include_on_hold_task

並列処理#

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

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

Usage Details#

タスクの担当者を変更します。作業中状態、完了状態のタスクは、担当者を変更できません。保留中状態のタスクは、デフォルトでは担当者を変更できません。

usage: annofabcli task [-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 ...] (-u USER_ID | --not_assign)
                       [-tq TASK_QUERY] [--include_on_hold_task]
                       [--parallelism {2,3,4}]

Named Arguments#

-p, --project_id

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

-t, --task_id

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

-u, --user_id

タスクを新しく担当するユーザのuser_idを指定してください。

--not_assign

指定した場合、タスクの担当者は未割り当てになります。

-tq, --task_query

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

  • task_id

  • phase

  • phase_stage

  • status

  • user_id

  • account_id

  • no_user

--include_on_hold_task

指定した場合、保留中のタスクの担当者も変更します。指定しない場合、保留中のタスクはスキップされます。

--parallelism

Possible choices: 2, 3, 4

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

global optional arguments#

--yes

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

--endpoint_url

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

Default: 'https://annofab.com'

--annofab_user_id

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

--annofab_password

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

--annofab_pat

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

--logdir

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

Default: .log

--disable_log

ログを無効にします。

--debug

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

チェッカーまたはオーナロールを持つユーザで実行してください。