> For the complete documentation index, see [llms.txt](https://docs.immedio.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.immedio.io/user-group-management/groups/index.md).

# グループ一覧

グループを作成すると、面談の担当者の組み合わせを柔軟に設定できます。

## グループ一覧とは

グループ一覧とは、immedioを利用するユーザーをグループとして組織化し、面談予約時の担当者割り当てを効率化するための機能です。グループを作成し、その中にユニットと呼ばれるユーザーの組み合わせを設定することで、面談予約時の担当者の自動割り当てが可能になります。

## グループ一覧でできること

| 機能            | 説明                                |
| ------------- | --------------------------------- |
| グループ追加        | 新しいグループを作成する機能                    |
| グループ名編集       | 既存のグループの名前を変更する機能                 |
| グループアーカイブ     | 使用しないグループをアーカイブする機能               |
| グループCSVアップロード | CSVファイルを使って複数のグループとユニットを一度に作成する機能 |
| グループCSVダウンロード | 既存のグループ情報をCSVファイルとしてダウンロードする機能    |
| 複数グループ一括アーカイブ | 選択した複数のグループを一度にアーカイブする機能          |
| 検索            | グループ名またはグループに所属するユーザーを検索する機能      |
| アーカイブ表示切替     | アーカイブ済みのグループの表示/非表示を切り替える機能       |
| グループ一覧のソート    | グループ一覧をソートする機能                    |

## グループ追加

### グループ追加をする手順

1. グループ一覧画面で「グループ追加・管理」ボタンをクリックし、「グループを追加」を選択
2. グループ作成ダイアログが表示される
3. グループ名を入力
4. 「作成する」ボタンをクリック

### 設定項目

| 項目    | 説明      | 制限          |
| ----- | ------- | ----------- |
| グループ名 | グループの名前 | 最大64文字、重複不可 |

## グループ一括追加・更新（CSVアップロード）

CSVファイルをアップロードして、グループとユニットを一括で追加・更新できます。四半期ごとの大幅なグループ変更などで、手動での作成作業を効率化できます。\\

* 既存グループは更新、新規グループは追加となります
* メールアドレス列の最初のメールアドレスのユーザーが主催者となります
* 2番目以降のメールアドレスのユーザーがサブメンバーとして設定されます
* メールアドレスは「;」（セミコロン）区切りで複数指定できます
* ユニット優先度は1以上の正の整数で指定します
* 同じグループ名で複数行指定した場合は、同じグループ内の別々のユニットとして作成されます

#### 更新処理について

* グループ名が同じ場合は、グループ内のユニットがすべてCSVの内容で置き換えられます
  * 別グループとして新規作成されたり、元々のグループに追記するという動きにはなりません。完全にCSVの内容と同一になります
  * ユニット優先度も同様です。すべてCSVの内容と同一になります

### CSVファイルの形式

#### ヘッダー行（必須）

```
グループ名,ユニット優先度,メールアドレス
```

#### データ行の例

```
営業チームA,1,tanaka@example.com;sato@example.com;suzuki@example.com
営業チームA,2,yamada@example.com
営業チームB,1,takahashi@example.com;watanabe@example.com
```

生成されるグループ

* 営業チームA
  * ユニット1:
    * 優先度: 1
    * 主催者: <tanaka@example.com>
    * サブメンバー1: <sato@example.com>
    * サブメンバー2: <suzuki@example.com>
  * ユニット2:
    * 優先度: 2
    * 主催者: <yamada@example.com>
* 営業チームB
  * ユニット1:
    * 優先度: 1
    * 主催者: <takahashi@example.com>
    * サブメンバー1: <watanabe@example.com>

#### フィールドの説明

| フィールド   | 必須 | 説明                                                     |
| ------- | -- | ------------------------------------------------------ |
| グループ名   | ○  | グループの名前（既存の場合は更新、新規の場合は追加）                             |
| ユニット優先度 | ○  | 正の整数（1以上）                                              |
| メールアドレス | ○  | ユーザーのメールアドレス。「;」区切りで複数指定可能。最初のメールアドレスが主催者、以降がサブメンバーとなる |

### 操作手順

#### 1. CSVファイルの準備

1. 上記の形式に従ってCSVファイルを作成
2. ファイルサイズと行数の制限を確認（後述）

#### 2. アップロード実行

1. グループ一覧画面で「グループ追加・管理」ボタンをクリックし、「CSVアップロード」を選択
2. 準備したCSVファイルを選択
3. 「アップロード」ボタンをクリック

#### 3. 結果確認

* 成功時：グループ一覧に反映される
* エラー時：エラーメッセージが表示される

### 注意事項

* CSVファイルのサイズの上限は1MBです
* 一度に処理できるデータ行数は200行までです
* メールアドレスの区切り文字は「;」（セミコロン）です。「,」（カンマ）で区切ると列数エラーになりますのでご注意ください

### よくある質問

#### 既存のグループを更新すると、既存のユニットはどうなりますか？

既存のユニットはすべて削除され、CSVファイルで指定した新しいユニットに置き換えられます。

#### 同じグループ名で複数行指定した場合はどうなりますか？

同じグループ名の行は、それぞれ別のユニットとして作成されます

## グループCSVダウンロード <a href="#csv-export" id="csv-export"></a>

既存のグループ情報をCSVファイルとしてダウンロードできます。CSVアップロードと同じフォーマットのため、ダウンロードしたCSVを編集して再アップロードすることも可能です。

### 操作手順

1. グループ一覧画面で「グループ追加・管理」ボタンをクリック
2. ドロップダウンメニューから「CSVダウンロード」を選択
3. CSVファイルが自動的にダウンロードされる

### ダウンロードされるCSVの内容

#### フォーマット

```
グループ名,ユニット優先度,メールアドレス
```

* CSVアップロードのフォーマットと同一です
* アーカイブ済みのグループは出力されません
* グループ名の昇順、ユニット優先度の昇順でソートされます
* メールアドレスは「;」区切りで出力されます。最初のメールアドレスが主催者です

#### 出力例

```
グループ名,ユニット優先度,メールアドレス
営業チームA,1,tanaka@example.com;sato@example.com
営業チームA,2,yamada@example.com
営業チームB,1,takahashi@example.com;watanabe@example.com;suzuki@example.com
```

## グループ名編集

### グループ名を編集する方法

1. グループ一覧で対象グループの操作メニュー（縦三点アイコン）をクリック
2. ドロップダウンメニューから「グループ名編集」を選択
3. グループ編集ダイアログが表示される
4. グループ名を変更
5. 「更新する」ボタンをクリック

### 設定項目

| 項目    | 説明      | 制限          |
| ----- | ------- | ----------- |
| グループ名 | グループの名前 | 最大64文字、重複不可 |

## グループアーカイブ

グループをアーカイブすることで、使用しないグループを非表示にできます。

### 注意事項

* アーカイブはあくまで非表示にするのみで、削除ではありません。アーカイブされたグループは後から復元できます。
* すでにフローチャートルーターなどに設定されている場合でも、引き続き使用されます。

### グループアーカイブする手順

1. グループ一覧で対象グループの操作メニュー（縦三点アイコン）をクリック
2. ドロップダウンメニューから「アーカイブする」を選択
3. グループがアーカイブされる

### アーカイブ解除手順

1. 「アーカイブ済みを表示」チェックボックスをオン
2. アーカイブ済みグループの操作メニュー（縦三点アイコン）をクリック
3. ドロップダウンメニューから「アーカイブを解除する」を選択
4. グループのアーカイブが即時解除される

### 注意事項

* アーカイブ機能は、グループを削除するのではなく、非表示にする機能です
* 現在、グループの削除機能はありません

## 複数グループ一括アーカイブ

複数のグループを一括でアーカイブすることもできます。

### 複数グループを一括でアーカイブする手順

1. グループ一覧でアーカイブしたいグループのチェックボックスを選択（複数選択可能）
2. 画面下部に表示されるアクションバーの「アーカイブする」をクリック
3. 確認ダイアログが表示される
4. 「アーカイブする」ボタンをクリック
5. 選択したグループが一括でアーカイブされる

## 検索

グループ名またはグループに所属しているユーザーで検索ができます。

### 操作手順

1. グループ一覧画面の検索ボックスにグループ名、ユーザー名、またはメールアドレスを入力
2. 入力したテキストに一致するグループが表示される

### 検索対象

| 項目      | 説明                         |
| ------- | -------------------------- |
| グループ名   | グループの名前（部分一致、大文字小文字を区別しない） |
| ユーザー名   | グループに所属するユーザーの姓名           |
| メールアドレス | グループに所属するユーザーのメールアドレス      |

## アーカイブ表示切替

既にアーカイブされたグループを含めて表示するかどうかを切り替えることができます。

### 使い方

1. グループ一覧画面の「アーカイブ済みを表示」チェックボックスをオン/オフ
2. チェックがオンの場合、アーカイブ済みのグループも表示される
3. チェックがオフの場合、アーカイブ済みでないグループのみ表示される

## グループ一覧のソート

### 使い方

1. グループ一覧のヘッダー部分の項目名をクリック
2. クリックするたびにソート順が切り替わる
3. ソート中の項目にはソートアイコンが表示される

### ソート可能な項目

| 項目    | ソート方法              |
| ----- | ------------------ |
| グループ名 | アルファベット順/逆アルファベット順 |
| 更新日時  | 新しい順/古い順           |
| 最終更新者 | アルファベット順/逆アルファベット順 |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.immedio.io/user-group-management/groups/index.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
