組織のファイルフォーマット
組織の追加や変更を行うためのファイルフォーマットを説明します。
ファイルの読み込み手順は、次のページを参照してください。
ファイルを使ってユーザーや組織などを追加または変更する
ファイルフォーマット
1行ごとに1つの組織の情報を記入します。
ファイルに記入した「組織コード」と一致する組織がcybozu.comに存在する場合、その組織の情報が上書きされます。
それぞれの行には次の項目が必要です。省略することはできません。
- 組織コード
- 表示名
- 新組織コード
- 別言語での表示名
- 別言語の名前を表示する言語
- 親組織コード
- 説明
上記項目の詳細は、次のページを参照してください。
組織情報の項目
ファイル作成時の注意事項
読み込むファイルには、必要な組織すべてを記入してください。
記入していない組織は、cybozu.comから削除されます。
意図せず組織が削除されることを防ぐため、既存の組織を書き出したファイルを使って、読み込み用のファイルを作成することを推奨します。
ファイルの書き出し手順は次のページを参照してください。
ユーザーや組織などの情報をファイルに書き出す
組織を削除する場合
組織の情報を削除するには、削除する組織を読み込むファイルから除きます。
組織を削除する場合の注意事項
ファイルに記入する項目
情報を変更しない項目には、*(アスタリスク)を記入します。
親組織は、子組織よりも上の行に記入します。
組織コード
新規に組織を追加する場合
既存の組織の組織コードと重複しない文字列を記入します。
既存の組織の情報を変更する場合
現在の組織コードを記入します。
組織コードを変更する場合も「組織コード」には現在の組織コードを記入してください。変更後の組織コードは「新組織コード」に記入します。
表示名
「表示名」には必ず文字列を記入してください。
新組織コード
「組織コード」を変更する場合
新しい組織コードを記入します。
新規に組織を追加する、または「組織コード」以外の情報を変更する場合
「組織コード」と同じ文字列、または「*」を記入します。
別言語での表示名
「表示名」とは別に、言語に応じた表示名を記入できます。
たとえば、日本語ユーザーには「営業部」と表示し、英語ユーザーには「Sales.Div」と表示するといった運用ができます。
別言語の名前を表示する言語
「別言語での表示名」を記入した場合、次のいずれかを必ず記入します。
- 日本語:ja
- 英語:en
- 中国語(簡体字):zh
- 中国語(繁体字):zh-TW
- スペイン語:es
親組織コード
親組織の組織コードを記入します。
空欄の場合、最上位の階層の組織になります。
空白文字の削除
次の項目の先頭や末尾に空白文字がある場合、それらはファイルからデータを読み込む際に削除されます。
- 組織コード
- 表示名
- 新組織コード
- 別言語での表示名
- 別言語の名前を表示する言語
- 親組織コード
ファイルの例
前提条件
- org001が存在する。
- org001の子組織として、org001-1が存在する。
- org001の子組織として、org001-2が存在する。
実施する操作の例
- org001を変更しない。
- org001-1の表示名を「営業部」に変更する。
- org001-1の子組織として、org001-1-1を追加する。
- org001-2を削除する。
- 最上位の階層の組織として、org002を追加する。
CSVファイルの記述例
組織コード, 表示名, 新組織コード, 別言語での表示名, 別言語の名前を表示する言語, 親組織コード, 説明
org001, *, *, *, *, ,*
org001-1, 営業部, *, *, *, org001,*
org001-1-1, 第1グループ, *, Sales Group#1, en, org001-1,
org002, 人事部, *, , , ,
先頭行は「項目名」です。記述を省略するか、ファイルを読み込む際に「先頭行をスキップする」を選択します。
削除する組織(org001-2)はファイルに記入しません。