iDempiere 資産登録属性の使い方｜固定資産管理 操作マニュアル・技術仕様
📖 固定資産管理の全体像: 固定資産管理の全体図 も合わせてご覧ください。
資産登録属性は、資産ユーザー登録で顧客・ユーザーから収集する追加項目（属性）を自由に定義するマスタです。画面のカスタマイズをせずに「設置場所」「購入店舗」のような独自の入力項目を資産登録フォームに追加できます。
📌 ポイント: 属性のデータ型は「リファレンス」項目で指定します。Table / List 型を選ぶ場合は「リファレンスキー」（AD_Reference_Value_ID）の指定が必須です（未指定だと選択肢が解決できません）。
資産登録属性でできること
Section titled “資産登録属性でできること”- 資産ユーザー登録で収集する属性項目の定義（名称・説明）
- シーケンスNoによる表示順の制御
- リファレンス（データ型）の指定（String / List / Table 等）
- Table / List 型の場合の選択肢（リファレンスキー）の指定
- 品目割当タブによる「どの品目にどの属性を使うか」の割当
- セルフサービス（外部公開）可否の制御
| タブ名 | テーブル | 項目数 | 役割 |
|---|---|---|---|
| 資産登録属性 | A_RegistrationAttribute | 約10項目 | 属性の定義（名称・リファレンス・表示順） |
| 品目割当 | A_RegistrationProduct | 約6項目 | 属性を使用する品目の割当 |
基本操作手順
Section titled “基本操作手順”graph TD
A["🚀 メニューから開く<br/>資産管理 > Customer Service > 資産登録属性"] --> B["➕ 新規で属性を作成<br/>（名称・シーケンスNo）"]
B --> C{データ型}
C -->|文字列・数値等| D["📝 リファレンスを選択"]
C -->|Table / List| E["📋 リファレンス＋<br/>リファレンスキーを選択"]
D --> F["💾 保存"]
E --> F
F --> G["🔗 品目割当タブで<br/>対象品目を割当"]
G --> H["✅ 資産ユーザー登録の<br/>値タブで入力可能に"]
アクセス方法（メニューパス）
Section titled “アクセス方法（メニューパス）”メニューから「資産管理 ▸ Customer Service ▸ 資産登録属性」を開きます（AD_Window_ID: 300）。
- ツールバーの「新規」ボタンをクリック
- 基本情報を入力:
- 名称: 属性名（例:
設置場所） - シーケンスNo: 表示順（小さい値が先頭）
- リファレンス: データ型（必須）
- リファレンスキー: Table / List 型の場合の選択肢定義
- セルフサービス: 外部（セルフサービス）から入力可能にする場合にチェック
- 名称: 属性名（例:
- 「保存」をクリック
- 必要に応じて「品目割当」タブで属性を使用する品目を登録
項目リファレンス
Section titled “項目リファレンス”資産登録属性タブ
Section titled “資産登録属性タブ”| 項目名 | 必須 | 型 | 説明 |
|---|---|---|---|
| 名称 | 必須 | 文字列 | 属性の名称（識別子） |
| 説明 | - | 文字列 | 属性の補足説明 |
| シーケンスNo | 必須 | 整数 | 表示順（小さい順に表示） |
| リファレンス | 必須 | 選択 | データ型（System Reference） |
| DBカラム名称 | - | 文字列 | データベースカラム名（任意） |
| リファレンスキー | - | 選択 | Table / List 型の場合に必要な選択肢定義 |
| セルフサービス | 必須 | チェック | セルフサービス経由での入力可否 |
| 有効 | 必須 | チェック | 属性の有効/無効 |
品目割当タブ
Section titled “品目割当タブ”| 項目名 | 必須 | 型 | 説明 |
|---|---|---|---|
| 登録属性 | 必須 | 選択 | 親の資産登録属性 |
| 品目 | 必須 | 検索 | 属性を使用する品目 |
| 説明 | - | 文字列 | 補足説明 |
| 有効 | 必須 | チェック | 割当の有効/無効 |
よくある質問（FAQ）
Section titled “よくある質問（FAQ）”Q. Table / List 型の属性で選択肢が表示されません
Section titled “Q. Table / List 型の属性で選択肢が表示されません”「リファレンスキー」（AD_Reference_Value_ID）が未設定です。カラム定義上「データ型が Table または List の場合に指定必須」とされており、選択肢の元になるリファレンスを指定してください。
Q. 属性の表示順を変えるには？
Section titled “Q. 属性の表示順を変えるには？”「シーケンスNo」を変更します。小さい番号の属性から順に表示されます。
Q. 特定の品目だけに属性を表示したい
Section titled “Q. 特定の品目だけに属性を表示したい”「品目割当」タブ（A_RegistrationProduct）で属性と品目を紐づけます。割当てた品目に対する資産ユーザー登録でその属性が使用されます。
Q. 属性を廃止したい場合は削除できますか？
Section titled “Q. 属性を廃止したい場合は削除できますか？”レコード削除は可能なテーブル定義ですが、既に資産ユーザー登録の「値」で使用されている属性は「有効」チェックを外して無効化する運用を推奨します。
🛠 技術仕様（開発者向け）
資産登録属性は A_RegistrationAttribute（属性定義）と A_RegistrationProduct（品目割当）の 2 テーブルで構成されます。MRegistrationAttribute クラス（227行）が属性定義を担い、ImmutablePOSupport を実装したキャッシュ対応マスタです。品目割当には M クラスが無く、生成クラス X_A_RegistrationProduct（194行）のみで操作します。
アーキテクチャ概要
Section titled “アーキテクチャ概要”classDiagram
class MRegistrationAttribute {
+getAll(ctx) MRegistrationAttribute[]
+get(A_RegistrationAttribute_ID) MRegistrationAttribute
+getCopy(ctx, id, trxName) MRegistrationAttribute
+markImmutable() MRegistrationAttribute
}
class X_A_RegistrationAttribute {
<<generated>>
}
class X_A_RegistrationProduct {
<<generated>>
}
class PO {
<<abstract>>
}
MRegistrationAttribute --|> X_A_RegistrationAttribute
X_A_RegistrationAttribute --|> PO
X_A_RegistrationProduct --|> PO
MRegistrationAttribute --> X_A_RegistrationProduct : assigned products
パッケージ: org.compiere.model
ソースファイル: org.adempiere.base/src/org/compiere/model/MRegistrationAttribute.java
関連DBテーブル
Section titled “関連DBテーブル”A_RegistrationAttribute（資産登録属性）
Section titled “A_RegistrationAttribute（資産登録属性）”| カラム名 | 型 | 必須 | 説明 | 備考 |
|---|---|---|---|---|
| A_RegistrationAttribute_ID | ID | PK | 属性ID | 主キー |
| Name | String(60) | Y | 名称 | 識別子 |
| Description | String(255) | N | 説明 | |
| SeqNo | Integer | Y | シーケンスNo | 表示順 |
| AD_Reference_ID | Table | Y | リファレンス | データ型 |
| AD_Reference_Value_ID | Table | N | リファレンスキー | Table/List 型で必要 |
| ColumnName | String(63) | N | DBカラム名称 | |
| IsSelfService | YesNo | Y | セルフサービス | デフォルト Y |
| IsActive | YesNo | Y | 有効 | デフォルト Y |
A_RegistrationProduct（品目割当）
Section titled “A_RegistrationProduct（品目割当）”| カラム名 | 型 | 必須 | 説明 | 備考 |
|---|---|---|---|---|
| A_RegistrationAttribute_ID | TableDirect | PK(親) | 属性FK | isparent |
| M_Product_ID | Search | Y | 品目FK | |
| Description | String(255) | N | 説明 | |
| IsActive | YesNo | Y | 有効 |
ビジネスロジック
Section titled “ビジネスロジック”MRegistrationAttribute.getAll(ctx): クライアント単位で全属性を取得（資産ユーザー登録側から呼ばれます）MRegistrationAttribute.get(...)/getCopy(...):ImmutablePOSupportによるキャッシュ経由の参照。繰り返し参照時は DB クエリを発行せず高速に取得できます- beforeSave / afterSave の独自オーバーライドはありません（バリデーションは AD 定義の必須制約に依存）
拡張ポイント（カスタマイズ箇所）
Section titled “拡張ポイント（カスタマイズ箇所）”- 本テーブルには標準の Callout 定義はありません（gw_column の callout 列は全て空）
- 属性定義に独自制約（命名規則・SeqNo 重複禁止等）を加える場合は OSGi Model Validator で
MRegistrationAttributeのTYPE_BEFORE_NEW/TYPE_BEFORE_CHANGEをフックするのが安全です
関連プロセス
Section titled “関連プロセス”このウィンドウに紐づく標準プロセスはありません。
関連ドキュメント
Section titled “関連ドキュメント”iDempiereカスタマイズのご相談
Section titled “iDempiereカスタマイズのご相談”資産登録属性を使えば、画面開発なしで資産登録フォームの入力項目を追加できます。属性の入力チェックや外部フォーム連携のカスタマイズもコア改変なしで実現可能です。
Ａｓ－Ｌｉｎｋ株式会社では、OSGiプラグインによる安全なカスタマイズを提供しています。