project_member update#

Description#

既存のプロジェクトメンバのロール、抜取検査率、抜取受入率をCSVまたはJSONで更新します。 自分自身の抜取検査率・抜取受入率も更新できます。自分自身のロールを変更する指定がある場合は、そのユーザの抜取率を含む更新全体をスキップします。 プロジェクトに所属していないユーザ(脱退済みを含む)は更新しません。 複数ユーザに同じロールを設定する場合は project_member update_role を使用してください。

旧 project_member change の代わりに、このコマンドまたは update_role を使用してください。

Examples#

JSONで更新する#

--project_id に対象プロジェクト、--json に更新情報の配列を指定します。 ユーザごとに user_id と更新するプロパティを記載してください。

  • member_role: ロール。指定できる値は project_member update_role を参照してください。

  • sampling_inspection_rate: 抜取検査率(0~100の整数)

  • sampling_acceptance_rate: 抜取受入率(0~100の整数)

省略したキーの値は維持します。抜取率に null を指定すると設定を解除します。 member_role に null は指定できません。

$ annofabcli project_member update --project_id prj1 \
  --json '[{"user_id":"user1","member_role":"worker"},{"user_id":"user2","sampling_inspection_rate":null,"sampling_acceptance_rate":20}]'

JSONファイルを指定する場合は --json file://members.json を使用してください。

自分自身の抜取率を更新する場合は、ログインユーザのユーザIDを指定します。

$ annofabcli project_member update --project_id prj1 \
  --json '[{"user_id":"my_user_id","sampling_inspection_rate":10,"sampling_acceptance_rate":20}]'

CSVで更新する#

ヘッダ行あり、カンマ区切りのCSVを --csv に指定します。 各列はJSONのキーに対応します。必須列は user_id で、他の列は省略できます。 空欄の値は維持します。抜取率の設定解除にはJSONを使用してください。 同じ user_id を複数行に記載することはできません。

members.csv#
user_id,member_role,sampling_inspection_rate,sampling_acceptance_rate
user1,worker,,
user2,,10,20
$ annofabcli project_member update --project_id prj1 --csv members.csv

Usage Details#

既存のプロジェクトメンバのロール、抜取検査率、抜取受入率を更新します。自分自身の抜取率も更新できますが、ロールは変更できません。

usage: annofabcli project_member update [-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 (--csv CSV |
                                        --json JSON)

Named Arguments#

-p, --project_id

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

--csv

更新対象と更新後の値が記載されたCSVファイルのパスを指定します。ヘッダ行あり、カンマ区切りです。 必須列: user_id 任意列: member_role, sampling_inspection_rate, sampling_acceptance_rate 空欄の値は変更しません。抜取率の設定解除には --json を使用してください。

--json

更新対象と更新後の値をJSONオブジェクトの配列で指定します。キーはCSVの列に対応します。 file:// を先頭に付けるとJSONファイルを指定できます。 キーを省略すると値を維持します。抜取率にnullを指定すると設定を解除します。member_roleにnullは指定できません。

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リクエストの内容やレスポンスのステータスコードなど、デバッグ用のログが出力されます。

オーナロールを持つユーザで実行してください。