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

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

1行ごとに1つの「組織」の情報を記入します。
ファイルに記入した「組織コード」と一致する「組織」がcybozu.comに存在する場合、その「組織」の情報が上書きされます。

それぞれの行には次の項目が必要です。省略することはできません。

• 「組織コード」
• 「表示名」
• 「新組織コード」
• 「別言語での表示名」
• 「別言語の名前を表示する言語」
• 「親組織コード」
• 「説明」

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

読み込むファイルには、必要な「組織」すべてを記入してください。
記入していない「組織」は、cybozu.comから削除されます。

意図せず「組織」が削除されることを防ぐため、既存の「組織」を書き出したファイルを使って、読み込み用のファイルを作成することを推奨します。
ファイルの書き出し手順は次のページを参照してください。
ユーザーや組織などの情報をファイルに書き出す

「組織」の情報を削除するには、削除する「組織」を読み込むファイルから除きます。
組織を削除する場合の注意事項

情報を変更しない項目には、*（アスタリスク）を記入します。
「親組織」は、子組織よりも上の行に記入します。

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

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

「表示名」には必ず文字列を記入してください。

新しい「組織コード」を記入します。

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

「表示名」とは別に、言語に応じた表示名を記入できます。
たとえば、日本語ユーザーには「営業部」と表示し、英語ユーザーには「Sales.Div」と表示するといった運用ができます。

「別言語での表示名」を記入した場合、次のいずれかを必ず記入します。

• 日本語：ja
• 英語：en
• 中国語（簡体字）：zh
• 中国語（繁体字）：zh-TW
• スペイン語：es
• ポルトガル語（ブラジル）：pt-BR
• タイ語：th

「親組織」の「組織コード」を記入します。
空欄の場合、最上位の階層の「組織」になります。

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

• 「組織コード」
• 「表示名」
• 「新組織コード」
• 「別言語での表示名」
• 「別言語の名前を表示する言語」
• 「親組織コード」

先頭行に項目名を記述した例を次に示します。項目名の記述は省略することもできます。
先頭行に項目名を記述する場合は、ファイルの読み込み時に「先頭行をスキップする」にチェックを入れます。
情報を変更しない既存の「組織」も記入します。記入されていない「組織」は、cybozu.comから削除されます。

• 最上位の階層の「組織」として、org001が存在する。
• org001の子組織として、org001-01が存在する。
• org001の子組織として、org001-02が存在する。

この状態で組織情報を書き出すと、次の内容が書き出されるとします。

組織コード, 表示名, 新組織コード, 別言語での表示名, 別言語の名前を表示する言語, 親組織コード, 説明
org001, 営業部, org001, Sales Division, en, ,
org001-01, 国内営業部, org001-01, Domestic Sales Department, en, org001,
org001-02, 海外営業部, org001-02, International Sales Department, en, org001,

前提条件の「組織」に対して、次の「組織」を追加する例です。

• 最上位の階層の「組織」として、org002を追加する。
• org001-01の子組織としてorg001-01-01を追加する。

org002とorg001-01-01を、ファイルに追記します。

組織コード, 表示名, 新組織コード, 別言語での表示名, 別言語の名前を表示する言語, 親組織コード, 説明
org001, *, *, *, *, , *
org001-01, *, *, *, *, org001, *
org001-02, *, *, *, *, org001, *
org002, 情報システム部, *, System Department, en, , *
org001-01-01, 国内第一営業部, *, First Domestic Sales Department, en, org001-01, *

org001-01とorg001-02の「表示名」を変更する例です。

組織コード, 表示名, 新組織コード, 別言語での表示名, 別言語の名前を表示する言語, 親組織コード, 説明
org001, *, *, *, *, , *
org001-01, 営業部（国内）, *, *, *, org001, *
org001-02, 営業部（海外）, *, *, *, org001, *

org001-02という「組織」を削除する例です。
削除する「組織」はファイルに記入しません。

組織コード, 表示名, 新組織コード, 別言語での表示名, 別言語の名前を表示する言語, 親組織コード, 説明
org001, *, *, *, *, , *
org001-01, *, *, *, *, org001, *