グループ一覧（CSV形式）

グループの追加・変更・削除を行うための CSVフォーマットについて解説します。

Note:

グループ関連の CSVフォーマットは3種類あります。それぞれの用途は以下の通りです。

グループ一覧 ：グループの追加や削除、名称変更ができます。メンバー情報などは含みません。
サービスグループ一覧 ：サービスプロバイダーにグループをプロビジョニング連携している場合に使用します。サービスプロバイダー側のグループIDを登録、または削除できます。
グループメンバー一覧 ：既存のグループへメンバーを追加、または削除できます。

それぞれのフォーマットに従ってCSVファイルを作成し一括処理操作を行うことで、画面上で操作することなく、複数のグループやメンバーの追加・変更・削除をまとめて行うことができます。

ダウンロード時と一括処理のためのアップロード時で CSVフォーマットは共通です。

CAUTION:

グループを「グループ一覧」から削除すると、そのグループに紐づくメンバーや、サービスIDなどすべての設定値が削除されます。この操作は元に戻せませんのでご注意ください。

ここでは、グループ一覧の CSVフォーマットについて解説します。

CSVファイル作成時の注意点

文字コードは「UTF-8」形式、「BOMなし」に設定し作成してください。
ファイルの１行目に CSV項目を記載し、2行目以降に値を記載します。１行で１グループ分のデータが設定できますので、複数のグループを設定する場合は１グループ分ずつ複数行に分けて記載してください。
CSV項目や値はカンマ区切りで作成してください。カンマ以外の区切り文字はサポートしていません。
CSV項目は大文字・小文字を区別しません。
データの操作（作成・更新・削除）により必須項目は異なります。必須項目はもれなく含めてください。

1行目に CSV項目、2行目以降に各項目の値を記載した作成例です。

operation	groupId	displayName	description
CREATE	sales@example.com	営業部ML	営業部のメーリングリスト
CREATE	system@example.com	情報システム部ML

テキストエディターでは以下のように確認できます。

"operation","groupId","displayName","description"

"CREATE","sales@example.com","営業部ML","営業部のメーリングリスト"

"CREATE","system@example.com","情報システム部ML",""

CSV項目	画面表示項目	入力値	必須
			作成	更新	削除
			operation	-	グループを作成する場合は"CREATE" 更新する場合は"UPDATE" 削除する場合は"DELETE"と記載します。大文字・小文字は区別されません。空欄にした場合は、処理は行われません。	●	●	●
groupId	グループID	グループIDを記載します。必須項目ですので空欄にすることはできません。作成の場合、グループIDは「XXX@レルム名」の形式で任意の IDを記載します。その際、＠以前の文字列は、半角記号< > =を除く、半角英小文字、半角数字64文字以内で記載します。@以降の文字列は、既存のレルム名を記載します。	●	●	●
displayName	表示名	表示名を記載します。半角全角255文字以内で記載します。作成・更新の場合は、必須項目のため空欄にすることはできません。	●	●
description	説明	グループの説明を記載します。半角記号< > =を除く、半角全角1024文字以内で記載します。空欄でも構いません。更新時に空欄にした場合は空欄で更新されます。 Note: Google Workspaceや Microsoft 365とプロビジョニング連携を設定している場合、この項目もプロビジョニングの対象となり、自動的に更新されます。	●	●