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.
  • string QuestionLabel { get; } - Label of the question
  • (From object) TypeInformation TypeInformation { get; } - Get information about this class.

Static Methods

  • array Question_getLabelsOfLoadedQuestions() - Get labels of the questions that have been loaded in current session and might be saved upon completion
  • 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