Actions

ExpressionScript - presentation/ja: Difference between revisions

From LimeSurvey Manual

Bravehorse (talk | contribs)
Created page with "しかし、質問内で式と条件の両方を使用する方法があります。上で述べたように、条件式は出現条件式のフィールドを置き換えま..."
m Text replacement - " enclose="div"" to ""
 
(68 intermediate revisions by 3 users not shown)
Line 8: Line 8:




LimeSurveyでは、新しいExpression Manager(EM)モジュールを使用して、より複雑な分岐、評価、検証、およびカスタマイズがサポートされています。LimeSurveyがサーバー内で行う置換、[[Setting conditions/ja|条件]]、[[Assessments/ja|評価]]の管理方法を置き換えることができます。また、ランタイムデータベースの読み込みのほとんどが不要になるため、処理速度が大幅に向上します。EMはDr. Thomas White(TMSWhite)が開発しました。
LimeSurveyでは、新しいExpressionScript(EM)モジュールを使用して、より複雑な分岐、評価、検証、および文言調整がサポートされています。LimeSurveyがサーバー内で行う置換、[[Setting conditions/ja|条件]]、[[Assessments/ja|評価]]の管理方法を置き換えることができます。また、ランタイムデータベースの読み込みのほとんどが不要になるため、処理速度が大幅に向上します。EMはDr. Thomas White(TMSWhite)が開発しました。




Line 33: Line 33:
#*質問コードは数字で始めることはできないので、質問番号を質問コードにするときは、単に"q1"、"q1a"、"g1q2"のようにしてください。
#*質問コードは数字で始めることはできないので、質問番号を質問コードにするときは、単に"q1"、"q1a"、"g1q2"のようにしてください。
#*現在のところ、データをSPSSまたはRにエクスポートすると、これが変数名になります。したがって、統計分析を行う場合は、ユニークにしなければなりません。
#*現在のところ、データをSPSSまたはRにエクスポートすると、これが変数名になります。したがって、統計分析を行う場合は、ユニークにしなければなりません。


==EMを使わなければならないのか?==
==EMを使わなければならないのか?==
Line 58: Line 59:


{| class="wikitable"
{| class="wikitable"
!Style!!Pros!!Cons
!スタイル!!長所!!短所
|-
|-
|Conditions||1. Nice [[Setting conditions|GUI]] for creating simple conditions. <br/>2. GUI well documented and understood by support team||1. Only supports simple comparisons and does not "AND" and "OR" conditions well. <br/>2. Cascading conditions work erratically <br/>3. Slow - database intensive -it can slow down long surveys. <br/>4. Some reported problems with reloading conditions.<br/>5. GUI doesn't scale well when there are dozens, hundreds, or thousands of questions. <br/>6. It could be slow to convert paper-based surveys since it must use [[SGQA identifier|SGQA]] names. <br/>7. Often need a programmer to custom-code logic needed for complex branching.
|条件||1. シンプルな条件を作成するための優れた[[Setting conditions/ja|GUI]]<br/>2. サポートチームにより文書化され理解しやすいGUI||1. 簡単な比較のみをサポートし、"AND"/"OR"条件はうまく機能しない<br/>2. 条件を入れ子にした場合の動作が不安定<br/>3. データベースアクセスが遅く、アンケートに時間がかかる<br/>4. 条件のリロードで不具合がレポートされている<br/>5. GUIに拡張性がなく、何十、何百、または何千もの質問があるときにうまくいかない<br/>6. [[SGQA identifier/ja|SGQA]]名を使用しなければならないので、紙ベースのアンケートを変換するのが遅いかもしれない<br/>7. 複雑な分岐が必要な場合、カスタムコードロジックを書くプログラマーが必要なことがある
|-
|-
|Relevance||1. Supports very complex logic, including 80+ functions and math/string operators. <br/>2. Perfect support for [[Expression_Manager_to_be_updated#Relevance_and_Cascading_Relevance|cascading logic]]. <br/>3. Fast - no extra database calls, supporting 1000+ question surveys. <br/>4. No problems with reloading logic since it does not require [[SGQA identifier|SGQA]] codes. <br/>5. Syntax-highlighting scales to 1000+ question surveys. <br/>6. Easy and fast to use for groups wanting to computerize existing paper-based surveys. <br/>7. It easily supports semi-structured interviews and epidemiological surveys without needing a programmer||1. No GUI for simple conditions - it makes use of [[Expression_Manager_to_be_updated#Syntax_Highlighting|syntax-highlighting]] instead.
|出現条件||1. 80以上の関数と数学/文字列演算子を含む非常に複雑なロジックのサポート<br/>2. [[Expression_Manager_to_be_updated#Relevance_and_Cascading_Relevance|入れ子のロジック]]の完全サポート<br/>3. 高速 - 余計なデータベースアクセスがなく、1000以上の質問があるアンケートをサポート<br/>4. [[SGQA identifier/ja|SGQA]]コードを必要としないため、リロードロジックで問題が生じない<br/>5. 構文ハイライト機能は1000以上の質問があるアンケートにも対応<br/>6. 既存の紙ベースのアンケートの電子化に簡単かつ迅速に対応<br/>7. プログラマーを必要とせずに半構造化インタビューや疫学調査を容易にサポート||1. 単純な条件のためのGUIがない(代わりに[[Expression_Manager_to_be_updated#Syntax_Highlighting|構文ハイライト機能]]を使用)
|}
|}




{{Note| '''Note:'''
{{Note| '''注意:'''
*We recommend you to use whatever fits better your needs.
*ニーズに合ったものを使用することをお勧めします。
*For a more detailed explanation of the EM features, click on the following [[EM and its features|link]].}}
*EM機能の詳細については、[[EM and its features|こちら]]をクリックしてください。}}




Line 74: Line 75:




The best way to get started with the EM is to:
式マネージャーを始める最善の方法は以下のとおりです。
*Install the latest stable version from http://www.limesurvey.org/en/download.
*http://www.limesurvey.org/en/download からLimeSurveyの最新の安定版をインストールしてください。
*Import and explore some [[Expression Manager Sample Surveys|sample surveys]].
*[[ExpressionScript Sample Surveys|サンプルアンケート]]をインポートして確認します。
*Explore the [[Expression Manager HowTos|use cases and HowTos]], and the [[Expression Manager Examples|step-by-step examples]].
*[[ExpressionScript HowTos|使用例と使用法]][[ExpressionScript Examples|ステップバイステップの例]]を読んでください。
*Explore the EM documentation (this page)
*EMに関するドキュメント(このページ)を読んでください。
**Unit Tests of Isolated Expressions (advanced)
**分離された式の単体テスト(上級)
***shows examples of using all EM functions and operators, and the PHP and JavaScript results;
***すべてのEM関数と演算子、PHPとJavaScriptの結果の使用例を表示します。
***note there are few functions that generate different results in the PHP and JavaScript versions, so this page lets you plan your EM logic accordingly.
***PHPとJavaScriptのバージョンで異なる結果を生成する関数はほとんどありません。このページの内容を踏まえ、EMロジックを適切に計画することができます。
 


=用語=
=用語=




These words are commonly used to describe the capabilities of the EM:
これらの単語は、EMの機能を記述するために一般的に使用されます。
 
*'''出現条件に基づく分岐''' - 質問が出現条件を満たす場合は質問し、満たさない場合は質問しません(非表示となり、データベース内ではNULLとして格納されます)。質問エディターパネルと質問グループエディターパネルに[[QS:Relevance/ja|出現条件フィールド]]があります。後者では、各質問に同じ条件をコピーしたり、グループと質問レベルの条件付きロジックを組み合わせたりせずに、一連の条件をグループ全体に適用するために使用されます。
EM "thinks" of its functionality in the following terms:
*'''文言調整''' - どの質問を表示すべきか決めたら、文言調整(''パイピング''とも呼ぶ)でどのように質問するかを指定します。これは簡単な置換(例: {TOKEN:FIRSTNAME})だけでなく、回答者が回答した性別、数に基づいて、動詞や名詞を変化させることもできます。また、アンケート回答者が回答したか(またはどのように回答したか)に基づいて、アンケート回答者に送信するメッセージを変更することもできます。
*'''Relevance-based Branching''' - if a question is relevant, then ask it, otherwise don't (e.g., make it invisible and mark it as NULL in the database). You may find the [[QS:Relevance|Relevance fields]] in the question editor panel as well as in the question group editor panel. The later is used to apply a set of conditions to an entire group without having to copy the same condition to each question, and/or combine group and question-level conditional logic).
*'''''' - EMでは、[[Question type - Equation/ja|]]という新しい質問タイプを追加され、式の結果が格納されます。式はページ内で非表示であっても結果が計算され、データベースに書き込まれます。したがって、非表示のまま行うスコア計算、複雑な式に基づくナビゲーション、評価、データベース内に作成・格納されるレポートに使用されます。
*'''Tailoring''' - Once you know which questions should be asked, tailoring (sometimes called ''piping'') specifies how the question should be asked. This lets you support not only simple substitution (like {TOKEN:FIRSTNAME}), but also conjugation of verbs and declination of nouns based upon the gender or number of your subjects. It also lets you change the message you deliver to a survey respondent based upon whether they answered (or how they answered) other questions.
*'''Equations''' - EM adds a new question type called [[Question type - Equation|Equation]] which stores the result of an Expression. The equation results are computed and written to the database, even if you hide them on the page. Thus, they are used for hidden scoring calculations, navigation based upon complex equations, assessments, and reports that will be generated and stored within the database.




Line 98: Line 96:




Every question type now has a [[QS:Relevance|Relevance option]] which controls whether the question is displayed or not. The EM processes each Relevance Equation in the order they appear in the survey. If the expression is true (or missing - to support legacy surveys), the question will be displayed. If it is not relevant, then the question will be hidden, and the value will be NULLed in the database. If there are no relevant questions in a group, the entire group will be skipped.
すべての質問タイプで、質問が表示されるかどうかを制御する[[QS:Relevance/ja|出現条件オプション]] が追加されました。EMは、アンケートに登場する順に出現条件式を処理します。式が真(または式がない - 古い形式のアンケート向け)の場合、質問が表示されます。出現条件式が偽の場合、質問は非表示になり、その値はデータベースでNULLになります。グループに出現条件を満たす質問がない場合、グループ全体がスキップされます。


さらに、式に含まれる変数のいずれかの出現条件が偽の場合、式は常に偽と評価されます。これにより'''出現条件の入れ子'''が可能になり、各々の質問に対して非常に長い出現条件の式を書く必要がなくなります。
さらに、式に含まれる変数のいずれかの出現条件が偽の場合、式は常に偽と評価されます。これにより'''出現条件の入れ子'''が可能になり、各々の質問に対して非常に長い出現条件の式を書く必要がなくなります。
Line 122: Line 120:




Expression Manager also supports group-level relevance. This makes it easier to implement looping.  Say you want to collect information from up to 10 entities (such as products or people from a household), where you first determine how many entities need follow-up (such as by asking how many people live in a household or having people check which products they like from a long list). After knowing how many entities need follow-up, you can use Group-level relevance like {count >= 1}, {count >=2}, ... {count >= 10} for each of the 10 groups of follow-up questions.  Within each group, you can have question-level conditional logic (e.g. gender or age-specific follow-up questions for each subject). The question and group-level relevance equations are ANDed together to determine which should be shown.
ExpressionScriptはグループレベルの関連性もサポートしています。これにより、ループの実装が容易になります。最大10のエンティティ(製品や家族など)から情報を収集したい場合、(家族の人数を答えさせたり、長いリストから好きな製品を選択させたりして)繰り返しが必要なエンティティの数を最初に判断します。エンティティの数がわかったら、10こある繰り返し用グループごとに{count >= 1}, {count >=2}, ... {count >= 10}のようにグループレベルの出現条件を設定します。各々のグループ内では、質問レベルの条件付きロジック(例:各々のエンティティの性別や年齢に基づく質問)を作成できます。質問とグループレベルの出現条件の式は、表示すべきかを決定するためにAND演算されます。
 
例を確認するには、次のアンケートをインポートします。[[Media:EM survey - Cohabs.zip|国勢調査の例]]
 
以下のスクリーンショットでは、回答者が少なくとももう1人の同居者と一緒に住んでいる場合、グループ''Person 1''が表示されている(出現条件を満たしている)ことがわかります。
 


To check such an example, import the following survey: [[Media:EM survey - Cohabs.zip|Census survey example]].
<center>[[File:Group-level relevance example screen.png]]</center>




==カスタマイズ/パイプ==
==文言調整/パイプ==




Anything within curly braces is now treated as an Expression (with one exception described below). Expressions have access to all the LimeReplacementFields and variables (via several aliases), all typical equation operators (mathematical, logical, and comparison), and to dozens of functions (that even work dynamically on the client-side).
中括弧内のものはすべて式として扱われるようになりました(後述する例外が1つあります)。式はすべてのLimeReplacementFields、すべての変数(いくつかのエイリアスを介して)、すべての一般的な演算子(数学、論理、比較)、数多くの関数(クライアント側でも動的に機能する)にアクセスします。


By Using these equations, you can do things such as:
これらの式を使用すると、次のようなことができます。
#Conditionally show tailored messages to the respondents based on prior responses;
#先行する質問への回答に基づいて文言調整されたメッセージを回答者に表示する
#Create Assessments and show Assessment results (or conditionally branch or show messages) based upon those results, all without using the Assessments module itself;
#評価を作成し、その結果に基づいて評価結果を表示する(条件付きで分岐、またはメッセージを表示する)([[Assessments/ja|評価モジュール]]自体は使用しない)
#Conjugate verbs and decline nouns within questions, answers, and reports;
#質問、回答、およびレポート内の動詞、名詞を変化させる
#Show summaries of responses before the "Show your answers" page at the end of the survey.
#アンケートの最後で、"回答を表示する"ページの前に回答の要約を表示する




Line 142: Line 145:




There is a new question type called [[Question type - Equation|Equation]]. Think of it as a [[Question type - Text display|Text display question type]], except that it stores the value of what is displayed in the database. So, if the Equation Question text contains an Assessment computation, that value would be stored in the database in a variable that can be displayed in public or private statistics.
[[Question type - Equation/ja|]]と呼ばれる新しい質問タイプがあります。これは、表示されている値をデータベースに格納することを除き、[[Question type - Text display/ja|テキスト表示質問タイプ]]と似ています。したがって、式の質問テキストに評価計算が含まれている場合、パブリックまたはプライベート統計情報内に表示できる変数の値がデータベースに格納されます。




Line 148: Line 151:




Anything contained within curly braces is now considered an Expression (with one exception: '''there must be no leading or trailing whitespace''' - this is needed to ensure the Expression Manager does not try to process embedded JavaScript).
中カッコ内に含まれるものはすべて式と見なされます(ただし、先頭または末尾に空白がないことが必要です。これは、式マネージャーが埋め込みJavaScriptを処理しないようにするためです)。


Note that it is OK for expressions to span multiple lines, as long as there is no whitespace after the opening curly brace or before the closing curly brace. This is especially helpful for nested "if()" statements like this:
開く括弧の後、閉じる括弧の前に空白がない限り、式は複数の行にまたがっても構いません。特に次のような入れ子のif()構文が見やすくなります。


<syntaxhighlight lang="java" enclose="div">{if(is_empty(PFTotals),
<syntaxhighlight lang="java">{if(is_empty(PFTotals),
 '',
 '',
 if(PFTotals >= -5 && PFTotals <= -4,
 if(PFTotals >= -5 && PFTotals <= -4,
Line 179: Line 182:
</syntaxhighlight>
</syntaxhighlight>


The Expression Manager supports the following syntax:
式マネージャは、次の構文をサポートしています。
*All standard mathematical operators (e.g. +,-,*,/,!);
*標準的な数学演算子(例: +,-,*,/,!
*All standard comparison operators (e.g. <,<=,==,!=,>,>=, plus their equivalents: lt, le, eq, ne, gt, ge);
*標準的な比較演算子(例: <,<=,==,!=,>,>=, およびこれらと同じ意味を持つlt, le, eq, ne, gt, ge)
*Parentheses (so you can group sub-expressions);
*かっこ(入れ子の式をグループ化できます)
*Conditional operators (e.g. &&,| | and their equivalents: and, or);
*条件演算子(例: &&, | | およびこれらと同じ意味を持つand, or)
*Single and double-quoted strings (which can each embed strings with the other quote type);
*シングルまたはダブルクオートで囲まれた文字列(別のクオート記号で囲まれた文字列を含めることができます)
*Comma operator (so can have a list of expressions and just return the final result);
*コンマ演算子(式のリストを持ち、最終結果を返します)
*Assignment operator (=);
*代入演算子(=
*Pre-defined variables (to refer to questions, question attributes, and responses) - e.g., the [[SGQA identifier|SGQA codes]];
*定義済み変数(質問、質問属性、回答を参照する) - 例: [[SGQA identifier/ja|SGQAコード]]
*Pre-defined functions (there are already 80+, and it is easy to add more).
*定義済み関数(80以上あり、簡単に追加できます)




Line 220: Line 223:
|}
|}


{{Note| For consistency between JavaScript and PHP, the plus operator (+) does addition if both operands are numeric, but does concatenation if both parts are non-numeric strings. However, we recommend using the "join()" function for concatenation, as that makes your intent more clear. It also avoids unexpected results if you were expecting strings but got numbers instead (or vice versa).}}
{{Note| JavaScriptとPHPの間の一貫性を保つために、プラス演算子(+)は両方のオペランドが数値の場合は加算を行いますが、両方の部分が数値以外の文字列の場合は連結します。しかし、意図をもっとはっきりさせるため、連結関数join()を使うことをお勧めします。文字列を期待しているのに数値となったり、その逆となったりすることも防止します。}}
 
====番号と文字列の不一致およびアルファベット/数字の比較に関する注意====
 
次の用語は、EMの機能を記述するためによく使用されます。
 
たとえば、Q0.NAOKが数値質問で値が9である場合、<code>Q0.NAOK > "50"</code>はtrueとなります。これは、演算子<code>></code>が、これを<i>数値</i>の比較ではなく、<i>文字列</i>の比較とみなすためです。


整数値を確実に比較するには、<code>[[Expression_Manager/ja#.E5.AE.9F.E8.A3.85.E6.B8.88.E3.81.BF.E9.96.A2.E6.95.B0|intval]](Q0.NAOK) > 50</code>を使用します。Q0.NAOKが数値でない(空または文字列)場合は、intval(Q0.NAOK) === 0となります。文字列値を比較する("A" < "B")場合は、直接[[Expression_Manager/ja#.E5.AE.9F.E8.A3.85.E6.B8.88.E3.81.BF.E9.96.A2.E6.95.B0|strcmp]]を使用します。<code>strcmp(Q0.NAOK,"B")</code>または<code>strcmp(Q0.NAOK,"A5")</code>


==代入演算子(=)を使用する際の注意 ==
==代入演算子(=)を使用する際の注意 ==




You should avoid using the assignment operators unless absolutely necessary, since they may cause unexpected side-effects. For example, if you change the value of a previous response, the cascading relevance and validation logic between that question and the current question is not re-computed, so you could end up with internally inconsistent data (e.g., questions that stay answered but should have been NULLed, or questions that are skipped but should have been answered). In general, if you want to assign a value to a variable, you should create an Equation question type, and use an expression to set its value. However, there are some rare times that people really need this operator, so we made it available.
代入演算子は、予期しない副作用を引き起こす可能性があるため、どうしても必要な場合を除いて使用しないでください。たとえば、先行する質問の値を変更すると、その質問と現在の質問との間で入れ子となった出現条件と検証ロジックが再計算されないため、内部的に一貫性のないデータになることがあります(たとえば、NULLにすべきなのに回答がある、回答すべきだがスキップされる、等)。一般に、変数に値を割り当てる場合は、式の質問タイプを作成し、その値を設定する式を使用する必要があります。しかし、この演算子がまれに必要となるため用意されています。


この演算子について注意を促すため、構文式の中では赤いフォントで表示されています("=="と混同しないようにするため)。
この演算子について注意を促すため、構文式の中では赤いフォントで表示されています("=="と混同しないようにするため)。
Line 234: Line 244:




===Using Assignment Operator===  
===代入演算子を使用する===  




The main reasons you may want to use the assignment operator are:
代入演算子を使用する主な理由は次のとおりです。
*You need to set the default value via equation for a question that does not accept default values (such as list radio, where the user interface lets you pick one of the answer options, but does not let you enter an equation). However, be careful, as LimeSurvey will not be able to validate that your equation generates one of the allowable answers for that question;
*既定値を設定できない質問の既定値を式を使って設定する必要がある(ユーザーインターフェイスでは回答オプションの1つを選択できるが、式を入力することができないリスト、ラジオなど)。ただし、LimeSurveyは式がその質問に対する許容可能な回答を生成できるかどうかを検証できないため、注意して使用してください。
*You need to forcibly change the response to a previous question based upon a later response;
*後続の回答に基づいて先行する質問への回答を強制的に変更する必要がある
* etc...
* など...




You can use all the expression manager system for this purpose. It's better to use an [[Question_type_-_Equation|Equation]] for this purpose.
{{Alert|title=注意|text= 代入はPHPでのみ行われます。つまり、値はページ内で更新されているのではなく、ユーザーが次のページに移動したときにだけ更新されるということです。したがって、代入演算子が他の式と同じページで使用されている場合は注意してください。}}




Some examples:
この目的のために、式マネージャーシステムを使用することができます。この目的のため、[[Question_type_-_Equation/ja|式]]を使用する方がよいでしょう。
* Set answer to a short text question in lowercase : <code>{QCODE=strtolower(QCODE.NAOK)}</code>;
* Set a default answer to an array question type at start of a survey : <code>{Q1_SQ1=(is_empty(Q1_SQ1.NAOK),"A99",Q1_SQ1.NAOK)}</code>;
* Set a default answer to an array texts question type at start of a survey : <code>{Q1_SQY1_SQX1 = (is_empty(Q1_SQY1_SQX1.NAOK),"Inserted answer", Q1_SQY1_SQX1.NAOK)}</code>;
* Set an answer with condition : <code>{QCODE=if(YesNo="Y","A1","")}</code>.


例:
* 質問への回答を小文字にする: <code>{QCODE=strtolower(QCODE.NAOK)}</code>
* アンケートの開始時に配列質問タイプに既定の回答を設定する: <code>{Q1_SQ1=(is_empty(Q1_SQ1.NAOK),"A99",Q1_SQ1.NAOK)}</code>
* アンケート開始時に配列テキストの質問タイプに対する既定の回答を設定する: <code>{Q1_SQY1_SQX1 = (is_empty(Q1_SQY1_SQX1.NAOK),"Inserted answer", Q1_SQY1_SQX1.NAOK)}</code>
* 条件付きの回答を設定する: <code>{QCODE=if(YesNo="Y","A1","")}</code>


= XSS セキュリティ =
= XSS セキュリティ =




With [[Global_settings#Security|XSS enabled]], some parts of the expression manager system cannot be used:
[[Global_settings/ja#Security|XSSを有効にする]]と、式マネージャーシステムの一部がつかえなくなります。
* starting a HTML tag in expression but ending in another expression;
* 式でHTMLタグを開き、別の式で閉じる
* using a complex expression within a URL.
* URL内で複雑な式を使用する




{{Note| Please note that XSS is enabled by default in any LimeSurvey installation.}}
{{Note| LimeSurveyのインストールではXSSはデフォルトで有効になっています。}}




Examples and workarounds:
例と解決策
* <code>{if( 1 ,"&lt;strong&gt;","")}information{if( 1 ,"&lt;/strong&gt;","")}</code> is broken with XSS security, here you can use <code>{if(1,"<strong&gt;information&lt;/strong&gt;","information")}</code>;
* <code>{if( 1 ,"&lt;strong&gt;","")}information{if( 1 ,"&lt;/strong&gt;","")}</code>はXSSでは正常に動作しないため、次のようにします。<code>{if(1,"<strong&gt;information&lt;/strong&gt;","information")}</code>
* <code>&lt;a href="/script.php?value={if(QCODE == "Y","yes","no")}"&gt;next&lt;/a&gt;</code>, here you can use an equation question because using a complete question code is OK : <code>&lt;a href="/script.php?value={EQUATION.NAOK}"&gt;next&lt;/a&gt;</code>.
* <code>&lt;a href="/script.php?value={if(QCODE == "Y","yes","no")}"&gt;next&lt;/a&gt;</code>は、ここでは式の質問を使います。なぜなら、完全な質問コードがOKだからです。<code>&lt;a href="/script.php?value={EQUATION.NAOK}"&gt;next&lt;/a&gt;</code>




Line 272: Line 283:




Expression Manager provides read-only access to whichever variables you might need. For backwards compatibility, it provides access to the following:
式マネージャーでは、必要な変数に読み取り専用でアクセスできます。互換性のため、次のものにアクセスできます。
*[[Survey_participants|TOKEN:xxx]] - the value of a TOKEN (e.g., TOKEN:FIRSTNAME, TOKEN:ATTRIBUTE_5) (only for '''not''' [[Participant_settings|anonymous survey]]).
*[[Survey_participants/ja|TOKEN:xxx]] - TOKENの値(例: TOKEN:FIRSTNAME, TOKEN:ATTRIBUTE_5)([[Participant_settings/ja|匿名アンケート]]'''でない'''もののみ)
*[[Adding a question#Information_from_previous_answers|INSERTANS:SGQA]] - the display value of an answer (e.g., "Yes") - similar to using {QCODE.shown}.
*[[Questions_-_introduction/ja#Information_from_previous_answers|INSERTANS:SGQA]] - 回答の表示値("はい"など) - {QCODE.shown}と類似
*All [[The_template_editor#Keywords|{XXX} values used by templates]].
*すべての[[Theme_editor/ja#Keywords|テンプレートで使われる{XXX}の値]]
*In question text, you can use {QID} replaced by the question id and {SGQ} replaced by the SGQA of the question.
*質問テキストでは、質問idの代わりに{QID}、質問のSGQAの代わりに{SGQ}を使います。


In addition, Expression Manager lets you refer to variables by the Question Code (the 'title' column in the questions table within the database). This is also the variable label used when you export your data to SPSS, R, or SAS. For example, if you have questions about name, age, and gender, you could call those variables ''name'', ''age'', and ''gender'' instead of ''12345X13X22'', ''12345X13X23'', and  ''12345X13X24''. This makes equations easier for everyone to read and validate the logic, plus making it possible to shuffle questions around without having to keep track of group or question numbers.
さらに、式マネージャーでは、質問コード(データベース内の質問テーブルの'タイトル'列)で変数を参照できます。これは、データをSPSS、R、またはSASにエクスポートするときにも使用される変数ラベルです。たとえば、名前、年齢、性別に関する質問がある場合、''12345X13X22''''12345X13X23’'''12345X13X24''の代わりに、変数''name''''age''''gender''で呼び出すことができます。これにより、誰もが簡単にロジックを理解し検証することができ、グループや質問の数を把握しなくても質問をシャッフルすることができます。


<div class='simplebox'>
<div class='simplebox'>
'''Important:''' It is safer to refer to variables that occur in the preceding pages or questions.
'''重要:''' 先行するページや質問で発生する変数を参照するのが安全です。
</div>
</div>


Line 288: Line 299:


{| class="wikitable"
{| class="wikitable"
!Syntax!!Meaning!!Example!!Example Result
!構文!!意味!!!!例の実行結果
|-
|-
|Qcode||an alias for Qcode.code||{implode(',',name,gender)}||'Tom','M'
|Qcode||Qcode.codeの別名||{implode(',',name,gender)}||'Tom','M'
|-
|-
|Qcode.code||the selected response code for the question if it is relevant (otherwise blank), or the text value if it is not a coded question||{implode(',',name.code,gender.code)}||'Tom','M'
|Qcode.code||質問で選択した回答のコード(出現条件を満たす場合。満たさない場合は空白)、またはコード化されていない質問のテキスト値||{implode(',',name.code,gender.code)}||'Tom','M'
|-
|-
|Qcode.NAOK||same as Qcode - see discussion of NAOK||{gender.NAOK}||'M'
|Qcode.NAOK||Qcodeと同じ - NAOKについての議論を参照||{gender.NAOK}||'M'
|-
|-
|Qcode.value||the assessment value for the question if it is relevant (otherwise blank), or the text value if it is not a coded question||{gender.value}||'1'
|Qcode.value||質問の評価値(出現条件を満たす場合。満たさない場合は空白)、またはコード化されていない質問のテキスト値||{gender.value}||'1'
|-
|-
|Qcode.valueNAOK||same as Qcode.value - see discussion about NAOK||{gender.valueNAOK}||'1'
|Qcode.valueNAOK||Qcode.valueと同じ - NAOKについての議論を参照||{gender.valueNAOK}||'1'
|-
|-
|Qcode.shown||the dispay value for the question||{implode(',',name.shown,gender.shown)}||'Tom','Male'
|Qcode.shown||質問の表示値||{implode(',',name.shown,gender.shown)}||'Tom','Male'
|-
|-
|Qcode.question||the text of the question||{gender.question}||'What is your gender?'
|Qcode.question||質問のテキスト||{gender.question}||'What is your gender?'
|-
|-
|Qcode.mandatory||whether the question is mandatory (Y/N)||{gender.mandatory}||'N'
|Qcode.mandatory||質問が必須かどうか(Y/N)||{gender.mandatory}||'N'
|-
|-
|Qcode.qid||the internal question number (not the sequential number)||{gender.qid}||337
|Qcode.qid||内部で使用する質問番号(順番を示す連続番号ではない)||{gender.qid}||337
|-
|-
|Qcode.type||the question type||{gender.type}||'G'
|Qcode.type||質問タイプ||{gender.type}||'G'
|-
|-
|Qcode.jsName||the correct javascript name for the question, regardless whether declared on or off this page||{gender.jsName}||'java1827X3X337'
|Qcode.jsName||質問の正しいjavascript名(このページで宣言されているかどうかにかかわらず)||{gender.jsName}||'java1827X3X337'
|-
|-
|Qcode.gid||the internal group number (not the sequential number)||{gender.gid}||3
|Qcode.gid||内部で使用するグループ番号(順番を示す連続番号ではない)||{gender.gid}||3
|-
|-
|Qcode.qseq||the sequential number of the question, starting from 0||{gender.qseq}||5
|Qcode.qseq||質問の連続番号(0から始まる)||{gender.qseq}||5
|-
|-
|Qcode.gseq||the sequential number of the group, starting from 0||{gender.gseq}||1
|Qcode.gseq||グループの連続番号(0から始まる)||{gender.gseq}||1
|-
|-
|Qcode.relevanceStatus||whether the question is currently relevant (0 or 1)||{gender.relevanceStatus}||1
|Qcode.relevanceStatus||質問が現在出現条件を満たすかどうか(0または1)||{gender.relevanceStatus}||1
|-
|-
|Qcode.relevance||the question-level relevance equation||{gender.relevance}||'!is_empty(name)'
|Qcode.relevance||質問レベルの出現条件式||{gender.relevance}||'!is_empty(name)'
|-
|-
|Qcode.grelevance||the  group-level relevance equation||{gender.grelevance}||'num_children >= 5'
|Qcode.grelevance||グループレベルの出現条件式||{gender.grelevance}||'num_children >= 5'
|-
|-
|Qcode.sgqa||the SGQA value for this question||{gender.sgqa}||'1827X3X337'
|Qcode.sgqa||この質問のSGQA値||{gender.sgqa}||'1827X3X337'
|}
|}


Line 344: Line 355:




It is recommended to clear your expression of HTML that appears within your expression. If you use the LimeSurvey HTML editor, click on the "Source" button (located in the upper left part of the editor) and delete all the characters that are not related to your expression (e.g., <p>,</br>, and so on).
式の中のHTML表現を消去することをお勧めします。 LimeSurvey HTMLエディターを使用する場合は、エディターの左上にある"ソース"ボタンをクリックして、式に関連しないすべての文字を削除します(例:<p></br> など)。




Line 354: Line 365:
   QuestionCode . '_' . SubQuestionID . '_' . ScaleId
   QuestionCode . '_' . SubQuestionID . '_' . ScaleId


For '''comment''' and '''other''', the corresponding question codes are QuestionCode_comment and QuestionCode_other, respectively.
'''comment''''''other'''の場合、対応する質問コードはそれぞれQuestionCode_comment、QuestionCode_otherです。


{| class="wikitable"
{| class="wikitable"
!Type!!Description!!Code!!SubQs!!Answer Options!!Scales!!Answer Code!!Answer Shown!!Relevance
!種類!!説明!!コード!!サブ質問!!回答オプション!!尺度!!回答コード!!回答表示!!出現条件
|-
|-
|5||5 Point Choice Radio-Buttons||Q1|| ||1-5|| ||{Q1}||{Q1.shown}||{Q1==3}
|5||5点尺度ラジオボタン||Q1|| ||1-5|| ||{Q1}||{Q1.shown}||{Q1==3}
|-
|-
|B||Array (10 Point Choice) Radio-Buttons||Q2||L1-L6||1-10|| ||{Q2_L2}||{Q2_L2.shown}||{Q2_L2==7}
|B||配列(10点選択)ラジオボタン||Q2||L1-L6||1-10|| ||{Q2_L2}||{Q2_L2.shown}||{Q2_L2==7}
|-
|-
|A||Array (5 Point Choice) Radio-Buttons||Q3||1-5||1-5|| ||{Q3_1}||{Q3_1.shown}||{Q3_1>=3}
|A||配列(5点選択)ラジオボタン||Q3||1-5||1-5|| ||{Q3_1}||{Q3_1.shown}||{Q3_1>=3}
|-
|-
|1||Array (Flexible Labels) Dual Scale||Q4||sq1-sq5||0:a1-a3||1:b1-b3||{Q4_sq1_0}||{Q4_sq1_1.shown}||{Q4_sq1_1=='b2'}
|1||配列(フレキシブルラベル)二元尺度||Q4||sq1-sq5||0:a1-a3||1:b1-b3||{Q4_sq1_0}||{Q4_sq1_1.shown}||{Q4_sq1_1=='b2'}
|-
|-
|H||Array (Flexible) - Column Format||Q5||1-5||s,m,t|| ||{Q5_1}||{Q5_1.shown}||{Q5_1=='s'}
|H||配列(フレキシブル) - 列フォーマット||Q5||1-5||s,m,t|| ||{Q5_1}||{Q5_1.shown}||{Q5_1=='s'}
|-
|-
|F||Array (Flexible) - Row Format||Q6||F1-F5||1-5|| ||{Q6_F3}||{Q6_F3.shown}||{Q6_F3==4}
|F||配列(フレキシブル) - 行フォーマット||Q6||F1-F5||1-5|| ||{Q6_F3}||{Q6_F3.shown}||{Q6_F3==4}
|-
|-
|E||Array (Increase/Same/Decrease) Radio-Buttons||Q7||1-7||I,S,D|| ||{Q7_4}||{Q7_4.shown}||{Q7_4=='D'}
|E||配列(増加/同じ/減少)ラジオボタン||Q7||1-7||I,S,D|| ||{Q7_4}||{Q7_4.shown}||{Q7_4=='D'}
|-
|-
|:||Array (Multi Flexi) 1 To 10||Q8||ls1,todo,ls2||min,max,avg|| ||{Q8_ls1_max}||{Q8_ls2_avg.shown}||{Q8_ls2_min==7}
|:||配列(数値)1から10||Q8||ls1,todo,ls2||min,max,avg|| ||{Q8_ls1_max}||{Q8_ls2_avg.shown}||{Q8_ls2_min==7}
|-
|-
|;||Array (Multi Flexi) Text||Q9||hp,st,sw||1st,2nd,3rd|| ||{Q9_hp_3rd}||{Q9_hp_3rd.shown}||{Q9_hp_3rd=='Peter'}
|;||配列(テキスト)||Q9||hp,st,sw||1st,2nd,3rd|| ||{Q9_hp_3rd}||{Q9_hp_3rd.shown}||{Q9_hp_3rd=='Peter'}
|-
|-
|C||Array (Yes/Uncertain/No) Radio-Buttons||Q10||1-5||Y,N,U|| ||{Q10_1}||{Q10_1.shown}||{Q10_3=='Y'}
|C||配列(はい/わからない/いいえ)ラジオボタン||Q10||1-5||Y,N,U|| ||{Q10_1}||{Q10_1.shown}||{Q10_3=='Y'}
|-
|-
|X||Boilerplate Question||Q11|| || || || ||{Q11.shown}||
|X||テキスト表示||Q11|| || || || ||{Q11.shown}||
|-
|-
|D||Date||Q12|| || || ||{Q12}||{Q12.shown}||
|D||日付||Q12|| || || ||{Q12}||{Q12.shown}||
|-
|-
|*||Equation||Q13|| || || ||{Q13}||{Q13.shown}||{Q13>5}
|*||||Q13|| || || ||{Q13}||{Q13.shown}||{Q13>5}
|-
|-
|~124~||File Upload (records number of files uploaded)||Q14|| || || ||{Q14}|| ||{Q14>0}
|~124~||ファイルアップロード(アップロードファイル数を記録)||Q14|| || || ||{Q14}|| ||{Q14>0}
|-
|-
|G||Gender Drop-Down List||Q15|| ||M,F|| ||{Q15}||{Q15.shown}||{Q15=='M'}
|G||性別ドロップダウンリスト||Q15|| ||M,F|| ||{Q15}||{Q15.shown}||{Q15=='M'}
|-
|-
|U||Huge Free Text||Q16|| || || ||{Q16}||{Q16.shown}||{strlen(Q16)>100}
|U||非常に長いテキスト||Q16|| || || ||{Q16}||{Q16.shown}||{strlen(Q16)>100}
|-
|-
|I||Language Question||Q17|| || || ||{Q17}||{Q17.shown}||{Q17=='en'}
|I||言語||Q17|| || || ||{Q17}||{Q17.shown}||{Q17=='en'}
|-
|-
|!||List - Dropdown||Q18|| ||1-5|| ||{Q18}||{Q18.shown}||{Q18==3}
|!||リスト - ドロップダウン||Q18|| ||1-5|| ||{Q18}||{Q18.shown}||{Q18==3}
|-
|-
|L||List Drop-Down/Radio-Button List||Q19|| ||A-Z|| ||{Q19}||{Q19.shown}||{Q19=='X'}
|L||リスト ドロップダウン/ラジオボタンリスト||Q19|| ||A-Z|| ||{Q19}||{Q19.shown}||{Q19=='X'}
|-
|-
|O||List With Comment Drop-Down/Radio-Button List + Textarea||Q20|| ||A-F|| ||{Q20},{Q20comment}||{Q20.shown}||{Q20=='B'}
|O||コメント付きリスト(ドロップダウン/ラジオボタンリスト + テキスト領域)||Q20|| ||A-F|| ||{Q20},{Q20comment}||{Q20.shown}||{Q20=='B'}
|-
|-
|T||Long Free Text||Q21|| || || ||{Q21}||{Q21.shown}||{strstr(Q21,'hello')>0}
|T||長いテキスト||Q21|| || || ||{Q21}||{Q21.shown}||{strstr(Q21,'hello')>0}
|-
|-
|M||Multiple Choice Checkbox||Q22||A-F, other|| || ||{Q22_E}, {Q22_other}||{Q22_E.shown}, {Q22_other.shown}||{Q22_E=='Y'}
|M||複数選択チェックボックス||Q22||A-F, other|| || ||{Q22_E}, {Q22_other}||{Q22_E.shown}, {Q22_other.shown}||{Q22_E=='Y'}
|-
|-
|P||Multiple Choice With Comments Checkbox + Text||Q23||A-F|| || ||{Q23_D}, {Q23_Dcomment}||{Q23_D.shown}||{!is_empty(Q23)}
|P||コメント付き複数選択(チェックボックス + テキスト)||Q23||A-F|| || ||{Q23_D}, {Q23_Dcomment}||{Q23_D.shown}||{!is_empty(Q23)}
|-
|-
|K||Multiple Numerical Question||Q24||self,mom,dad|| || ||{Q24_self}||{Q24_self.shown}||{Q24_self>30}
|K||数値入力(複数)||Q24||self,mom,dad|| || ||{Q24_self}||{Q24_self.shown}||{Q24_self>30}
|-
|-
|Q||Multiple Short Text||Q25||A-F|| || ||{Q25_B}||{Q25_B.shown}||{substr(Q25_B,1,1)=='Q'}
|Q||複数の短いテキスト||Q25||A-F|| || ||{Q25_B}||{Q25_B.shown}||{substr(Q25_B,1,1)=='Q'}
|-
|-
|N||Numerical Question Type||Q26|| || || ||{Q26}||{Q26.shown}||{Q26 > 30}
|N||数値||Q26|| || || ||{Q26}||{Q26.shown}||{Q26 > 30}
|-
|-
|R||Ranking Style||Q27||1-4|| || ||{Q27_1}||{Q27_1.shown}||{Q27_1==3}
|R||順位||Q27||1-4|| || ||{Q27_1}||{Q27_1.shown}||{Q27_1==3}
|-
|-
|S||Short Free Text||Q28|| || || ||{Q28}||{Q28.shown}||{Q28=='mine'}
|S||短いテキスト||Q28|| || || ||{Q28}||{Q28.shown}||{Q28=='mine'}
|-
|-
|Y||Yes/No Radio-Buttons||Q29|| || || ||{Q29}||{Q29.shown}||{Q29=='Y'}
|Y||はい/いいえラジオボタン||Q29|| || || ||{Q29}||{Q29.shown}||{Q29=='Y'}
|}
|}


Line 423: Line 434:


NAOK --> "Not Applicable"(該当なし、NA)は問題ない(OK)
NAOK --> "Not Applicable"(該当なし、NA)は問題ない(OK)


NAOKは、すべてまたは一部の変数が出現条件を満たさないということです。"Not Applicable"(該当なし、NA)は問題ない(OK)。  
NAOKは、すべてまたは一部の変数が出現条件を満たさないということです。"Not Applicable"(該当なし、NA)は問題ない(OK)。  


For example: count(Q1_SQ1,Q1_SQ2,Q1_SQ3,Q1_SQ4) give always an empty string if one subquestion of Q1 is filtered.
: count(Q1_SQ1,Q1_SQ2,Q1_SQ3,Q1_SQ4) は、Q1のサブ質問の一つがフィルターされている場合、常に空文字となります。このような質問で、チェックされたサブ質問の数をカウントするには、count(Q1_SQ1.NAOK,Q1_SQ2.NAOK,Q1_SQ3.NAOK,Q1_SQ4.NAOK)とします。サブ質問が隠されている場合、式マネージャーは空文字を返します。
To count the number of checked subquestion in such question can be count(Q1_SQ1.NAOK,Q1_SQ2.NAOK,Q1_SQ3.NAOK,Q1_SQ4.NAOK). If the subquestion is hidden, the EM returns an empty string.


NAOKがない場合、1つの質問または1つのサブ質問が非表示になっている場合、式マネージャーは常に空の文字列を返します(falseを返すのと同じです)。
NAOKがない場合、1つの質問または1つのサブ質問が非表示になっている場合、式マネージャーは常に空の文字列を返します(falseを返すのと同じです)。
Line 433: Line 444:
.shownは常にNAOKの仕組み(非表示の時は空文字)を使っていますが、回答のコードが必要な場合は、質問コードの後に.NAOKを付加するとよいでしょう。それが必要で、内容を理解している場合は別です。
.shownは常にNAOKの仕組み(非表示の時は空文字)を使っていますが、回答のコードが必要な場合は、質問コードの後に.NAOKを付加するとよいでしょう。それが必要で、内容を理解している場合は別です。


More information is provided in the [[#Overriding_Cascading_Conditions|Overriding Cascading Conditions subsection]].
詳細は、[[#.E5.85.A5.E3.82.8C.E5.AD.90.E6.9D.A1.E4.BB.B6.E3.81.AE.E4.B8.8A.E6.9B.B8.E3.81.8D|入れ子条件の上書きの項]]にあります。




Line 459: Line 470:
#''suffix''は、通常のqcode接尾辞のいずれかです(例: NAOK、value、shown)。
#''suffix''は、通常のqcode接尾辞のいずれかです(例: NAOK、value、shown)。


#''sub-selector'' can be one of the following:
#''サブセレクター''は次のようなものがあります。
*comments - only subquestions that are comments (e.g., [[Question type - Multiple choice with comments|multiple choice with comment]] and [[Question type - List with comment|list with comment]]);
*comments - コメントとなるサブ質問のみ([[Question type - Multiple choice with comments/ja|コメント付き複数選択]][[Question type - List with comment/ja|コメント付きリスト]]など)
*nocomments - only subquestions that are not comments;
*nocomments - コメントのないサブ質問のみ
*sq_X - where X is a row or column identifier.  Only subquestions matching pattern X are selected. Note that search is done on complete code identifier, then sq_X match and include subquestions nX, X, Xn (e.g. if you use sq_1, subquestions a1, 1a, 1, 11 or 001 was included). Put attention at dual scale question type where subquestions code are QCODE_SQCODE_1 and QCODE_SQCODE_1 and to ranking question type where subquestions code are QCODE_1,QCODE_2 ....
*sq_X - Xは行か列の識別子。パターンXと一致するサブ質問のみが選択されます。検索は完全なコード識別子で行われ、sq_XはnX、X、Xnといったサブ質問にマッチしますが(例えば、sq_1を使用する場合はサブ質問a1、1a、1、11または001がマッチします)。 二元スケール質問タイプではサブ質問はQCODE_SQCODE_1とQCODE_SQCODE_1になり、順位付け質問タイプではサブ質問コードがQCODE_1,QCODE_2 ....となります。


'''例:'''
'''例:'''
Line 483: Line 494:
*that.''qname''.''sub-selector''.''suffix''
*that.''qname''.''sub-selector''.''suffix''


''qname'' is the question name without any subquestion extensions. So, let's create a question 'q1', 'q' representing also its ''qname''.
''qname''は、サブ質問拡張がない質問の名前です。質問 'q1'を作成したら、それが''qname''となります。


例:
例:
Line 499: Line 510:
*式に使用される各変数を明示的に命名する場合。
*式に使用される各変数を明示的に命名する場合。
*サブ質問を持たない変数を使用する場合(例:単一回答の質問)。そのような場合に、変数にプレフィックスとして"that"をつけると、予期しない結果が出る危険があります。}}
*サブ質問を持たない変数を使用する場合(例:単一回答の質問)。そのような場合に、変数にプレフィックスとして"that"をつけると、予期しない結果が出る危険があります。}}


=関数へのアクセス=
=関数へのアクセス=
Line 513: Line 523:


{| class="wikitable"
{| class="wikitable"
!Function!!Meaning!!Syntax
!機能!!意味!!構文
|-
|-
|[http://www.php.net/manual/en/function.abs.php abs]||Absolute value||number abs(number)
|[http://www.php.net/manual/en/function.abs.php abs]||絶対値||number abs(数値)
|-
|-
|[http://www.php.net/manual/en/function.acos.php acos]||Arc cosine||number acos(number)
|[http://www.php.net/manual/en/function.acos.php acos]||アークコサイン||number acos(数値)
|-
|-
|[http://www.php.net/manual/en/function.addslashes.php addslashes]||Quote string with slashes||string addslashes(string)
|[http://www.php.net/manual/en/function.addslashes.php addslashes]||文字列をスラッシュで引用||string addslashes(文字列)
|-
|-
|[http://www.php.net/manual/en/function.asin.php asin]||Arc sine||number asin(number)
|[http://www.php.net/manual/en/function.asin.php asin]||アークサイン||number asin(数値)
|-
|-
|[http://www.php.net/manual/en/function.atan.php atan]||Arc tangent||number atan(number)
|[http://www.php.net/manual/en/function.atan.php atan]||アークタンジェント||number atan(数値)
|-
|-
|[http://www.php.net/manual/en/function.atan2.php atan2]||Arc tangent of two variables||number atan2(number, number)
|[http://www.php.net/manual/en/function.atan2.php atan2]||2変数のアークタンジェント||number atan2(number, 数値)
|-
|-
|[http://www.php.net/manual/en/function.ceil.php ceil]||Round fractions up||number ceil(number)
|[http://www.php.net/manual/en/function.ceil.php ceil]||切り上げ||number ceil(数値)
|-
|-
|[http://www.php.net/manual/en/function.checkdate.php checkdate]||Returns true(1) if it is a valid date in gregorian calendar||bool checkdate(month,day,year)
|[http://www.php.net/manual/en/function.checkdate.php checkdate]||グレゴリオ暦で有効な日付であれば真(1)を返す||bool checkdate(,,)
|-
|-
|convert_value||Convert a numerical value using a inputTable and outputTable of numerical values||number convert_value(fValue, iStrict, sTranslateFromList, sTranslateToList)
|convert_value||変換元リストにある数値を対応する変換先リストの数値に変換する||number convert_value(変換する数値, 一致フラグ, 変換元リスト, 変換先リスト)
|-
|-
|[http://www.php.net/manual/en/function.cos.php cos]||Cosine||number cos(number)
|[http://www.php.net/manual/en/function.cos.php cos]||コサイン||number cos(数値)
|-
|-
|count||count the number of answered (non-blank)questions in the list||number count(arg1, arg12, ..., argN)
|count||リスト内で回答された(空白でない)質問の数||number count(arg1, arg12, ..., argN)
|-
|-
|countif||Count the number of answered questions in the list equal the first argument||number countif(matches, arg1, arg2, ... argN)
|countif||回答された質問のうち、比較値と等しいリスト内の回答の数||number countif(比較値, arg1, arg2, ... argN)
|-
|-
|countifop||Count the number of answered questions in the list which pass the criteria (arg op value)||number countifop(op, value, arg1, arg2, ... argN)
|countifop||回答された質問のうち、条件を満たすリスト内の回答の数(回答 演算子 比較値)||number countifop(演算子, 比較値, arg1, arg2, ... argN)
|-
|-
|[http://www.php.net/manual/en/function.date.php date]||Format a local date/time||string date(format <nowiki>[</nowiki>, timestamp=time()])
|[http://www.php.net/manual/en/function.date.php date]||指定した、もしくは現在のローカルの日付/時刻を書式化する||string date(日付書式 <nowiki>[</nowiki>, 指定時刻=time()])
|-
|-
|[http://www.php.net/manual/en/function.exp.php exp]||Calculates the exponent of e||number exp(number)
|[http://www.php.net/manual/en/function.exp.php exp]||eの累乗を計算する||number exp(数値)
|-
|-
|fixnum||Display numbers with comma as radix separator, if needed||string fixnum(number)
|fixnum||必要に応じてカンマで区切られた数字を表示する||string fixnum(数値)
|-
|-
|[http://www.php.net/manual/en/function.floor.php floor]||Round fractions down||number floor(number)
|[http://www.php.net/manual/en/function.floor.php floor]||切り捨て||number floor(数値)
|-
|-
|[http://www.php.net/manual/en/function.gmdate.php gmdate]||Format a GMT date/time||string gmdate(format <nowiki>[</nowiki>, timestamp=time()])
|[http://www.php.net/manual/en/function.gmdate.php gmdate]||指定した、もしくは現在のGMTの日付/時刻を書式化する||string gmdate(日付書式 <nowiki>[</nowiki>, 指定時刻=time()])
|-
|-
|[http://www.php.net/manual/en/function.html-entity-decode.php html_entity_decode]||Convert all HTML entities to their applicable characters (always uses ENT_QUOTES and UTF-8)||string html_entity_decode(string)
|[http://www.php.net/manual/en/function.html-entity-decode.php html_entity_decode]||HTML エンティティを適切な文字に変換する (常にENT_QUOTES、UTF-8を使用)||string html_entity_decode(文字列)
|-
|-
|[http://www.php.net/manual/en/function.htmlentities.php htmlentities]||Convert all applicable characters to HTML entities (always uses ENT_QUOTES and UTF-8)||string htmlentities(string)
|[http://www.php.net/manual/en/function.htmlentities.php htmlentities]||すべての変換可能な文字をHTMLエンティティに変換する(常にENT_QUOTES、UTF-8を使用)||string htmlentities(文字列)
|-
|-
|[http://www.php.net/manual/en/function.htmlspecialchars.php expr_mgr_htmlspecialchars]||Convert special characters to HTML entities (always uses ENT_QUOTES and UTF-8)||string htmlspecialchars(string)
|[http://www.php.net/manual/en/function.htmlspecialchars.php expr_mgr_htmlspecialchars]||特殊文字をHTMLエンティティに変換する(常にENT_QUOTESとUTF-8を使用)||string htmlspecialchars(文字列)
|-
|-
|[http://www.php.net/manual/en/function.htmlspecialchars-decode.php expr_mgr_htmlspecialchars_decode]||Convert special HTML entities back to characters (always uses ENT_QUOTES and UTF-8)||string htmlspecialchars_decode(string)
|[http://www.php.net/manual/en/function.htmlspecialchars-decode.php expr_mgr_htmlspecialchars_decode]||Convert special特殊な HTML エンティティを文字に戻す(常にENT_QUOTESとUTF-8を使用)||string htmlspecialchars_decode(文字列)
|-
|-
|[http://www.php.net/manual/en/function.idate.php idate]||Format a local time/date as integer||string idate(string <nowiki>[</nowiki>, timestamp=time()])
|[http://www.php.net/manual/en/function.idate.php idate]||指定した、もしくは現在のローカルな時刻/日付を整数として整形する||string idate(文字列 <nowiki>[</nowiki>, 指定時刻=time()])
|-
|-
|if||Excel-style if(test,result_if_true,result_if_false)||if(test,result_if_true,result_if_false)
|if||Excelスタイルのif(条件,trueの時の結果,falseの時の結果)||if(条件,trueの時の結果,falseの時の結果)
|-
|-
|[http://www.php.net/manual/en/function.implode.php implode]||Join array elements with a string||string implode(glue,arg1,arg2,...,argN)
|[http://www.php.net/manual/en/function.implode.php implode]||配列要素を文字列により連結する||string implode(区切り文字,arg1,arg2,...,argN)
|-
|-
|[http://www.php.net/manual/en/function.intval.php intval]||Get the integer value of a variable||int intval(number <nowiki>[</nowiki>, base=10])
|[http://www.php.net/manual/en/function.intval.php intval]||変数の整数としての値を取得する||int intval(数値 <nowiki>[</nowiki>, 基数=10])
|-
|-
|[http://www.php.net/manual/en/function.empty.php is_empty]||Determine whether a variable is considered to be empty||bool is_empty(var)
|[http://www.php.net/manual/en/function.empty.php is_empty]||変数が空であるかどうかを検査する||bool is_empty(変数)
|-
|-
|[http://www.php.net/manual/en/function.is-float.php is_float]||Finds whether the type of a variable is float||bool is_float(var)
|[http://www.php.net/manual/en/function.is-float.php is_float]||変数の型が float かどうか調べる||bool is_float(変数)
|-
|-
|[http://www.php.net/manual/en/function.is-int.php is_int]||Find whether the type of a variable is integer||bool is_int(var)
|[http://www.php.net/manual/en/function.is-int.php is_int]||変数が整数型かどうかを検査する||bool is_int(変数)
|-
|-
|[http://www.php.net/manual/en/function.is-nan.php is_nan]||Finds whether a value is not a number||bool is_nan(var)
|[http://www.php.net/manual/en/function.is-nan.php is_nan]||値が数値でないかどうかを判定する||bool is_nan(変数)
|-
|-
|[http://www.php.net/manual/en/function.is-null.php is_null]||Finds whether a variable is NULL||bool is_null(var)
|[http://www.php.net/manual/en/function.is-null.php is_null]||変数が NULL かどうか調べる||bool is_null(変数)
|-
|-
|[http://www.php.net/manual/en/function.is-numeric.php is_numeric]||Finds whether a variable is a number or a numeric string||bool is_numeric(var)
|[http://www.php.net/manual/en/function.is-numeric.php is_numeric]||変数が数字または数値形式の文字列であるかを調べる||bool is_numeric(変数)
|-
|-
|[http://www.php.net/manual/en/function.is-string.php is_string]||Find whether the type of a variable is string||bool is_string(var)
|[http://www.php.net/manual/en/function.is-string.php is_string]||変数の型が文字列かどうかを調べる||bool is_string(変数)
|-
|-
|join{{NewIn|2.0|b=130129}}||Join elements as a new string||join(arg1, arg2, ... argN)
|join{{NewIn|2.0|b=130129}}||要素を新しい文字列として結合する||join(arg1, arg2, ... argN)
|-
|-
|list||Return comma-separated list of non-blank values||string list(arg1, arg2, ... argN)
|list||空白でない値をコンマ区切りリストで返す||string list(arg1, arg2, ... argN)
|-
|-
|[http://www.php.net/manual/en/function.log.php log]|| The logarithm of number to base, if given, or the natural logarithm. ||number log(number,base=e)
|[http://www.php.net/manual/en/function.log.php log]|| 自然対数(底が指定されている場合は底に対する対数)||number log(数値,=e)
|-
|-
|[http://www.php.net/manual/en/function.ltrim.php ltrim]||Strip whitespace (or other characters) from the beginning of a string||string ltrim(string <nowiki>[</nowiki>, charlist])
|[http://www.php.net/manual/en/function.ltrim.php ltrim]||文字列の最初から空白 (もしくはその他の文字) を取り除く||文字列 ltrim(string <nowiki>[</nowiki>, 削除する文字のリスト])
|-
|-
|[http://www.php.net/manual/en/function.max.php max]||Find highest value||number max(arg1, arg2, ... argN)
|[http://www.php.net/manual/en/function.max.php max]||最大値を返す||number max(arg1, arg2, ... argN)
|-
|-
|[http://www.php.net/manual/en/function.min.php min]||Find lowest value||number min(arg1, arg2, ... argN)
|[http://www.php.net/manual/en/function.min.php min]||最小値を返す||number min(arg1, arg2, ... argN)
|-
|-
|[http://www.php.net/manual/en/function.mktime.php mktime]||Get UNIX timestamp for a date (each of the 6 arguments are optional)||number mktime([hour [, minute [, second [, month [, day [, year ]]]]]])
|[http://www.php.net/manual/en/function.mktime.php mktime]||日付を Unix のタイムスタンプとして取得する(引数は省略可)||number mktime([[, [, [, [, [, ]]]]]])
|-
|-
|modulo-function||The modulo function is '''not supported''' yet. You can use the floor() function instead||floor(x/y)==(x/y)
|modulo-function||モジュロ関数はまだ'''サポートされていません'''。代わりにfloor()関数を使用します。||floor(x/y)==(x/y)
|-
|-
|[http://www.php.net/manual/en/function.nl2br.php nl2br]||Inserts HTML line breaks before all newlines in a string||string nl2br(string)
|[http://www.php.net/manual/en/function.nl2br.php nl2br]||改行文字の前にHTMLの改行タグを挿入する||string nl2br(文字列)
|-
|-
|[http://www.php.net/manual/en/function.number-format.php number_format]||Format a number with grouped thousands||string number_format(number)
|[http://www.php.net/manual/en/function.number-format.php number_format]||数字を千位毎にグループ化してフォーマットする||string number_format(数値)
|-
|-
|pi||Get value of pi||number pi()
|pi||円周率||number pi()
|-
|-
|[http://www.php.net/manual/en/function.pow.php pow]||Exponential expression||number pow(base, exp)
|[http://www.php.net/manual/en/function.pow.php pow]||指数表現||number pow(基数, 指数)
|-
|-
|[http://www.php.net/manual/en/function.quoted-printable-decode.php quoted_printable_decode]||Convert a quoted-printable string to an 8 bit string||string quoted_printable_decode(string)
|[http://www.php.net/manual/en/function.quoted-printable-decode.php quoted_printable_decode]||quoted-printable 文字列を 8 ビット文字列に変換する||string quoted_printable_decode(文字列)
|-
|-
|[http://www.php.net/manual/en/function.quoted-printable-encode.php quoted_printable_encode]||Convert a 8 bit string to a quoted-printable string||string quoted_printable_encode(string)
|[http://www.php.net/manual/en/function.quoted-printable-encode.php quoted_printable_encode]||8 ビット文字列を quoted-printable 文字列に変換する||string quoted_printable_encode(文字列)
|-
|-
|[http://www.php.net/manual/en/function.quotemeta.php quotemeta]||Quote meta characters||string quotemeta(string)
|[http://www.php.net/manual/en/function.quotemeta.php quotemeta]||メタ文字をクォートする||string quotemeta(文字列)
|-
|-
|[http://www.php.net/manual/en/function.rand.php rand]||Generate a random integer, see [[Expression Manager Sample Surveys#Randomly Ask One Question Per Group|this example]]||int rand() OR int rand(min, max)
|[http://www.php.net/manual/en/function.rand.php rand]||乱数を生成する([[ExpressionScript Sample Surveys/ja#Randomly Ask One Question Per Group|]]||int rand() OR int rand(最小値, 最大値)
|-
|-
|regexMatch||compare a string to a [[Using regular expressions|regular expression]]||bool regexMatch(pattern,input)
|regexMatch||文字列を[[Using regular expressions/ja|正規表現]]で比較する||bool regexMatch(パターン,文字列)
|-
|-
|[http://www.php.net/manual/en/function.round.php round]||Rounds a number to an optional precision||number round(val <nowiki>[</nowiki>, precision])
|[http://www.php.net/manual/en/function.round.php round]||数値を任意の精度に丸める||number round(<nowiki>[</nowiki>, 丸める桁数])
|-
|-
|[http://www.php.net/manual/en/function.rtrim.php rtrim]||Strip whitespace (or other characters) from the end of a string||string rtrim(string <nowiki>[</nowiki>, charlist])
|[http://www.php.net/manual/en/function.rtrim.php rtrim]||文字列の最後から空白(またはその他の文字)を取り除く||string rtrim(文字列 <nowiki>[</nowiki>, 削除する文字のリスト])
|-
|-
|[http://www.php.net/manual/en/function.sin.php sin]||Sine||number sin(arg)
|[http://www.php.net/manual/en/function.sin.php sin]||サイン||number sin(arg)
|-
|-
|[http://www.php.net/manual/en/function.sprintf.php sprintf]||Return a formatted string||string sprintf(format, arg1, arg2, ... argN)
|[http://www.php.net/manual/en/function.sprintf.php sprintf]||フォーマットされた文字列を返す||string sprintf(フォーマット, arg1, arg2, ... argN)
|-
|-
|[http://www.php.net/manual/en/function.sqrt.php sqrt]||Square root||number sqrt(arg)
|[http://www.php.net/manual/en/function.sqrt.php sqrt]||平方根||number sqrt(arg)
|-
|-
|stddev||Calculate the Sample Standard Deviation for the list of numbers||number stddev(arg1, arg2, ... argN)
|stddev||数値のリストのサンプル標準偏差を計算する||number stddev(arg1, arg2, ... argN)
|-
|-
|[http://www.php.net/manual/en/function.str-pad.php str_pad]||Pad a string to a certain length with another string||string str_pad(input, pad_length <nowiki>[</nowiki>, pad_string])
|[http://www.php.net/manual/en/function.str-pad.php str_pad]||文字列を固定長になるまで他の文字列で埋める||string str_pad(入力文字列, 文字列の長さ  <nowiki>[</nowiki>, 埋める文字列])
|-
|-
|[http://www.php.net/manual/en/function.str-repeat.php str_repeat]||Repeat a string||string str_repeat(input, multiplier)
|[http://www.php.net/manual/en/function.str-repeat.php str_repeat]||文字列を反復する||string str_repeat(入力文字列, 繰り返し回数)
|-
|-
|[http://www.php.net/manual/en/function.str-replace.php str_replace]||Replace all occurrences of the search string with the replacement string||string str_replace(search, replace, subject)
|[http://www.php.net/manual/en/function.str-replace.php str_replace]||検索文字列に一致したすべての文字列を置換する||string str_replace(検索文字列, 置き換える値, 対象の文字列)
|-
|-
|[http://www.php.net/manual/en/function.strcasecmp.php strcasecmp]||Binary safe case-insensitive string comparison||int strcasecmp(str1, str2)
|[http://www.php.net/manual/en/function.strcasecmp.php strcasecmp]||大文字小文字を区別しないバイナリセーフな文字列比較を行う||int strcasecmp(文字列1, 文字列2)
|-
|-
|[http://www.php.net/manual/en/function.strcmp.php strcmp]||Binary safe string comparison||int strcmp(str1, str2)
|[http://www.php.net/manual/en/function.strcmp.php strcmp]||バイナリセーフな文字列比較を行う||int strcmp(文字列1, 文字列2)
|-
|-
|[http://www.php.net/manual/en/function.strip-tags.php strip_tags]||Strip HTML and PHP tags from a string||string strip_tags(str, allowable_tags)
|[http://www.php.net/manual/en/function.strip-tags.php strip_tags]||文字列から HTML および PHP タグを取り除く||string strip_tags(文字列, 取り除かないタグ)
|-
|-
|[http://www.php.net/manual/en/function.stripos.php stripos]||Find position of first occurrence of a case-insensitive unicode string (starting by 0, return false if not found)|||int stripos(haystack, needle <nowiki>[</nowiki>, offset=0])
|[http://www.php.net/manual/en/function.stripos.php stripos]||大文字小文字を区別せずに文字列が最初に現れる位置を探す(0から始まり、現れなければfalse)|||int stripos(対象文字列, 検索文字列 <nowiki>[</nowiki>, 検索開始位置=0])
|-
|-
|[http://www.php.net/manual/en/function.stripslashes.php stripslashes]||Un-quotes a quoted string||string stripslashes(string)
|[http://www.php.net/manual/en/function.stripslashes.php stripslashes]||クォートされた文字列のクォート部分を取り除く||string stripslashes(文字列)
|-
|-
|[http://www.php.net/manual/en/function.stristr.php stristr]||Case-insensitive strstr||string stristr(haystack, needle <nowiki>[</nowiki>, before_needle=false])
|[http://www.php.net/manual/en/function.stristr.php stristr]||大文字小文字を区別しないstrstr||string stristr(対象文字列, 検索文字列 <nowiki>[</nowiki>, 検索文字列の前まで=false])
|-
|-
|[http://www.php.net/manual/en/function.strlen.php strlen]||Get string length||int strlen(string)
|[http://www.php.net/manual/en/function.strlen.php strlen]||文字列の長さを得る||int strlen(文字列)
|-
|-
|[http://www.php.net/manual/en/function.strpos.php strpos]||Find position of first occurrence of an unicode string (starting by 0, return false if not found)||int strpos(haystack, needle <nowiki>[</nowiki> offset=0])
|[http://www.php.net/manual/en/function.strpos.php strpos]||文字列内の部分文字列が最初に現れる場所を見つける(0から始まり、現れなければfalse)||int strpos(対象文字列, 検索文字列 <nowiki>[</nowiki> 検索開始位置=0])
|-
|-
|[http://www.php.net/manual/en/function.strrev.php strrev]||Reverse a string||string strrev(string)
|[http://www.php.net/manual/en/function.strrev.php strrev]||文字列を逆順にする||string strrev(文字列)
|-
|-
|[http://www.php.net/manual/en/function.strstr.php strstr]||Find first occurrence of a string||string strstr(haystack, needle<nowiki>[</nowiki>, before_needle=false])
|[http://www.php.net/manual/en/function.strstr.php strstr]||文字列が最初に現れる位置を見つける||string strstr(対象文字列, 検索文字列<nowiki>[</nowiki>, 検索文字列の前まで=false])
|-
|-
|[http://www.php.net/manual/en/function.strtolower.php strtolower]||Make a string lowercase||string strtolower(string)
|[http://www.php.net/manual/en/function.strtolower.php strtolower]||文字列を小文字にする||string strtolower(文字列)
|-
|-
|[http://www.php.net/manual/en/function.strtotime.php strtotime]||Parse about any English textual datetime description into a Unix timestamp||int strtotime(string)
|[http://www.php.net/manual/en/function.strtotime.php strtotime]||P英文形式の日付をUnixタイムスタンプに変換する||int strtotime(文字列)
|-
|-
|[http://www.php.net/manual/en/function.strtoupper.php strtoupper]||Make a string uppercase||string strtoupper(string)
|[http://www.php.net/manual/en/function.strtoupper.php strtoupper]||文字列を大文字にする||string strtoupper(文字列)
|-
|-
|[http://www.php.net/manual/en/function.substr.php substr]||Return part of an unicode string||string substr(string, start <nowiki>[</nowiki>, length])
|[http://www.php.net/manual/en/function.substr.php substr]||unicode文字列の一部分を返す||string substr(文字列, 開始位置 <nowiki>[</nowiki>, 長さ])
|-
|-
|sum||Calculate the sum of values in an array||number sum(arg1, arg2, ... argN)
|sum||配列中の値の合計||number sum(arg1, arg2, ... argN)
|-
|-
|sumifop||Sum the values of answered questions in the list which pass the criteria (arg op value)||number sumifop(op, value, arg1, arg2, ... argN)
|sumifop||回答された質問のうち、条件を満たすリスト内の回答の合計(回答 演算子 比較値)||number sumifop(演算子, , arg1, arg2, ... argN)
|-
|-
|[http://www.php.net/manual/en/function.tan.php tan]||Tangent||number tan(arg)
|[http://www.php.net/manual/en/function.tan.php tan]||タンジェント||number tan(arg)
|-
|-
|[http://www.php.net/manual/en/function.time.php time]||Return current UNIX timestamp||number time()
|[http://www.php.net/manual/en/function.time.php time]||現在の Unix タイムスタンプを返す||number time()
|-
|-
|[http://www.php.net/manual/en/function.trim.php trim]||Strip whitespace (or other characters) from the beginning and end of a string||string trim(string <nowiki>[</nowiki>, charlist])
|[http://www.php.net/manual/en/function.trim.php trim]||文字列の先頭および最後から空白(またはその他の文字)を取り除く||string trim(文字列 <nowiki>[</nowiki>, 削除する文字のリスト])
|-
|-
|[http://www.php.net/manual/en/function.ucwords.php ucwords]||Uppercase the first character of each word in a string||string ucwords(string)
|[http://www.php.net/manual/en/function.ucwords.php ucwords]||文字列の各単語の最初の文字を大文字にする||string ucwords(文字列)
|-
|-
|unique||Returns true if all non-empty responses are unique||boolean unique(arg1, ..., argN)
|unique||空白以外の回答のすべてが一意である場合にtrueを返す||boolean unique(arg1, ..., argN)
|}
|}




{{Note| Click [[Functions that are Planned or Being Considered|here]] if you wish to find out more about planned (or being constrained) functions.}}
{{Note|計画されている(または検討中の)関数の詳細を知りたい場合は、[[Functions that are Planned or Being Considered/ja|ここ]]をクリックしてください。}}
 


=式マネージャーとローカル変数=
=式マネージャーとローカル変数=
Line 693: Line 702:


{| class="wikitable"
{| class="wikitable"
!Operator!!Example!!a!!b!!Result
!演算子!!!!a!!b!!結果
|-
|-
|<nowiki>+ (unary)</nowiki>||<nowiki>+a</nowiki>||N/A|| ||false
|<nowiki>+ (単項演算子)</nowiki>||<nowiki>+a</nowiki>||N/A|| ||false
|-
|-
|- (unary)||-a||N/A|| ||false
|<nowiki>- (単項演算子)</nowiki>||<nowiki>-a</nowiki>||N/A|| ||false
|-
|-
|!||!a||N/A|| ||false
|!||!a||N/A|| ||false
|-
|-
|== (or eq)||a == b||N/A||5||false
|== (またはeq)||a == b||N/A||5||false
|-
|-
|== (or eq)||a == b||N/A||0||false
|== (またはeq)||a == b||N/A||0||false
|-
|-
|== (or eq)||a == b||N/A||N/A||false
|== (またはeq)||a == b||N/A||N/A||false
|-
|-
|!= (or ne)||a != b||N/A||5|| false
|!= (またはne)||a != b||N/A||5|| false
|-
|-
|!= (or ne)||a != b||N/A||N/A|| false
|!= (またはne)||a != b||N/A||N/A|| false
|-
|-
|!= (or ne)||a != b||N/A||0||false
|!= (またはne)||a != b||N/A||0||false
|-
|-
|> (or gt)||a > b||N/A||5|| false
|> (またはgt)||a > b||N/A||5|| false
|-
|-
|>= (or ge)||a >= b||N/A||5||false
|>= (またはge)||a >= b||N/A||5||false
|-
|-
|< (or lt)||a < b||N/A||5||false
|< (またはlt)||a < b||N/A||5||false
|-
|-
|<= (or le)||a <= b||N/A||5||false
|<= (またはle)||a <= b||N/A||5||false
|-
|-
|and||a and b||N/A||5||false
|and||a and b||N/A||5||false
Line 739: Line 748:
|()||(a)||N/A|| ||false
|()||(a)||N/A|| ||false
|-
|-
|(exp)||(a && b)||N/A||5||false
|()||(a && b)||N/A||5||false
|-
|-
|(exp) op (exp)||(b + b) > (a && b)||N/A||5||false
|() 演算子 ()||(b + b) > (a && b)||N/A||5||false
|-
|-
|function||sum(a,b,b)||N/A||5||false
|関数||sum(a,b,b)||N/A||5||false
|-
|-
|function||max(a,b)||N/A||5||false
|関数||max(a,b)||N/A||5||false
|-
|-
|function||min(a,b)||N/A||5||false
|関数||min(a,b)||N/A||5||false
|-
|-
|function||implode(', ',a,b,a,b)||N/A||5||false
|関数||implode(', ',a,b,a,b)||N/A||5||false
|-
|-
|function||if(a,a,b)||N/A||5||false
|関数||if(a,a,b)||N/A||5||false
|-
|-
|function||is_empty(a)||N/A|| ||false
|関数||is_empty(a)||N/A|| ||false
|-
|-
|function||is_empty(a)||0 (or blank)|| ||true
|関数||is_empty(a)||0 (or blank)|| ||true
|-
|-
|function||!is_empty(a)||N/A|| ||false
|関数||!is_empty(a)||N/A|| ||false
|}
|}


Line 766: Line 775:
出現条件を満たした回答の合計を表示したいとします。式 {sum(q1,q2,q3,...,qN)}を使おうとするでしょう。しかし、これは内部的にLEMif(LEManyNA("q1","q2","q3",...,"qN"),"",sum(LEMval("q1"),LEMval("q2"),LEMval("q3"),...,LEMval("qN")))に変換されます。これにより、値q1〜qNのいずれかが出現条件を満たさない場合、式は常にfalseを返します。この場合、sum()はすべての質問が出現して回答されない限り"0"となります。
出現条件を満たした回答の合計を表示したいとします。式 {sum(q1,q2,q3,...,qN)}を使おうとするでしょう。しかし、これは内部的にLEMif(LEManyNA("q1","q2","q3",...,"qN"),"",sum(LEMval("q1"),LEMval("q2"),LEMval("q3"),...,LEMval("qN")))に変換されます。これにより、値q1〜qNのいずれかが出現条件を満たさない場合、式は常にfalseを返します。この場合、sum()はすべての質問が出現して回答されない限り"0"となります。


To get around this, each variable can have a ".NAOK" suffix (meaning that Not Applicable is OK) added to it. In such cases, the following behavior occurs. Say you have a variable q1.NAOK:
この問題を回避するために、各変数には".NAOK"という接尾辞(「Not Applicable」はOK)を追加することができます。このような場合、次のような現象が発生します。変数q1.NAOKがあるとします。
#q1 is not added to the LEManyNA() clause
#q1はLEManyNA()節には追加されません
#LEMval('q1') will continue to check whether the response is relevant and will return <nowiki>""</nowiki> if it is not (so individual irrelevant responses will be ignored, but they will not void the entire expression).
#LEMval('q1')は回答が出現条件を満たしているかを確認し、そうでない場合は<nowiki>""</nowiki>を返します(出現条件を満たさない回答は無視されますが、式全体を無効にしません)。


したがって、合計を求める方法は、次の式となります。'''sum(q1.NAOK,q2.NAOK,q3.NAOK,...,qN.NAOK)'''
したがって、合計を求める方法は、次の式となります。'''sum(q1.NAOK,q2.NAOK,q3.NAOK,...,qN.NAOK)'''


The use of the .NAOK suffix also lets authors design surveys that have several possible paths but then converge on common paths later. For example, say subjects answer a survey in a way that is outside the normal range of responses. The author could alert the subjects that they may not get valid results, and ask them whether they really want to continue with the survey. If they say "Yes", then the rest of the questions will be shown. The condition for the "rest of the questions" would check whether the initial responses were answered within the normal range OR whether the subject said "Yes" to the question that is only relevant if they answered outside the normal range.
.NAOK接尾辞を使用することで、いくつかの可能な経路を経て、後に共通の経路に収束するアンケートを設計することができます。例えば、回答者が通常の範囲から外れた回答をしたとします。アンケート実施者は、有効な結果を得られない可能性があることを回答者に警告し、アンケートを継続するかどうかを尋ねることができます。彼らが"はい"と答えると、残りの質問が表示されます。 "残りの質問"の条件は、回答が正常範囲内で回答されたか、または正常範囲外で回答した場合にのみ表示される質問に対して"はい"と回答したかどうかをチェックします。


=式マネージャーはどのように条件付き文言調整を実現するか?=
=式マネージャーはどのように条件付き文言調整を実現するか?=
Line 781: Line 790:


{| class="wikitable"
{| class="wikitable"
!Question Code!!Relevance!!Question Type!!Question
!質問コード!!出現条件!!質問タイプ!!質問
|-
|-
|name||1||text||What is your name?
|name||1||text||名前は何ですか。
|-
|-
|age||1||text||How old are you?
|age||1||text||何歳ですか。
|-
|-
|badage||!is_empty(age)||expr||{(age<16) or (age>80)}
|badage||!is_empty(age)||expr||{(age<16) or (age>80)}
|-
|-
|agestop||badage||message||Sorry, {name}, you are too {if( (age<16),'young',if( (age>80),'old','middle-aged') ) } for this test.
|agestop||badage||message||すみません、{name}さん。あなたは{if( (age<16),'若い',if( (age>80),'高齢','中間の年齢') ) }です。
|-
|-
|kids||!badage||yesno||Do you have children?
|kids||!badage||yesno||子供はいますか。
|-
|-
|parents||1||expr||{!badage && kids=='Y'}
|parents||1||expr||{!badage && kids=='Y'}
|-
|-
|numKids||parents||text||How many children do you have?
|numKids||parents||text||子供は何人いますか。
|-
|-
|kid1||parents && numKids >= 1||text||How old is your first child?
|kid1||parents && numKids >= 1||text||一人目の子供は何歳ですか。
|-
|-
|kid2||parents && numKids >= 2||text||How old is your second child?
|kid2||parents && numKids >= 2||text||二人目の子供は何歳ですか。
|-
|-
|kid3||parents && numKids >= 3||text||How old is your third child?
|kid3||parents && numKids >= 3||text||三人目の子供は何歳ですか。
|-
|-
|kid4||parents && numKids >= 4||text||How old is your fourth child?
|kid4||parents && numKids >= 4||text||四人目の子供は何歳ですか。
|-
|-
|kid5||parents && numKids >= 5||text||How old is your fifth child?
|kid5||parents && numKids >= 5||text||五人目の子供は何歳ですか。
|-
|-
|sumage||1||expr||{sum(kid1.NAOK,kid2.NAOK,kid3.NAOK,kid4.NAOK,kid5.NAOK)}
|sumage||1||expr||{sum(kid1.NAOK,kid2.NAOK,kid3.NAOK,kid4.NAOK,kid5.NAOK)}
|-
|-
|report||parents||text||{name}, you said you are {age} and that you have {numKids}.  The sum of ages of your first {min(numKids,5)} kids is {sumage}
|report||parents||text||{name}さん、あなたの年齢は{age}歳で、{numKids}人の子供がいます。上から{min(numKids,5)}人の子供の年齢の合計は{sumage}です。
|}
|}




To download the above survey example, click on the following link: [[Media:No_of_kids_-_Micro_Tailoring.zip|Number of kids survey example]].
このアンケート例をダウンロードするには、次のリンクをクリックしてください。[[Media:No_of_kids_-_Micro_Tailoring.zip|子供の数のアンケート例]]


これらの質問はすべて1つのページ(たとえば同じグループ)に入れることができ、出現条件に合致する質問のみが表示されます。さらに、子供の年齢を入力すると、最後の質問のsum()式がページ上で動的に更新されます。
これらの質問はすべて1つのページ(たとえば同じグループ)に入れることができ、出現条件に合致する質問のみが表示されます。さらに、子供の年齢を入力すると、最後の質問のsum()式がページ上で動的に更新されます。


式マネージャーは、各式を名前付き<nowiki><span></nowiki>要素で囲むことでこの機能を提供します。値が変更されるたびに、その<nowiki><span></nowiki>要素に表示される式を再計算し、再表示します。そのようなカスタマイズされた式が同じページに数十、または数百もあっても、ページは一度の画面更新ですべて再表示されます。


式マネージャーは、各式を名前付き<nowiki><span></nowiki>要素で囲むことでこの機能を提供します。値が変更されるたびに、その<nowiki><span></nowiki>要素に表示される式を再計算し、再表示します。そのようなカスタマイズされた式が同じページに数十、または数百もあっても、ページは一度の画面更新ですべて再表示されます。


=構文ハイライト=
=構文ハイライト=
Line 829: Line 838:


{| class="wikitable"
{| class="wikitable"
!Color!!Sample!!Meaning!!Tooltip!!Comments
!!!!!意味!!ツールチップ!!コメント
|-
|-
|tan background||style='background-color: #eee8aa'|Sample||the whole equation||none||Anything within curly braces that is recognized as an equation (e.g., there is no leading or trailing whitepace) will be color-coded with a tan background to help distinguish it from surrounding text
|黄褐色の背景||style='background-color: #eee8aa'|||式全体||なし||式として認識される中括弧内のもの(先頭または末尾に空白がない)は、周囲のテキストと区別するために黄褐色の背景で色分けされます。
|-
|-
|bold red text||style='color:#ff0000; background-color:#eee8aa'|'''Sample'''||An error||Some explanation on error||Can be an unknow variable or an error in function. Survey is broken and the questions that rely on the respective expression will not be shown to the respondents.
|太字の赤色テキスト||style='color:#ff0000; background-color:#eee8aa'|''''''||エラー||エラーに関する説明||不明な変数または関数のエラーである可能性があります。アンケートは正常に動作せず、式に依存する質問は回答者には表示されません。
|-
|-
|blue text||style='color:#0000ff; background-color:#eee8aa'|Sample||function name||meaning and allowable syntax||It refers to function names or things that should be functions since they are followed by an open parenthesis. They are displayed in bold blue text. Tooltips show the meaning and allowable syntax for the function.
|青色のテキスト||style='color:#0000ff; background-color:#eee8aa'|||関数名||意味と許容される構文||これは、関数の名前、または関数と思われるもの(開く括弧が続くため)を示します。太字の青いテキストで表示されます。ツールチップには、その関数の意味と許容される構文が表示されます。
|-
|-
|grey text||style='color:#808080; background-color:#eee8aa'|Sample||string||none||Single and double-quoted strings are shown in grey text.
|灰色のテキスト||style='color:#808080; background-color:#eee8aa'|||文字列||なし||一重引用符と二重引用符で囲まれた文字列は灰色のテキストで表示されます。
|-
|-
|cyan text||style='color:#4169e1; background-color:#eee8aa'|Sample||variable set on the same page,||<nowiki>[</nowiki>name or SGQA code]: question; value; answerList showing codes for each value||Any variable that is set on the same page as the question you are currently editing is shown in cyan text (it can be updated in javascript). The tooltip shows its name (if you used INSERTANS:xxx) or its SGQA code (if you used the new naming system), the actual question, and its current value (or blank if not set). If the question type expects responses from an enumerated value set, the mapping of the codes to display values is shown.
|水色のテキスト||style='color:#4169e1; background-color:#eee8aa'|||同一ページでセットされた変数||<nowiki>[</nowiki>名前またはSGQAコード]: 質問; ; それぞれの値に対するコードを示すanswerList||現在編集している質問と同じページで設定された変数は水色のテキストで表示されます(javascriptで更新できます)。ツールチップには、名前(INSERTANS:xxxを使用した場合)またはそのSGQAコード(新しい命名システムを使用した場合)、実際の質問、および現在の値(設定されていない場合は空白)が表示されます。列挙された値セットからの選択を期待する質問タイプの場合、コードの表示値へのマッピングが示されます。
|-
|-
|green text||style='color:#008000; background-color:#eee8aa'|Sample||variable set on a prior page||<nowiki>[</nowiki>name or SGQA code]: question; value; answerList showing codes for each value||Any variable that is set on a prior page is shown in bold green text. The tooltip shows its name (if you used INSERTANS:xxx) or SGQA code (if you used the new naming system), the actual question, and its current value (or blank if not set).  If the question type expects responses from an enumerated value set, the mapping of the codes to display values is shown.
|緑色のテキスト||style='color:#008000; background-color:#eee8aa'|||先行するページでセットされた変数||<nowiki>[</nowiki>名前またはSGQAコード]: 質問; ; それぞれの値に対するコードを示すanswerList||先行するページで設定された変数は太字の緑色のテキストで表示されます。ツールチップには、名前(INSERTANS:xxxを使用した場合)またはそのSGQAコード(新しい命名システムを使用した場合)、実際の質問、および現在の値(設定されていない場合は空白)が表示されます。列挙された値セットからの選択を期待する質問タイプの場合、コードの表示値へのマッピングが示されます。
|-
|-
|bold pink text||style='color:#9370db; background-color:#eee8aa'|Sample||variable set on a later page <sup>in general : empty at survey start, but can be filled with index or move previous</sup>||<nowiki>[</nowiki>name or SGQA code]: question; value; answerList showing codes for each value||Any variable that is set on a prior page is shown in bold pink text. The tooltip shows its name (if you used INSERTANS:xxx) or SGQA code (if you used the new naming system), the actual question, and its current value (or blank if not set). If the question type expects responses from an enumerated value set, the mapping of the codes to display values is show.
|太字のピンク色のテキスト||style='color:#9370db; background-color:#eee8aa'|||後続のページでセットされる変数<sup>通常、アンケート開始時は空ですが、質問番号にしたり、前に戻ることができます。</sup>||<nowiki>[</nowiki>名前またはSGQAコード]: 質問; ; それぞれの値に対するコードを示すanswerList||後続のページで設定される変数は太字のピンク色のテキストで表示されます。ツールチップには、名前(INSERTANS:xxxを使用した場合)またはそのSGQAコード(新しい命名システムを使用した場合)、実際の質問、および現在の値(設定されていない場合は空白)が表示されます。列挙された値セットからの選択を期待する質問タイプの場合、コードの表示値へのマッピングが示されます。
|-
|-
|bold tan text||style='color:#a0522d; background-color:#eee8aa'|Sample||a lime replacement value||the value||Lime Replacement Strings (like {TOKEN:xxx}, {PRIVACY_MESSAGE}) are shown in bold tan text.  
|太字の黄褐色のテキスト||style='color:#a0522d; background-color:#eee8aa'|||LimeSurveyの置換値||||LimeSurveyの置換文字列({TOKEN:xxx}{PRIVACY_MESSAGE}など)は、太字の黄褐色のテキストで表示されます。  
|-
|-
|red text||style='color:#ff4500; background-color:#eee8aa'|Sample||assignment operator (=) ||warning message||If you use one of the assignment operator (=), that operator will be displayed in red text. This is meant to help prevent accidental re-assignment of values when you really meant to check whether a == b instead of  setting the value of a = b.
|赤色のテキスト||style='color:#ff4500; background-color:#eee8aa'|||代入演算子(=||警告メッセージ||代入演算子(=)を使用している場合、演算子は赤色のテキストで表示されます。aにbを代入するのではなく、aとbが等しいかをチェックしようとする場合に誤って代入することのないようにするためのものです。
|-
|-
|normal black text||style='color:black; background-color:#eee8aa'|Sample||punctuation||none||All other punctuation signs within the expression are shown as normal black text.
|通常の黒色のテキスト||style='color:black; background-color:#eee8aa'|||その他の記号||なし||式の中のその他の記号は通常の黒色のテキストで表示されます。
|-
|-
|red-boxed text||a bold red line surrounds the error||syntax error||description of the error||Any detected syntax errors are shown within red boxes. The tooltip shows the error. Examples include unmatched parentheses, use of undefined functions, passing the wrong number of arguments to functions, poorly structured expressions (e.g., missing operators between variables), trying to assign a new value to a read-only variable, trying to assign values to non-variables, or using unsupported syntax. Note that the syntax error dectection system may only report one error in an expression even if there are multiple errors; however, if any errors are detected, at least one error will be shown.
|赤枠で囲まれたテキスト||太い赤枠で囲まれたエラー||構文エラー||エラーの説明||構文エラーは赤色のボックス内に示されています。ツールチップは、エラーを示します。例としては、括弧の不一致、未定義関数の使用、関数に渡す引数の数の誤り、不完全に構造化された式(変数の間の演算子欠落など)、読み取り専用の変数への値の代入、非変数への値の代入、またはサポートされていない構文の使用などです。構文エラー検知システムは、複数のエラーがある場合でも、式の中のエラーを1つだけ報告します。
|}
|}




{{Note| By tooltips, we refer to the popup message that is displayed when you hover over certain functions and variables.}}
{{Note|ツールチップとは、特定の関数や変数にカーソルを置いたときに表示されるポップアップメッセージのことです。}}
 


=参考記事=
=参考記事=




==[[Expression Manager Sample Surveys/ja|式マネージャーのサンプル]]==
==[[ExpressionScript Sample Surveys/ja|式マネージャーのサンプル]]==




==[[Expression Manager HowTos/ja|ユースケースとHowTo]]==
==[[ExpressionScript HowTos/ja|ユースケースとHowTo]]==




==[[Expression Manager Examples/ja|ステップバイステップの例]]==
==[[ExpressionScript Examples/ja|ステップバイステップの例]]==




==[[Expression Manager for developers/ja|開発者向け参考情報]]==
==[[ExpressionScript for developers/ja|開発者向け参考情報]]==




==[[Expression Manager Roadmap/ja|ロードマップ/状況/ToDoリスト]]==
==[[ExpressionScript Roadmap/ja|ロードマップ/状況/ToDoリスト]]==

Latest revision as of 13:58, 16 February 2022



はじめに

LimeSurveyでは、新しいExpressionScript(EM)モジュールを使用して、より複雑な分岐、評価、検証、および文言調整がサポートされています。LimeSurveyがサーバー内で行う置換、条件評価の管理方法を置き換えることができます。また、ランタイムデータベースの読み込みのほとんどが不要になるため、処理速度が大幅に向上します。EMはDr. Thomas White(TMSWhite)が開発しました。


主な定義

  1. :  中括弧で囲まれたもの
    • 開く中括弧の直後または閉じる中括弧の直前に空白がない
    • 式の内容はEMが評価するため、数式、関数、複雑な文字列と日付処理を含めることができます。
  2. 文言調整: "パイピング"とも呼ばれますが、これは条件付きでテキストを変更するプロセスです。
    • すべての'置換フィールド'、参加者データ、回答データにアクセスできます。
    • 質問、回答、およびそのプロパティにも簡単にアクセスできます。
  3. 出現条件式:  質問を表示するかを制御する新しい質問属性
    • 出現条件式がある場合、その出現条件が真と評価された場合にのみ質問が表示されます。
    • 内部では、すべてのarray_filterコマンドとarray_filter_excludeコマンドがサブ質問レベルの出現条件になります。
  4. SGQA:  LimeSurvey <= 1.91+で変数の命名に使われているものです。
    • Survey(アンケート)-Group(グループ)-Question(質問)-Answer(回答)の略です。
    • SGQA変数は123X5X382X971のようなもので、サブ質問の接尾辞がつくことがあります。
    • これらの変数はベースとなるS/Q/G/Aデータベースコードに固有のもので、変更する必要があることが良くあります。
  5. 質問タイプ:  データベースに計算やレポートを保存する新しい質問タイプ
    • これはテキストを表示する質問のようなものですが、"この質問をいつも隠す"を設定しても、その内容はデータベースに保存されます。
  6. 質問コード:  EMでの使用が推奨される変数名
    • これは質問の目的を示すわかりやすい名前にすることができ、複雑なロジックを読みやすくなります。
    • 質問コードは数字で始めることはできないので、質問番号を質問コードにするときは、単に"q1"、"q1a"、"g1q2"のようにしてください。
    • 現在のところ、データをSPSSまたはRにエクスポートすると、これが変数名になります。したがって、統計分析を行う場合は、ユニークにしなければなりません。


EMを使わなければならないのか?

短い答えは"いいえ"ですが、作成するアンケートがどれだけ複雑かによって変わります。

例えば、条件エディターでは、アンケートの質問に適用できるいくつかの基本的な式を扱います。ただし、条件エディタには制限があります。EMが使用されているのはこのためです。EMがカスタマイズの可能性を広げています。


条件と出現条件式の両方を使えるか?

はい。質問によって条件エディターを使用することも、出現条件式を使用することもできます。

条件と式の両方を同じ質問で設定することはできません。 条件が設定されると、出現条件のフィールドに書き込まれた式は使われません。さらに、出現条件式フィールドは手動では編集できません。

しかし、質問内で式と条件の両方を使用する方法があります。上で述べたように、条件式は出現条件式のフィールドを置き換えます。完了したら、新しく作成された式を確認し、テキストエディターにコピーします。条件エディターで作成した条件を削除し、残りの式と一緒にテキストエディターにコピーした条件ベースの式を追加して質問を編集します。


条件と関連のどちらを選ぶべきか?

各々の長所と短所のリストを以下に示します。

スタイル 長所 短所
条件 1. シンプルな条件を作成するための優れたGUI
2. サポートチームにより文書化され理解しやすいGUI
1. 簡単な比較のみをサポートし、"AND"/"OR"条件はうまく機能しない
2. 条件を入れ子にした場合の動作が不安定
3. データベースアクセスが遅く、アンケートに時間がかかる
4. 条件のリロードで不具合がレポートされている
5. GUIに拡張性がなく、何十、何百、または何千もの質問があるときにうまくいかない
6. SGQA名を使用しなければならないので、紙ベースのアンケートを変換するのが遅いかもしれない
7. 複雑な分岐が必要な場合、カスタムコードロジックを書くプログラマーが必要なことがある
出現条件 1. 80以上の関数と数学/文字列演算子を含む非常に複雑なロジックのサポート
2. 入れ子のロジックの完全サポート
3. 高速 - 余計なデータベースアクセスがなく、1000以上の質問があるアンケートをサポート
4. SGQAコードを必要としないため、リロードロジックで問題が生じない
5. 構文ハイライト機能は1000以上の質問があるアンケートにも対応
6. 既存の紙ベースのアンケートの電子化に簡単かつ迅速に対応
7. プログラマーを必要とせずに半構造化インタビューや疫学調査を容易にサポート
1. 単純な条件のためのGUIがない(代わりに構文ハイライト機能を使用)


注意:
  • ニーズに合ったものを使用することをお勧めします。
  • EM機能の詳細については、こちらをクリックしてください。


はじめに

式マネージャーを始める最善の方法は以下のとおりです。

  • http://www.limesurvey.org/en/download からLimeSurveyの最新の安定版をインストールしてください。
  • サンプルアンケートをインポートして確認します。
  • 使用例と使用法ステップバイステップの例を読んでください。
  • EMに関するドキュメント(このページ)を読んでください。
    • 分離された式の単体テスト(上級)
      • すべてのEM関数と演算子、PHPとJavaScriptの結果の使用例を表示します。
      • PHPとJavaScriptのバージョンで異なる結果を生成する関数はほとんどありません。このページの内容を踏まえ、EMロジックを適切に計画することができます。

用語

これらの単語は、EMの機能を記述するために一般的に使用されます。

  • 出現条件に基づく分岐 - 質問が出現条件を満たす場合は質問し、満たさない場合は質問しません(非表示となり、データベース内ではNULLとして格納されます)。質問エディターパネルと質問グループエディターパネルに出現条件フィールドがあります。後者では、各質問に同じ条件をコピーしたり、グループと質問レベルの条件付きロジックを組み合わせたりせずに、一連の条件をグループ全体に適用するために使用されます。
  • 文言調整 - どの質問を表示すべきか決めたら、文言調整(パイピングとも呼ぶ)でどのように質問するかを指定します。これは簡単な置換(例: {TOKEN:FIRSTNAME})だけでなく、回答者が回答した性別、数に基づいて、動詞や名詞を変化させることもできます。また、アンケート回答者が回答したか(またはどのように回答したか)に基づいて、アンケート回答者に送信するメッセージを変更することもできます。
  • - EMでは、という新しい質問タイプを追加され、式の結果が格納されます。式はページ内で非表示であっても結果が計算され、データベースに書き込まれます。したがって、非表示のまま行うスコア計算、複雑な式に基づくナビゲーション、評価、データベース内に作成・格納されるレポートに使用されます。


出現条件とカスケードされた出現条件

すべての質問タイプで、質問が表示されるかどうかを制御する出現条件オプション が追加されました。EMは、アンケートに登場する順に出現条件式を処理します。式が真(または式がない - 古い形式のアンケート向け)の場合、質問が表示されます。出現条件式が偽の場合、質問は非表示になり、その値はデータベースでNULLになります。グループに出現条件を満たす質問がない場合、グループ全体がスキップされます。

さらに、式に含まれる変数のいずれかの出現条件が偽の場合、式は常に偽と評価されます。これにより出現条件の入れ子が可能になり、各々の質問に対して非常に長い出現条件の式を書く必要がなくなります。

たとえば、5つの質問Q1〜Q5があり、Q1が答えられたらQ2、Q2に答えられたらQ3などを表示したいとします。出現条件の式は次のようになります。

質問コード 出現条件 質問
Q1 1 名前は何ですか。
Q2 Q1 {Q1}さん、何歳ですか。
Q3 Q2 {Q2}歳なのですね。結婚していますか。
Q4 Q3 == "Y" {Q1}さん、結婚して何年になりますか。
Q5 Q4 {Q1}さん、子供は何人いますか。


グループレベルの出現条件

ExpressionScriptはグループレベルの関連性もサポートしています。これにより、ループの実装が容易になります。最大10のエンティティ(製品や家族など)から情報を収集したい場合、(家族の人数を答えさせたり、長いリストから好きな製品を選択させたりして)繰り返しが必要なエンティティの数を最初に判断します。エンティティの数がわかったら、10こある繰り返し用グループごとに{count >= 1}, {count >=2}, ... {count >= 10}のようにグループレベルの出現条件を設定します。各々のグループ内では、質問レベルの条件付きロジック(例:各々のエンティティの性別や年齢に基づく質問)を作成できます。質問とグループレベルの出現条件の式は、表示すべきかを決定するためにAND演算されます。

例を確認するには、次のアンケートをインポートします。国勢調査の例

以下のスクリーンショットでは、回答者が少なくとももう1人の同居者と一緒に住んでいる場合、グループPerson 1が表示されている(出現条件を満たしている)ことがわかります。



文言調整/パイプ

中括弧内のものはすべて式として扱われるようになりました(後述する例外が1つあります)。式はすべてのLimeReplacementFields、すべての変数(いくつかのエイリアスを介して)、すべての一般的な演算子(数学、論理、比較)、数多くの関数(クライアント側でも動的に機能する)にアクセスします。

これらの式を使用すると、次のようなことができます。

  1. 先行する質問への回答に基づいて文言調整されたメッセージを回答者に表示する
  2. 評価を作成し、その結果に基づいて評価結果を表示する(条件付きで分岐、またはメッセージを表示する)(評価モジュール自体は使用しない)
  3. 質問、回答、およびレポート内の動詞、名詞を変化させる
  4. アンケートの最後で、"回答を表示する"ページの前に回答の要約を表示する


と呼ばれる新しい質問タイプがあります。これは、表示されている値をデータベースに格納することを除き、テキスト表示質問タイプと似ています。したがって、式の質問テキストに評価計算が含まれている場合、パブリックまたはプライベート統計情報内に表示できる変数の値がデータベースに格納されます。


構文

中カッコ内に含まれるものはすべて式と見なされます(ただし、先頭または末尾に空白がないことが必要です。これは、式マネージャーが埋め込みJavaScriptを処理しないようにするためです)。

開く括弧の後、閉じる括弧の前に空白がない限り、式は複数の行にまたがっても構いません。特に次のような入れ子のif()構文が見やすくなります。

{if(is_empty(PFTotals),
 '',
 if(PFTotals >= -5 && PFTotals <= -4,
   'Very Soft',
   if(PFTotals >= -3 && PFTotals <= -2,
     'Soft',
     if(PFTotals == -1,
       'Somewhat Soft',
       if(PFTotals == 0,
         'Moderate',
         if(PFTotals == 1,
           'Somewhat Hard',
           if(PFTotals >= 2 && PFTotals <= 3,
             'Hard',
             if(PFTotals >= 4 && PFTotals <= 5,
               'Very Hard',
               ''
             )
           )
         )
       )
     )
   )
 )
)}

式マネージャは、次の構文をサポートしています。

  • 標準的な数学演算子(例: +,-,*,/,!)
  • 標準的な比較演算子(例: <,<=,==,!=,>,>=, およびこれらと同じ意味を持つlt, le, eq, ne, gt, ge)
  • かっこ(入れ子の式をグループ化できます)
  • 条件演算子(例: &&, | | およびこれらと同じ意味を持つand, or)
  • シングルまたはダブルクオートで囲まれた文字列(別のクオート記号で囲まれた文字列を含めることができます)
  • コンマ演算子(式のリストを持ち、最終結果を返します)
  • 代入演算子(=)
  • 定義済み変数(質問、質問属性、回答を参照する) - 例: SGQAコード
  • 定義済み関数(80以上あり、簡単に追加できます)


演算子

EM構文は、通常の演算子の優先順位に従います。

レベル 演算子 説明
1 () グループ化または関数呼び出しのための括弧
2 ! - + 単項演算子: 否定、正負
3 * / 乗算、除算
4 + - 加算、減算
5 < <= > >= lt le gt ge 比較演算子
6 == != eq ne 同等比較
7 and 論理積 AND
8 or 論理和 OR
9 = 代入演算子
10 , コンマ演算子
JavaScriptとPHPの間の一貫性を保つために、プラス演算子(+)は両方のオペランドが数値の場合は加算を行いますが、両方の部分が数値以外の文字列の場合は連結します。しかし、意図をもっとはっきりさせるため、連結関数join()を使うことをお勧めします。文字列を期待しているのに数値となったり、その逆となったりすることも防止します。

番号と文字列の不一致およびアルファベット/数字の比較に関する注意

次の用語は、EMの機能を記述するためによく使用されます。

たとえば、Q0.NAOKが数値質問で値が9である場合、Q0.NAOK > "50"はtrueとなります。これは、演算子>が、これを数値の比較ではなく、文字列の比較とみなすためです。

整数値を確実に比較するには、intval(Q0.NAOK) > 50を使用します。Q0.NAOKが数値でない(空または文字列)場合は、intval(Q0.NAOK) === 0となります。文字列値を比較する("A" < "B")場合は、直接strcmpを使用します。strcmp(Q0.NAOK,"B")またはstrcmp(Q0.NAOK,"A5")

代入演算子(=)を使用する際の注意

代入演算子は、予期しない副作用を引き起こす可能性があるため、どうしても必要な場合を除いて使用しないでください。たとえば、先行する質問の値を変更すると、その質問と現在の質問との間で入れ子となった出現条件と検証ロジックが再計算されないため、内部的に一貫性のないデータになることがあります(たとえば、NULLにすべきなのに回答がある、回答すべきだがスキップされる、等)。一般に、変数に値を割り当てる場合は、式の質問タイプを作成し、その値を設定する式を使用する必要があります。しかし、この演算子がまれに必要となるため用意されています。

この演算子について注意を促すため、構文式の中では赤いフォントで表示されています("=="と混同しないようにするため)。



代入演算子を使用する

代入演算子を使用する主な理由は次のとおりです。

  • 既定値を設定できない質問の既定値を式を使って設定する必要がある(ユーザーインターフェイスでは回答オプションの1つを選択できるが、式を入力することができないリスト、ラジオなど)。ただし、LimeSurveyは式がその質問に対する許容可能な回答を生成できるかどうかを検証できないため、注意して使用してください。
  • 後続の回答に基づいて先行する質問への回答を強制的に変更する必要がある
  • など...


  注意 : 代入はPHPでのみ行われます。つまり、値はページ内で更新されているのではなく、ユーザーが次のページに移動したときにだけ更新されるということです。したがって、代入演算子が他の式と同じページで使用されている場合は注意してください。



この目的のために、式マネージャーシステムを使用することができます。この目的のため、を使用する方がよいでしょう。

例:

  • 質問への回答を小文字にする: {QCODE=strtolower(QCODE.NAOK)}
  • アンケートの開始時に配列質問タイプに既定の回答を設定する: {Q1_SQ1=(is_empty(Q1_SQ1.NAOK),"A99",Q1_SQ1.NAOK)}
  • アンケート開始時に配列テキストの質問タイプに対する既定の回答を設定する: {Q1_SQY1_SQX1 = (is_empty(Q1_SQY1_SQX1.NAOK),"Inserted answer", Q1_SQY1_SQX1.NAOK)}
  • 条件付きの回答を設定する: {QCODE=if(YesNo="Y","A1","")}

XSS セキュリティ

XSSを有効にすると、式マネージャーシステムの一部がつかえなくなります。

  • 式でHTMLタグを開き、別の式で閉じる
  • URL内で複雑な式を使用する


LimeSurveyのインストールではXSSはデフォルトで有効になっています。


例と解決策

  • {if( 1 ,"<strong>","")}information{if( 1 ,"</strong>","")}はXSSでは正常に動作しないため、次のようにします。{if(1,"<strong>information</strong>","information")}
  • <a href="/script.php?value={if(QCODE == "Y","yes","no")}">next</a>は、ここでは式の質問を使います。なぜなら、完全な質問コードがOKだからです。<a href="/script.php?value={EQUATION.NAOK}">next</a>


変数へのアクセス

式マネージャーでは、必要な変数に読み取り専用でアクセスできます。互換性のため、次のものにアクセスできます。

さらに、式マネージャーでは、質問コード(データベース内の質問テーブルの'タイトル'列)で変数を参照できます。これは、データをSPSS、R、またはSASにエクスポートするときにも使用される変数ラベルです。たとえば、名前、年齢、性別に関する質問がある場合、12345X13X2212345X13X23’'、12345X13X24の代わりに、変数nameagegenderで呼び出すことができます。これにより、誰もが簡単にロジックを理解し検証することができ、グループや質問の数を把握しなくても質問をシャッフルすることができます。

重要: 先行するページや質問で発生する変数を参照するのが安全です。

さらに、式マネージャーを使用すると、多くの質問プロパティにアクセスできます。


構文 意味 例の実行結果
Qcode Qcode.codeの別名 {implode(',',name,gender)} 'Tom','M'
Qcode.code 質問で選択した回答のコード(出現条件を満たす場合。満たさない場合は空白)、またはコード化されていない質問のテキスト値 {implode(',',name.code,gender.code)} 'Tom','M'
Qcode.NAOK Qcodeと同じ - NAOKについての議論を参照 {gender.NAOK} 'M'
Qcode.value 質問の評価値(出現条件を満たす場合。満たさない場合は空白)、またはコード化されていない質問のテキスト値 {gender.value} '1'
Qcode.valueNAOK Qcode.valueと同じ - NAOKについての議論を参照 {gender.valueNAOK} '1'
Qcode.shown 質問の表示値 {implode(',',name.shown,gender.shown)} 'Tom','Male'
Qcode.question 質問のテキスト {gender.question} 'What is your gender?'
Qcode.mandatory 質問が必須かどうか(Y/N) {gender.mandatory} 'N'
Qcode.qid 内部で使用する質問番号(順番を示す連続番号ではない) {gender.qid} 337
Qcode.type 質問タイプ {gender.type} 'G'
Qcode.jsName 質問の正しいjavascript名(このページで宣言されているかどうかにかかわらず) {gender.jsName} 'java1827X3X337'
Qcode.gid 内部で使用するグループ番号(順番を示す連続番号ではない) {gender.gid} 3
Qcode.qseq 質問の連続番号(0から始まる) {gender.qseq} 5
Qcode.gseq グループの連続番号(0から始まる) {gender.gseq} 1
Qcode.relevanceStatus 質問が現在出現条件を満たすかどうか(0または1) {gender.relevanceStatus} 1
Qcode.relevance 質問レベルの出現条件式 {gender.relevance} '!is_empty(name)'
Qcode.grelevance グループレベルの出現条件式 {gender.grelevance} 'num_children >= 5'
Qcode.sgqa この質問のSGQA値 {gender.sgqa} '1827X3X337'


HTMLエディターの問題

HTMLエディターを使用すると、一部の文字がHTML実体に置き換えられます。

  • & → &amp;
  • < → &lt;
  • > → &gt;

HTMLエディターを使用する場合は、次のものを使用する必要があります。

  • & に対しては and
  • < に対してはlt
  • <= に対してはle
  • > に対してはgt
  • >= に対してはge


式の中のHTML表現を消去することをお勧めします。 LimeSurvey HTMLエディターを使用する場合は、エディターの左上にある"ソース"ボタンをクリックして、式に関連しないすべての文字を削除します(例:


など)。

Qcode変数の命名

Qcodeを構成する方法(およびいくつかのプロパティにアクセスする方法)の質問タイプ別の詳細は次のとおりです。一般に、Qcodeは次のように構成されます。

 QuestionCode . '_' . SubQuestionID . '_' . ScaleId

commentotherの場合、対応する質問コードはそれぞれQuestionCode_comment、QuestionCode_otherです。

種類 説明 コード サブ質問 回答オプション 尺度 回答コード 回答表示 出現条件
5 5点尺度ラジオボタン Q1 1-5 {Q1} {Q1.shown} {Q1==3}
B 配列(10点選択)ラジオボタン Q2 L1-L6 1-10 {Q2_L2} {Q2_L2.shown} {Q2_L2==7}
A 配列(5点選択)ラジオボタン Q3 1-5 1-5 {Q3_1} {Q3_1.shown} {Q3_1>=3}
1 配列(フレキシブルラベル)二元尺度 Q4 sq1-sq5 0:a1-a3 1:b1-b3 {Q4_sq1_0} {Q4_sq1_1.shown} {Q4_sq1_1=='b2'}
H 配列(フレキシブル) - 列フォーマット Q5 1-5 s,m,t {Q5_1} {Q5_1.shown} {Q5_1=='s'}
F 配列(フレキシブル) - 行フォーマット Q6 F1-F5 1-5 {Q6_F3} {Q6_F3.shown} {Q6_F3==4}
E 配列(増加/同じ/減少)ラジオボタン Q7 1-7 I,S,D {Q7_4} {Q7_4.shown} {Q7_4=='D'}
: 配列(数値)1から10 Q8 ls1,todo,ls2 min,max,avg {Q8_ls1_max} {Q8_ls2_avg.shown} {Q8_ls2_min==7}
; 配列(テキスト) Q9 hp,st,sw 1st,2nd,3rd {Q9_hp_3rd} {Q9_hp_3rd.shown} {Q9_hp_3rd=='Peter'}
C 配列(はい/わからない/いいえ)ラジオボタン Q10 1-5 Y,N,U {Q10_1} {Q10_1.shown} {Q10_3=='Y'}
X テキスト表示 Q11 {Q11.shown}
D 日付 Q12 {Q12} {Q12.shown}
* Q13 {Q13} {Q13.shown} {Q13>5}
~124~ ファイルアップロード(アップロードファイル数を記録) Q14 {Q14} {Q14>0}
G 性別ドロップダウンリスト Q15 M,F {Q15} {Q15.shown} {Q15=='M'}
U 非常に長いテキスト Q16 {Q16} {Q16.shown} {strlen(Q16)>100}
I 言語 Q17 {Q17} {Q17.shown} {Q17=='en'}
! リスト - ドロップダウン Q18 1-5 {Q18} {Q18.shown} {Q18==3}
L リスト ドロップダウン/ラジオボタンリスト Q19 A-Z {Q19} {Q19.shown} {Q19=='X'}
O コメント付きリスト(ドロップダウン/ラジオボタンリスト + テキスト領域) Q20 A-F {Q20},{Q20comment} {Q20.shown} {Q20=='B'}
T 長いテキスト Q21 {Q21} {Q21.shown} {strstr(Q21,'hello')>0}
M 複数選択チェックボックス Q22 A-F, other {Q22_E}, {Q22_other} {Q22_E.shown}, {Q22_other.shown} {Q22_E=='Y'}
P コメント付き複数選択(チェックボックス + テキスト) Q23 A-F {Q23_D}, {Q23_Dcomment} {Q23_D.shown} {!is_empty(Q23)}
K 数値入力(複数) Q24 self,mom,dad {Q24_self} {Q24_self.shown} {Q24_self>30}
Q 複数の短いテキスト Q25 A-F {Q25_B} {Q25_B.shown} {substr(Q25_B,1,1)=='Q'}
N 数値 Q26 {Q26} {Q26.shown} {Q26 > 30}
R 順位 Q27 1-4 {Q27_1} {Q27_1.shown} {Q27_1==3}
S 短いテキスト Q28 {Q28} {Q28.shown} {Q28=='mine'}
Y はい/いいえラジオボタン Q29 {Q29} {Q29.shown} {Q29=='Y'}


NAOKの利用

NAOK --> "Not Applicable"(該当なし、NA)は問題ない(OK)


NAOKは、すべてまたは一部の変数が出現条件を満たさないということです。"Not Applicable"(該当なし、NA)は問題ない(OK)。

例: count(Q1_SQ1,Q1_SQ2,Q1_SQ3,Q1_SQ4) は、Q1のサブ質問の一つがフィルターされている場合、常に空文字となります。このような質問で、チェックされたサブ質問の数をカウントするには、count(Q1_SQ1.NAOK,Q1_SQ2.NAOK,Q1_SQ3.NAOK,Q1_SQ4.NAOK)とします。サブ質問が隠されている場合、式マネージャーは空文字を返します。

NAOKがない場合、1つの質問または1つのサブ質問が非表示になっている場合、式マネージャーは常に空の文字列を返します(falseを返すのと同じです)。

.shownは常にNAOKの仕組み(非表示の時は空文字)を使っていますが、回答のコードが必要な場合は、質問コードの後に.NAOKを付加するとよいでしょう。それが必要で、内容を理解している場合は別です。

詳細は、入れ子条件の上書きの項にあります。


予約変数 "this"、"self"、"that"

回答されたサブ質問の数を数えたり、スコアを合計するなど、質問の全体を評価したい場合がよくあります。また、質問の特定の行や列(行や列の合計を取得してデータベースに格納するなど)を処理したい場合もあります。以下の予約変数により、そのプロセスを簡単に実現できます。


変数"This"

"this"変数は、"質問全体の検証式と"サブ質問の検証式"のオプションで排他的に使用されます(後者はGUIからは使えません)。該当の質問内の各セルの変数名に展開されます。したがって、各エントリが3より大きいかどうかを確認する場合は、"サブ質問の検証式"を(this > 3)に設定します。


変数"Self"

"self""that"変数はより強力で、式を処理する前に展開されるマクロとして機能します。"self"変数の構文は次のとおりです。

  • self
  • self.suffix
  • self.sub-selector
  • self.sub-selector.suffix
  1. suffixは、通常のqcode接尾辞のいずれかです(例: NAOK、value、shown)。
  1. サブセレクターは次のようなものがあります。
  • comments - コメントとなるサブ質問のみ(コメント付き複数選択コメント付きリストなど)
  • nocomments - コメントのないサブ質問のみ
  • sq_X - Xは行か列の識別子。パターンXと一致するサブ質問のみが選択されます。検索は完全なコード識別子で行われ、sq_XはnX、X、Xnといったサブ質問にマッチしますが(例えば、sq_1を使用する場合はサブ質問a1、1a、1、11または001がマッチします)。 二元スケール質問タイプではサブ質問はQCODE_SQCODE_1とQCODE_SQCODE_1になり、順位付け質問タイプではサブ質問コードがQCODE_1,QCODE_2 ....となります。

例:

  • 質問に対して何らかの回答があったか? -> {count(self.NAOK)>0}
  • この質問の評価点数は? -> {sum(self.value)}

行と列の合計を取得することもできます。列A-Eと行1-5の数字の配列があるとします。

  • 総合計は? -> {sum(self.NAOK)}
  • 列Bの合計は? -> {sum(self.sq_B.NAOK)}
  • 行3の合計は? -> {sum(self.sq_3.NAOK)}


変数"That"

"that"は"self"に似ていますが、他の質問を参照することができます。構文は次のとおりです。

  • that.qname
  • that.qname.suffix
  • that.qname.sub-selector
  • that.qname.sub-selector.suffix

qnameは、サブ質問拡張がない質問の名前です。質問 'q1'を作成したら、それがqnameとなります。

例:

  • 質問q1に対して何らかの回答があったか? -> {count(that.q1.NAOK)>0}
  • q2の評価点数は? -> {sum(that.q2.NAOK)}
  • q3の総合計は? -> {sum(that.q3.NAOK)}
  • q4の列Cの合計は? -> {sum(that.q4.sq_C.NAOK)}
  • q4の行2の合計は? -> {sum(that.q4.sq_2.NAOK)}

"self"と"that"変数は、出現条件、検証、文言調整の式で使用できます。

注意すべき点は、ロジックファイルの表示機能を使用すると、"self"と"that"を展開した値が表示されることです。これにより、生成される実際の式が表示され、その結果、変数が存在することを検証できるようになります。かなり長い式になるかもしれないので、混乱しているように見えるかもしれません。しかし、質問を編集すると、"self"や"that"を使っている元の式が表示されます。

以下の場合は、これらの変数を使用しないでください。
  • 式に使用される各変数を明示的に命名する場合。
  • サブ質問を持たない変数を使用する場合(例:単一回答の質問)。そのような場合に、変数にプレフィックスとして"that"をつけると、予期しない結果が出る危険があります。

関数へのアクセス

式マネージャーでは、以下に示すように、数学関数、文字列関数、およびユーザー定義関数が利用できます。これらの関数にはPHPとJavaScriptに同等のものがあるので、サーバ側(PHP)とクライアント側(JavaScript)で同じように動作します。新しい機能を追加するのは簡単です。


実装済み関数

現在、以下の関数が利用可能です。

機能 意味 構文
abs 絶対値 number abs(数値)
acos アークコサイン number acos(数値)
addslashes 文字列をスラッシュで引用 string addslashes(文字列)
asin アークサイン number asin(数値)
atan アークタンジェント number atan(数値)
atan2 2変数のアークタンジェント number atan2(number, 数値)
ceil 切り上げ number ceil(数値)
checkdate グレゴリオ暦で有効な日付であれば真(1)を返す bool checkdate(月,日,年)
convert_value 変換元リストにある数値を対応する変換先リストの数値に変換する number convert_value(変換する数値, 一致フラグ, 変換元リスト, 変換先リスト)
cos コサイン number cos(数値)
count リスト内で回答された(空白でない)質問の数 number count(arg1, arg12, ..., argN)
countif 回答された質問のうち、比較値と等しいリスト内の回答の数 number countif(比較値, arg1, arg2, ... argN)
countifop 回答された質問のうち、条件を満たすリスト内の回答の数(回答 演算子 比較値) number countifop(演算子, 比較値, arg1, arg2, ... argN)
date 指定した、もしくは現在のローカルの日付/時刻を書式化する string date(日付書式 [, 指定時刻=time()])
exp eの累乗を計算する number exp(数値)
fixnum 必要に応じてカンマで区切られた数字を表示する string fixnum(数値)
floor 切り捨て number floor(数値)
gmdate 指定した、もしくは現在のGMTの日付/時刻を書式化する string gmdate(日付書式 [, 指定時刻=time()])
html_entity_decode HTML エンティティを適切な文字に変換する (常にENT_QUOTES、UTF-8を使用) string html_entity_decode(文字列)
htmlentities すべての変換可能な文字をHTMLエンティティに変換する(常にENT_QUOTES、UTF-8を使用) string htmlentities(文字列)
expr_mgr_htmlspecialchars 特殊文字をHTMLエンティティに変換する(常にENT_QUOTESとUTF-8を使用) string htmlspecialchars(文字列)
expr_mgr_htmlspecialchars_decode Convert special特殊な HTML エンティティを文字に戻す(常にENT_QUOTESとUTF-8を使用) string htmlspecialchars_decode(文字列)
idate 指定した、もしくは現在のローカルな時刻/日付を整数として整形する string idate(文字列 [, 指定時刻=time()])
if Excelスタイルのif(条件,trueの時の結果,falseの時の結果) if(条件,trueの時の結果,falseの時の結果)
implode 配列要素を文字列により連結する string implode(区切り文字,arg1,arg2,...,argN)
intval 変数の整数としての値を取得する int intval(数値 [, 基数=10])
is_empty 変数が空であるかどうかを検査する bool is_empty(変数)
is_float 変数の型が float かどうか調べる bool is_float(変数)
is_int 変数が整数型かどうかを検査する bool is_int(変数)
is_nan 値が数値でないかどうかを判定する bool is_nan(変数)
is_null 変数が NULL かどうか調べる bool is_null(変数)
is_numeric 変数が数字または数値形式の文字列であるかを調べる bool is_numeric(変数)
is_string 変数の型が文字列かどうかを調べる bool is_string(変数)
join (New in 2.0 build 130129) 要素を新しい文字列として結合する join(arg1, arg2, ... argN)
list 空白でない値をコンマ区切りリストで返す string list(arg1, arg2, ... argN)
log 自然対数(底が指定されている場合は底に対する対数) number log(数値,底=e)
ltrim 文字列の最初から空白 (もしくはその他の文字) を取り除く 文字列 ltrim(string [, 削除する文字のリスト])
max 最大値を返す number max(arg1, arg2, ... argN)
min 最小値を返す number min(arg1, arg2, ... argN)
mktime 日付を Unix のタイムスタンプとして取得する(引数は省略可) number mktime([時 [, 分 [, 秒 [, 月 [, 日 [, 年 ]]]]]])
modulo-function モジュロ関数はまだサポートされていません。代わりにfloor()関数を使用します。 floor(x/y)==(x/y)
nl2br 改行文字の前にHTMLの改行タグを挿入する string nl2br(文字列)
number_format 数字を千位毎にグループ化してフォーマットする string number_format(数値)
pi 円周率 number pi()
pow 指数表現 number pow(基数, 指数)
quoted_printable_decode quoted-printable 文字列を 8 ビット文字列に変換する string quoted_printable_decode(文字列)
quoted_printable_encode 8 ビット文字列を quoted-printable 文字列に変換する string quoted_printable_encode(文字列)
quotemeta メタ文字をクォートする string quotemeta(文字列)
rand 乱数を生成する( int rand() OR int rand(最小値, 最大値)
regexMatch 文字列を正規表現で比較する bool regexMatch(パターン,文字列)
round 数値を任意の精度に丸める number round(値 [, 丸める桁数])
rtrim 文字列の最後から空白(またはその他の文字)を取り除く string rtrim(文字列 [, 削除する文字のリスト])
sin サイン number sin(arg)
sprintf フォーマットされた文字列を返す string sprintf(フォーマット, arg1, arg2, ... argN)
sqrt 平方根 number sqrt(arg)
stddev 数値のリストのサンプル標準偏差を計算する number stddev(arg1, arg2, ... argN)
str_pad 文字列を固定長になるまで他の文字列で埋める string str_pad(入力文字列, 文字列の長さ [, 埋める文字列])
str_repeat 文字列を反復する string str_repeat(入力文字列, 繰り返し回数)
str_replace 検索文字列に一致したすべての文字列を置換する string str_replace(検索文字列, 置き換える値, 対象の文字列)
strcasecmp 大文字小文字を区別しないバイナリセーフな文字列比較を行う int strcasecmp(文字列1, 文字列2)
strcmp バイナリセーフな文字列比較を行う int strcmp(文字列1, 文字列2)
strip_tags 文字列から HTML および PHP タグを取り除く string strip_tags(文字列, 取り除かないタグ)
stripos 大文字小文字を区別せずに文字列が最初に現れる位置を探す(0から始まり、現れなければfalse) int stripos(対象文字列, 検索文字列 [, 検索開始位置=0])
stripslashes クォートされた文字列のクォート部分を取り除く string stripslashes(文字列)
stristr 大文字小文字を区別しないstrstr string stristr(対象文字列, 検索文字列 [, 検索文字列の前まで=false])
strlen 文字列の長さを得る int strlen(文字列)
strpos 文字列内の部分文字列が最初に現れる場所を見つける(0から始まり、現れなければfalse) int strpos(対象文字列, 検索文字列 [ 検索開始位置=0])
strrev 文字列を逆順にする string strrev(文字列)
strstr 文字列が最初に現れる位置を見つける string strstr(対象文字列, 検索文字列[, 検索文字列の前まで=false])
strtolower 文字列を小文字にする string strtolower(文字列)
strtotime P英文形式の日付をUnixタイムスタンプに変換する int strtotime(文字列)
strtoupper 文字列を大文字にする string strtoupper(文字列)
substr unicode文字列の一部分を返す string substr(文字列, 開始位置 [, 長さ])
sum 配列中の値の合計 number sum(arg1, arg2, ... argN)
sumifop 回答された質問のうち、条件を満たすリスト内の回答の合計(回答 演算子 比較値) number sumifop(演算子, 値, arg1, arg2, ... argN)
tan タンジェント number tan(arg)
time 現在の Unix タイムスタンプを返す number time()
trim 文字列の先頭および最後から空白(またはその他の文字)を取り除く string trim(文字列 [, 削除する文字のリスト])
ucwords 文字列の各単語の最初の文字を大文字にする string ucwords(文字列)
unique 空白以外の回答のすべてが一意である場合にtrueを返す boolean unique(arg1, ..., argN)


計画されている(または検討中の)関数の詳細を知りたい場合は、ここをクリックしてください。

式マネージャーとローカル変数

ページのJavaScriptを適切に構築するため、式マネージャーはページに設定されている変数とJavaScript IDが何であるかを知る必要があります(例: document.getElementById(x))。また、他のページにどの変数が設定されているかも知る必要があります(これにより、必要な<input type='hidden' value='x'>フィールドが存在しているか確認できます)。


条件の入れ子

いずれかの変数がfalseである場合、式全体はfalseになります。たとえば、次の表では、N/Aは変数の1つがtrueでないことを意味します。


演算子 a b 結果
+ (単項演算子) +a N/A false
- (単項演算子) -a N/A false
! !a N/A false
== (またはeq) a == b N/A 5 false
== (またはeq) a == b N/A 0 false
== (またはeq) a == b N/A N/A false
!= (またはne) a != b N/A 5 false
!= (またはne) a != b N/A N/A false
!= (またはne) a != b N/A 0 false
> (またはgt) a > b N/A 5 false
>= (またはge) a >= b N/A 5 false
< (またはlt) a < b N/A 5 false
<= (またはle) a <= b N/A 5 false
and a and b N/A 5 false
and a and b N/A N/A false
or a or b N/A N/A false
or a or b N/A 5 false
+ a + b N/A 5 false
* a * b N/A 5 false
/ a / b 5 N/A false
() (a) N/A false
(式) (a && b) N/A 5 false
(式) 演算子 (式) (b + b) > (a && b) N/A 5 false
関数 sum(a,b,b) N/A 5 false
関数 max(a,b) N/A 5 false
関数 min(a,b) N/A 5 false
関数 implode(', ',a,b,a,b) N/A 5 false
関数 if(a,a,b) N/A 5 false
関数 is_empty(a) N/A false
関数 is_empty(a) 0 (or blank) true
関数 !is_empty(a) N/A false


入れ子条件の上書き

出現条件を満たした回答の合計を表示したいとします。式 {sum(q1,q2,q3,...,qN)}を使おうとするでしょう。しかし、これは内部的にLEMif(LEManyNA("q1","q2","q3",...,"qN"),"",sum(LEMval("q1"),LEMval("q2"),LEMval("q3"),...,LEMval("qN")))に変換されます。これにより、値q1〜qNのいずれかが出現条件を満たさない場合、式は常にfalseを返します。この場合、sum()はすべての質問が出現して回答されない限り"0"となります。

この問題を回避するために、各変数には".NAOK"という接尾辞(「Not Applicable」はOK)を追加することができます。このような場合、次のような現象が発生します。変数q1.NAOKがあるとします。

  1. q1はLEManyNA()節には追加されません
  2. LEMval('q1')は回答が出現条件を満たしているかを確認し、そうでない場合は""を返します(出現条件を満たさない回答は無視されますが、式全体を無効にしません)。

したがって、合計を求める方法は、次の式となります。sum(q1.NAOK,q2.NAOK,q3.NAOK,...,qN.NAOK)

.NAOK接尾辞を使用することで、いくつかの可能な経路を経て、後に共通の経路に収束するアンケートを設計することができます。例えば、回答者が通常の範囲から外れた回答をしたとします。アンケート実施者は、有効な結果を得られない可能性があることを回答者に警告し、アンケートを継続するかどうかを尋ねることができます。彼らが"はい"と答えると、残りの質問が表示されます。 "残りの質問"の条件は、回答が正常範囲内で回答されたか、または正常範囲外で回答した場合にのみ表示される質問に対して"はい"と回答したかどうかをチェックします。

式マネージャーはどのように条件付き文言調整を実現するか?

ここでは、カスタマイズ(質問タイプ'expr'は式を意味します)の例を示します。


質問コード 出現条件 質問タイプ 質問
name 1 text 名前は何ですか。
age 1 text 何歳ですか。
badage !is_empty(age) expr {(age<16) or (age>80)}
agestop badage message すみません、{name}さん。あなたは{if( (age<16),'若い',if( (age>80),'高齢','中間の年齢') ) }です。
kids !badage yesno 子供はいますか。
parents 1 expr {!badage && kids=='Y'}
numKids parents text 子供は何人いますか。
kid1 parents && numKids >= 1 text 一人目の子供は何歳ですか。
kid2 parents && numKids >= 2 text 二人目の子供は何歳ですか。
kid3 parents && numKids >= 3 text 三人目の子供は何歳ですか。
kid4 parents && numKids >= 4 text 四人目の子供は何歳ですか。
kid5 parents && numKids >= 5 text 五人目の子供は何歳ですか。
sumage 1 expr {sum(kid1.NAOK,kid2.NAOK,kid3.NAOK,kid4.NAOK,kid5.NAOK)}
report parents text {name}さん、あなたの年齢は{age}歳で、{numKids}人の子供がいます。上から{min(numKids,5)}人の子供の年齢の合計は{sumage}です。


このアンケート例をダウンロードするには、次のリンクをクリックしてください。子供の数のアンケート例

これらの質問はすべて1つのページ(たとえば同じグループ)に入れることができ、出現条件に合致する質問のみが表示されます。さらに、子供の年齢を入力すると、最後の質問のsum()式がページ上で動的に更新されます。

式マネージャーは、各式を名前付き<span>要素で囲むことでこの機能を提供します。値が変更されるたびに、その<span>要素に表示される式を再計算し、再表示します。そのようなカスタマイズされた式が同じページに数十、または数百もあっても、ページは一度の画面更新ですべて再表示されます。


構文ハイライト

式の入力と検証を支援するために、EMでは以下のような構文強調表示機能を提供しています。

構文ハイライトの種類と意味

意味 ツールチップ コメント
黄褐色の背景 式全体 なし 式として認識される中括弧内のもの(先頭または末尾に空白がない)は、周囲のテキストと区別するために黄褐色の背景で色分けされます。
太字の赤色テキスト エラー エラーに関する説明 不明な変数または関数のエラーである可能性があります。アンケートは正常に動作せず、式に依存する質問は回答者には表示されません。
青色のテキスト 関数名 意味と許容される構文 これは、関数の名前、または関数と思われるもの(開く括弧が続くため)を示します。太字の青いテキストで表示されます。ツールチップには、その関数の意味と許容される構文が表示されます。
灰色のテキスト 文字列 なし 一重引用符と二重引用符で囲まれた文字列は灰色のテキストで表示されます。
水色のテキスト 同一ページでセットされた変数 [名前またはSGQAコード]: 質問; 値; それぞれの値に対するコードを示すanswerList 現在編集している質問と同じページで設定された変数は水色のテキストで表示されます(javascriptで更新できます)。ツールチップには、名前(INSERTANS:xxxを使用した場合)またはそのSGQAコード(新しい命名システムを使用した場合)、実際の質問、および現在の値(設定されていない場合は空白)が表示されます。列挙された値セットからの選択を期待する質問タイプの場合、コードの表示値へのマッピングが示されます。
緑色のテキスト 先行するページでセットされた変数 [名前またはSGQAコード]: 質問; 値; それぞれの値に対するコードを示すanswerList 先行するページで設定された変数は太字の緑色のテキストで表示されます。ツールチップには、名前(INSERTANS:xxxを使用した場合)またはそのSGQAコード(新しい命名システムを使用した場合)、実際の質問、および現在の値(設定されていない場合は空白)が表示されます。列挙された値セットからの選択を期待する質問タイプの場合、コードの表示値へのマッピングが示されます。
太字のピンク色のテキスト 後続のページでセットされる変数通常、アンケート開始時は空ですが、質問番号にしたり、前に戻ることができます。 [名前またはSGQAコード]: 質問; 値; それぞれの値に対するコードを示すanswerList 後続のページで設定される変数は太字のピンク色のテキストで表示されます。ツールチップには、名前(INSERTANS:xxxを使用した場合)またはそのSGQAコード(新しい命名システムを使用した場合)、実際の質問、および現在の値(設定されていない場合は空白)が表示されます。列挙された値セットからの選択を期待する質問タイプの場合、コードの表示値へのマッピングが示されます。
太字の黄褐色のテキスト LimeSurveyの置換値 LimeSurveyの置換文字列({TOKEN:xxx}、{PRIVACY_MESSAGE}など)は、太字の黄褐色のテキストで表示されます。
赤色のテキスト 代入演算子(=) 警告メッセージ 代入演算子(=)を使用している場合、演算子は赤色のテキストで表示されます。aにbを代入するのではなく、aとbが等しいかをチェックしようとする場合に誤って代入することのないようにするためのものです。
通常の黒色のテキスト その他の記号 なし 式の中のその他の記号は通常の黒色のテキストで表示されます。
赤枠で囲まれたテキスト 太い赤枠で囲まれたエラー 構文エラー エラーの説明 構文エラーは赤色のボックス内に示されています。ツールチップは、エラーを示します。例としては、括弧の不一致、未定義関数の使用、関数に渡す引数の数の誤り、不完全に構造化された式(変数の間の演算子欠落など)、読み取り専用の変数への値の代入、非変数への値の代入、またはサポートされていない構文の使用などです。構文エラー検知システムは、複数のエラーがある場合でも、式の中のエラーを1つだけ報告します。


ツールチップとは、特定の関数や変数にカーソルを置いたときに表示されるポップアップメッセージのことです。


参考記事

式マネージャーのサンプル

ユースケースとHowTo

ステップバイステップの例

開発者向け参考情報

ロードマップ/状況/ToDoリスト