理解する表現

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

式フィールドの式を理解する

フォームの式フィールドの式は、それが格納して表示する値を定義するものです。例えば、注文フォーム内の金額フィールドは、通常、単価と注文数の値を掛け合わせた結果となります。この金額フィールドの式は次のようになります：

単価 * 注文数量

ここでは、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で乗算されます。
条件式を定義することができます。詳細はこちら

条件式の定義

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

もし（条件）、（条件が真の場合の値）、（条件が偽の場合の値）

例を挙げましょう。注文フォーム内の金額を、注文数が15以上の場合に$10割引するとします（実際の世界では、注文に1つの商品しか含まれないということを仮定していますが、これはほとんどあり得ません）。

この場合は、注文で要求された数量が15以上かどうかです。
注文された数量が15以上の場合、割引価格を返す式となります。
注文された数量が15以下の場合、その金額をそのまま返す式となります。

この表現は次のようになります：

もし（注文数が15を超える場合、金額から100を引く、金額）

条件式をネストすることができます - 内部に別の条件式を使用します。サンプル式を見るには、こちらを参照してください。

サンプル表現

定数およびDelugeシステム変数を含む式

フォーマットフィールドの目的	その表現	説明
文字列を表示する	'abcd'	文字列の値は、ダブルクォーテーションマークで囲む必要があります。
双引用符を含む文字列を表示する場合	'\'abcd\''	双引用符を表示したい場合は、バックスラッシュ文字（\）を先に付ける必要があります。
数字を表示する	105	数字はそのまま挿入できます
10進数の値を表示	105.23	10進数の値はそのまま挿入することができます。
日付の値を表示する	'10-Aug-2018'	日付の値はシングルクォーテーションマークで囲む必要があります。値は、そのアプリの設定で設定された日付フォーマットに従う必要があります（この例ではフォーマットがdd-MMM-yyyyと考えられます）。
現在の日付を表示します	zoho.currentdate または today	zoho.currentdate および today は、現在の日付を返すシステム変数です。
明日の日付を表示します	tomorrow または today.addDay(1)	tomorrow は、現在の日の後の日付を返すシステム変数です。addDay()は、組み込みの日付関数です。
昨日の日付を表示	昨日	昨日は、現在の日付の前日の日付を返すシステム変数です。
日時の値を表示する	'10-Aug-2018 14:30:00'	日時の値は、シングルクォーテーションマークで囲まれている必要があります。値は、そのアプリの設定で設定された日付フォーマットに従う必要があります。この例では、フォーマットがdd-MMM-yyyyと考えられます。
現在の日付と時刻を表示する	zoho.currenttime または now	zoho.currenttime および now は、現在の日付と時刻を返すシステム変数です。
小数値を小数点以下2桁（100番目）までに丸める	10.5356.round(2) または 100.2345.round(2)	round（）は組み込み関数です。演算対象の値を指定し、小数値を小数点以下何桁までに丸めるかを指定する必要があります。
文字列中の文字数を検索する	'This is a string'.length()	length()は組み込み関数です。文字列内に含まれる空白を含めた文字数を返します。
入力した日付と現在の日付の間の日数を求める	zoho.currentdate.daysBetween(Delivery_Date)	zoho.currentdate は、現在の日付を返すシステム変数です。 Delivery_date は、フィールドリンク名です。 daysBetween()は、2つの日付または日時の値の間の日数を返す組み込み関数です。

フィールドを含む表現

関数フィールドの目的	その表現	説明
プロダクトフォーム内の、Product Name と Product Type という2つのフィールドのデータを結合します。	Product_Type + Product_Name または Product_Type + ' - ' + Product_Name	Product_Type と Product_Name は、フィールドリンク名です。+ は、算術演算子であり、どちらか一方が文字列の場合、その演算子は演算子を結合します。
フィールド内に入力された文字数を検索するには、コメントなどをご覧ください。	Comments.length()	コメントは、フィールドのリンク名です。length()は、文字列内の文字数を返す組み込み関数です。
小数値を格納したフィールドを小数点以下1桁（つまり、小数点以下1桁）に丸める	<field_link_name>.round(1)	round() は組み込み関数です。それは、操作対象とする小数値と、丸める小数点以下の桁数を指定する必要があります。小数値を含むフィールドは、フィールドリンク名で参照されます。
2つの日付または日時フィールド（開始日と終了日）の間の日数を求めるには	Start_Date.daysBetween(End_Date)	Start_DateとEnd_Dateはフィールドリンク名です。daysBetween（）は組み込み関数です。2つの日付または日時値間の日数を返します。
ユーザーが選択した住所の緯度と経度を表示します	Address.latitude + ' , ' + Address.longitude	アドレスは複合フィールドです。式は2つの値をカンマで結合します。注：ユーザーが地図から住所を選択すると、緯度と経度が取得されます。

ルックアップおよびサブフォームフィールドを含む式

フォーマットフィールドの目的	その表現	説明
部門に勤務する従業員のメールアドレスの別名を表示してください	Department.Email_Alias	通常、従業員は一度に1つの部門にのみ割り当てられます。この関係は、ルックアップフィールドを使用して構築されます。部門データは従業員フォームからルックアップされます。部門とメールアドレスの別名がフィールドリンク名です。
注文時の価格を表示する	Product.Price	通常、商品の詳細は別のフォームに保存され、注文フォームで照会されます。商品は照会フィールドで、注文フォームに追加され、選択した商品の価格が取得されます。
注文された各製品の行合計を注文フォームに表示します。	価格 * 数量	価格と数量は、フィールドリンク名です。価格は、製品フォームから選択された製品の価格を表示する式フィールドです（上記の例を参照）。
サブフォームに追加されたレコード数を表示します	Line_Items.count()	Line_Items は、サブフォームのフィールドリンク名です。 count() は、フォーム内のレコード数を返す組み込み集計関数です。
メインフォームにサブフォーム内の数値の合計を表示します	Line_Items.sum(Line_Total)	Line_Items は、サブフォームのフィールドリンク名です。 Line_Total は、各注文商品のライン合計（上記の例を参照）を格納するフィールドのリンク名です。 sum（）は、組み込みの集約関数です。

条件式

条件式について学ぶためには、こちらを参照してください。

式フィールドの目的	条件	条件が正しい場合の値	条件が正しくない場合の値	最終式	説明
ユーザーが商品を選択し、注文フォームに数量を入力した場合、行合計を商品（乗算）の価格と数量で設定します。そうでない場合は、ゼロ（0）として設定します。	Product.Price != null && Quantity != null	Product.Price * Quantity	0	if(Product.Price != null && Quantity != null, Product.Price * Quantity, 0)	Price とQuantity は、フィールドリンク名です。Price は、Product フォームから選択した商品の価格を表示する式フィールドになります。
ユーザーがあなたのWebinar Feedbackフォームで選択した数値のRatingを、1 - Poor、2 - Average、3 - Good、4 - Excellentという単語に変換します。これらの数値は、radioフィールドによって表示されます。	Rating == '1'	'Poor'	if(Rating == '2', 'Average', if(Rating == '3', 'Good', 'Excellent'))	if(Rating == '1', 'Poor', if(Rating == '2', 'Average', if(Rating == '3', 'Good', 'Excellent')))	これは入れ子条件式の例です。Ratingは選択フィールドのリンク名で、1、2、3、4がその選択肢です。式は1から4までを順にチェックし、対応する単語を返します。