ユーザーのインポート/更新(既存のグループを使用)

CSVインポート機能には、最も一般的に使用されるインポートオプションのテンプレートがあらかじめ用意されています。このトピックでは、新規または既存のユーザーを新しいグループに追加するためのCSVインポートのサンプルと、対応するテンプレートの各エンティティに関する情報を提供します。

を作成する方法については CSVファイルを作成する方法については、 CSVファイルを使用したデータのインポートを参照してください。

グループのインポートについてはグループのインポート/更新.

新しいユーザーを既存のグループにリンクする

データの一括インポート]ウィンドウで、[ CSVテンプレートのダウンロード]を選択します。
ダウンロードしたファイルから link-new-user-to-groups.csv.
CSVファイルで、各列（テンプレートテーブルの最上行）に定義されたエンティティに従って、各選択フィールドに情報を入力する。

既存のグループに新規ユーザーをインポートするためのサンプルCSVファイルフォーマット：

user_username,user_name,user_password,user_email,user_language,user_active,group_role,group_name,user_organizationId
user1,ユーザー名,パスワード,ユーザーメールアドレス,EN-US,TRUE,TEST_TAKER,グループA,root

一番上の行（または行）は、下の対応するフィールドに値を入力するエンティティを指定します。

既存のユーザーを既存のグループにリンクする

新規ユーザーのインポートについては、以下を参照してください。ユーザのインポート/更新.

データの一括インポート]ウィンドウで、[ CSVテンプレートのダウンロード]を選択します。
ダウンロードしたファイルから link-existing-user-to-groups.csv.
CSVファイルで、各列（テンプレートテーブルの最上行）に定義されたエンティティに従って、各選択フィールドに情報を入力する。

既存のグループと既存のユーザーをインポートするためのサンプルCSVファイルフォーマット：

ユーザー名,グループ名,グループロール
ユーザー1,グループB,グレーダー

一番上の行（または行）は、下の対応するフィールドに値を入力するエンティティを指定します。

エンティティ

必須

user_username
- TAOポータルでユーザーを識別するためのユーザー名。
- このフィールドへの値の入力は、ユーザの作成または更新時に必須ですが、作成後に変更することはできません。
user_password
- TAOポータル上で識別するためのユーザー名のパスワード。パスワードは8文字以上で、少なくとも大文字、小文字、特殊文字が1つずつ必要です。
  注意:このフィールドは、新規ユーザーを作成する場合のみ必須です。

group_name
- 既存のグループを参照する。
- ユーザの割り当てを作成または更新する場合、このフィールドへの値の入力は必須です。
- 複数の行にユーザーを追加することで、同じユーザーを複数のグループに追加できます。
user_organizationId
- ユーザーが割り当てられている（階層内の）組織単位。
- このフィールドは、組織（階層）が有効になっている場合にのみ有効である。
- 有効な場合、このフィールドは必須である。

利用可能

user_name
- ユーザー名。
user_email
- ユーザーに割り当てられた電子メール。
user_language
- 利用可能なロケールのリストから：
  - en-US - 英語(アメリカ)
  - no-NO - ノルウェー語
  - de-DE - ドイツ語
  - pt-BR - ポルトガル語（ブラジル）
  - es-ES - スペイン語
  - lt-LT - リトアニア語
  - it-IT - イタリア語
  - nl-NL - オランダ語
  - pt-PT - ポルトガル語（ポルトガル）
  - ro-RO - ルーマニア語
  - he-IL - ヘブライ語
  - fr-FR - フランス語
  - ja-JP - 日本語
- デフォルト値なし。
user_active
- 有効（アクティブ）または無効（非アクティブ）ユーザーを作成する。非アクティブユーザーはログインできません。
- 空の場合、デフォルト値はActive (TRUE).追加 FALSE をクリックして、グループに非アクティブのフラグを立てる。
- 数値1と0が使われた場合、それらは自動的にtrueとfalseに変換され、ログファイルに警告が送られる。
group_role
- ユーザーを利用可能なロールのいずれかに割り当てます。
  - GROUP_MANAGER
  - TEST_TAKER
  - GRADER
- このフィールドが空の場合、デフォルトのロールはTEST_TAKERとなります。
- ユーザーは、指定されたグループ内で複数のロールを持つことはできません。しかし、ユーザは異なるグループで異なる役割を持つことができます。これは、割り当てられたグループ/役割ごとに別々の行にユーザを追加することで管理されます。
group_user_active
- ユーザーのグループとロールの割り当てを確認します。
- で指定されたロールを持つユーザーを、指定されたグループに追加する。 group_role フィールドの値をTRUE.
- 値が FALSE または、空のままであれば、そのユーザは指定されたグループから削除されます。
- 注: group_user_activeは、ポータルからダウンロードしたテンプレートにはまだ含まれていません。このフィールドをCSVファイルに追加することで、この説明の機能を実行できます。このフィールドが含まれていない場合は、TRUE値で含まれている場合と同じ動作になります。

既存のグループ内のユーザーを更新する

ユーザーを更新するには、必須のエンティティ値（ユーザー名）を入力する必要があります。その他の値はすべて更新できます。
カラムの値が空白の場合、対応する値は削除される（必須でない場合、そうでない場合はエラーとなる）。
カラムの値に新しい値があると、前の値に置き換わる。
カラムが削除された場合、既存の値が保持されます。