ユーザー一括管理（招待・更新）

概要

CSVファイルを用いて、複数のユーザーを一括で登録（招待）または更新できます。
本機能には、以下の2つの操作があります。

ユーザー一括登録: 新規ユーザーをCSVファイルで一括登録し、招待メールを送信します。ユーザー管理画面のヘッダーにあるユーザー一括登録ボタンから操作します。
ユーザー一括更新: 既存ユーザーの権限やチーム所属をCSVファイルで一括更新します。タブ右側にあるユーザー一括更新リンクから操作します。

必要な権限

本機能は、アカウント特権管理者またはアカウント管理者のみ利用できます。
各権限について、詳しくは各ユーザー権限でできることを参照してください。

同時実行の制限

1アカウントにつき、同時に実行できるインポートジョブは1件のみです。一括登録・一括更新を問わず、実行中のジョブがある場合は新たなインポートを開始できません。

機能

ユーザー一括登録

CSVファイルを使用して、複数の新規ユーザーを一度に登録できます。
インポート処理の完了後、登録されたユーザーに招待メールが送信されます。

ユーザー一括更新

CSVファイルを使用して、既存ユーザーの権限やチーム所属を一括で更新できます。
ユーザー一括更新を実行すると、CSVに入力した値で対象ユーザーの情報を完全に置き換えます。

インポート履歴の表示

各画面の下部にインポート履歴が表示されます。
直近90日のログを最大10件表示します。

以下は、インポート履歴に表示されるステータスの一覧です。

ステータス	説明
インポート中	インポート処理を実行中です。
登録完了 / 更新完了	すべての行が正常に処理されました。
一部登録済み / 一部更新済み	一部の行でエラーが発生しました。正常に処理された行と、エラーの行があります。
登録失敗 / 更新失敗	インポートに失敗しました。バリデーションエラーまたはすべての行でエラーが発生しました。

エラーの詳細は、各インポート履歴の実行ログを表示から確認できます。

CSVファイルのフォーマット・制約

フォーマット

ユーザー一括登録・ユーザー一括更新のいずれも、同一のCSVフォーマットを使用します。
各画面のCSVテンプレートをダウンロードリンクから、テンプレートをダウンロードできます。

CSVファイルの1行目には、以下のヘッダー行が含まれます。

email,role,cometa_roles,team_admin,team_member

2行目以降に、ユーザー情報を入力してください。
以下は、各カラムの説明です。

なお、制約に該当する場合は、取り込みの失敗や該当行がスキップされる場合があります。

カラム名	必須	入力する情報
`email`	✓	メールアドレスを入力します。大文字・小文字の区別はありません。
`role`	✓	アカウント権限を入力します。以下のいずれかの値を指定します。 `admin`：アカウント管理者 `member`：メンバー
`cometa_roles`	-	COMETA権限を入力します。以下のいずれかの値を入力します。 `admin`：データストア管理者 `metadata_editor`：メタデータ編集者 `rawdata_viewer`：実データ閲覧者 `glossary_admin`：用語集管理者 `glossary_viewer`：用語集閲覧者各権限について、詳しくは各COMETAロールでできることを参照ください。複数指定する場合はカンマ区切りにし、ダブルクォートで囲みます（例：`"metadata_editor,rawdata_viewer"`）。
`team_admin`	-	チーム管理者として所属させるチーム名を入力します。複数指定する場合はカンマ区切りにし、ダブルクォートで囲みます（例：`"チームA,チームB"`）。
`team_member`	-	チームメンバーとして所属させるチーム名を入力します。複数指定する場合はカンマ区切りにし、ダブルクォートで囲みます（例：`"チームA,チームB"`）。

ユーザー情報の上書き

ユーザー一括更新を実行すると、CSVに入力した値で対象ユーザーの情報を完全に置き換えます。

アカウント権限：空欄にした場合、対象ユーザーの既存のCOMETA権限がすべて解除されます。
チーム：CSVに記載されていないチームからは、対象ユーザーが自動的に除外されます。team_admin列とteam_member列の両方を空欄にした場合、対象ユーザーのチーム所属がすべて解除されます。

また、インポートできるCSVの文字コード・行数は以下のとおりです。

文字コード：UTF-8またはWindows-31J（CP932）に対応しています。
最大行数：1ファイルあたりのデータ行は最大1,000行です（ヘッダー行を除く）。

制約

ファイル全体がエラーになる制約

以下のいずれかに該当する行がCSVファイル内に含まれる場合、ファイル全体が処理されずエラーとなります。

email列にアカウント特権管理者のメールアドレスが入力されている場合
role列にsuper_admin（アカウント特権管理者）が指定された場合
（インポートの実行者がアカウント管理者の場合）
- cometa_roles列にglossary_adminまたはglossary_viewerが指定された場合
- team_adminまたはteam_member列に自分がチーム管理者であるチーム以外のチームが指定された場合

行単位でエラーになる制約

以下のいずれかの制約に該当する行はエラーとなります。エラーとなった行以外は処理されます。

email列のメールアドレスの形式が不正な行
role列が空欄または不正な値の行
cometa_roles列に指定可能な値以外の値が含まれる行
team_adminまたはteam_member列にアカウントに存在しないチーム名が指定されている行
team_admin列とteam_member列に同一のチームが指定されている行
（一括登録の場合）
- email列に既にアカウントに登録済みのメールアドレスが指定されている行
（一括更新の場合）
- email列にアカウントに登録されていないメールアドレスが指定されている行
- team_admin列の値で更新すると、チーム管理者がいなくなるチームが発生する行

CSVの内容が反映されない制約

以下の制約に該当する列は、CSVに入力されている場合でも更新されません。

（インポートの実行者がアカウント管理者の場合）
- 更新対象のアカウントの権限がglossary_adminまたはglossary_viewerの場合のrole列

Documentation Index