WAGBY11 MANUAL / 05
親・子・孫の関係を定義する
受注伝票・受注明細・納品予定を3階層で管理し、各詳細画面からたどる方法を説明します。
最終更新日:
1. このページで伝える機能
受注伝票に受注明細を持たせ、さらに各明細に複数の納品予定を持たせられます。同じ品物を分割して納品する場合など、明細ごとに日付と数量を管理できます。
親・子・孫はどのようにつながる?
親子関係の基本では、受注伝票を親、受注明細を子として説明しました。さらに一つの明細に複数の納品予定を持たせると、納品予定が孫になります。孫にとっての直接の親は受注明細です。
一つの伝票に複数の明細
この明細に属する納品予定
孫:納品予定(10個を2回に分けて納品)
| 受注ID | 明細番号 | 納品番号 | 数量 |
|---|---|---|---|
| 1001 | 1 | 1 | 4 |
| 1001 | 1 | 2 | 6 |
この明細に属する納品予定
孫:納品予定(6個を2回に分けて納品)
| 受注ID | 明細番号 | 納品番号 | 数量 |
|---|---|---|---|
| 1001 | 2 | 1 | 2 |
| 1001 | 2 | 2 | 4 |
孫の主キー = 親ID(受注ID)+ 子の枝番(明細番号)+ 孫の枝番(納品番号)
孫は、子のキー全体と孫自身の枝番で識別する
子の受注明細は「受注ID+明細番号」の複合主キーを持ちます。孫の納品予定には、その子を特定する二つの値を両方とも引き継ぎ、孫自身の枝番である「納品番号」を加えます。
図の「受注ID 1001・明細番号1・納品番号1」と「受注ID 1001・明細番号2・納品番号1」は、別の納品予定です。納品番号は受注明細ごとに自動で採番するため、別の明細では同じ番号を使えます。同じ明細の中に同じ納品番号を重複して保存することはできません。
受注IDと納品番号だけでは、どの明細の納品予定かが決まりません。親から子へ、子から孫へと、直前の階層を特定するキー全体を引き継ぐのがポイントです。この例のAppSchemaでは、孫に引き継ぐ受注IDと明細番号をorderKey・lineKeyとして保持し、納品番号のdeliveryNoと合わせた三つの項目を主キーにします。
2. Wagby11で実現できること
受注伝票の関連データから受注明細の詳細を開くと、その明細に属する納品予定を確認できます。納品番号は、枝番を読み取る表示用項目で確認しています。

納品予定を追加するときは、受注伝票のキーと明細番号の両方が引き継がれます。利用者が保存用のキー項目を個別に入力する必要はありません。

受注明細の登録・更新フォームに納品予定の一覧編集を組み込み、受注明細と納品予定をまとめて保存することもできます。受注明細が「受注ID+明細番号」の複合主キーでも利用できます。操作と設定は複合主キーの親子同時登録・更新を参照してください。
受注伝票・受注明細・納品予定の三階層全体を一画面で同時保存する機能は対象外です。受注伝票と受注明細、または受注明細と納品予定という、直接つながる二階層ごとに設定します。
3. AIへの指示例
最小限の指示例
受注明細ごとに、複数の納品予定日と納品数量を管理できるようにしてください。納品予定の識別方法や、既存の受注明細の主キーをどう参照するかをAIが類推して補います。既存の枝番付き明細を保つことと、各階層をたどる操作か、受注明細と納品予定の同時登録・更新を使うかを伝えます。
より詳細な指示例
SalesOrder→order_line→DeliveryPlanの3階層にしてください。order_lineの既存の複合主キーorderId・lineNoは変更しません。DeliveryPlanは両キーを保存するlong型のorderKey・lineKeyと、自動採番のdeliveryNoを主キーとし、order_lineへの論理参照lineRefを全キーのmappingsで定義します。納品日と納品数量を用意し、納品番号は保存しない読み取り専用の表示項目でも確認できるようにします。受注明細の詳細から納品予定一覧と新規登録へ進めるようにしてください。order_lineの新規登録・更新フォームにもDeliveryPlanの一覧編集を組み込み、受注明細と納品予定を一度の保存で登録・更新できるようにしてください。親への全キーの引継ぎと、納品予定の追加・変更・削除を確認します。3階層全体を一画面で同時保存する構成にはしません。
既存のモデル・主キー・データ・権限を保持し、guide・referenceで必要な仕様を確認してください。新規モデルにはG_ADMINの必要な登録・参照・更新・削除権限と予約属性versionを用意します。メニューと一般利用者向け操作マニュアルを更新し、設計情報の検証・コード生成・起動を行って保存後の内容を確認してください。4. 編集されるAppSchemaの例
以下は関連する定義の抜粋です。
# DeliveryPlan.yaml の属性の抜粋
entity:
attributes:
- { name: 受注ID保存列, name_en: orderKey, type: long,
pk: true, not_null: true, hidden: true }
- { name: 明細番号保存列, name_en: lineKey, type: long,
pk: true, not_null: true, hidden: true }
- { name: 納品番号, name_en: deliveryNo, type: branchid, pk: true }
- name: 受注明細
name_en: lineRef
type: reference
not_null: true
fk:
entity: order_line
mappings:
- { local: orderKey, target: orderId }
- { local: lineKey, target: lineNo }
- { name: 納品日, name_en: deliveryDate, type: date }
- { name: 納品数量, name_en: quantity, type: integer }
- { name: バージョン, name_en: version, type: number,
hidden: true, reserved: true }
受注明細と納品予定をまとめて入力する場合は、受注明細側へ次を追加します。
# order_line.yaml に追加する画面設定の抜粋
ui:
form:
children:
- entity: DeliveryPlan
bulk_save: true
screens: [create, update]参照先の複合主キー全項目を、同じ順序で対応付けます。lineRefは論理参照なので主キーにはせず、保存用のorderKey・lineKeyと枝番を主キーにします。保存用キーの入力補完や納品番号の採番は標準処理が行います。受注明細側のui.form.childrenに納品予定を指定すると、受注明細の登録・更新画面で納品予定も編集できます。親と子の予約属性version、必要な登録・参照・更新・削除権限も用意します。
5. 参考資料
- guide:エンティティ間の関係
designer/docs/appschema/markdown/guide/03-model/03-relations.md- reference:entity
designer/docs/appschema/markdown/reference/06-entity.md- guide:親子モデル同時更新
designer/docs/appschema/markdown/guide/07-screens/17-parent-child-bulk-edit.md- reference:ui
designer/docs/appschema/markdown/reference/10-ui.md- guide:詳細画面
designer/docs/appschema/markdown/guide/07-screens/06-detail.md