Question class

From Catglobe Wiki
Jump to: navigation, search

Question



Base class for all question types

Parent class

Inherits from object

Methods

  • object AsValue() - Convert the Question to plain object
  • Empty Set(object value "New value for question") - Update the question with the given value
  • string ToString() - The string representation of the object.

Properties

  • bool IsChanged { get; } - True if the value of the question has changed
  • (From object) string ObjectTypeName { get; } - The name of the type of object.
  • int QasId { get; } - Id of the qas. 0 if no stored data.
  • string QuestionLabel { get; } - Label of the question
  • (From object) TypeInformation TypeInformation { get; } - Get information about this class.
  • int UserId { get; } - Id of the user. 0 if no user or no stored data.

Static Methods

  • array Question_getLabelsOfLoadedQuestions() - Get labels of the questions that have been loaded in current session and might be saved upon completion
  • Array of Question Question_loadQuestionFromQuestionnaire(int questionnaireId "Id of the questionnaire to load from. 0 to use context", string questionLabel "Label of the question to load", bool latestOnly "If user has multiple qas, only include last created", bool completedOnly "Limit by qas that is completed") - Load all question from questionnaire
  • Array of Question Question_loadQuestionFromQuestionnaire(int questionnaireId "Id of the questionnaire to load from. 0 to use context", string questionLabel "Label of the question to load", bool latestOnly "If user has multiple qas, only include last created", bool completedOnly "Limit by qas that is completed", int limitByQuestionnaireId "Limit by users that participated in this questionnaire", bool limitByCompletedQuestionnaireId "Limit by qas that is completed the limitByQuestionnaireId") - Load all question from questionnaire
  • Dictionary Question_loadQuestions() - Load questions
  • Dictionary Question_loadQuestions(array questionLabels "Labels of the questions to load") - Load questions
  • Dictionary Question_loadQuestions(array questionLabels "Labels of the questions to load", QAS qas "Qas to load data from") - Load questions
  • Empty Question_saveQuestions(Dictionary questionData "Dictionary of labels and data", QAS qas "Qas to save data to") - Change questions
  • Empty Question_unloadAll() - Save and remove all loaded questions. Useful if a called script is expected to change current values. Only deletes those referenced directly through question variables.


See more

Examples

Question_getLabelsOfLoadedQuestions

//run in questionnaire context
number a = Q2Single;
array b = Q3Multi;
string c = Q4Text;
//...
array loadedQuestions = Question_getLabelsOfLoadedQuestions();
print(loadedQuestions);//{Q2Single,Q3Multi,Q4Text}

Question_loadQuestions

//run in questionnaire context
//Add this line to the top of script to increase performance
Question_loadQuestions({"Q2Single","Q3Multi","Q4Text"});
//then working with Q2Single, Q3Multi, Q4Text as normal

Question_saveQuestions

//Load questions
Dictionary d = Question_loadQuestions ({"Q2Single","Q3Multi","Q4Text"}, new QAS (118108496));
//for load all questions from target qas, use empty at question array: Question_loadQuestions (empty, new QAS (118108496))
print(d);//{"Q2Single": 1, "Q3Multi": {True,False,False,True}, "Q4Text":  string test}
//Create new qas
QAS qas = new QAS (15723782, 0);
qas.Save();
//set data for new rpq by copy form rpq 118108496 
Question_saveQuestions(d, qas);
//print data
qas.MakeCurrentQAS();
print(Q2Single);//1
print(Q3Multi);//{True,False,False,True}
print(Q4Text);//string test

Question_saveQuestions

QAS qas = new QAS (15723782,0);
qas.Save();
Dictionary d = {
"Q2Single": 1,
"Q3Multi": {true,false,false,true},
"Q4Text": "test",
"Q5Scale": 2,
"Q6Number": 3,
"Q7OPen": "open",
"Q8SingleGrid": {1,2},
"Q9MutiGrid": {{true,false},{false, true}},
"Q10TextGrid": {"test1","test2"},
"Q11ScaleGrid": {3,5}
};
Question_saveQuestions(d, qas);

Question_saveQuestions

setRPQId(118108530);
Dictionary d = {
"Q2Single": Q2Single,
"Q3Multi": Q3Multi,
"Q4Text": Q4Text,
"Q5Scale": Q5Scale,
"Q6Number": Q6Number,
"Q7OPen": Q7OPen,
"Q8SingleGrid": Q8SingleGrid,
"Q9MutiGrid": Q9MutiGrid,
"Q10TextGrid": Q10TextGrid,
"Q11ScaleGrid": Q11ScaleGrid
};
QAS qas = new QAS (15725032,0);
qas.Save();
Question_saveQuestions(d, qas);

Question.Set() Question.AsValue() and Question.IsChanged

setRPQId(118108496);
print(Q2Single.IsChanged);//False
Q2Single.Set(1);
number value = Q2Single.AsValue();
print(value);//1
print(Q2Single.IsChanged);//True