グループ(ロール)のファイルフォーマット

記事番号:020147
対象読者: cybozu.com共通管理者

「グループ(ロール)」の追加や変更を行うためのファイルフォーマットを説明します。

ファイルを読み込む手順は、次のページを参照してください。
ファイルを使ってユーザーや組織などを追加または変更する

ファイルフォーマット

ファイルに記入した「グループ(ロール)」だけが、追加または変更されます。
ファイルに記入した「グループコード」と一致するグループがcybozu.comに存在する場合、その「グループ(ロール)」の情報が上書きされます。

1行につき、1つの「グループ(ロール)」の情報を記入します。
それぞれの行には次の項目が必要です。省略することはできません。

  • 「グループコード」
  • 「グループ名」
  • 「新グループコード」
  • 「グループタイプ」
  • 「説明」
  • 「削除」

上記項目の詳細は、次のページを参照してください。
グループ情報の項目

ファイルに記入する項目

情報を変更しない項目には、*(アスタリスク)を記入します。

「グループコード」

新規に「グループ(ロール)」を追加する場合

既存のグループの「グループコード」と重複しない文字列を記入します。

既存の「グループ(ロール)」の情報を変更する場合

現在の「グループコード」を記入します。
現在の「グループコード」を変更する場合は、変更後の「グループコード」を「新グループコード」に記入します。

「グループ名」

「グループ名」には必ず文字列を記入してください。
既存の「グループ名」と重複しない文字列を記入します。

「新グループコード」

「グループコード」を変更する場合

新しい「グループコード」を記入します。

新規に「グループ(ロール)」を追加する、または「グループコード」以外の情報を変更する場合

「グループコード」と同じ文字列、または「*」を記入します。

「グループタイプ」

新規に「グループ(ロール)」を追加する場合

次のどちらかを記入します。

  • 静的グループ:static
  • 動的グループ:dynamic

「グループタイプ」の違いは次のページを参照してください。
グループタイプ

既存の「グループ(ロール)」の情報を変更する場合

既存の「グループ(ロール)」の「グループタイプ」、または「*」を記入します。
静的を動的に変えるなど、「グループタイプ」は変更できません。

「削除」

次のどちらかを記入します。

  • 「グループ(ロール)」を削除する場合
    「1」を記入します。
  • 「グループ(ロール)」を追加、またはグループ情報を変更する場合
    「*」を記入するか、空欄にします。

空白文字の削除

次の項目の先頭や末尾に空白文字がある場合、それらはファイルからデータを読み込む際に削除されます。

  • 「グループコード」
  • 「グループ名」
  • 「新グループコード」
  • 「グループタイプ」
  • 「削除」

CSVファイルの記述例

先頭行に項目名を記述した例を次に示します。項目名の記述は省略することもできます。
先頭行に項目名を記述する場合は、ファイルの読み込み時に「先頭行をスキップする」にチェックを入れます。
情報を追加または変更しない項目には、*(アスタリスク)を記入します。

「グループ(ロール)」を追加する場合

grp001という静的グループと、grp002という動的グループを追加する例です。

コピーされました
グループコード, グループ名, 新グループコード, グループタイプ, 説明, 削除
grp001, Managers, *, static, *, *
grp002, Part-timers, *, dynamic, *, *

グループ情報を変更する場合

grp003のグループ情報を変更する例です。
次の項目を変更します。

  • 「グループ名」
  • 「グループコード」
  • 「説明」
コピーされました
グループコード, グループ名, 新グループコード, グループタイプ, 説明, 削除
grp003, Group3(Obsolete), old-group3, *, This group was obsoleted., *

「グループ(ロール)」を削除する場合

grp004を削除する例です。
「削除」に「1」を記入します。

コピーされました
グループコード, グループ名, 新グループコード, グループタイプ, 説明, 削除
grp004, *, *, *, *, 1