式の記述方法

概要

「ウィジェット」「アイテム」「やること」「条件」のパラメーターの多くには、式を記述することができます。

式を記述することで、ページ表示中のアイテムの値や、別のアクションで行った計算結果などを参照することが可能になります。

式が使えるのはパラメーターの入力時で、以下のパラメーター種別になります。

式の記述方法は大きく2種類あります。

文字列タイプのパラメーターでは、パラメーターを「=」から始めることにより、それ以降を式とみなします。Excel のセルに = 式を入力するような感覚です。

= 1 + 2

マッピングでは、各マッピング先に対して、マッピング元の値を=式で記述します。詳細はマッピングの記述方法をご覧ください。

複数行文字列やリッチテキストタイプのパラメーターでは、「=式」は使用できません。代わりに${}の中に式を埋め込みます。${}の外側は通常のテキストになります。

1 + 2 の結果は ${1 + 2} になります！

文字列タイプのパラメーターでも ${式}を使用することができます。ただし、=式と${式}を混在させることはできません。

ページ内処理では、式の中に入力タイプアイテムのアイテムIDを記述すると、ページ内でユーザーが入力中の値を取得できます。以下の例では「数値_1」「数値_2」というアイテム入力値の比率を計算します。

= 100 * 数値_1 / 数値_2

式の中に $1 など、「$数字」を記述すると、その数値をアクションの番号とみなし、アクションの結果値を取得します。

= $12 + $13

この「$数字」を、${式}記法で記述する場合は、以下の例のようになります。

正：12番アクションの結果は${$12}です。

以下の記述だと、$12 の部分が式にならないので、思った結果になりません。

誤：12番アクションの結果は$12です。

アクションの結果がオブジェクトやレコードのように属性値や子要素を持つ構造の場合、.で属性値や子要素を参照できます。レコードの場合、子要素はカラム（kintoneの場合はフィールド）になります。

以下の例では、アクション1が「JSONを読み込む」で{"商品コード": "EVS-020", "価格": 120000} という JSON を読み込んだ結果だった場合、商品コードの "EVS-020" を得ます。

= $1.商品コード

式の中で固定の文字列を扱う場合は、ダブルクォーテーションまたはシングルクォーテーションで囲みます。

文字列に改行を含めたい場合、文字の代わりに \n と記述するとその部分が改行となります。以下の例は「東京、名古屋、大阪」を改行で区切った文字列を作成します。

= "東京\n名古屋\n大阪"

複数の文字列を結合する場合は、「&」で結合します。「+」ではないので注意してください。

= "今日の日付は" & 日付_1 & "です"

数値に対しては四則演算 + - / * と剰余 % が使用可能です。

掛け算は「×」ではなくて半角の * になります。

割り算は「÷」ではなくて半角の / になります。

アイテムの中には、「複数選択チェックボックス」のように複数の値を持つものがあります。このようなアイテムは、値を「配列」と呼ばれる形式で持ちます。

配列の各要素には、JavaScript と同じように [] でアクセスできます。以下の例は「複数選択チェックボックス」で選択されている最初の値を取得します。

= チェックボックス[0]

以下の例は、"sample1", "sample2" という２つの要素を持つ配列を作成します。

= ["sample1", "sample2"]

配列に対して属性指定を行った場合、結果は元の配列の各要素に対して、属性値を取り出した配列になります。

以下の例で、アクション1の結果はレコードの配列とします。この式の結果は各レコードのレコード番号列を取り出した配列になります。

= $1.レコード番号

二項演算子（左辺と右辺があるタイプの演算）は、左辺を配列にすることができます。この場合、左辺の配列の各要素にその演算子を適用した新しい配列が作成されます。以下の例は、[5, 6, 7] という配列が返ります。

= [1, 2, 3] + 4

二項演算子で右辺が配列の場合、通常はエラーになります。ただし、右辺の配列が１要素のみの場合、その要素を取り出して演算します。以下の例は 6 + 4 と解釈されて結果は 10 になります。

= 6 + [4]

右辺が２要素以上になるとエラーになります。以下の例は実行時にエラーになります。

= 1 + [2, 3]

以下のリンク先ページを参照してください。