ユーザーのCSVの列の書き方

CSV一括登録で使う列(email・last_name・first_name・role・group_codes・employee_id・status とユーザーの項目)の書き方と決まりです。

CSV一括登録のファイルは、1 行目に列名、2 行目から 1 人 1 行で書きます。列の順番は自由で、使わない列は消してかまいません(email だけは必ず要ります)。ひな形は、CSV一括登録の画面の 「テンプレート」 で保存できます。

列

列名	中身	書き方
`email`	メールアドレス(必須)	255 文字まで。この値で、新しい人か登録済みの人かを見分けます
`last_name`	姓	50 文字まで。新しい人には必須
`first_name`	名	50 文字まで。新しい人には必須
`role`	ロール	`learner`(受講者)・`instructor`(講師)・`tenant_admin`(管理者)のどれか。空欄なら新しい人は受講者
`group_codes`	所属グループのコード	グループのコード。いくつかのグループに入れるときはセミコロン(`;`)で区切ります(例 `DC-EAST;HQ-HR`)
`employee_id`	社員番号	50 文字まで。ほかの人と同じ番号は使えません
`status`	状態	`active`(有効に戻す)・`inactive`(無効にする)。登録済みの人の状態を変えるときだけ使います
ユーザーの項目の名前(例「役職」「入社日」)	ユーザーの項目の値	組織で作ったユーザーの項目は、項目の名前と同じ列名で書きます。選ぶ形の項目は決めた選択肢の中から、日付は `2026-04-01` の形で

	新しい人(この組織に無いメールアドレス)	登録済みの人
取り込むと	招待中で登録し、招待メールを送ります	値の入っている列だけ書き換えます
空欄の列	既定の値(ロールは受講者)	変えません(下の 2 つは例外)
`group_codes` 列	そのグループに入れます	所属をその値に置き換えます。列があって空欄だと、どのグループにも所属しない状態になります
ユーザーの項目の列	その値を入れます	値をその値に置き換えます。空欄だと値を消します
`status`	空欄か `active`(`inactive` は使えません)	`inactive` で無効に、`active` で有効に戻します

所属や項目の値を変えないときは、その列ごと消してから取り込みます。登録済みの人の更新は CSVで登録済みのユーザーを更新する(所属・無効化) をご覧ください。