概要

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

ユーザーのインポート/更新

データの一括インポート]ウィンドウで、[CSVテンプレートのダウンロード]を選択します。
ダウンロードしたファイルから users.csv.
CSVファイルで、各列（テンプレート・テーブルの最上行）に定義されたエンティティに従って、各選択フィールドに情報を入力する。
CSVファイルの作成方法の詳細については、 CSVファイルを使用したデータのインポートを参照してください。

ユーザーをインポートするためのサンプルCSVファイル形式：

user_username,user_name,user_password,user_email,user_language,user_active,user_role,user_organizationId,user_externalId,user_metadata_<KEY>
user1,User Name,Password1!,test@email.com,en-US,TRUE,CONTENT_CREATOR|GROUP_CREATOR,root,{"google": "user-id"},{metadata_value}
user2,User Name 2,Password1!,test2@email.com,en-US,TRUE,ADMIN,root,{"google": "user-id"},{metadata_value}

一番上の行は、各ユーザーが値を入力するエンティティを指定します。

エンティティ

必須

user_username
- TAOポータルでユーザーを識別するためのユーザー名。
- このフィールドへの値の入力は、ユーザの作成または更新時に必須ですが、作成後に変更することはできません。
user_password
- TAOポータル上で識別するためのユーザー名のパスワード。パスワードは8文字以上で、大文字、小文字、特殊文字を少なくとも1つずつ使用する必要があります。
- このフィールドはユーザー作成時に必須です。
user_organizationId
- ユーザーが割り当てられている（階層内の）組織単位。
- このフィールドの値は、階層内の既存の組織ユニットのIDを参照する必要があります（またはルート）。
- このフィールドは、組織（階層）が有効になっている場合にのみ有効である。
- 有効な場合、このフィールドは必須である。

利用可能

user_email
- ユーザーに割り当てられた電子メール。
user_name
- ユーザーに割り当てられた名前。
user_active
- 有効（アクティブ）、無効（非アクティブ）ユーザーを作成する。非アクティブユーザーはログインできません。
- 空の場合、デフォルト値はActive (TRUE).追加 FALSE にフラグを立てる。グループ非アクティブとして。
- 数値1と0が使われた場合、それらは自動的にtrueとfalseに変換され、ログファイルに警告が送られる。
user_role
- 選択フィールドに、ユーザに割り当てたい各ロールを、スペースなしでパイプ｜で区切って列挙します（CSVファイルのサンプルを参照）：
  - ADMIN
  - GROUP_CREATOR
  - CONTENT_CREATOR
  - OFFLINE_UPLOADER
  - ONLINE_UPLOADER
  - DASHBOARD_VIEWER
- デフォルト値はありません。空の場合、ユーザはロールなしでインポートされます。
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 - 日本語
- デフォルト値なし。
```
ユーザー外部ID
```
- このIDはシングルサインオンに使用される (SSO) with an external ID provider.
- このエンティティに値を入力すると、変更はどのTAO環境にも適用されますが、SSOが設定されていない環境には影響しません。
```
user_metadata_<KEY>
```
- This is an experimental feature that allows admins to flag users and groups with metadata tags. <KEY> represents the metadata key. In the selection field, use enter the metadata value. For information on enabling additional features, see Customizing an account in the TAO Portal.

ユーザーの更新

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