組織 / ユーザー / ロール

組織、ユーザー、およびロールに関するデータの読み込みに使用するCSVファイルのフォーマットを説明します。

組織情報

組織情報の読み込みに使用するCSVファイルのフォーマットを説明します。
組織は、子組織が親組織のコードを認識することで階層化されます。CSVファイルで階層化した組織を読み込む場合は、子組織のレコードに親組織を記述します。
注意
  • Garoonでは、CSVファイルで読み込むことができるデータのうち、「組織情報」だけは、追記されずに上書きされます。
    そのため、CSVファイルから「組織情報」を読み込む場合、既存の組織が、CSVファイルの「現組織コード」に記載されていないと、その組織は削除されます。
    「組織情報」をCSVから読み込む場合は、CSVファイルにすべての「組織情報」を記載してください。
  • 運用管理者は、運用管理権限のある組織と、その下位の階層にある組織に対してのみ、組織情報をCSVファイルで管理できます。
    運用管理者の場合は、CSVファイルに自身が管理権限をもつすべての「組織情報」を記載してください。
  • 親組織は子組織よりも先に記述してください。
  • 運用管理者がCSVファイルから組織データを読み込む場合、「親組織コード」に「*」(アスタリスク)は指定できません。
補足
  • フィールドに「*」(アスタリスク)を設定すると、そのフィールドは上書きされません。
  • 新規に組織を追加する場合
    「現組織コード」と「新組織コード」について、次のように設定します。
    • 「現組織コード」に、「*」(アスタリスク)を設定する
    • 「新組織コード」に、追加する組織の組織コードを設定する
  • 既存の組織の組織コードを変更せずに、既存の組織情報を変更する場合
    「現組織コード」と「新組織コード」について、次のように設定します。
    • 「現組織コード」に、Garoonに登録されている組織の組織コードを設定する
    • 「新組織コード」に、「*」(アスタリスク)を設定する
  • 既存の組織の組織コードを変更する場合
    「現組織コード」と「新組織コード」について、次のように設定します。
    • 「現組織コード」に、変更する組織の組織コードを設定する
    • 「新組織コード」に、変更後の組織コードを設定する
CSVファイルの書式
現組織コード,組織名,新組織コード,親組織コード,メモ
記述例:
組織情報のCSVファイルの記述例
CSVファイルの項目と仕様
項目 文字数 必須 備考
現組織コード 100文字  
組織名 100文字 標準の組織名を記述します。
新組織コード 100文字  
親組織コード 100文字   指定しない場合は、最上位階層の組織が設定されます。
メモ 65535文字   1バイト文字を最大65535文字記述できます。
使用する文字のバイト数によって記述できる文字数が異なります。

組織の所属ユーザー

組織の所属ユーザーの読み込みに使用するCSVファイルのフォーマットを説明します。
注意
  • Garoonに登録されていない、組織コードまたはログイン名が記述されたCSVファイルを読み込むと、エラーが発生します。
    組織の所属ユーザーのCSVファイルには、Garoonに登録されている組織コードまたはログイン名を記述してください。
  • 運用管理者は、運用管理権限のある組織と、その下位の階層にある組織に対してのみ、組織の所属ユーザーの情報をCSVファイルで管理できます。
    読み込むCSVファイルに、管理権限のない組織を記載すると、エラーが発生します。自身が管理権限をもつ組織かどうかを確認してください。
CSVファイルの書式
組織コード,ログイン名1,ログイン名2,ログイン名3,...
記述例:
組織の所属ユーザーのCSVファイルの記述例
CSVファイルの項目と仕様
項目 文字数 必須 備考
組織コード 100文字 所属ユーザーを設定する組織の組織コードを記述します。
ログイン名1
ログイン名2
ログイン名3
...
100文字   所属ユーザーのログイン名を記述します。

組織名

言語ごとの組織名の読み込みに使用するCSVファイルのフォーマットを説明します。
注意
  • 組織名データのCSVファイルに記述されている組織が、Garoonに登録されている必要があります。
  • 言語コードを指定し、組織名を空欄にすると、指定した言語の組織名が削除されます。
CSVファイルの書式
組織コード,言語コード,組織名
記述例:
組織名のCSVファイルの記述例
CSVファイルの項目と仕様
項目 文字数 必須 備考
組織コード 100文字  
言語コード   次のいずれかの言語コードを記述します。
  • ja
    日本語の言語コードです。
  • en
    英語の言語コードです。
  • zh
    中国語(简体)の言語コードです。
  • zh-tw
    中国語(繁體)の言語コードです。
    中国語(繁體)とは、繁体字のことです
組織名 100文字   言語ごとの組織名を記述します。

ユーザー情報

ユーザー情報の読み込みに使用するCSVファイルのフォーマットを説明します。
GaroonのCSVファイルによるユーザー管理は、1つのファイルで次の処理が可能です。
  • ユーザーの追加
  • ユーザー情報の更新
  • ユーザーの削除
注意
  • 運用管理者は、運用管理権限のある組織と、その下位の階層にある組織に対してのみ、ユーザーの情報をCSVファイルで管理できます。
    読み込むCSVファイルに、管理権限のない組織に所属するユーザーのユーザーデータが含まれていると、エラーが発生します。自身が管理権限をもつ組織に所属するユーザーかどうかを確認してください。
補足
  • フィールドに「*」(アスタリスク)を設定すると、そのフィールドは上書きされません。
CSVファイルの書式
現ログイン名,名前,名前の言語,英語表記,新ログイン名,パスワード,ロケール,拠点,表示優先度,使用/停止,削除フラ グ,よみ,E-mail,メモ,役職,連絡先,URL(,ユーザー情報のカスタマイズ項目...)
記述例:
ユーザー情報のCSVファイルの記述例
補足
  • ユーザーを追加する場合
    追加するユーザーの「現ログイン名」は、すでにGaroonに登録されているユーザーのログイン名とは異なる必要があります。ログイン名が重複していると、ユーザー情報の変更とみなされます。
    ユーザーを追加する場合のCSVファイルの記述例
  • ユーザー情報を変更する場合
    ユーザー情報は、すべてのフィールドを変更できます。情報を変更したくないフィールドには「*」(アスタリスク)を設定します。
    たとえば、Garoonの導入時はパスワードフィールドに初期パスワードを設定しますが、次回からは「*」(アスタリスク)を設定します。次回以降に「*」(アスタリスク)を設定しなかった場合、ユーザーがパスワードを変更していても、CSVファイルに設定されたパスワードが上書きして設定されてしまいます。
    ユーザー情報を変更する場合のCSVファイルの記述例
  • ユーザーを削除する場合
    Garoonに登録されているユーザーを削除する場合は、「削除フラグ」に「1」を設定します。
    ユーザーを削除する場合のCSVファイルの記述例
    削除したユーザーのスケジュールやメッセージなどのデータは、システム管理の「ユーザーデータの削除時間の設定」画面で設定した削除時間に、自動的に削除されます。
    詳細は、ユーザーデータの削除時間を設定する方法を参照してください。
CSVファイルの項目と仕様
  • 読み込み項目
    項目 文字数 必須 備考
    現ログイン名 100文字 現ログイン名には、「*」(アスタリスク)を指定することはできません。
    Garoon全体でユニークである必要があります。
    名前 100文字 標準のユーザー名を記述します。
    名前の言語   次のいずれかの言語コードを記述します。
    • ja
      日本語の言語コードです。
    • en
      英語の言語コードです。
    • zh
      中国語(简体)の言語コードです。
    • zh-tw
      中国語(繁體)の言語コードです。
      中国語(繁體)とは、繁体字のことです
    英語表記 100文字   英語表記の入力欄を使用している場合には、英語で表示するユーザー名を記述します。
    新ログイン名 100文字  
    パスワード 64文字   ユーザーが設定したパスワードをCSVファイルの読み込み時に上書きしないようにする場合は、「*」を記述します。
    ロケール 100文字    
    拠点 100文字    
    表示優先度 8文字   ユーザーの一覧画面で表示する優先度を0(ゼロ)以上の整数で記述します。
    8桁まで指定できます。
    使用/停止     次のいずれかを記述します。
    • 0
      利用を禁止する場合に記述します。
    • 1
      利用を許可する場合に記述します。
    省略した場合は、「0」が読み込まれ、ユーザーを停止します。
    削除フラグ     登録されているユーザーを削除する場合は、「1」を記述します。
    よみ 100文字    
    E-mail 100文字    
    メモ 65535文字   1バイト文字を最大65535文字記述できます。
    使用する文字のバイト数によって記述できる文字数が異なります。
    役職 100文字    
    連絡先 100文字    
    URL 255文字    
  • カスタマイズ項目
    項目 文字数 必須1 備考
    文字列(1行) 100文字    
    文字列(複数行) 65535文字   1バイト文字を最大65535文字記述できます。
    使用する文字のバイト数によって記述できる文字数が異なります。
    URL 255文字    
    画像URL 255文字    
    E-mail 100文字    
    IP電話 100文字    
    パスワード 64文字    

    1:項目の設定で「必須項目にする」のチェックボックスを選択している場合は、必須です。

バージョン 3.0以前のCSVファイルの書式
バージョン 3.0以前のフォーマットを使用すると、ローカライズに関する情報の書き出しまたは読み込みができません。
現ログイン名,名前,新ログイン名,パスワード,表示優先度,使用/停止,削除フラグ,よみ,E-mail ,メモ,役職,連絡先,URL(,ユーザー情報のカスタマイズ項目...)

ユーザーの所属組織

ユーザーの所属組織の読み込みに使用するCSVファイルのフォーマットを説明します。
注意
  • Garoonに登録されていない、ログイン名または組織コードが記述されたCSVファイルを読み込むと、エラーが発生します。
    ユーザーの所属組織のCSVファイルには、Garoonに登録されているログイン名または組織コードを記述してください。
CSVファイルの書式
ログイン名,組織コード1(優先する組織),組織コード2,組織コード3,...
記述例:
ユーザーの所属組織のCSVファイルの記述例
CSVファイルの項目と仕様
項目 文字数 必須 備考
ログイン名 100文字 所属組織を設定するユーザーのログイン名を記述します。
組織コード1
組織コード2
組織コード3
...
100文字   所属組織の組織コードを記述します。
先頭の組織コードが「優先する組織」になります。

ユーザーの所持ロール

ユーザーの所持ロールの読み込みに使用するCSVファイルのフォーマットを説明します。
注意
  • Garoonに登録されていない、ログイン名またはロール名が記述されたCSVファイルを読み込むと、エラーが発生します。
    ユーザーの所持ロールのCSVファイルには、Garoonに登録されているログイン名またはロール名を記述してください。
CSVファイルの書式
ログイン名,ロール名1,ロール名2,ロール名3,...
記述例:
ユーザーの所持ロールのCSVファイルの記述例
CSVファイルの項目と仕様
項目 文字数 必須 備考
ログイン名 100文字 所持ロールを設定するユーザーのログイン名を記述します。
ロール名1
ロール名2
ロール名3
...
100文字   所持ロールのロール名を記述します。

ロール情報

ロール情報の読み込みに使用するCSVファイルのフォーマットを説明します。
注意
  • ロールを追加する場合、「ロール名」には、すでにGaroon登録されているロールと異なるロール名を記述する必要があります。ロール名が重複していると、ロール情報の変更とみなされます。
  • CSVファイルを使用した、ロール名の変更、および削除はできません。
CSVファイルの書式
ロール名,メモ
記述例:
ロール情報のCSVファイルの記述例
CSVファイルの項目と仕様
項目 文字数 必須 備考
ロール名 100文字 Everyone、LoginUser、Owner、CommandLine、Administratorsは、ロール名として使用できません。
メモ 65535文字   1バイト文字を最大65535文字記述できます。
使用する文字のバイト数によって記述できる文字数が異なります。

ロールの所持ユーザー

ロールの所持ユーザーの読み込みに使用するCSVファイルのフォーマットを説明します。
注意
  • Garoonに登録されていない、ロール名またはログイン名が記述されたCSVファイルを読み込むと、エラーが発生します。
    ロールの所持ユーザーのCSVファイルには、Garoonに登録されているロール名またはログイン名を記述してください。
CSVファイルの書式
ロール名,ログイン名1,ログイン名2,ログイン名3,...
記述例:
ロールの所持ユーザーのCSVファイルの記述例
CSVファイルの項目と仕様
項目 フィールド長
(文字数)
必須 備考
ロール名 100文字 所持ユーザーを設定するロール名を記述します。
ログイン名1
ログイン名2
ログイン名3
...
100文字   所持ユーザーのログイン名を記述します。