マスタメンテナンステンプレートのマスタ参照機能を使って受注管理アプリケーションを作成する手順

公開日: 2026-10-01 / カテゴリ: CookBook

はじめに

マスタメンテナンステンプレートのマスタ参照機能を使い、受注管理アプリケーションを作成する手順をご紹介します。 本機能は 2024 Spring(Iris) 以降で利用できます。

マスタ参照機能とは、登録・編集画面に「参照」ボタンを設け、別のマスタからレコードを検索・選択して値を取り込む機能です。

本CookBookでは、以下の構成の受注管理アプリケーションを作成します。

  • メインエンティティ(受注ヘッダ)が「顧客マスタ」「社員マスタ(担当者)」を参照する
  • サブエンティティ(受注明細)が「商品マスタ」「倉庫マスタ」を参照する

マスタ参照機能を使う場面

こんな困りごとはありませんか

受注の登録画面を、マスタ参照機能を使わずに作ると、以下のような問題が起きやすくなります。

  • 顧客ID・商品ID・倉庫IDを、利用者が手入力する。IDの入力ミスや、存在しないIDの登録が起きる。
  • IDだけでは、どの顧客・商品か画面上で分からない。名称は別途入力することになり、IDと名称がずれる。
  • 顧客名や商品名を受注データ側にも入力すると、マスタ側で名称を変更しても、受注データ側の名称が古いまま残る。

マスタ参照機能で解決できること

  • 「参照」ボタンからマスタの一覧を開き、レコードを選んで入力できる。IDを覚えたり、手入力したりする必要がない。
  • 保存されるのは、結合条件に設定した項目(顧客IDなど)だけ。名称などの付随情報は、マスタから取得して表示する。名称を二重に管理する必要がない。
  • 選択した顧客名・商品名などを、登録画面にも一覧画面にも表示できる。

こんな業務に向いています

以下のように、「トランザクション(業務データ)を、既存のマスタから選んで入力する」業務に向いています。

業務業務データ(参照元)参照するマスタ
受注管理(本CookBook)受注ヘッダ、受注明細顧客、社員(担当者)、商品、倉庫
経費精算経費精算ヘッダ、経費明細社員、勘定科目 など
プロジェクト管理プロジェクト、作業実績顧客、社員、プロジェクト区分 など

使い分けの目安

状況おすすめ
選択肢が少数で、ほとんど変わらない(例:ステータス、区分)選択肢(プルダウン)やラジオボタンを使う
選択肢が多い、または増減する。選んだ先の名称なども画面に表示したいマスタ参照機能

マスタ参照機能で選ぶ元のデータは、マスタメンテナンステンプレートで作ったアプリケーションで管理できます(手順7)。 本CookBookでは、顧客・社員・商品・倉庫のマスタを管理するアプリケーションを作成してデータを登録し、受注管理アプリケーションからそれらを参照します。

完成サンプル

「サイトマップ」→「Accel Studio」→「アプリケーション管理」→「アプリケーション一覧」→「インポート」にアクセスし、Accel Studio インポートデータをインポートすることでサンプルコンテンツをご利用になれます。

完成イメージ

登録画面(参照ボタン押下前) 37

参照ボタン押下後(マスタの選択画面) 38

選択後(参照結果が画面に反映された状態) 39

作成するアプリケーションの構成

画面と参照先マスタの関係

42

参照元参照先マスタ物理名
受注ヘッダ(メイン)顧客マスタm_customer
受注ヘッダ(メイン)社員マスタ(担当者)m_employee
受注明細(サブ)商品マスタm_product
受注明細(サブ)倉庫マスタm_warehouse

エンティティと辞書項目

05

受注ヘッダ(t_order)

辞書項目型備考
order_idstring主キー
order_datedate
customer_idstring顧客マスタとの結合条件
customer_namestring顧客マスタの参照項目(表示のみ)
employee_idstring社員マスタとの結合条件
employee_namestring社員マスタの参照項目(表示のみ)
delivery_addressstring
total_amountdecimal

受注明細(t_order_detail)

辞書項目型備考
order_detail_idint主キー
order_idstring受注ヘッダとの関連項目
product_idstring商品マスタとの結合条件
product_namestring商品マスタの参照項目(表示のみ)
warehouse_idstring倉庫マスタとの結合条件
warehouse_namestring倉庫マスタの参照項目(表示のみ)
quantityint
unit_pricedecimal

マスタ(参照先)

エンティティ辞書項目
m_customercustomer_id(主キー)、customer_name、contact_person、phone、address
m_employeeemployee_id(主キー)、employee_name、department、email
m_productproduct_id(主キー)、product_name、category、standard_price
m_warehousewarehouse_id(主キー)、warehouse_name、location、manager

※ER図には、参照項目(customer_name、employee_name、product_name、warehouse_name)を記載していません。

用語

マスタ参照の設定では、以下の2種類の項目を指定します。

用語内容
結合条件参照元の項目と参照先マスタの主キーを結び付ける条件です。選択した値が、参照元のテーブルに保存されます。
参照項目参照結果として画面に表示する項目です。主キー以外のマスタ情報で、表示専用(編集不可)です。参照元のテーブルには保存されません。

たとえば受注ヘッダの顧客の場合、結合条件は customer_id(受注ヘッダ)と customer_id(顧客マスタ)、参照項目は customer_name です。

レシピ

1. 辞書項目を作成する。

IM-Repositoryで、ER図の項目に対応する辞書項目を作成します。 本CookBookでは、カテゴリ「cookbook」を作成し、その配下に作成しました。

  1. 「サイトマップ」→「IM-Repository」→「辞書項目」を開く。 01

  2. 辞書項目を作成する。 02

  3. 影響範囲確認をし、変更を確定させる。 03

辞書項目の数が多いため、手作業での作成が大変な場合は、「完成サンプル」のインポートデータをご利用ください。インポートデータには、辞書項目とエンティティが含まれています。

IM-Repositoryの操作方法については以下のガイドを参考にしてください。 intra-mart 開発者向けポータル Developer Portal - はじめてのIM-Repository

2. エンティティを作成する。

手順1で作成した辞書項目を使い、以下の6つのエンティティを作成します。

  • 受注ヘッダ(t_order)
  • 受注明細(t_order_detail)
  • 顧客マスタ(m_customer)
  • 社員マスタ(m_employee)
  • 商品マスタ(m_product)
  • 倉庫マスタ(m_warehouse)

受注ヘッダには、参照項目として表示する customer_name・employee_name もエンティティ項目に含めます。 受注明細も同様に、product_name・warehouse_name を含めます。

  1. 「サイトマップ」→「Repository」→「エンティティ一覧」を開く。

  2. 受注ヘッダ(t_order)を作成する。主キーは order_id。 04

  3. 受注明細(t_order_detail)を作成する。主キーは order_detail_id。 07

  4. 顧客マスタ(m_customer)を作成する。主キーは customer_id。 08

  5. 社員マスタ(m_employee)を作成する。主キーは employee_id。 09

  6. 商品マスタ(m_product)を作成する。主キーは product_id。 10

  7. 倉庫マスタ(m_warehouse)を作成する。主キーは warehouse_id。 11

3. マスタのデータ定義を作成する。

参照先となる4つのマスタについて、データ定義(テーブル)を作成します。

  1. マスタのエンティティを選択し、「データ定義」タブを開く。 12

  2. 「データ定義を追加」からウィザードに沿ってテーブルを作成し、影響範囲確認で確定させる。 13

  3. 残りの3つのマスタも同様に作成する。

4. 受注ヘッダのデータ定義を作成し、マスタへの参照を設定する。

  1. 受注ヘッダ(t_order)を選択し、「データ定義」タブから「データ定義を追加」を選択する。 14

  2. 「テーブル定義設定」の「参照項目設定を追加」を選択する。 15

  3. 「エンティティを参照する」を選択する。 16

  4. 顧客マスタへの参照を設定する。

設定項目設定値
参照先エンティティm_customer
参照項目(参照元 → 参照先)customer_name → customer_name
結合条件(参照元 → 参照先)customer_id → customer_id(抽出方法:一致)

17

参照項目に設定した customer_name は、受注ヘッダのテーブルの列からは除かれます。 18

  1. 続けて、社員マスタへの参照を設定する。
設定項目設定値
参照先エンティティm_employee
参照項目(参照元 → 参照先)employee_name → employee_name
結合条件(参照元 → 参照先)employee_id → employee_id(抽出方法:一致)

19

  1. 参照項目設定の一覧に2件が表示されたことを確認し、ウィザードを進めて影響範囲確認で確定させる。 20

5. 受注明細のデータ定義を作成し、マスタへの参照を設定する。

手順4と同様に、受注明細(t_order_detail)のデータ定義を作成し、参照を設定します。

  1. 商品マスタへの参照を設定する。
設定項目設定値
参照先エンティティm_product
参照項目(参照元 → 参照先)product_name → product_name
結合条件(参照元 → 参照先)product_id → product_id(抽出方法:一致)

21

  1. 倉庫マスタへの参照を設定する。
設定項目設定値
参照先エンティティm_warehouse
参照項目(参照元 → 参照先)warehouse_name → warehouse_name
結合条件(参照元 → 参照先)warehouse_id → warehouse_id(抽出方法:一致)

22

  1. 参照項目設定の一覧に2件が表示されたことを確認し、ウィザードを進めて影響範囲確認で確定させる。 23

6. 受注ヘッダと受注明細を関連付ける。

受注ヘッダ(メインエンティティ)と受注明細(サブエンティティ)の関連を登録します。

  1. 受注ヘッダ(t_order)の「関連一覧」タブを開き、「関連を登録」を選択する。 24

  2. 関連先に t_order_detail を選択し、多重度を「1 : n」にする。 25

  3. 関連元・関連先のエンティティ項目に order_id を設定し、「サブエンティティを設定」を選択する。 26 27

  4. 内容を確認して追加する。 28

  5. 受注ヘッダのエンティティ項目に、t_order_detail が追加されたことを確認する。 29

7. 参照先マスタのアプリケーションを作成し、データを登録する。

  1. 「サイトマップ」→「Accel Studio」→「アプリケーション作成」→「業務テンプレート一覧」から、マスタメンテナンスの「次へ」を選択する。 30

  2. 作成方法で「エンティティを選択」を選択する。 31

  3. アプリケーション情報を入力する。 34

  4. 「扱うデータの定義」で参照先マスタのエンティティ(m_customer)を選択し、「アプリケーションを作成」を選択する。 35

  5. 残りのマスタ(m_employee、m_product、m_warehouse)も同様にアプリケーションを作成する。

  6. 作成したアプリケーションから、各マスタにデータを登録する。 本CookBookでは、各マスタに 00000001 〜 00000003 の3件のサンプルデータを登録しました。

8. 受注管理アプリケーションを作成する。

手順7と同様に、マスタメンテナンスの「エンティティを選択」からアプリケーションを作成します。

  1. 「扱うデータの定義」で、受注ヘッダ(t_order)を選択する。 参照項目設定のあるエンティティを選択すると、マスタ参照機能がアプリケーションに追加されます。 32

  2. 「明細データの利用指定」で明細データの利用数を1にし、「取り扱う明細データの定義」で子エンティティに受注明細(t_order_detail)を選択する。 33

  3. 「アプリケーションを作成」を選択し、ビルドジョブのステータスが COMPLETE になることを確認する。 36

9. 動作を確認する。

  1. 受注管理アプリケーションの登録画面を開く。 受注ヘッダの下に顧客・担当者の参照エリア、受注明細に商品・倉庫の参照列が表示されます。 37

  2. 顧客の「参照」ボタンを押し、顧客マスタから顧客を選択する。 38

  3. 担当者、明細の商品・倉庫も同様に選択し、その他の項目を入力して登録する。 結合条件に設定した項目(customer_id など)が保存され、名称(customer_name など)が参照項目として表示されます。 39

  4. 一覧画面で、登録した受注の顧客名・担当者名が表示されることを確認する。 40

完了

マスタ参照機能を使った受注管理アプリケーションを作成できました。

受注ヘッダから顧客・担当者、受注明細から商品・倉庫のマスタを参照して入力できます。

39