StatFunctions: Difference between revisions
From LimeSurvey Manual
DenisChenu (talk | contribs) m (you can use <, >, >=, <=, <> operator) |
m (Some text changes for better readability) |
||
| Line 1: | Line 1: | ||
{{FeatureStarting|4.1.0}} | {{FeatureStarting|4.1.0}} | ||
Functions for expression manager to count some statistics data : | Functions for the expression manager to count some statistics data : | ||
* statCount(QuestionCode.sgqa[, submitted = true]) : count the | * statCount(QuestionCode.sgqa[, submitted = true]) : count the number of already submitted answered questions by QuestionCode. You can count the number of submitted (= completed) surveys with statCount('sid') for example. | ||
* statCountIf(QuestionCode.sgqa, value[, submitted = true]) : count the | * statCountIf(QuestionCode.sgqa, value[, submitted = true]) : count the number of responses where answer to question QuestionCode equals value. The comparison uses [https://www.yiiframework.com/doc/api/1.1/CDbCriteria#compare-detail Yii compare], you can use <, >, >=, <=, <> operator at start of your value. | ||
You can find an usage of | You can find an example of the usage of these 2 functions in: [https://github.com/LimeSurvey/LimeSurvey/blob/master/tests/data/surveys/survey_archive_statCountFunctionsTest.lsa survey_archive_statCountFunctionsTest] inside the test directory. | ||
[[File:StatFunctionsSample.png]] | [[File:StatFunctionsSample.png]] | ||
This plugin | This plugin uses the [[ExpressionManagerStart]] plugin and it creates two functions. These 2 functions don't use javascript, so the check is done only when the respondent moves ahead in the survey. | ||
{{Alert|Before using these functions : the plugin must be activated in [[Plugin_manager#General|Plugin Manager]].}} | {{Alert|Before using these functions : the plugin must be activated in [[Plugin_manager#General|Plugin Manager]].}} | ||
[[Category:Plugins]][[Category:Core Plugins]] | [[Category:Plugins]][[Category:Core Plugins]] | ||
Revision as of 17:39, 17 December 2021
Functions for the expression manager to count some statistics data :
- statCount(QuestionCode.sgqa[, submitted = true]) : count the number of already submitted answered questions by QuestionCode. You can count the number of submitted (= completed) surveys with statCount('sid') for example.
- statCountIf(QuestionCode.sgqa, value[, submitted = true]) : count the number of responses where answer to question QuestionCode equals value. The comparison uses Yii compare, you can use <, >, >=, <=, <> operator at start of your value.
You can find an example of the usage of these 2 functions in: survey_archive_statCountFunctionsTest inside the test directory.
This plugin uses the ExpressionManagerStart plugin and it creates two functions. These 2 functions don't use javascript, so the check is done only when the respondent moves ahead in the survey.
Before using these functions : the plugin must be activated in Plugin Manager.