式の理解

お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

数式項目の式について

数式項目の式（Expression）は、その項目に保存・表示される値を定義するものです。たとえば、金額項目は通常、単価と注文数量項目の値を掛け合わせた結果になります。この金額項目の式は次のようになります。

Unit_Price * Ordered_Quantity

ここで、Unit_PriceとOrdered_Quantityは項目リンク名であり、アスタリスク（*）は、2つの項目の値を掛け算する算術演算子を表します。数式項目の式の定義については、次のセクションを参照してください。

式を構成する要素

数式項目の式は、次の要素を組み合わせて構成できます。

項目	式には、同じフォーム内の項目や、ルックアップ項目やサブフォーム項目を介して関連付けられたフォーム内の項目を含めることができます。
定数	固定値を指します。定数には、テキスト、数値、特殊文字、またはそれらの組み合わせを指定できます。たとえば、abcdは文字列定数、123.02は数値定数、abcd - 123は（123という数値を含みますが）文字列定数です。定数のデータ型は、式内での記述方法によって決まります。詳細はガイドラインを参照してください。
Deluge システム変数	Deluge のシステム変数を含めると便利な場合があります。たとえば、zoho.currentdateは現在の日付を返す変数です。詳細はこちら
演算子	1つまたは複数の値（オペランド）に対して特定の計算を行う記号です。たとえば、+ 記号は、2つの数値の加算や、2つの文字列の連結を行う算術演算子です。詳細はこちら
組み込み関数	1つまたは複数の値に対して特定の処理を行います。たとえば、length()関数は、文字列内の文字数を返します。詳細はこちら

式を定義する際のガイドライン

式のサンプルセクションでは、ここで説明するガイドラインを例で示しています。

式に項目を含める場合：
- 項目は、その項目リンク名で参照します。式には、メモ項目とセクション項目以外のすべての項目タイプを含めることができます。数式項目は、別の数式項目の式の中で参照できます。
Deluge のシステム変数を含めるには、変数名を直接入力する必要があります。
式に定数を含める場合：
- 文字列定数は二重引用符で囲みます。数値定数はそのまま記述します。日付および日時の定数は、単一引用符で囲みます。
式を評価する際の実行順序を指定するには、かっこを使用します。
- 例 1：式2 + 3 * 5の結果は 17 になります。乗算演算子（*）は加算演算子（+）よりも優先して実行されるため、まず 3 と 5 が掛け算され、その結果（15）に 2 が加算されます。
- 例 2：式(2 + 3) * 5の結果は 25 になります。かっこ内の処理が先に実行されるため、まず 2 と 3 が加算され、その結果（5）に 5 が掛け算されます。
条件式を定義することもできます。詳細はこちら

メモ：数式項目でべき乗を計算するには、次の構文を使用します：<input.number.power(input.Expression)>

条件式の定義

条件式とは、ブール式の結果に応じて 2 つの値のうちいずれか 1 つを返す式です。次のように定義します。

if ( <条件>, <条件が真の場合の値>, <条件が偽の場合の値> )

例を見てみましょう。注文フォームで、注文数量が 15 を超える場合に金額から 10 ドルを割り引きたいとします。（説明を簡単にするため、ここでは 1 件の注文に 1 つの商品しか含まれないものとします。実際には複数の商品を含むことが一般的です。）

ここでの条件は、その注文で指定された数量が 15 を超えているかどうかです。
注文数量が 15 を超える場合、式は割引後の金額を返す必要があります。
注文数量が 15 以下の場合、式は金額をそのまま返す必要があります。

この場合の式は次のようになります。

if ( Ordered_Quantity > 15, 金額 - 100, 金額 )

条件式は入れ子にすることもできます。つまり、ある条件式の中で別の条件式を使用できます。サンプル式については、こちらのセクションを参照してください。

式のサンプル

定数と Deluge システム変数を含む式

数式フィールドの目的	式	説明
文字列を表示する	'abcd'	文字列値は二重引用符で囲む必要があります。
二重引用符を含む文字列を表示する	'\'abcd\''	表示したい二重引用符の前にバックスラッシュ（\）を付ける必要があります。
数値を表示する	105	数値はそのまま入力できます。
小数値を表示する	105。23	小数値もそのまま入力できます。
日付値を表示する	'10-Aug-2018'	日付値は一重引用符で囲む必要があります。値は、そのアプリの設定で指定されている日付形式に従う必要があります（この例ではdd-MMM-yyyy形式）。
現在の日付を表示する	Zoho。currentdate or 今日	Zoho。currentdate と今日は、現在の日付を返すシステム変数です。
明日の日付を表示する	明日 or 今日。addDay(1)	明日は、現在の日付の翌日の日付を返すシステム変数です。addDay() は組み込みの日付関数です。
昨日の日付を表示する	昨日	昨日は、現在の日付の前日の日付を返すシステム変数です。
日付と時刻の値を表示する	'10-Aug-2018 14:30:00'	日付と時刻の値は一重引用符で囲む必要があります。値は、そのアプリの設定で指定されている日付形式に従う必要があります。この例では形式は dd-MMM-yyyy です。
現在の日付と時刻を表示する	Zoho。currenttime or now	Zoho。currenttime と now は、現在の日付と時刻を返すシステム変数です。
小数値を小数第 2 位（百分の一）に四捨五入する	10。5356。round(2) or 100。2345。round(2)	round() は組み込み関数です。丸め対象の値と、小数値を丸める小数桁数を指定します。
文字列内の文字数を取得する	'This is a string'.length()	length() は組み込み関数です。空白を含め、文字列内の文字数を返します。
入力された日付と現在の日付の間の日数を求める	Zoho。currentdate。daysBetween(Delivery_Date)	Zoho。currentdate は現在の日付を返すシステム変数です。Delivery_date はフィールドのリンク名です。daysBetween() は、2 つの日付または日付と時刻の値の間の日数を返す組み込み関数です。

フィールドを含む式

数式項目の目的	式	説明
商品名前項目と商品種類項目など、2 つの項目のデータを商品フォームで連結して表示する。	Product_Type + Product_Name or Product_Type + ' - ' + Product_Name	Product_TypeとProduct_Nameは項目リンク名です。+は、オペランドのいずれかが文字列の場合にオペランド同士を連結する算術演算子です。
項目（例：コメント）に入力された文字数を取得する。	コメント。length()	コメントは項目のリンク名です。length() は組み込み関数で、文字列内の文字数を返します。
項目に保存されている小数値を小数第 1 位（小数点以下 1 桁）に四捨五入する。	<field_link_name>.round(1)	round()は組み込み関数です。処理対象の小数値と、四捨五入する小数点以下の桁数を指定する必要があります。小数値を含む項目は、その項目リンク名で参照します。
2 つの日付または日付-時間項目（例：開始する日付とEnd 日付）の間の日数を求める。	Start_Date。daysBetween(End_Date)	Start_DateとEnd_Dateは項目リンク名です。daysBetween() は組み込み関数で、2 つの日付または日付-時間値の間の日数を返します。
ユーザーが選択した住所の緯度と経度を表示する。	住所。緯度 + ' , ' + 住所。経度	住所は複合項目です。この式は 2 つの値をカンマ区切りで連結して表示します。メモ: 緯度と経度は、ユーザーが地図上で住所を選択した場合にのみ取得されます。

ルックアップ項目とサブフォーム項目を含む式

数式項目の目的	式	説明
従業員が所属する部署のメール Aliasを表示する。	部署。Email_Alias	通常、従業員は同時に 1 つの部署にのみ所属します。この関係はルックアップ項目を使用して確立されます。部署データは従業員フォームからルックアップされます。部署とEmail_Aliasは項目リンク名です。
注文時に商品の価格を表示する。	商品。価格	通常、商品詳細は別フォームに保存され、順番フォームでルックアップされます。商品は順番フォームに追加されたルックアップ項目であり、これを通じて選択した商品の価格が取得されます。
折れ線グラフ合計として、注文フォーム内で各注文商品の合計金額を表示する。	価格 * 数量	価格と数量は項目リンク名です。価格は、選択した商品の価格を商品フォームから表示する数式項目にすることもできます（上記の例を参照）。
サブフォームに追加されたデータ件数を表示する。	Line_Items。件数()	Line_Itemsはサブフォームの項目リンク名です。件数()は組み込みの集計関数で、フォーム内のデータ件数を返します。
サブフォーム内に存在する数値の合計をメインフォームに表示する。	Line_Items。sum(Line_Total)	Line_Itemsはサブフォームの項目リンク名です。Line_Totalは、各注文商品の折れ線グラフ合計（上記の例を参照）を保存する項目のリンク名です。sum()は組み込みの集計関数です。

条件式

条件式とは何かについては、こちらのセクションを参照してください。

数式項目の目的	条件	条件が真の場合の値	条件が真でない場合の値	最終式	説明
ユーザーが注文フォームで商品を選択し、数量を入力したときに、その折れ線グラフ合計を、価格と数量の積（乗算）で設定し、それ以外の場合は 0 に設定します。	商品。価格 != null && 数量 != null	商品。価格 * 数量	0	if(商品。価格 != null && 数量 != null, 商品。価格 * 数量, 0)	価格と数量は項目のリンク名です。価格は、選択された商品の価格を商品フォームから表示する数式項目にすることができます。
ユーザーがWebinar フィードバックフォームで選択した数値の評価を、1 - Poor、2 - 平均、3 - Good、4 - Excellent のように、対応する語句に変換します。これらの数値は、ラジオボタン項目に表示される選択肢です。	評価 == '1'	'Poor'	if(評価 == '2', '平均', if(評価 == '3', 'Good', 'Excellent'))	if(評価 == '1', 'Poor', if(評価 == '2', '平均', if(評価 == '3', 'Good', 'Excellent')))	これは条件式の入れ子の例です。評価は選択肢項目のリンク名で、1、2、3、4が選択肢です。この式は 1 から 4 まで順にチェックし、該当する語句を返します。