関数と式の仕様

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

金額計算、条件分岐、文字列の組み立て、日付の移動などを、項目の値と関数の組み合わせで表現できます。初期値と計算・導出項目は、共通の式の文法と関数を使います。ただし、使う場面によって項目参照や休日関数などの制約が異なります。

式の構文を覚えてからAIに指示する必要はありません。「何から何を求めるか」「未入力ならどうするか」「いつ計算するか」を伝えると、AIが対応する式を組み立てられます。このページは、使える機能を確認するための資料です。

2. Wagby11で実現できること

例えば数量2と単価1,200から金額2,400を求め、条件に応じた割引や、表示用の文字列を組み合わせられます。

2.1 初期値・保存時計算・表示時計算の違い

式はサーバーで評価します。初期値はフォームを開くときの候補であり、登録APIやアップロードなど、すべての登録経路へ値を設定する仕組みではありません。すべての保存経路で計算が必要なら保存時計算を使います。初期値の適用順序は式で初期値を求めるで説明します。

2.2 式の書き方

関数は#today()のように先頭に#を付け、項目はname_enをそのまま使います。関数名・項目名の大文字と小文字は区別します。式全体を#{...}や${...}で囲みません。YAMLでは#がコメント記号になるため、式文字列を引用符で囲みます。

式中の文字列は一重または二重引用符で囲みます。同じ引用符を文字として含める場合は二つ続けます。例：'O''Brien'。バックスラッシュで引用符を逃がす書き方は使いません。条件分岐の両側は、同じ型・null・共通の数値型にできる値を返すようにします。

2.3 使える関数の一覧

表のstringは文字列、integerは整数、numberは数値、decimalは十進小数、booleanは真偽値、date・time・datetimeは日付・時刻・日時です。[ ]は省略できる引数、...は複数の引数、->の右側は結果の型を表します。Tは同じ型同士、anyは式で扱えるスカラー値、|や/で並べた型はいずれか一つを意味します。

文字列・型変換 ／ 数値・丸め ／ 未設定値 ／ 日付・時刻・日時 ／ 利用者情報 ／ 休日・営業日

2.4 文字列・型変換

#concatenateは1〜32個の文字列を連結し、nullと空文字を読み飛ばします。数値をつなぐときは#toStrや#textで文字列にします。#left・#rightの文字数省略時は1文字、#midの開始位置は1からです。文字数はUnicodeのコードポイント単位で数えます。

#trimは半角・全角空白、タブ、改行の前後を除去し、内部で連続する空白を半角空白一つにします。#textの日付書式はJavaのDateTimeFormatter、数値書式はDecimalFormatのパターンです。例：#text(amount, "#,##0.00")。文字列出力と#padLeftの指定桁数は最大65,536コードポイントです。

#toStrの日付はyyyy-MM-dd、時刻はHH:mm:ss、日時はyyyy-MM-dd'T'HH:mm:ssXXXの形式です。時刻・日時の秒未満は出力せず、日時の文字列化には評価時のタイムゾーンを使います。

2.5 数値・丸め

#roundは四捨五入（HALF_UP）、#roundDownは0方向への切り捨て、#roundUpは0から離れる方向への切り上げです。残す小数桁数は−38〜38で、0は整数、負数は整数部分の桁を表します。例：#round(#decimal('2.15'), 1)は2.2です。

#divideの丸め方式は省略するとHALF_UPです。第4引数には'UP'・'DOWN'・'CEILING'・'FLOOR'・'HALF_UP'・'HALF_DOWN'・'HALF_EVEN'・'UNNECESSARY'を指定できます。#min・#maxは2〜32個の数値を取り、nullを含むとnullを返します。

2.6 未設定値の判定・補完

数値や日付の未設定はamount == nullのように判定します。#nz(quantity)は数値項目が未設定なら0にします。#nvl(name, "未入力")は未設定なら代わりの値を返します。#nz(null)や#nvl(null, null)は型を決められないため使えません。

関数の引数は先に評価されるため、#nvlでゼロ除算などのエラーを回避することはできません。危険な計算を避ける場合は、quantity == null or quantity == 0 ? null : #divide(amount, quantity, 2)のように条件分岐を使います。

2.7 日付・時刻・日時

#today()・#now()は処理ごとの基準時刻とenvironment.timezoneを使います。同じ処理内では基準時刻を共有します。日時から年月日などを取り出す場合は、その日時が持つオフセットを使い、別の地域へ暗黙に換算しません。

#boMonth・#eoMonthの第2引数は移動する月数で、省略時は0（同じ月）です。日付や日時の移動関数では、正数は未来、負数は過去へ移動します。

#dateDifの単位は'Y'（完了した年数）、'M'（完了した月数）、'D'（日数）、'YM'（年数を除く月数）、'YD'（年数を除く日数）、'MD'（月数を除く日数）です。終了日が開始日より前の場合はエラーです。#fiscalYearは4月始まりの年度を返します。

#moveMonth・#eDate・#moveYearは、移動先に同じ日がなければ月末へ補正します。#betweenTimeは差の絶対値を使い、24時間を超える日数部分を捨てます。長い期間の日数は#dateDifで求めます。

#dateTimeValueは既定でyyyy-MM-dd HH:mm:ssとyyyy/MM/dd HH:mm:ssを受け付け、任意の第2引数で書式を指定できます。#dateValueはyyyy-MM-ddとyyyy/MM/dd、#timeValueはHH:mmとHH:mm:ssを受け付けます。時刻は'9:5'などの1桁表記も使えます。

#weekDayの第2引数は、省略または1なら日曜1〜土曜7、2なら月曜1〜日曜7、3なら月曜0〜日曜6です。#toDateTime(date)はその日の0時、#toDateTime(time)は1970年1月1日のその時刻になります。

2.8 利用者情報

利用者情報は処理に渡された認証情報のスナップショットです。利用者なしの処理ではID・名前・メールはnull、#hasGroupはfalseになります。#hasGroupは直接所属するグループIDとの完全一致であり、子孫グループやロール・権限の判定ではありません。

2.9 休日・営業日

初期値と保存時計算で利用できます。表示時計算では使えません。休日サービスと辞書の構成が必要です。#workdayは開始日を含めず営業日数だけ移動し、0なら開始日を返します。#networkDaysは両端を含み、逆順なら負数を返します。

一度に扱える営業日数・走査日数・期間は最大3,660日です。処理全体にも評価回数の制限があります。保証期間外の不明な平日や上限超過はエラーとなり、暦日計算に置き換えることはありません。

2.10 式に書けないことと上限

• 参照できるのは、用途で許可された同じモデルのスカラー項目や単一参照キーです。customer.nameのように参照先の項目を直接たどる記法や、配列・複数参照・関連データの操作は使えません。参照先の値はルックアップで用意します。
• Javaのメソッド呼び出し、オブジェクト生成、代入、任意のDB・ファイル・ネットワーク操作は使えません。関数は一覧にあるものを使います。
• IF(...)・AND(...)・TODAY()の形式は使いません。条件分岐は条件 ? 値1 : 値2、現在日は#today()です。小数リテラル、指数演算、正規表現、Elvis演算子も使えません。

• 式は最大1,024文字、括弧などの深さは最大16段、関数の引数は最大32個です。式全体の構造やトークン数にも上限があり、複雑すぎる式は生成前の検証でエラーになります。

  複雑な計算や、式の上限を超える処理は、AppSchemaのrulesに「いつ・どの条件で・何を計算するか」を文章で記述し、その内容をもとにAIにJavaコードを実装させることで対応できます。ルールの説明文と、対応するJavaコードの実装・動作確認を合わせてAIに依頼します。

• 自己参照と循環参照は使えません。式の結果は設定先の型に合う必要があり、整数への変換時は範囲と小数部も検査します。呼び出されない条件分岐の中も、関数名・型などは検証します。

通常の関数はnullを渡すとnullを返しますが、例外があります。例えば#len(null)は0、#isBlank(null)はtrueです。#decimal(null)・#date(null)はエラーです。関数ごとの規則を確認します。

アプリケーション全体の標準ロケールとタイムゾーンは、「環境」の標準の言語とタイムゾーンを設定するを参照してください。

3. AIへの指示例

最小限の指示例

数量と単価から金額を求め、円未満の扱いと未入力時の動作も提案してください。保存する金額と、表示用の文字列を分けてください。

対象項目、数値の桁数、丸め桁数、未入力時の扱いなどをAIが類推して補います。保存する値か表示だけの値か、四捨五入か切り捨てかなど、決まっている条件は具体的に伝えます。

より詳細な指示例

計算見積CalcQuoteで、quantityとunitPriceの積を小数第2位まで四捨五入し、amountへ登録・更新時に保存してください。
数量か単価が未入力の場合はamountをnullにします。amountはdecimal型、precision14・scale2とし、利用者には直接入力させません。
表示用のamountLabelはDBへ保存せず、amountが未設定なら「未入力」、設定済みなら「見積金額：2,400.00円」の形式にしてください。
Wagby11で使える関数と式の仕様を確認し、保存時計算と表示時計算を使い分けてください。quantity=2、unitPrice=1200と、片方が未入力の場合の結果を確認してください。
既存のモデル・主キー・項目・データ・権限を保持してください。必要なメニュー・一般利用者向け操作マニュアルを更新し、設計情報の検証・コード生成・起動後に保存結果と画面表示を確認してください。

4. 編集されるAppSchemaの例

数量と単価は定義済みとし、計算項目の抜粋を示します。利用者が構文を覚える必要はありません。

entity:
  attributes:
    - name: 金額
      name_en: amount
      type: decimal
      precision: 14
      scale: 2
      calc:
        on: [create, update]
        expression: 'quantity == null or unitPrice == null ? null : #round(quantity * unitPrice, 2)'
    - name: 金額表示
      name_en: amountLabel
      type: string
      length: 100
      transient: true
      calc:
        on: [display]
        expression: 'amount == null ? "未入力" : #concatenate("見積金額：", #text(amount, "#,##0.00"), "円")'

保存時計算の金額を表示時計算が読み、文字列へ整えます。計算項目は読み取り専用になります。文字列を作る目的と金額を保存する目的を分けて指示できます。

5. 参考資料

reference：式言語

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

reference：利用できる関数

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

reference：rules（業務ルール）

designer/docs/appschema/html/reference/08-rules.html

guide：初期値

designer/docs/appschema/html/guide/05-input-control/01-initial-value.html