マルチレポート

マルチレポートに関するデータのCSVファイルのフォーマットを説明します。

カテゴリー

カテゴリーの読み込みに使用するCSVファイルのフォーマットを説明します。
CSVファイルの書式
親カテゴリーコード,カテゴリーコード,カテゴリー名,メモ
記述例:
CSVファイルの記述例の画像
CSVファイルの項目と仕様
項目 文字数 必須 備考
親カテゴリーコード 100文字   ルートに配置するカテゴリーは「ROOT_CATEGORY」を記述します。省略した場合は、ルートに配置されます。
カテゴリーコード 100文字  
カテゴリー名 100文字 標準のカテゴリー名を記述します。
メモ 65535文字   1バイト文字を最大65535文字記述できます。使用する文字のバイト数によって記述できる文字数が異なります。

カテゴリー名

言語ごとのカテゴリー名の読み込みに使用するCSVファイルのフォーマットを説明します。
注意
  • 「カテゴリーコード」に、Garoonに登録されていないカテゴリーのカテゴリーコードが設定されていた場合、その言語ごとのカテゴリー名は読み込まれません。
  • CSVファイルを読み込ませることで、CSVファイルに記載しなかった既存の言語ごとのカテゴリー名が、削除されることはありません。
    ただし、「言語コード」を記述していても、「カテゴリー名」を空欄にすると、その言語のカテゴリー名は削除されます。
CSVファイルの書式
カテゴリーコード,言語コード,カテゴリー名
記述例:
CSVファイルの記述例の画像
CSVファイルの項目と仕様
項目 文字数 必須 備考
カテゴリーコード 100文字  
言語コード   次のいずれかの言語コードを記述します。
  • ja
    日本語の言語コードです。
  • en
    英語の言語コードです。
  • zh
    中国語(简体)の言語コードです。
  • zh-tw
    中国語(繁體)の言語コードです。
    中国語(繁體)とは、繁体字のことです
カテゴリー名 100文字   言語ごとのカテゴリー名を記述します。

アクセス権

アクセス権の読み込みに使用するCSVファイルのフォーマットを説明します。
アクセス権は、カテゴリーに対して設定します。アクセス権を設定するカテゴリーごとに、セキュリティモデルを設定する行と、アクセス権を設定する行を記述します。
補足
  • アクセス権のデータを読み込む場合、CSVファイルに記述されている対象がGaroonに登録されていないと、エラーが発生します。
  • CSVファイルからアクセス権データを読み込むと、既存のアクセス権データとの差分が読み込まれます。
CSVファイルの書式
  • セキュリティモデルを設定する行:
    カテゴリーのセキュリティモデルを記述します。書式は、次のとおりです。
    カテゴリーコード,設定項目,設定値
  • アクセス権を設定する行:
    設定するアクセス権を、設定対象ごとに行を分けて記述します。書式は、次のとおりです。
    カテゴリーコード,設定項目,設定値,設定対象
記述例:
CSVファイルの記述例の画像

a) :1件目のデータ

b) :2件目のデータ

c) :セキュリティモデルを設定する行

d) :アクセス権を設定する行

セキュリティモデルを設定する行の項目と仕様
項目 文字数 必須 備考
カテゴリーコード 100文字  
設定項目   「security_model」を記述します。
設定値   次のどちらかを記述します。
  • revoke
    制限の対象を選択する場合に記述します。
  • grant
    許可の対象を選択する場合に記述します。
「revoke」と「grant」についての詳細は、セキュリティモデルの説明を参照してください。
アクセス権を設定する行の項目と仕様
項目 文字数 必須 備考
カテゴリーコード 100文字 セキュリティモデルを設定する行と同じカテゴリーコードを記述します。
設定項目   アクセス権を設定する対象の種別を記述する項目です。記述できる種別は、次のとおりです。
  • user
    ユーザーのアクセス権を設定する場合に記述します。
  • group
    組織のアクセス権を設定する場合に記述します。
  • dynamic_role
    動的ロールのアクセス権を設定する場合に記述します。
  • role
    ロールのアクセス権を設定する場合に記述します。
設定値    
  • セキュリティモデルが制限の対象を選択するrevokeの場合:
    何も記述しません。
    「設定対象」に記述したユーザー、組織、またはロールのアクセス権がすでに登録されている場合、「設定値」に「B」を記述してCSVファイルを読み込むと、その登録情報が削除されます。
  • セキュリティモデルが許可の対象を選択するgrantの場合:
    「B」を記述します。
    「設定対象」に記述したユーザー、組織、またはロールのアクセス権がすでに登録されている場合、「設定値」を空にしてCSVファイルを読み込むと、その登録情報が削除されます。
設定対象 100文字 「設定項目」の種別に応じたコードを記述します。記述できるコードは、次のとおりです。
  • ログイン名
    「設定項目」に「user」を記述した場合は、そのユーザーのログイン名を記述します。
  • 組織コード
    「設定項目」に「group」を記述した場合は、その組織の組織コードを記述します。
  • ロール名
    「設定項目」に「dynamic_role」または「static_role」を記述した場合は、そのロールのロール名を記述します。

レポート

レポートデータをCSVファイルに書き出したときのファイルのフォーマットを説明します。
レポートデータは、CSVファイルの書き出しのみに対応しています。レポートデータをCSVファイルから読み込むことはできません。
CSVファイルの書式
標題,作成者,作成日時,参加者,相手側の参加者,項目1,項目2,...,コメント
出力例:
CSVファイルの出力例の画像
CSVファイルの項目と仕様
項目 備考
標題 レポートの作成者が入力した標題が記述されます。
作成者 レポートの作成者のユーザー名が記述されます。
作成日時 レポートの作成日時が記述されます。
参加者 「参加者」欄に追加されているユーザー名が記述されます。
相手側の参加者 「相手側の参加者」欄に追加されている、共有アドレス帳のアドレスの表示名が記述されます。
項目 項目に入力した内容が書き出されます。
コメント レポートに書き込まれているすべてのコメントが書き出されます。