iDempiere レポート作成階層の使い方｜会計 操作マニュアル・技術仕様

📖 会計の全体像: 会計の全体図 も合わせてご覧ください。

レポート作成階層は、財務レポートで使用する「ツリー（階層）」の組合せを名前付きで定義するマスタです。組織・勘定科目・品目などの会計セグメントは複数の階層（ツリー）を持てるため、同じデータを「管理会計視点」「制度会計視点」など異なる集計構造でレポートできます。

📌 ポイント: レポート作成階層はレポート実行時に選択して使います。選択しなかった場合は各セグメントのデフォルトツリーが使用されるため、標準の集計だけで足りる場合はこのマスタの登録は不要です。

レポート作成階層でできること

• レポート用ツリーの組合せの名前付き定義（複数パターンを保存可能）
• 組織ツリー・勘定科目ツリーの差し替え（管理会計と制度会計で別の集計構造を使い分け）
• 品目・取引先・プロジェクト・キャンペーン・販売地域・アクティビティの各ツリーの指定
• 財務レポート実行時の集計視点の切替

画面構成

レポート作成階層は 1 タブのシンプルなマスタです。

タブ名	テーブル	項目数	役割
レポート作成階層	PA_Hierarchy	約14項目	8種類のツリー（組織・勘定科目・アクティビティ・取引先・品目・プロジェクト・キャンペーン・販売地域）の組合せ定義

基本操作手順

graph TD
    A["🌳 事前準備<br/>使用する各ツリーを定義しておく"] --> B["🚀 メニューから開く<br/>会計管理 > 会計レポート > レポート作成階層"]
    B --> C["➕ 新規で名称を入力"]
    C --> D["🌲 8種類のツリーを選択<br/>組織/勘定科目/アクティビティ/取引先/<br/>品目/プロジェクト/キャンペーン/販売地域"]
    D --> E["💾 保存"]
    E --> F["📊 財務レポート実行時に<br/>レポート作成階層を選択"]

事前準備 使用する各ツリーを定義しておく メニューから開く 会計管理 > 会計レポート > レポート作成階層 新規で名称を入力 8種類のツリーを選択 組織/勘定科目/アクティビティ/取引先/ 品目/プロジェクト/キャンペーン/販売地域 保存 財務レポート実行時に レポート作成階層を選択

アクセス方法（メニューパス）

メニューから「会計管理 ▸ 会計レポート ▸ レポート作成階層」を開きます。

新規登録

1. 「新規」ボタンをクリック
2. 名称を入力（例: 管理会計ビュー）
3. 8種類のツリーをすべて選択（全項目必須）:
   • 組織ツリー / 勘定科目ツリー / アクティビティツリー / 取引先ツリー
   • 品目ツリー / プロジェクトツリー / キャンペーンツリー / 販売地域ツリー
4. 「保存」をクリック

💡 ヒント: 変えたいツリーが 1 つだけ（例: 勘定科目のみ管理会計用）でも、残り 7 種類にはデフォルトのツリーを選択して保存します。8 項目すべてが必須です。

項目リファレンス

項目名	必須	型	説明
名称	必須	文字列	階層セットの識別名
説明 / コメント	-	文字列	補足説明
組織ツリー	必須	選択	組織の集計階層（レポート・セキュリティに使用）
勘定科目ツリー	必須	選択	勘定科目（Natural Account）の集計階層
アクティビティツリー	必須	選択	アクティビティの集計階層
取引先ツリー	必須	選択	取引先の集計階層
品目ツリー	必須	選択	品目の集計階層
プロジェクトツリー	必須	選択	プロジェクトの集計階層
キャンペーンツリー	必須	選択	キャンペーンの集計階層
販売地域ツリー	必須	選択	販売地域の集計階層

全項目一覧はリファレンス参照

よくある質問（FAQ）

Q. レポート作成階層を指定しないとどうなりますか？

各セグメントのデフォルトツリーが使用されます（PA_Hierarchy_ID のヘルプに明記: 「選択されない場合はデフォルトの階層ツリーが使用される」）。標準の集計構造で問題なければ登録不要です。

Q. どの画面で使いますか？

財務レポート等の会計レポート実行時にパラメータとして選択します。レポートの集計・小計がここで指定したツリー構造に従って行われます。

Q. すべてのツリーが必須なのはなぜですか？

テーブル定義上、8 種類のツリー項目はすべて必須（NOT NULL）です。1 セグメントだけ差し替えたい場合も、残りのセグメントにはデフォルトと同じツリーを明示的に選択してください。

関連機能

• 財務レポートの使い方
• 勘定科目表の使い方
• 画面リファレンス: レポート作成階層

🛠 技術仕様（開発者向け）

概要

レポート作成階層は PA_Hierarchy テーブル（アクセスレベル: Client、削除不可）に格納されます。MHierarchy クラス（174行）は Immutable キャッシュ対応の軽量マスタで、ツリータイプからツリーIDを解決する getAD_Tree_ID() が中心機能です。

アーキテクチャ概要

classDiagram
    class MHierarchy {
        +get(ctx, PA_Hierarchy_ID) MHierarchy$
        +getAD_Tree_ID(TreeType) int
        +markImmutable() MHierarchy
    }
    class X_PA_Hierarchy {
        <<generated>>
    }
    class PO {
        <<abstract>>
    }
    MHierarchy --|> X_PA_Hierarchy
    X_PA_Hierarchy --|> PO
    MHierarchy --> AD_Tree : 8種類のツリー参照

+get(ctx, PA_Hierarchy_ID) MHierarchy$ +getAD_Tree_ID(TreeType) int +markImmutable() MHierarchy <> <> > X_PA_Hierarchy X_PA_Hierarchy --

パッケージ: org.compiere.model ソースファイル: org.adempiere.base/src/org/compiere/model/MHierarchy.java

関連DBテーブル

PA_Hierarchy（レポート作成階層）

カラム名	型	必須	説明	備考
PA_Hierarchy_ID	ID	PK	レポート作成階層ID	未選択時はデフォルトツリー使用
Name	String(60)	Y	名称	識別子
Description / Help	String/Text	N	説明 / コメント
AD_Tree_Org_ID	Table	Y	組織ツリー	レポートとセキュリティに使用
AD_Tree_Account_ID	Table	Y	勘定科目ツリー	Natural Account Tree
AD_Tree_Activity_ID	Table	Y	アクティビティツリー
AD_Tree_BPartner_ID	Table	Y	取引先ツリー
AD_Tree_Product_ID	Table	Y	品目ツリー
AD_Tree_Project_ID	Table	Y	プロジェクトツリー
AD_Tree_Campaign_ID	Table	Y	キャンペーンツリー
AD_Tree_SalesRegion_ID	Table	Y	販売地域ツリー
IsActive	YesNo	Y	有効

ビジネスロジック

getAD_Tree_ID(String TreeType)

ツリータイプ（組織・勘定科目等）を受け取り、この階層定義で設定された対応ツリーのIDを返します。財務レポートエンジンがレポート作成階層を指定された場合にこのメソッド経由でツリーを解決します。

beforeSave() / afterSave() のオーバーライドはなく、モデル固有の保存時ロジックはありません（必須制約はテーブル定義による）。markImmutable() によりキャッシュ共有時の不変性が保証されます。

拡張ポイント

• Model Validator: PA_Hierarchy の保存前にツリーの組合せ妥当性（例: 特定ロールでは特定ツリーのみ許可）をチェックできます
• Callout: 標準ではこのテーブルにカラム callout は定義されていません

関連プロセス

リファレンスページ・メニューに直接関連するプロセスは登録されていません（財務レポート実行時のパラメータとして参照）。

関連ドキュメント

• 画面リファレンス: レポート作成階層
• 財務レポートの技術仕様

---

iDempiereカスタマイズのご相談

管理会計向けの独自集計構造や部門別レポートは、レポート作成階層と財務レポートの組合せで多くの場合カスタマイズなしに実現できます。

Ａｓ－Ｌｉｎｋ株式会社では、OSGiプラグインによる安全なカスタマイズを提供しています。

OSS ERP導入・カスタマイズサービスの詳細はこちら