メインコンテンツまでスキップ

値入力欄の書き方

このページでは、ワークフローの値入力欄で使う式の基本構文・演算子・型の扱いについて説明します。
{{ ... }} 記法の使い分けから、条件式の型判定・よくある間違いまでをまとめたリファレンスです。

フィルタを使った値の加工については フィルタ一覧 を参照してください。

基本的な表記​

値入力欄で {{ ... }} で囲んだ内容は式として評価されます。

入力例評価結果
ok固定文字列 ok
{{ user_name }}変数 user_name の値
{{ count + 1 }}count + 1 の計算結果
{{ status == "ok" }}true または false
注記

値を入力するときは、まず「固定値をそのまま入れたいのか」「式の評価結果を使いたいのか」を判断します。

  • 固定値：そのまま入力する。
  • 変数参照、計算、比較、加工をしたい： {{ ... }} を使う。
  • 条件式： true / false になる形で書く。
  • 変数設定：キー名にも {{ ... }} を使う。
固定値を設定したい場合は {{ }} で囲まないでください。
  • {{ }} で囲まない場合は、入力した値がそのまま扱われます。
  • デフォルト値など決まった値をそのまま設定する場合に利用します。
変数設定 ではキー名にも {{ ... }} を使えます。

キー名が result_{{ index }}の場合、index が 2 のとき、実際のキー名は result_2 になります。
例）以下の変数設定で index = 2、score = 80 の場合、result_2 = 90 が保存されます。

  • キー名: result_{{ index }}
  • 値: {{ score + 10 }}

キー名を動的に変えることで、繰り返し処理や連番付きの保存に対応しやすくなります。

演算子​

比較演算子​

演算子例
=={{ status == "ok" }}
!={{ count != 0 }}
> / < / >= / <={{ score >= 80 }}

論理演算子​

演算子例
&&{{ score >= 80 && isActive }}
||{{ status == "ok" || status == "pending" }}
!{{ !isDeleted }}

含有判定​

演算子例
in{{ item in items }}

条件式の型判定​

条件式の評価結果は型によって次のように扱われます。

型true になる値false になる値
booltruefalse
string"true", "1""false", "0"
int, double0 以外0
それ以外-実行時エラー

判定例​

式結果
{{ true }}true
{{ "1" }}, {{ "true" }}true
{{ 0 }}, {{ "false" }}false
{{ -1 }}true

よくある間違い​

NG 例問題修正例
value > 0{{ }} がないため式として評価されません{{ value > 0 }}
{{ ok }}固定文字列のつもりが変数参照になりますok
{{ count > "10" }}数値と文字列の比較で意図しない結果になります{{ count > 10 }}

予約語の一覧​

Agentiqs で使用している予約語は、テンプレートや項目の処理を制御するために使用されるため、
ユーザー定義の項目名・変数名・置換キー名などには使用できません。

予約語と同じ名称を使用した場合

テンプレートの解析エラーが発生する、または意図した値として認識されない可能性があります。

予約語の一覧

break capture case continue do
else end false for func
if import in null readonly
ret tablerow this true when
while with wrap

に最終更新