よくある質問：数式フィールド

よくある質問：数式フィールド

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

数式項目の基本

数式項目とは？
数式項目は、他の項目の値に基づいて値を自動計算するカスタム項目です。項目、定数、演算子、関数を使用して定義した式に基づき、データの計算を自動化できます。参照先の項目の値が変更されるとリアルタイムで更新されるため、手動で計算する必要がありません。

たとえば、チケット料金やチケット枚数などの適切な項目と、返金する割合を数式で指定することで、返金総額を自動計算できます。次の例では、金額の70%のみを返金するものとします。

`{cf_ticket_price} * {no_of_tickets_booked} * 0.7`

出力。

数式項目を手動で編集できますか？
いいえ。数式項目の値は設定された式によって決まるため、読み取り専用です。担当者が計算結果を直接変更することはできません。

結果を変更するには、式で使用している項目の値を更新します。たとえば、返金額の数式でチケット料金と枚数を使用している場合、いずれかの値を変更すると返金額が自動的に再計算されます。
数式項目が再計算されるタイミング
数式項目は、参照先の項目の値が変更されるたびに自動的に再計算されます。個別の更新操作や手動での再読み込みは必要ありません。

チケットに基づく計算では、チケットを開くと、現在の結果を［チケットのプロパティ］（［チケット情報］内）で確認できます。
計算に使用する項目に値がない場合
数式で参照している項目が空欄または使用できない場合、数式の結果は0になります。

たとえば、次の返金額の計算式を使用するとします。
  1. {cf_ticket_price} * {no_of_tickets_booked} * 0.7
チケット料金またはチケット枚数のいずれかが空欄の場合、計算される返金額は0になります。数式の出力を利用する前に、計算に必要なすべての項目に値が入力されていることを確認してください。
数式項目は顧客に表示されますか？
いいえ。数式項目は担当者による内部利用を目的としており、顧客には表示されません。そのため、チケット内の業務上の計算や内部参照用の値に利用できます。
他の項目の値を数式で使用するには
数式の作成画面には、レイアウトで使用可能なすべての項目が一覧表示される［項目］セクションがあります。数式に項目を追加するには、目的の項目（料金や数量など）をクリックします。その項目のAPI名が式に自動的に挿入されるため、手動で入力せずに既存のデータを簡単に参照できます。

数式項目を追加するには
レイアウトに数式項目を追加するには
  1. ［設定］→［カスタマイズ］→［レイアウトと項目］に移動します。
  2. ［レイアウト］で、数式項目を追加するレイアウトテンプレートをクリックします。
  3. カスタマイズするタブを選択し、対象のレイアウトテンプレートをクリックします。
  4. ［項目の追加］で、［数式］項目をクリックし、レイアウト内の目的の位置にドラッグします。
  5. 基本情報を入力します。
    1. 数式項目の［ラベル］を入力します。
    2. 計算内容に応じて適切な［戻り値の種類］を選択します。
      1. ブール値：真／偽を示すチェックボックス
      2. 小数：小数点を含む数値
      3. 通貨：金額
      4. 文字列：テキスト形式の値
      5. 日付：カレンダーの日付
      6. 日時：時刻を含む日付
    3. ［式エディター］に式を直接入力します。
    4. 式全体を手動で入力する代わりに、表示される選択肢から項目名や演算子を挿入できます。
    5. ［項目の式］ボックスには、選択したレイアウトのすべての項目が参照しやすいように表示されます。
    6. 次の演算子を使用できます。
      1. +（加算）
      2. -（減算）
      3. *（乗算）
      4. /（除算）
      5. %（剰余）
      6. <（より小さい）
      7. >（より大きい）
      8. ^（累乗）
      9. .（ドット）
    7. 数式が有効でエラーがないことを確認するには、［構文を確認する］をクリックします。
  6. 検証が完了したら、［追加］をクリックして、数式項目をレイアウトに保存します。

数式項目の作成と設定

レイアウトに数式項目を追加するには
  1. ［設定］→［カスタマイズ］→［レイアウトと項目］の順に移動します。
  2. ［レイアウト］で、数式項目を追加するレイアウトテンプレートを開きます。
  3. 対象のタブとレイアウトを選択します。
  4. 項目を追加で、［数式項目］を目的の場所にドラッグします。
  5. 基本設定を入力します。
    1. 分かりやすい項目名を入力します。
    2. 想定される結果に合った戻り値の種類を選択します。
  6. 式エディターで式を作成します。
    1. 項目リストから使用可能な項目を挿入します。
    2. 必要に応じて演算子や関数を挿入します。
  7. 式を検証するには、［構文を確認］を選択します。
  8. 数式項目をレイアウトに保存するには、［追加］を選択します。
数式の結果は目的の値の種類と一致している必要があるため、式を確定する前に戻り値の種類を選択してください。
他の項目の値を数式に挿入するには
数式エディターの［項目］セクションを使用します。選択したレイアウトで使用可能な項目が一覧表示されます。

価格や数量など、計算に必要な項目を選択します。項目のAPI名が式に自動で挿入されるため、項目の参照を手動で入力する際のエラーを防止できます。

たとえば、チケット価格と予約数を選択すると、次のような式を作成できます。
  1. {cf_ticket_price} * {no_of_tickets_booked}
選択できるのは、選択したレイアウトに含まれている項目です。


数式で使用できる演算子
数式では、次の演算子を使用できます。

+ — 加算
- — 減算
* — 乗算
/ — 除算
% — 余り
< — より小さい
> — より大きい
^ — べき乗
. — ドット

たとえば、合計金額の70%を計算するには、金額に0.7を掛けます。
  1. {cf_ticket_price} * {no_of_tickets_booked} * 0.7
%演算子は余りを返します。割合を適用するための演算子ではありません。
数式項目を保存する前に式を確認するには
数式エディターで式を作成または更新した後、［構文を確認］を選択します。式が検証され、項目を保存する前に修正が必要な問題が特定されます。

複数の項目、演算子、関数を組み合わせた後は、構文の確認が特に重要です。式の検証が正常に完了したら、［追加］を選択して数式項目を作成します。
数式の複雑さに上限はありますか？
数式項目では、安定したパフォーマンスを維持しながら詳細な式を使用できます。各式では、次の上限が適用されます。
  1. 1,500文字
  2. 15個の関数
  3. 25個の演算子
この上限の範囲内で、さまざまな計算、条件、データ変換に対応できます。数式がさらに複雑になる場合は、使用可能な項目を活用して、計算を管理しやすい小さな式に分けることを検討してください。

戻り値の種類と結果

数式項目ではどのような種類の値を返すことができますか？
数式項目では、次の6種類の戻り値がサポートされています。
  1. 真偽値 - TRUEまたはFALSEを返します。条件に基づく結果に適しています。
  2. 小数 - 94.3など、小数点以下を含む数値を返します。
  3. 通貨 - 適用される通貨形式で金額を返します。
  4. 文字列 - テキストを返します。
  5. 日付 - 時刻を含まない日付を返します。
  6. 日時 - 日付と時刻の両方を返します。
個々の参照元項目の種類だけでなく、最終的な出力に合う戻り値の種類を選択してください。
計算結果の金額を通貨として表示するにはどうすればよいですか？
数式項目の戻り値の種類を［通貨］に設定します。これにより、結果が適用される通貨形式の金額として表示されます。

たとえば、返金額を計算する数式では、戻り値の種類として［通貨］を使用できます。
  1. {cf_ticket_price} * {no_of_tickets_booked} * 0.7
担当者が結果を単なる数値ではなく金額として確認する必要がある場合は、戻り値の種類を［小数］にするよりも［通貨］にすることをお勧めします。
数式項目では、数値の代わりにテキストを返すことができますか？
はい。テキストを返すには、数式項目の戻り値の種類として［文字列］を選択します。

文字列の数式には、他の項目を参照せずに固定メッセージを含めることもできます。例：
  1. 'メモ：MWV Bankでは返金を受け付けていません。'
指定したテキストが数式項目の値として表示されます。
数式項目を日付や時刻の計算に使用できますか？
はい。数式項目では、日付と日時の戻り値の種類、および日時値の作成、比較、調整に使用できる日時関数がサポートされています。

使用できる日付／時刻関数は次のとおりです。
  1. Dayofmonth
  2. Hour
  3. Minute
  4. Month
  5. Year
  6. Yr
  7. Weekday
  8. Newdatetime
  9. Newdate
  10. Adddate
  11. Subdate
  12. Now
  13. Datecomp
  14. Instant
日付のみが必要な場合は［日付］を使用し、結果に日付と時刻の両方を含める必要がある場合は［日時］を使用します。

関数と高度な式

数式項目ではどの関数を使用できますか？
数式項目では、数値計算、テキスト処理、日付と時刻の処理、論理条件、値の変換に使用できる関数が用意されています。

数値関数
  1. Abs
  2. Ceil
  3. Floor
  4. Naturallog
  5. Base10log
  6. Max
  7. Min
  8. Sqrt
テキスト関数
  1. Len
  2. Equals
  3. EqualsIgnoreCase
  4. IsEmpty
  5. Find
  6. Concat
  7. Contains
  8. Startswith
  9. Endswith
  10. Lower
  11. Upper
  12. Trim
  13. Substring
  14. Replace
  15. ReplaceAll
論理関数
  1. If
  2. And
  3. Or
  4. Not
変換関数
  1. Tonumber
  2. Tostring
演算子だけでは目的の結果を得られない場合に関数を使用します。たとえば、条件の評価、テキストの標準化、値の変換、日付の一部の取得などに使用できます。
式エディターに関数を直接入力できますか？
いいえ。関数は、数式エディターの［関数を挿入］から追加する必要があります。

関数を挿入するには、次の手順を実行します。
  1. 数式エディターで、［関数を挿入］を選択します。
  2. 使用可能な関数の一覧から必要な関数を選択します。
  3. 挿入された式で、必要に応じて関数のパラメーターを追加または置き換えます。
  4. 数式項目を保存する前に、［構文を確認］を選択します。
関数選択機能を使用することで、サポートされている関数のみを数式に挿入できます。
条件に基づいて数式から異なる値を返すにはどうすればよいですか？
If、And、Or、Notなどの論理関数を使用します。これらの関数を使用すると、式で条件を評価し、その条件を満たすかどうかに基づいて結果を返すことができます。

たとえば、真偽値の数式では条件に応じてTRUEまたはFALSEを返すことができ、If関数では条件の結果に基づいて適切な値を返すことができます。社内での適格性の確認や、その他のルールに基づく計算に役立ちます。
数式内でテキスト値を比較または標準化できますか？
はい。テキスト関数を使用すると、文字列の比較、テキストの検出、大文字／小文字の変換、前後の空白の削除、テキストの結合や置換ができます。

例：
  1. テキストの完全一致が必要な場合は、Equalsを使用します。
  2. 大文字と小文字を区別せずに比較する場合は、EqualsIgnoreCaseを使用します。
  3. 値の先頭と末尾にある空白を削除するには、Trimを使用します。
  4. 大文字／小文字を統一するには、LowerまたはUpperを使用します。
  5. テキストに必要な値が含まれているかどうかを評価するには、Contains、Startswith、またはEndswithを使用します。
これらの関数は、式の一部としてテキスト項目を評価または正規化する場合に役立ちます。
Info
関連情報：数式項目