演算機能

このページの内容:

演算機能について

演算機能を使用すると、各回答にカスタム値を作成できます。例えば、個別の参加者のスコアリングを使って、式を計算する関数を作成できます。演算機能は、アンケートフロー、質問内、または選択肢テキストで実行できます。

アンケートフロー

アンケートフローで実行される演算機能は、埋め込みデータとして保存する必要があります。方程式の結果は、デフォルトでは回答者に表示されません。方程式の結果を回答者に表示したい場合は、テキストの差し込みを使います。

このアンケートでは、2つの質問に対する回答が合計され、1.33が乗算され、加重満足度と呼ばれる埋め込みデータフィールドとして保存されます。

質問または選択肢テキスト

質問または選択肢テキストで実行された演算機能は回答者に表示されますが、アンケート結果では報告されません。

このアンケートでは、演算機能の結果がアンケート質問のテキストの一部として表示されます。

演算機能の構文

すべての演算機能は、次の構文内に含まれます。

$e{ }

方程式が「{」と「}」の間に挿入されます。方程式のすべての項目はスペースで区切る必要があります。

$e{ 4 + 4 }

右から左に記述する言語の構文

アンケートがヘブライ語やアラビア語など、右から左に記述される言語の場合、演算機能に使用する構文は少し異なります。

{ }#$

例： 4 + 4を追加するには：

{ 4 + 4 }#$

方程式が「{」と「}」の間に挿入されます。方程式のすべての項目はスペースで区切る必要があります。

テキストの差し込みの使用

4 + 4を追加しても良いですが、アンケートで提供される回答に対して演算機能を実行する機能の方が便利です。例えば、ある研究で満足度の質問への回答に固定数を掛けることが求められる場合があります。このような場合にテキストの差し込みを使用します。

テキストの差し込みは、各回答者の動的な数値を取得するために使用されます。方程式に必要な数値を表すテキストの差し込みコードを生成する方法については、「テキストの差し込み」サポートページを参照してください。

テキストの差し込みの形式は以下のとおりです。

${q://QID1/SelectedChoicesRecode}

演算機能でテキストの差し込みを使用するには、「${」と「}」を削除します。その結果、コードは次のようになります。

q://QID1/SelectedChoicesRecode

演算機能に配置すると次のようになります。

$e{ q://QID1/SelectedChoicesRecode * 4 }

3桁ごとの区切りと小数点区切り

演算機能は数値のみをサポートします。
コンピューターサイエンスでは、小数点の区切り記号はピリオド（.）として定義されます。コンマを小数点の区切り記号として使うことはできません。

例： $e{ 1.5 + 1 }は2.5となり、これは正しいです。 $e{ 1,5 + 1 }は1となり、これは正しくありません。

3桁ごとまたは小数点の区切り記号としてコンマ（,）を使用すると演算機能が中断します。 3桁ごとまたは小数点の区切り記号としてコンマ（,）を使用しないようにしてください。

例： 1000桁の数字で計算する場合、たとえば $e{ 1000 + 1 } は1001になりますが、これは正しいです。 $e{ 1,000 + 1 }は1となり、この例では正しくありません。 $e{ 1.000 + 1 }は2となり、これもこの例では正しくありません。

利用可能な演算

加算、減算、乗算、および除算

$e{ 1 + 2 - 3 / 4 * 8 }の解は-3になります。

ヒント： 演算機能の代わりにスコアリング機能を使うと単純な加算を簡単に実行できます。

括弧

括弧を追加して、演算の順序を指定できます。

$e{ ( 1 + 2 - 3 ) / 4 * 8 }の解は0になります。

ヒント： 演算機能は、次の演算の標準的な順序に従います：括弧、指数、乗算、除算、加算、減算。

指数

$e{ 6 ^ 2 }の解は36になります。

平方根

$e{ sqrt( 9 ) }の解は3になります。

代わりに指数を使用しても構いません。たとえば、$e{ 9 ^ ( 1 / 2 ) }を使います。

絶対値

$e{ abs( -23 ) }の解は23になります。

丸め

$e{ round( 10 / 3 , 2 ) }は、小数点以下2桁で10/3を丸め、解は3.33になります。

演算機能のトラブルシューティング

演算機能では、形式が正しくないと評価されない場合があります。数学演算が評価されない場合、以下の2つの一般的なエラーを確認してください。方程式内のHTMLスペースと正しくフォーマットされていないテキストの差し込み。

HTMLスペース

リッチコンテンツエディターで数学の方程式を書くとき、スペースがHTMLに変換され、式が無効になる場合があります。リッチコンテンツエディターの標準ビューでは、次の式は問題ないように見えます。

しかし、テキストエディターのソースビューに切り替えると、スペースの1つがHTMLに変換され、「 」として表示されます。

 とその他のHTMLタグは数式を無効にします。ソースビューからこれらを削除して、方程式を修正します。

誤ってフォーマットされたテキストの差し込み

前述のように、演算機能でテキストの差し込みを使用する場合、テキストの差し込みコードから$と{}を削除する必要があります。たとえば、テキストの差し込みコード${q://QID1/SelectedChoicesRecode}は、数式でq://QID1/SelectedChoicesRecodeとして使用する必要があります。

テキストの差し込みから$と{}が削除されていなくても、多くの演算機能は正常に機能します。ただし、テキストの差し込みに値がない場合（たとえば、テキストの差し込みが参照している質問を回答者がスキップした場合）、および$と{}が削除されていない場合、方程式は失敗します。

テキストの差し込みが空になって式が失敗を防ぐために、すべての方程式から$および{}を削除します。

上記の「演算機能の構文」セクションを参照して、演算機能ですべての構文規則に従っていることを確認してください。