グループ(ロール)のファイルフォーマット
グループ(ロール)の追加や変更を行うためのファイルフォーマットを説明します。
ファイルを読み込む手順は、次のページを参照してください。
ファイルを使ってユーザーや組織などを追加または変更する
ファイルフォーマット
ファイルに記入したグループだけが、追加または変更されます。
ファイルに記入した「グループコード」と一致するグループがkintone.comに存在する場合、そのグループの情報が上書きされます。
1行につき、1つのグループ(ロール)の情報を記入します。
それぞれの行には次の項目が必要です。省略することはできません。
- グループコード
- グループ名
- 新グループコード
- グループタイプ
- 説明
- 削除
上記項目の詳細は、次のページを参照してください。
グループ情報の項目
ファイルに記入する項目
情報を変更しない項目には、*(アスタリスク)を記入します。
グループコード
新規にグループを追加する場合
既存のグループのグループコードと重複しない文字列を記入します。
既存のグループの情報を変更する場合
現在のグループコードを記入します。
現在のグループコードを変更する場合は、変更後のグループコードを「新グループコード」に記入します。
グループ名
「グループ名」には必ず文字列を記入してください。
既存のグループ名と重複しない文字列を記入します。
新グループコード
「グループコード」を変更する場合
新しいグループコードを記入します。
新規にグループを追加する、または「グループコード」以外の情報を変更する場合
「グループコード」と同じ文字列、または「*」を記入します。
グループタイプ
新規にグループを追加する場合
次のどちらかを記入します。
- 静的グループ:static
- 動的グループ:dynamic
グループタイプの違いは次のページを参照してください。
グループタイプ
既存のグループの情報を変更する場合
既存グループのグループタイプ、または「*」を記入します。
静的を動的に変えるなど、グループタイプは変更できません。
削除
次のどちらかを記入します。
- グループを削除する場合
「1」を記入します。 - グループを追加、またはグループ情報を変更する場合
「*」を記入するか、空欄にします。
空白文字の削除
次の項目の先頭や末尾に空白文字がある場合、それらはファイルからデータを読み込む際に削除されます。
- グループコード
- グループ名
- 新グループコード
- グループタイプ
- 削除
CSVファイルの記述例
1行目は項目名です。記述を省略するか、ファイルを読み込む際に「先頭行をスキップする」を選択します。
情報を追加または変更しない項目には、*(アスタリスク)を記入します。
グループを追加する場合
grp001という静的グループと、grp002という動的グループを追加する例です。
グループコード, グループ名, 新グループコード, グループタイプ, 説明, 削除
grp001, Managers, *, static, *, *
grp002, Part-timers, *, dynamic, *, *
グループ情報を変更する場合
grp003のグループ情報を変更する例です。
次の項目を変更します。
- グループ名
- グループコード
- 説明
グループコード, グループ名, 新グループコード, グループタイプ, 説明, 削除
grp003, Group3(Obsolete), old-group3, *, This group was obsoleted., *
グループを削除する場合
grp004を削除する例です。
「削除」に「1」を記入します。
グループコード, グループ名, 新グループコード, グループタイプ, 説明, 削除
grp004, *, *, *, *, 1