グループ一覧（CSV形式）
グループの追加・変更・削除を行うための CSVファイルについて解説します。
ダウンロードされる CSVファイルも同様の形式で保存されます。
CSVファイル作成時の注意点
-
文字コードは「UTF-8」形式、「BOMなし」に設定し作成してください。
-
ファイルの１行目に CSV項目を記載し、2行目以降に値を記載します。１行で１グループ分のデータが設定できますので、複数のグループを設定する場合は１グループ分ずつ複数行に分けて記載してください。
-
CSV項目や値はカンマ区切りで作成してください。カンマ以外の区切り文字はサポートしていません。
-
CSV項目は大文字・小文字を区別しません。
-
データの操作（作成・更新・削除）により必須項目は異なります。必須項目はもれなく含めてください。
グループ情報の CSVファイル作成例
- 1行目に CSV項目、2行目以降に各項目の値を記載した CSVファイルの作成例です。Google Workspaceの場合を例にしています。
- グループは、Google Workspaceや Microsoft 365のプロビジョニング連携で対象となります。
- グループのメンバーごとに１行ずつレコードを記載します。
| operation | groupId | displayName | description | googleGroupActive | googleGroupId | memberType | ・・・ |
|---|---|---|---|---|---|---|---|
| CREATE | group1@example.com | 第一グループ | 営業部のグループ | TRUE | group1@example.com | USER | ・・・ |
| CREATE | group2@example.com | 第二グループ | TRUE | group2@example.com | USER | ・・・ |
テキストエディターでは以下のように確認できます。
| "operation","groupId","displayName","description","googleGroupActive","googleGroupId","memberType",・・・ "CREATE","group1@example.com","第一グループ","第一グループ","TRUE","group1@example.com","USER",・・・ "CREATE","group2@example.com","第二グループ","","TRUE","group2@example.com","USER",・・・ |
グループ情報の項目一覧
- 更新の場合、memberTypeや memberIdを変更すると Google Workspaceや Microsoft 365のプロビジョニング時に既存メンバーは削除され、新たにメンバーが再登録されます。
- 一括処理で、Google Workspaceグループの投稿権限設定や公開設定などが変更されることはありません。
| CSV項目 | 画面表示項目 | 入力値 | 必須 | ||
|---|---|---|---|---|---|
| 作成 | 更新 | 削除 | |||
| operation | - | グループを 作成する場合は"CREATE" 更新する場合は"UPDATE" 削除する場合は"DELETE"と記載します。 大文字・小文字は区別されません。 Google Workspaceや Box、Microsoft 365と連携させるための有効フラグやその他の設定は、 グループの作成時（"CREATE"）と更新時（"UPDATE"）に行うことができます。 空欄にした場合は、処理は行われません。 |
● | ● | ● |
| groupId | グループID | グループIDを記載します。 必須項目ですので空欄にすることはできません。 作成の場合、グループIDは「XXX@レルム名」の形式で任意の IDを記載します。その際、＠以前の文字列は、 半角記号< > =を除く、半角英小文字、半角数字64文字以内で記載します。@以降の文字列は、既存のレルム名を記載します。 |
● | ● | ● |
| displayName | 表示名 | 表示名を記載します。 半角全角255文字以内で記載します。 作成・更新の場合は、必須項目のため空欄にすることはできません。 |
● | ● | |
| description | 説明 | グループの説明を記載します。 半角記号< > =を除く、半角全角1024文字以内で記載します。 更新時に空欄にした場合は空欄で更新されます。
Note: Google Workspaceや Microsoft 365とプロビジョニング連携をした場合に対象となります。
|
● | ● | |
| Google Workspace連携の場合 | |||||
| googleGroupActive | Google有効フラグ | Google Workspace連携を 有効にする場合は"TRUE" 無効にする場合は"FALSE"と記載します。 大文字・小文字は区別されません。
CAUTION:
"TRUE"の場合は、googleGroupIdを記載する必要があります。
|
|||
| googleGroupId | Google WorkspaceグループID | Google Workspace側のグループID（メールアドレス）を指定します。 半角記号- _ . ' @を含む半角英数字255文字以内で記載可能です。 この値の変更はできません。 |
|||
| Box連携の場合 | |||||
| boxGroupActive | Box有効フラグ | Box連携を 有効にする場合は"TRUE" 無効にする場合は"FALSE"と記載します。 大文字・小文字は区別されません。
CAUTION:
"TRUE"の場合は、boxGroupIdを記載する必要があります。
|
|||
| boxGroupId | BoxグループID | Box側のグループIDを指定します。 半角全角255文字以内で記載可能です。 |
|||
| Microsoft 365連携の場合 | |||||
| office365ProviderName | Microsoft 365のサービスプロバイダー表示名 | Microsoft 365のサービスプロバイダー表示名を記載します。
Note: 左メニューの
から編集画面にて確認できます。
|
|||
| office365GroupActive | Microsoft 365有効フラグ | Microsoft 365連携を 有効にする場合は"TRUE" 無効にする場合は"FALSE"を記載します。 大文字・小文字は区別されません。 |
|||
| office365GroupId | Microsoft 365グループID | 作成の場合は空欄にします。 更新・削除の場合は Microsoft 365側のグループID（uuid）を記載します。 |
|||
| office365GroupType | Microsoft 365グループタイプ | 連携させる Microsoft 365側のグループタイプを記載します。 現在対応しているグループタイプはセキュリティ グループのみですので、"SECURITY"と記載します。 大文字・小文字は区別されません。 |
|||
| cybozu.com連携の場合 | |||||
| cybozuProviderName | cybozu.comのサービスプロバイダー表示名 | cybozu.comのサービスプロバイダー表示名を記載します。
Note: 左メニューの
から編集画面にて確認できます。
|
|||
| cybozuGroupActive | cybozu.com有効フラグ | cybozu.com連携を 有効にする場合は"TRUE" 無効にする場合は"FALSE"を記載します。 大文字・小文字は区別されません。 |
|||
| cybozuGroupId | cybozu.comグループID | 作成の場合は空欄にします。 更新・削除の場合は cybozu.com側のグループID（uuid）を記載します。 |
|||
| グループメンバー
Note:
|
|||||
| memberType | メンバータイプ | メンバーのタイプを記載します。 メンバーが CloudGate UNO の ユーザーアカウントの場合は"USER" グループの場合は"GROUP" 存在しない場合は"OTHER"を記載します。 大文字・小文字は区別されません。 OTHERの場合は、Microsoft 365連携でプロビジョニング対象外となります。
CAUTION:
グループの場合は、memberPermissionを記載する必要があります。
|
|||
| memberId | メンバーID | ユーザーIDまたはグループIDを指定します。 メンバータイプが OTHERの場合はメールアドレスとなります。 |
|||
| memberPermission | メンバー権限 | メンバーの権限を記載します。 メンバーの権限を オーナーにする場合は"OWNER" マネージャーにする場合は"MANAGER" メンバーにする場合は"MEMBER"を記載します。 大文字・小文字は区別されません。
Note: Microsoft 365連携では対象外となります。
|
|||
