---
title: "ユーザー一括管理（招待・更新） | COMETA Docs"
slug: "bulk-user-management"
updated: 2026-10-27T10:06:52Z
published: 2026-10-27T10:06:52Z
canonical: "documents.trocco.io/bulk-user-management"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://documents.trocco.io/llms.txt
> Use this file to discover all available pages before exploring further.

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

## 概要

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

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

![](https://cdn.document360.io/3a3bae1e-f157-487f-8798-01e9d820e760/Images/Documentation/bulk-user-management-2026-07-02-08-48-23.png)

              必要な権限

              

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

              同時実行の制限

              

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

## 機能

### ユーザー一括登録

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

### ユーザー一括更新

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

### インポート履歴の表示

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

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

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

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

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

### フォーマット

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

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

```
email,role,cometa_roles,team_admin,team_member
```

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

なお、[制約](/cometa/docs/bulk-user-management)に該当する場合は、取り込みの失敗や該当行がスキップされる場合があります。

| カラム名 | 必須 | 入力する情報 |
| --- | --- | --- |
| `email` | ✓ | メールアドレスを入力します。大文字・小文字の区別はありません。 |
| `role` | ✓ | アカウント権限を入力します。以下のいずれかの値を指定します。 - `admin`：アカウント管理者 - `member`：メンバー |
| `cometa_roles` | - | COMETA権限を入力します。以下のいずれかの値を入力します。 - `admin`：データストア管理者 - `metadata_editor`：メタデータ編集者 - `rawdata_viewer`：実データ閲覧者 - `glossary_admin`：用語集管理者 - `glossary_viewer`：用語集閲覧者 - `chat_history_viewer`：チャット履歴閲覧者 各権限について、詳しくは[各COMETAロールでできること](/cometa/docs/cometa-roles-v2)を参照ください。 複数指定する場合はカンマ区切りにし、ダブルクォートで囲みます（例：`"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`・`chat_history_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`列
  - 更新対象のユーザーに付与済みの`glossary_admin`・`glossary_viewer`・`chat_history_viewer`（`cometa_roles`列で指定しなくても解除されません）