{{CGscriptClass_Template
|Name=Dashboard
|Description=Class to manipulate dashboards.
|Constructors=
{{CGscriptConstructors_Template|Parameters=
{{CGscriptParameters_Template|Type=number|Name=resourceId|Description=Resource id of the dashboard to load}}
|Description=Load existing dashboard}}
{{CGscriptConstructors_Template|Parameters=
{{CGscriptParameters_Template|Type=string|Name=layout|Description=The layout to use.|Comma=,}}{{CGscriptParameters_Template|Type=string|Name=title|Description=The title of the dashboard.|Comma=,}}{{CGscriptParameters_Template|Type=string|Name=isocode|Description=The isocode of the title.}}
|Description=Make new dashboard}}
|Methods=
{{CGscriptMethods_Template|ReturnType=Empty|Name=Save|Parameters=
{{CGscriptParameters_Template|Type=string|Name=name|Description=Name of the resource. If empty it will not change the existing name. Required for new scripts.|Comma=,}}{{CGscriptParameters_Template|Type=number|Name=parentResourceId|Description=Parent of the resource. If 0 it will not change the existing. Required for new scripts.}}
|Description=Save the current dashboard.}}
{{CGscriptMethods_Template|ReturnType=Empty|Name=Save|Description=Save the current dashboard using the existing name and parent.}}
{{CGscriptMethods_Template|ReturnType=string|Name=ToString|Description=The string representation of the object.}}
|Properties=
{{CGscriptProperties_Template|ReturnType=string|Name=Layout|HasGetter=1|HasSetter=1|Description=The layout.}}
{{CGscriptProperties_Template|ReturnType=string|Name=ObjectTypeName|HasGetter=1|Description=The name of the type of object.}}
{{CGscriptProperties_Template|ReturnType=Dictionary|Name=Title|HasGetter=1|HasSetter=1|Description=Get/Set the localized title of the dashboard.}}
{{CGscriptProperties_Template|ReturnType=TypeInformation|Name=TypeInformation|HasGetter=1|Description=Get information about this class.}}
{{CGscriptProperties_Template|ReturnType=number|Name=UniqueId|HasGetter=1|Description=The resource id of the workflow.}}
}}

File:RequiredUserNavigationAccessForAnnotationAndAlertApps.jpg

2014-03-03T03:16:28Z

CGHelpdesk:

File:MissNavigationAccessOnFolderModule.jpg

2014-03-03T03:15:16Z

CGHelpdesk:

2013-11-14T08:42:40Z

CGHelpdesk:

= Reverse the position of the subquestion texts with their textboxes in the text-grid question =

This guide will help you reverse the position of the subquestion texts with their textboxes in the text-grid question such as below images:

[[File:ReversePosition.jpg]]

Put below javascript code snippet into your text-grid question.

The function reverseQuestionTextsWithTextBoxes() requires the textbox width parameter. This function will do the reverse and set the textboxes' width to the specifed width.

 <source lang="javascript">
function reverseQuestionTextsWithTextBoxes(textBoxWidth /*number type and required*/) {
$('td.grid_subquestion_text').each(function() {
$(this).parent().append(this);
$(this).prev()
.removeAttr('width').css({'border-left':'none', 'border-right':'dotted 1px #ccc', 'width': (Number(textBoxWidth) + 10) + 'px' })
.children('input:text').css('width', textBoxWidth + 'px');
});
}

quest.onInit = function() {
reverseQuestionTextsWithTextBoxes(150); // Reverse and set the textbox width to 150px
};

</source>

2013-11-11T07:06:34Z

CGHelpdesk:

Questionnaire - Javascript Fun Tips

2013-11-11T07:04:56Z

CGHelpdesk:

'''[[Basic Hints|Basic Hints]]'''

'''[[Show more than one questions in the same page]]'''

'''[[Add answer options of the close questions to the open questions]]'''

'''[[Validate the questions by using the questioncheck() function]]'''

'''[[Show a text grid and a single question in the same page|Show a text grid question and a single question in the same page]]'''

'''[[Show more than one singe grid in the same page|Show more than one single grid in the same page]]'''

'''[[Show more than one singe question in the same page|Show more than one single question in the same page]]'''

'''[[Show single questions as dropdown lists in their own pages]]'''

----

[[Showing Answer Option in tab]]

[[Rotate answer options/sub questions]]

[[Randomize answer options/sub questions]]

[[Drag and drop answer option values]]

[[Change Impsys mages]]

[[Add an extra row before a sub question in a grid]]

[[Hide sub question text column in a grid question]]

[[Change stylesheet of an answer option column in a single grid question]]

[[Add an extra column before an answer option column in single grid question]]

[[Both horizontal and vertical single grid]]

[[Disable sub questions in text grids]]

[[Number grid]]

[[Close to URL]]

[[Double columns in text grids]]

[[Count down with invisible counter]]

[[Fold in/out texts in question text]]

[[Force email address]]

[[Force number of characters]]

[[Change text box size]]

[[Set focus on question text in the top]]

[[Maximum text length]]

[[Next button count down]]

[[Mark answer option with keyboard]]

[[Show flash movies on questionnaire viewer|Play a list of movies in questionnaire]] [[Show a single question as a dropdown list inside another text grid question]]

[[Hide Next button in n seconds]]

[[Show datepicker in text/text grid questions]]

[[Show column header in text grid question]]

[[Prioritize sub questions in a text grid question]]

[[Align min/max texts in scale grid questions]]

[[Add text before answer option of single question]]

[[Show language selector page]]

[[Reverse single grid between sub questions and answer options]]

[[Insert a TextGrid question into a SingleGrid Question]]

[[Script for making a text grid numerical summing to a specific value]]

[[Convert closed question TextBox into TextArea]]

[[Validate email specified as an open text of a single question]]

[[Require only one check for grid question]]

[[Change non-multi option in Multi question to Radio button]]

[[Make whole cell clickable in single and multi grids]]

[[AutoSum numerical text grid]]

[[Show open textbox in a grid question]]

[[Change progress bar images of questionnaire]]

[[Add CKEditor to an Open question]]

[[Upload images in questionnaire]]

[[Check whether values of open parts of a close question are positive numbers or not]]

Questionnaire - Javascript Fun Tips

2013-11-11T07:04:36Z

CGHelpdesk:

'''[[Basic Hints|Basic Hints]]'''

'''[[Show more than one questions in the same page]]'''

'''[[Add answer options of the close questions to the open questions]]'''

'''[[Validate the questions by using the questioncheck() function]]'''

'''[[Show a text grid and a single question in the same page|Show a text grid question and a single question in the same page]]'''

'''[[Show more than one singe grid in the same page|Show more than one single grid in the same page]]'''

'''[[Show more than one singe question in the same page|Show more than one single question in the same page]]'''

'''[[Show single questions as dropdown lists in their own pages]]'''

----

[[Showing Answer Option in tab]]

[[Rotate answer options/sub questions]]

[[Randomize answer options/sub questions]]

[[Drag and drop answer option values]]

[[Change Impsys mages]]

[[Add an extra row before a sub question in a grid]]

[[Hide sub question text column in a grid question]]

[[Change stylesheet of an answer option column in a single grid question]]

[[Add an extra column before an answer option column in single grid question]]

[[Both horizontal and vertical single grid]]

[[Disable sub questions in text grids]]

[[Number grid]]

[[Close to URL]]

[[Double columns in text grids]]

[[Count down with invisible counter]]

[[Fold in/out texts in question text]]

[[Force email address]]

[[Force number of characters]]

[[Change text box size]]

[[Set focus on question text in the top]]

[[Maximum text length]]

[[Next button count down]]

[[Mark answer option with keyboard]]

[[Show flash movies on questionnaire viewer|Play a list of movies in questionnaire]] [[Show a single question as a dropdown list inside another text grid question]]

[[Hide Next button in n seconds]]

[[Show datepicker in text/text grid questions]]

[[Show column header in text grid question]]

[[Prioritize sub questions in a text grid question]]

[[Align min/max texts in scale grid questions]]

[[Add text before answer option of single question]]

[[Show language selector page]]

[[Reverse single grid between sub questions and answer options]]

[[Insert a TextGrid question into a SingleGrid Question]]

[[Script for making a text grid numerical summing to a specific value]]

[[Convert closed question TextBox into TextArea]]

[[Validate email specified as an open text of a single question]]

[[Require only one check for grid question]]

[[Change non-multi option in Multi question to Radio button]]

[[Make whole cell clickable in single and multi grids]]

[[AutoSum numerical text grid]]

[[Show open textbox in a grid question]]

[[Change progress bar images of questionnaire]]

[[Add CKEditor to an Open question]]

[[Upload images in questionnaire]]

[[Check whether values of open parts of a close question are positive numbers or not]]

Basic Hints

2013-11-11T06:59:39Z

CGHelpdesk:

== Basic Hints ==

Questionnaire viewer is implemented in a way that you can add javascript to manipulate the way your questions are displayed.

jQuery is already included in the viewer, thanks to what javascript has even more powerful effect! (read more about jquery here: [http://jquery.com/ http://jquery.com/])

Javascript is a property on both question and questionnaire levels, which means that you can add javascript for each question or for the whole questionnaire.

The most important features are:

*quest: the current question's object
*questioncheck: the function called before going Next

=== quest ===

Some important properties of quest object:

*quest.questions: array of sub questions
*quest.options: array of answer options

Methods of quest object:

*quest.setQuestions(Array subQuestions): assign an array of question objects to the sub question list of the current question
*quest.setOptions(Array options): assign an array of options to the answer option list of the current question
*quest.setAnswer(string value): assign a value to the question
*quest.getHTML(): returns the HTML which will be rendered to display the question
*quest.onInit(): called right after loading the question
*quest.rotateAnswerOptions(startIndex, endIndex, rotateIndex): rotate answer options in a range specified by startIndex and endIndex, the first item in the range will be rotateIndex
*quest.rotateSubQuestions(startIndex, endIndex, rotateIndex): rotate sub questions in a range specified by startIndex and endIndex, the first item in the range will be rotateIndex
*quest.randomizeAnswerOptions(randomSeed, startIndex, endIndex): randomize answer options in a range specified by startIndex and endIndex, the order is unique for each randomSeed
*quest.randomizeSubQuestions(randomSeed, startIndex, endIndex):randomize sub questions in a range specified by startIndex and endIndex, the order is unique for each randomSeed 

=== questioncheck() ===

We need to override this function to get rid of the default question check supported by the questionnaire viewer, it is a must when showing more than one questions in the same page. The function returns true when there is nothing wrong and false otherwise.

There is an object which should be used to display errors: ErrorMessages.

*ErrorMessages.getInstance().clearErrorMessages(): clear all existing error messages
*ErrorMessages.getInstance().showErrorMessage(msg): show an error message

If you want to extend the questioncheck function with special cases then you should re-create the questioncheck function carefully, because else you will create an endless loop. If you get a stack overflow error from the browser, then your problem should be solved by the following script pattern:

<source lang="javascript">// Store a reference to the default question check
var defaultQuestionCheck = questioncheck;

// Implement your own question check routine
var questioncheck = function()
{
// Call the default question check
// If it fails
if (!defaultQuestionCheck())
// Then return at once with false
return false;

// Catch exceptions, this is just for precaution
try
{
// Optimistic assumption that everything is OK
var valid = true;

// Do your customized question checks here set variable
// valid to false if the question is answered incorrectly

if (!valid)
{
// You might want to clear default error messages given
ErrorMessages.getInstance().clearErrorMessages();

// Add your own error message
ErrorMessages.getInstance().showErrorMessage("An error message");

// Terminate the question check by returning false
return false;
}
}
catch(e)
{
// Inform about the reason for the exception
alert(e.message);

// And return false
return false;
}

// Everything is OK
return true;
}</source>

== Technical tips ==

=== Include an external script library ===

In case we want to use external javascript libraries hosted on external servers (like google), we need to include the library link to quest.onInit. A simple method of doing so is using jquery's getScript method ([http://docs.jquery.com/Ajax/jQuery.getScript#urlcallback http://docs.jquery.com/Ajax/jQuery.getScript#urlcallback])

'''Example:''' <source lang="javascript">
$.getScript("http://ui.jquery.com/testing/ui/ui.datepicker.js", function()
{
//the library is now ready to use
}
);
</source>

Do not include a js library as an attachment in a question's script, otherwise you will have a problem with resource access when respondents view the questionnaire. '''Solution for this''': if the script is short, copy it and put directly into the question/questionnaire's script, if it is big, find an external host (ex: google host). If you still wants to go with attachment, then create a new group with observer access to the attachments, add a dummy question in the questionnaire to add the current user to the group automatically, also add anonymous user to the group.

2013-11-11T04:39:03Z

CGHelpdesk: Created page with "a"

Check whether values of open parts of a close question are positive numbers or not

2013-11-11T04:34:02Z

CGHelpdesk:

== Check whether values of open parts of a close question are positive numbers or not ==

=== Description ===

This solution will check whether values of open parts of a close question (single question type or multi question type) are positive numbers or not.

[[File:OpenPart closeQuestion.jpg]]

=== How To Use ===

*'''Edit the qName and openPartIndexes values in the below script.'''

<source lang="javascript">
/**
* Check whether values of open parts of a close question are positive numbers or not
* @param {String} qName The name of the close question (case sensitive)
* @param {Array} openPartIndexes The indexes of the open parts
* @return {Boolean} return true if valid, false if invalid
* Ex: validate_Open_Parts_Of_Close_Question('Sp7', [2,3]); // Means check whether values of open parts of answer options 2,3 of the close
* // question Sp7 are positive numbers or not
*/
function validate_Open_Parts_Of_Close_Question(qName, openPartIndexes) {
function isPositiveNumber(n) {
var isNo = !isNaN(parseFloat(n)) && isFinite(n);
return isNo && (Number(n) >= 0) ? true : false;
}

if(!questioncheck())
return false;

var isValid = true;
$.each(openPartIndexes, function(i, opIndex) {
var opTxtBoxName = 'QUESTION.' + qName + '.Open.' + opIndex;
var opValue = $('input[type=text][name=' + opTxtBoxName + ']').val();
if(opValue !== '' && !isPositiveNumber(opValue)) {
isValid = false;
return false; // break this each loop
}
});

if(!isValid) {
alert('Værdien skal være et tal.');
return false;
}

return true;
}

quest.next = function() {
// Valiate the open parts of close question to make sure their values are positive numbers
var qName = 'Sp7'; // Change your close question name here
var openPartIndexes = [2]; // Set the open part indexes which want to validate values here
var isValid = validate_Open_Parts_Of_Close_Question(qName, openPartIndexes);
if(!isValid)
return false;

document["query"]["dir"].value = "next";
return true;
};
</source>

*'''Put the script to below location of your close question in the questionnaire editor'''

[[File:Question Javascript Property.jpg]]