iDempiere 資産ユーザー登録の使い方|固定資産管理 操作マニュアル・技術仕様
📖 固定資産管理の全体像: 固定資産管理の全体図 も合わせてご覧ください。
資産ユーザー登録は、顧客・ユーザーによる資産(製品)の登録情報を管理するウィンドウです。いわゆる「ユーザー登録(製品登録)」に相当し、どの取引先・ユーザーが、どの品目・資産を、いつから使用しているかを記録します。カスタマーサービス領域の機能で、資産登録属性で定義した追加項目の値も「値」タブに保存されます。
📌 ポイント: 収集したい項目は事前に資産登録属性で定義しておきます。登録済みレコードの属性値は「値」タブ(A_RegistrationValue)に属性 1 件につき 1 行で格納されます。
資産ユーザー登録でできること
Section titled “資産ユーザー登録でできること”- 取引先・ユーザー単位の資産(製品)ユーザー登録の記録
- 品目・資産マスタとの紐づけ
- 使用開始日付(AssetServiceDate)の管理
- 登録済み/本番運用中/公開許可フラグの管理
- 資産登録属性で定義した追加項目の値の記録(値タブ)
- Web(セルフサービス)経由の登録時のリモートホスト・アドレスの記録
| タブ名 | テーブル | 項目数 | 役割 |
|---|---|---|---|
| 資産ユーザー登録 | A_Registration | 約17項目 | 登録の基本情報(取引先・品目・資産・各種フラグ) |
| 値 | A_RegistrationValue | 約7項目 | 資産登録属性ごとの入力値 |
基本操作手順
Section titled “基本操作手順”graph TD
A["🚀 メニューから開く<br/>資産管理 > Customer Service > 資産ユーザー登録"] --> B["➕ 新規で登録情報を入力<br/>(名称・使用開始日付)"]
B --> C["🔗 取引先・ユーザー・<br/>品目・資産を紐づけ"]
C --> D["☑ フラグ設定<br/>(登録・公開許可・本番運用中)"]
D --> E["💾 保存"]
E --> F["📋 値タブで属性ごとの<br/>入力値を登録"]
アクセス方法(メニューパス)
Section titled “アクセス方法(メニューパス)”メニューから「資産管理 ▸ Customer Service ▸ 資産ユーザー登録」を開きます(AD_Window_ID: 301)。
- ツールバーの「新規」ボタンをクリック
- 基本情報を入力:
- 名称: 登録の識別名(必須)
- 使用開始日付: 資産の使用開始日(必須)
- 取引先 / ユーザー: 登録者を紐づけ(任意)
- 品目 / 資産: 対象の品目または資産マスタを紐づけ(任意)
- フラグを設定:
- 登録: 登録済みとして扱う場合にチェック
- 公開許可: 統計サマリ以外の情報公開を許可する場合にチェック
- 本番運用中: 対象システム・資産が本番運用中の場合にチェック
- 「保存」をクリック
- 「値」タブで資産登録属性ごとの値を入力
項目リファレンス
Section titled “項目リファレンス”資産ユーザー登録タブ
Section titled “資産ユーザー登録タブ”| 項目名 | 必須 | 型 | 説明 |
|---|---|---|---|
| 名称 | 必須 | 文字列 | 登録の識別名 |
| 説明 / コメント | - | 文字列 | 補足情報 |
| 取引先 | - | 検索 | 登録者の取引先 |
| ユーザー | - | 選択 | 登録者(取引先担当者) |
| 品目 | - | 検索 | 対象品目 |
| 資産 | - | 検索 | 対象資産(資産マスタ) |
| 登録 | 必須 | チェック | 登録済みフラグ |
| 公開許可 | 必須 | チェック | 情報公開の許可 |
| 本番運用中 | 必須 | チェック | 本番運用中フラグ |
| 使用開始日付 | 必須 | 日付 | 資産の使用開始日 |
| メモ | - | 文字列 | 追加のユーザー定義情報 |
| リモートホスト / リモートアドレス | - | 文字列 | Web登録時の接続元情報 |
| 項目名 | 必須 | 型 | 説明 |
|---|---|---|---|
| 資産ユーザー登録 | 必須 | 選択 | 親の登録レコード |
| 登録属性 | 必須 | 選択 | 資産登録属性 |
| 名称 | 必須 | 文字列 | 属性に対する入力値 |
| 説明 | - | 文字列 | 補足説明 |
よくある質問(FAQ)
Section titled “よくある質問(FAQ)”Q. 属性の入力欄が「値」タブに出てきません
Section titled “Q. 属性の入力欄が「値」タブに出てきません”資産登録属性が未定義か無効になっています。属性を定義し、品目を限定する場合は品目割当も確認してください。値タブは属性 1 件につき 1 行(A_RegistrationAttribute_ID が親キー)で登録します。
Q. リモートホスト・リモートアドレスには何が入りますか?
Section titled “Q. リモートホスト・リモートアドレスには何が入りますか?”Web(セルフサービス)経由で登録された場合の接続元情報です。MRegistration クラスには HTTP リクエストから属性値を取り込む loadAttributeValues / updateAttributeValues メソッドがあり、Web フォームからの登録処理を想定した作りになっています。画面から手入力した場合は空のままで問題ありません。
Q. 品目と資産のどちらを紐づけるべきですか?
Section titled “Q. 品目と資産のどちらを紐づけるべきですか?”どちらも任意項目です。自社の資産マスタ(A_Asset)に存在する個体は「資産」を、個体管理していない製品の登録は「品目」を紐づける、といった使い分けができます。
Q. 公開許可(IsAllowPublish)とは何ですか?
Section titled “Q. 公開許可(IsAllowPublish)とは何ですか?”チェックすると統計的なサマリ情報だけでなく登録情報自体の公開を許可する意思表示になります(カラム定義の説明より)。公開範囲の運用ルールは組織側で定めてください。
🛠 技術仕様(開発者向け)
資産ユーザー登録は A_Registration(登録ヘッダ)と A_RegistrationValue(属性値)の 2 テーブル構成です。MRegistration クラス(275行)が登録の取得・属性値の読み書きを担い、MRegistrationValue クラス(164行)が個々の値を表します。Document 型ではありません(DocStatus / DocAction 無し)。
アーキテクチャ概要
Section titled “アーキテクチャ概要”classDiagram
class MRegistration {
+getAttributes() MRegistrationAttribute[]
+getValues() MRegistrationValue[]
+getValues(onlySelfService) MRegistrationValue[]
+loadAttributeValues(HttpServletRequest) int
+updateAttributeValues(HttpServletRequest) int
}
class X_A_Registration {
<<generated>>
}
class MRegistrationValue
class X_A_RegistrationValue {
<<generated>>
}
class PO {
<<abstract>>
}
MRegistration --|> X_A_Registration
X_A_Registration --|> PO
MRegistrationValue --|> X_A_RegistrationValue
X_A_RegistrationValue --|> PO
MRegistration --> MRegistrationValue : has many
MRegistration --> MRegistrationAttribute : uses
パッケージ: org.compiere.model
ソースファイル: org.adempiere.base/src/org/compiere/model/MRegistration.java
関連DBテーブル
Section titled “関連DBテーブル”A_Registration(資産ユーザー登録)
Section titled “A_Registration(資産ユーザー登録)”| カラム名 | 型 | 必須 | 説明 | 備考 |
|---|---|---|---|---|
| A_Registration_ID | ID | PK | 登録ID | 主キー |
| Name | String(60) | Y | 名称 | 識別子 |
| C_BPartner_ID | Search | N | 取引先 | |
| AD_User_ID | TableDirect | N | ユーザー | |
| M_Product_ID | Search | N | 品目 | |
| A_Asset_ID | Search | N | 資産 | |
| AssetServiceDate | Date | Y | 使用開始日付 | |
| IsRegistered | YesNo | Y | 登録済み | |
| IsAllowPublish | YesNo | Y | 公開許可 | |
| IsInProduction | YesNo | Y | 本番運用中 | |
| Note | String(2000) | N | メモ | |
| Remote_Host | String(120) | N | リモートホスト | Web登録時 |
| Remote_Addr | String(60) | N | リモートアドレス | Web登録時 |
| Processing | Button | N | 処理ボタン |
A_RegistrationValue(値)
Section titled “A_RegistrationValue(値)”| カラム名 | 型 | 必須 | 説明 | 備考 |
|---|---|---|---|---|
| A_Registration_ID | TableDirect | PK(親) | 登録FK | isparent |
| A_RegistrationAttribute_ID | TableDirect | PK(親) | 属性FK | isparent・識別子 |
| Name | String(60) | Y | 入力値 | |
| Description | String(255) | N | 説明 |
ビジネスロジック
Section titled “ビジネスロジック”getAttributes(): クライアントに定義された資産登録属性の一覧を取得getValues(boolean onlySelfService): 属性値を取得。onlySelfService=trueでセルフサービス公開対象の属性値のみに絞り込みloadAttributeValues(HttpServletRequest)/updateAttributeValues(HttpServletRequest): HTTP リクエストパラメータから属性値を一括生成・更新。Web セルフサービスフォームからの製品登録を想定したエントリポイントです- beforeSave 等での独自チェックはなく、必須制約(Name / AssetServiceDate)は AD 定義に依存します
拡張ポイント(カスタマイズ箇所)
Section titled “拡張ポイント(カスタマイズ箇所)”- 本テーブルに標準 Callout はありません
- 登録時の重複チェック(同一取引先×同一資産など)を追加する場合は OSGi Model Validator で
A_RegistrationのTYPE_BEFORE_NEWをフックします - Web フォーム連携を独自実装する場合は
loadAttributeValuesの利用が近道です
関連プロセス
Section titled “関連プロセス”このウィンドウに紐づく標準プロセスはありません(Processing ボタンカラムは存在しますが、標準メニュー・リファレンス上のプロセス割当はありません)。
関連ドキュメント
Section titled “関連ドキュメント”iDempiereカスタマイズのご相談
Section titled “iDempiereカスタマイズのご相談”資産ユーザー登録は Web セルフサービスからの製品登録受付やサポート台帳としての活用が可能です。自社サイトの登録フォームとの連携開発も承ります。
As-Link株式会社では、OSGiプラグインによる安全なカスタマイズを提供しています。