項目の値から金額などを計算する

1. このページで伝える機能

数量と単価を入力し、金額はWagby11に計算させられます。計算結果は入力項目から分けて管理でき、金額の手計算や転記を減らせます。

使える関数の一覧、演算子、未設定値や丸めの規則、用途ごとの制約は関数と式の仕様を参照してください。

2. Wagby11で実現できること

計算見積に数量2、単価1,200円を入力します。この例では保存時に計算します。

保存後の「金額・表題」タブでは、2×1,200で税抜金額が2,400円になります。会員割引がオフなら適用金額も2,400円です。表示用税込額は別の計算です。

計算項目を利用者が直接入力する必要はありません。未入力の場合の扱い、円未満の丸め、税込・税抜のどちらを求めるかも決められます。

親子フォームの入力中に明細金額と合計を再計算する動作や、非保存の子計算項目を集計する規則は、入力中に明細と合計を再計算するを参照してください。

3. AIへの指示例

最小限の指示例

数量と単価を掛けて、金額を自動計算してください。

AIは対象の数量・単価・金額項目、計算タイミングや数値の桁数を類推して補います。保存時に求めるか、入力中にも確認したいか、未入力をどう扱うかも伝えると仕様が明確になります。

より詳細な指示例

計算見積（CalcQuote）のquantityとunitPriceを掛けてamountへ保存してください。amountはdecimal、precision14・scale2、calc.onはcreateとupdateにします。数量または単価が未入力ならamountはnullにします。画面の金額は直接編集させず、数量2・単価1200を保存して2400になることを確認してください。
既存のモデル・主キー・項目・データ・権限を保持し、Wagby11のguide・referenceを確認してください。新規モデルには自動採番の主キーと予約属性version、必要なG_ADMINのCRUD権限を用意します。メニューと一般利用者向け操作マニュアルを更新し、設計情報の検証・コード生成・ビルドを完了してから起動し、画面と保存結果を確認してください。

4. 編集されるAppSchemaの例

以下は関連する定義の抜粋です。構文を覚えなくても、何から・いつ値を求め、保存するかをAIへ伝えられます。

entity:
  attributes:
    - { name: 数量, name_en: quantity, type: integer }
    - { name: 単価, name_en: unitPrice, type: decimal, precision: 12, scale: 2 }
    - name: 税抜金額
      name_en: amount
      type: decimal
      precision: 14
      scale: 2
      calc:
        on: [create, update]
        expression: 'quantity == null or unitPrice == null ? null : quantity * unitPrice'

保存するcalcは登録・更新で計算します。この例は整数の数量と十進小数の単価の積です。計算後の値にも必須・範囲などの検証を適用できます。

5. 参考資料

reference：式言語（属性の計算）

designer/docs/appschema/html/reference/16-expression-language.html

reference：利用できる関数

designer/docs/appschema/html/reference/17-expression-functions.html