このガイドでは、既存のユーザーを1つ以上のグループから他のグループに追加する方法を、Data Explorerと一括招待機能を組み合わせて説明します。
必要なユーザーレベル: 管理者
概要
このガイドでは、以下の方法を説明します。
- 特定のグループからユーザーを選択するためのData Explorerクエリを作成する
- クエリ結果をCSVファイルとしてダウンロードする
- 一括招待機能を使用して、これらのユーザーを新しいグループに追加する
要件
- Data Explorerプラグインがインストールされていること
- Discourseインスタンスへの管理者アクセス権
ユーザーグループに対して一括操作を実行する前には、必ずバックアップを作成してください。
Data Explorerクエリの作成
- 管理 → プラグイン → Data Explorer に移動します
- 新しいクエリを作成します
- クエリに名前を付けます（例：「グループ追加対象ユーザーの選択」）
- 以下のSQLコードをクエリ入力に貼り付けます。
--[params]
-- string_list :group_name
-- string_list :new_group_names
SELECT ue.email, :new_group_names as "groups"
FROM users u
INNER JOIN group_users gu ON u.id = gu.user_id
INNER JOIN groups g on g.id = gu.group_id
INNER JOIN user_emails ue on u.id = ue.user_id
WHERE g.name IN (:group_name)
AND ue.primary = true
- 「変更を保存」をクリックします
group_nameおよびnew_group_namesの入力欄が表示されない場合は、ページを再読み込みしてください
これで、Data Explorerの画面が次のようになります。
クエリの実行と結果のダウンロード
group_nameフィールドに、元のグループ名を入力しますnew_group_namesフィールドに、ターゲットグループ名を入力します- クエリを実行して、出力内容を確認します
CSVボタンをクリックして、結果をCSVファイルとしてダウンロードします
複数のグループからユーザーを選択する場合はグループ名をコンマ (,) で区切ります。ユーザーを複数のグループに追加する場合はグループ名をセミコロン (
で区切ります。
ユーザーの一括招待（新しいグループへ）
- プロファイルの招待済みページ (
/my/invited) に移動します - 一括招待ボタンをクリックします
- ダウンロードしたCSVファイルを選択します
- ファイルを処理するために「一括招待」をクリックします
グループ追加の確認
一括招待処理後、ターゲットグループを確認し、ユーザーが正しく追加されていることを確認してください。
たとえば、開始時に「grapes」グループにこれらのユーザーがいた場合：
そして、「fruits」グループが最初は空だった場合：
一括招待後、「fruits」グループにはデータが格納されているはずです。
複数のグループの選択
複数のグループからユーザーを選択し、複数のグループに追加することができます。
- 複数のグループからユーザーを選択するには、グループ名をコンマ (,) で区切ります:
grapes,cherries - ユーザーを複数のグループに追加するには、グループ名をセミコロン ( で区切ります:
fruits;vegetables