Catglobe Wiki - User contributions [en]

Microsoft login Customer Admin

2025-10-31T07:26:58Z

Nguyentrantri:

[[Category:Guides]]
Documentation for Customer admins:

= Configure your Entra to login to Catglobe =

Congratulations, instead of having to deal with usernames and password on your Catglobe based application you can now use Microsoft Entra login to access.

== Information you need ==

Your Catglobe contact should have given you:

1. The url to the Catglobe powered application.

2. A list of roles you need to give to your users

==== Configuration steps ====

1. Open the Url and click "Login with Microsoft".

[[File:mslogin.png]]

2. You should see a page informing you that your Tenant is new. Complete the registration process by clicking "Register".

[[File:regisTenant.png]]

3. If it says your tenant is already pending approval, someone else already did step 2.

4. The Catglobe application now appears in your list of Enterprise applications in your tenant configuration.

[[File:CustommerAdmin.jpg]]

5. Add groups as you desire and assign them a Catglobe App role as instructed.

[[File:customeradmin202.png]]

6. Add users to your groups.

7. Your users can now click the 'Login with Microsoft' button on the login page and will get the roles you have assigned to them.

[[File:mslogin.png]]

File:CustommerAdmin.jpg

2025-10-31T07:23:27Z

Nguyentrantri:

ResourceEdit class

2025-09-09T07:47:22Z

Nguyentrantri:

{{CGscriptClass_Template
|Name=<nowiki>ResourceEdit</nowiki>
|Description=<nowiki>Generic class for editing resources</nowiki>
|InheritsFrom=object|Methods=
{{CGscriptMethods_Template|ReturnType=string|Name=<nowiki>ToString</nowiki>|Inherited=object|Description=<nowiki>The string representation of the object.</nowiki>}}
|Properties=
{{CGscriptProperties_Template|ReturnType=bool|Name=<nowiki>CalculatedManHours</nowiki>|HasGetter=1|HasSetter=1|Description=<nowiki>Get/set calculated man hours flag</nowiki>}}
{{CGscriptProperties_Template|ReturnType=bool|Name=<nowiki>HasResourceTemplateId</nowiki>|HasGetter=1|Description=<nowiki>Indicates if resource can be templated</nowiki>}}
{{CGscriptProperties_Template|ReturnType=bool|Name=<nowiki>InheritAccess</nowiki>|HasGetter=1|HasSetter=1|Description=<nowiki>Get/set inherit access flag</nowiki>}}
{{CGscriptProperties_Template|ReturnType=string|Name=<nowiki>Name</nowiki>|HasGetter=1|HasSetter=1|Description=<nowiki>Get/set the resource name</nowiki>}}
{{CGscriptProperties_Template|ReturnType=string|Name=<nowiki>ObjectTypeName</nowiki>|HasGetter=1|Description=<nowiki>The name of the type of object.</nowiki>}}
{{CGscriptProperties_Template|ReturnType=int|Name=<nowiki>ParentId</nowiki>|HasGetter=1|HasSetter=1|Description=<nowiki>Get/set the parent resource id</nowiki>}}
{{CGscriptProperties_Template|ReturnType=string|Name=<nowiki>ResourceManHours</nowiki>|HasGetter=1|HasSetter=1|Description=<nowiki>Get/set resource man hours</nowiki>}}
{{CGscriptProperties_Template|ReturnType=int|Name=<nowiki>ResourceTemplateId</nowiki>|HasGetter=1|HasSetter=1|Description=<nowiki>Get/set resource template id</nowiki>}}
{{CGscriptProperties_Template|ReturnType=bool|Name=<nowiki>TimeregEnabled</nowiki>|HasGetter=1|HasSetter=1|Description=<nowiki>Get/set timereg enabled flag</nowiki>}}
{{CGscriptProperties_Template|ReturnType=TypeInformation|Name=<nowiki>TypeInformation</nowiki>|HasGetter=1|Inherited=object|Description=<nowiki>Get information about this class.</nowiki>}}
}}

Upload images in questionnaire

2019-04-05T11:11:11Z

Nguyentrantri: /* Source */

= Introduction =

We have a client who wants respondents to be able to upload images in a questionnaire

= Solution =

When the recipient open the answer sheet to answer, we will create the new folder whose name is recipient's name under the questionnaire then store the images that the he uploads in the image tab of this new created folder.

= How to do it =

== Requirement ==

*The user template of the recipients must have the navigation access to open the Image tab of the Folder and upload the images in this image tab.

== Step 1: Preparation ==

* In the group list, create the group containing the recipients and grant the needed navigation accesses to this group

* In the folder list, create the folder containing all the recipient's folder.

* Check the folder template resource id that the folder will use.

== Step 2: Create the new folder for the recipient ==

(You can see the script in the workflow whose resource id is 45408 in cg.catglobe.com)

<source lang="javascript" line="1">
array para = Workflow_getParameters();
number userId = para[0];

number ImageFolderResourceId = 45406;
number FolderTemplateResourceId = 2071;

array newFolder ;
number userResourceId = User_getResourceIdFromUserId(userId);
array userinfo = User_getUserByResourceId(userResourceId);
string ExistedFolderName = getNameFromResourceUniqueId(ImageFolderResourceId) + "\\"+ userinfo[USER_NAME];
array ExistedFolder = Folder_getFolderByName(ExistedFolderName);

if (ExistedFolder == empty)
{
newFolder = Folder_new(userinfo[USER_NAME],FolderTemplateResourceId ,ImageFolderResourceId);
Folder_save(newFolder);
}
else
{
newFolder = ExistedFolder ;
}
array permissions = {{userId , "FullControl"}};
updateUserPermission(newFolder[FOLDER_RESOURCE_ID], permissions);
string guid = getResourceGuid(newFolder[FOLDER_RESOURCE_ID]);
return getResourceIdFromGuid(guid);
</source>

== Step 3: Set up the questionnaire ==

(You can see the questionnaire whose resource id is 1219174 in cg.catglobe.com)

=== Step 3.1 : Create the dummy question for storing the folder id ===

We will call the workflow in step 2 to get the new created folder id of recipient

=== Step 3.2 : Add the following script to the questionnaire ===

Paste this code below into Javascript tab of the questionnaire

<source lang="javascript" line="1">
/*---------------------------------------------------------------------------------------------------------------
Server info
---------------------------------------------------------------------------------------------------------------*/
var ServerInfo =
{
"rootPath" : window.location.protocol+"//"+window.location.host
}

/*---------------------------------------------------------------------------------------------------------------
ResourceType enumeration
---------------------------------------------------------------------------------------------------------------*/
var ResourceType =
{
"Folder":"Folder"
};

//
// IFrame
//
function IFrame(parentElement)
{
// Create the iframe which will be returned
var iframe = document.createElement("iframe");

// If no parent element is specified then use body as the parent element
if(parentElement == null)
parentElement = document.body;

// This is necessary in order to initialize the document inside the iframe
parentElement.appendChild(iframe);

// Get the document object of the IFrame
iframe.getDocument = function()
{
// Depending on browser platform get the iframe's document, this is only
// available if the iframe has already been appended to an element which
// has been added to the document

var doc;

if(this.contentDocument)
// Firefox, Opera
doc = this.contentDocument;
else if(this.contentWindow)
// Internet Explorer
doc = this.contentWindow.document;
else if(this.document)
// Others?
doc = this.document;

// If we did not succeed in finding the document then throw an exception
if(doc == null)
throw "Document not found, append the parent element to the DOM before creating the IFrame";

return doc;
}

// Set iframe source
iframe.setSource = function(src)
{
// Set the source
this.src = src;

// Initialize the iframe's document
this.doc = this.getDocument();

// Open and close the iframe's document, this will allow us to manipulate
// the iframe's contents by script
iframe.doc.open();
iframe.doc.close();
}
// Set iframe source
iframe.setWidth = function(width)
{
// Set the width
this.width = width;
}
// Set iframe source
iframe.setHeight = function(height)
{
// Set the height
this.height = height;
}

// Initiate the iframe's document property
iframe.doc = iframe.getDocument();

// Open and close the iframe's document, this will allow us to manipulate
// the iframe's contents by script
iframe.doc.open();
iframe.doc.close();

// Return the iframe, now with an extra property iframe.doc containing the
// iframe's document
return iframe;
}

/*---------------------------------------------------------------------------------------------------------------
AttachmentList question control
---------------------------------------------------------------------------------------------------------------*/

function ImageList(elementContainer, width,height,viewimage)
{
this._elementContainer = elementContainer;
this._iframe = new IFrame(this._elementContainer);
$(this._iframe)
.attr("id", "ImageListIFrame")
.bind("load",
function()
{
if(this.src == '')
return;
if (viewimage == "off")
{
$('#ImageListIFrame').contents().find('#ImagesximageGrid_main').hide();
$('#ImageListIFrame').contents().find('#Imagesxtoolbar_Item_1').hide();
$('#ImageListIFrame').contents().find('#Imagesxtoolbar_Item_2').hide();
$('#ImageListIFrame').contents().find('#Imagesxtoolbar_Item_3').hide();

}
else
{
$('#ImageListIFrame').contents().find('#Imagesxtoolbar').hide();
$('#ImageListIFrame').contents().find('#ImagesximageGrid_c_0_2').hide();
$('#ImageListIFrame').contents().find('#ImagesximageGrid_rc_0_2').hide();
$('#ImageListIFrame').contents().find('#ImagesximageGrid_rc_1_2').hide();
$('#ImageListIFrame').contents().find('#ImagesximageGrid_rc_2_2').hide();
$('#ImageListIFrame').contents().find('#ImagesximageGrid_rc_3_2').hide();
$('#ImageListIFrame').contents().find('#ImagesximageGrid_rc_4_2').hide();
$('#ImageListIFrame').contents().find('#ImagesximageGrid_rc_5_2').hide();
$('#ImageListIFrame').contents().find('#ImagesximageGrid_rc_6_2').hide();
$('#ImageListIFrame').contents().find('#ImagesximageGrid_rc_7_2').hide();
$('#ImageListIFrame').contents().find('#ImagesximageGrid_rc_8_2').hide();
$('#ImageListIFrame').contents().find('#ImagesximageGrid_rc_9_2').hide();
$('#ImageListIFrame').contents().find('#ImagesximageGrid_rc_10_2').hide();
$('#ImageListIFrame').contents().find('#ImagesximageGrid_rc_11_2').hide();
$('#ImageListIFrame').contents().find('#ImagesximageGrid_rc_12_2').hide();
$('#ImageListIFrame').contents().find('#ImagesximageGrid_rc_13_2').hide();
$('#ImageListIFrame').contents().find('#ImagesximageGrid_rc_14_2').hide();
$('#ImageListIFrame').contents().find('#ImagesximageGrid_rc_15_2').hide();
}
});
if (width != null)
this._iframe.setWidth(width);
if (height != null)
this._iframe.setHeight(height);
}

//ImageList.path = "{rootPath}/Common/Resources/View/ContainerPage.aspx?tabtype=Images&type={type}&id={id}&isportal=false";
ImageList.path = "{rootPath}/Common/Resources/View/ContainerPage.aspx?tabtype=Images&type={type}&id={id}&isportal=false";

ImageList.prototype =
{

createImageListUrl: function(type, id)
{
return ImageList.path
.replace("{rootPath}", ServerInfo.rootPath)
.replace("{type}", type)
.replace("{id}", id);
},

setFolderId: function(FolderId)
{
$(this._iframe)
.attr("src", this.createImageListUrl(ResourceType.Folder, FolderId));
},

getImages: function()
{
var Name = 1;
var nameList = new Array();

with(this._iframe.contentWindow)
{

var grid = getCGExecuter().getGridUtilities().getGrid(__gridClientId);

for (var rowIndex = 0; rowIndex <grid.Rows.length; rowIndex ++)
{

nameList.push(grid.Rows.rows[rowIndex].getCell(Name).getValue());

}
}

return nameList;
},
/* getGUIDs: function()
{
var Name = 2;
var nameList = new Array();

with(this._iframe.contentWindow)
{

var grid = getCGExecuter().getGridUtilities().getGrid(__gridClientId);
var guidtext;
for (var rowIndex = 0; rowIndex <grid.Rows.length; rowIndex ++)
{
guid = grid.Rows.rows[rowIndex].getCell(Name).getValue();
nameList.push(jQuery.trim(guid.split('<a')[0]));

}
}

return nameList;
}
*/
getGUIDs: function()
{
var Name = 2;
var nameList = new Array();
with(this._iframe.contentWindow)
{

guid = '{{D_GUID}}';
alert("nham"+guid);
nameList.push(jQuery.trim(guid.split('<a')[0]));
}
return nameList;
}
}
/*---------------------------------------------------------------------------------------------------------------
End JAVA_SCRIPT of QUESTIONNAIRE
---------------------------------------------------------------------------------------------------------------*/
</source>

=== Step 3.3 : Create the question for showing the upload form ===

Paste this code below into Javascript tab of that question

<source lang="javascript" line="1">
Question.bind('afterShowQuestion', function(question, answerSheet, element) {
$('.cg-ui-input').hide();
var folderid = '{{D_Current_Folder_Id}}';
var dlg;
$.getScript("../../Script/ServerMethods/ServerMethods.js", function(){
$.getScript("../../Script/XmlParser/xmlp.js", function(){
ServerMethods.registerMethod(new Method(TYPE_ARRAY,'GetImageInfo',false,null,'~/Common/Resources/View/ImagesTab.ascx',new Parameter(TYPE_INT, 'imagepk')));
openImagedialog();
});
});//END getScript LV1
//SUB FUNCTION
function openImagedialog() {
window.getActiveDialog = function(body) {
var strBody = $(body).prop('outerHTML');
var imageId = parseInt(strBody.substring(strBody.lastIndexOf("addList(")+8,strBody.lastIndexOf(",'Add')")));
//console.log(imageId);
Question.attr('answer', imageId);
//console.log(Question);
$(parent.document).find('.ui-widget-overlay').remove();
$(parent.document).find('.ui-dialog').remove();
$('#comUp').text('An Image has just been uploaded. Please click "Next" button to continue');

return {papa: {}};
};
var virtualAppHost = window.location.origin;
var url = virtualAppHost + "/Common/ResourceExplorer/EditImagePage.aspx?afn=Images/Resources&parenttype=6" +
"&parentid=" + folderid;
var $dialog = $('<div></div>')
.html('<iframe style="border: 0px; " src="' + url + '" width="100%" height="100%"></iframe>')
.dialog({
autoOpen: false,
modal: true,
height: 190,
width: 463,
title: "Add new image"
});
$dialog.dialog('open');
}

});
</source>
== Source ==
Questionnaire Resource Id on cg.catglobe.com site: 1219174

Upload images in questionnaire

2019-04-05T11:10:14Z

Nguyentrantri: Update for new viewer

Upload images in questionnaire

2019-04-05T11:08:31Z

Nguyentrantri: Update for new viewer

= Introduction =

We have a client who wants respondents to be able to upload images in a questionnaire

= Solution =

When the recipient open the answer sheet to answer, we will create the new folder whose name is recipient's name under the questionnaire then store the images that the he uploads in the image tab of this new created folder.

= How to do it =

== Requirement ==

*The user template of the recipients must have the navigation access to open the Image tab of the Folder and upload the images in this image tab.

== Step 1: Preparation ==

* In the group list, create the group containing the recipients and grant the needed navigation accesses to this group

* In the folder list, create the folder containing all the recipient's folder.

* Check the folder template resource id that the folder will use.

== Step 2: Create the new folder for the recipient ==

(You can see the script in the workflow whose resource id is 45408 in cg.catglobe.com)

<source lang="javascript" line="1">
array para = Workflow_getParameters();
number userId = para[0];

number ImageFolderResourceId = 45406;
number FolderTemplateResourceId = 2071;

array newFolder ;
number userResourceId = User_getResourceIdFromUserId(userId);
array userinfo = User_getUserByResourceId(userResourceId);
string ExistedFolderName = getNameFromResourceUniqueId(ImageFolderResourceId) + "\\"+ userinfo[USER_NAME];
array ExistedFolder = Folder_getFolderByName(ExistedFolderName);

if (ExistedFolder == empty)
{
newFolder = Folder_new(userinfo[USER_NAME],FolderTemplateResourceId ,ImageFolderResourceId);
Folder_save(newFolder);
}
else
{
newFolder = ExistedFolder ;
}
array permissions = {{userId , "FullControl"}};
updateUserPermission(newFolder[FOLDER_RESOURCE_ID], permissions);
string guid = getResourceGuid(newFolder[FOLDER_RESOURCE_ID]);
return getResourceIdFromGuid(guid);
</source>

== Step 3: Set up the questionnaire ==

(You can see the questionnaire whose resource id is 1219174 in cg.catglobe.com)

=== Step 3.1 : Create the dummy question for storing the folder id ===

We will call the workflow in step 2 to get the new created folder id of recipient

=== Step 3.2 : Add the following script to the questionnaire ===

Paste this code below into Javascript tab of the questionnaire

<source lang="javascript" line="1">
/*---------------------------------------------------------------------------------------------------------------
Server info
---------------------------------------------------------------------------------------------------------------*/
var ServerInfo =
{
"rootPath" : window.location.protocol+"//"+window.location.host
}

/*---------------------------------------------------------------------------------------------------------------
ResourceType enumeration
---------------------------------------------------------------------------------------------------------------*/
var ResourceType =
{
"Folder":"Folder"
};

//
// IFrame
//
function IFrame(parentElement)
{
// Create the iframe which will be returned
var iframe = document.createElement("iframe");

// If no parent element is specified then use body as the parent element
if(parentElement == null)
parentElement = document.body;

// This is necessary in order to initialize the document inside the iframe
parentElement.appendChild(iframe);

// Get the document object of the IFrame
iframe.getDocument = function()
{
// Depending on browser platform get the iframe's document, this is only
// available if the iframe has already been appended to an element which
// has been added to the document

var doc;

if(this.contentDocument)
// Firefox, Opera
doc = this.contentDocument;
else if(this.contentWindow)
// Internet Explorer
doc = this.contentWindow.document;
else if(this.document)
// Others?
doc = this.document;

// If we did not succeed in finding the document then throw an exception
if(doc == null)
throw "Document not found, append the parent element to the DOM before creating the IFrame";

return doc;
}

// Set iframe source
iframe.setSource = function(src)
{
// Set the source
this.src = src;

// Initialize the iframe's document
this.doc = this.getDocument();

// Open and close the iframe's document, this will allow us to manipulate
// the iframe's contents by script
iframe.doc.open();
iframe.doc.close();
}
// Set iframe source
iframe.setWidth = function(width)
{
// Set the width
this.width = width;
}
// Set iframe source
iframe.setHeight = function(height)
{
// Set the height
this.height = height;
}

// Initiate the iframe's document property
iframe.doc = iframe.getDocument();

// Open and close the iframe's document, this will allow us to manipulate
// the iframe's contents by script
iframe.doc.open();
iframe.doc.close();

// Return the iframe, now with an extra property iframe.doc containing the
// iframe's document
return iframe;
}

/*---------------------------------------------------------------------------------------------------------------
AttachmentList question control
---------------------------------------------------------------------------------------------------------------*/

function ImageList(elementContainer, width,height,viewimage)
{
this._elementContainer = elementContainer;
this._iframe = new IFrame(this._elementContainer);
$(this._iframe)
.attr("id", "ImageListIFrame")
.bind("load",
function()
{
if(this.src == '')
return;
if (viewimage == "off")
{
$('#ImageListIFrame').contents().find('#ImagesximageGrid_main').hide();
$('#ImageListIFrame').contents().find('#Imagesxtoolbar_Item_1').hide();
$('#ImageListIFrame').contents().find('#Imagesxtoolbar_Item_2').hide();
$('#ImageListIFrame').contents().find('#Imagesxtoolbar_Item_3').hide();

}
else
{
$('#ImageListIFrame').contents().find('#Imagesxtoolbar').hide();
$('#ImageListIFrame').contents().find('#ImagesximageGrid_c_0_2').hide();
$('#ImageListIFrame').contents().find('#ImagesximageGrid_rc_0_2').hide();
$('#ImageListIFrame').contents().find('#ImagesximageGrid_rc_1_2').hide();
$('#ImageListIFrame').contents().find('#ImagesximageGrid_rc_2_2').hide();
$('#ImageListIFrame').contents().find('#ImagesximageGrid_rc_3_2').hide();
$('#ImageListIFrame').contents().find('#ImagesximageGrid_rc_4_2').hide();
$('#ImageListIFrame').contents().find('#ImagesximageGrid_rc_5_2').hide();
$('#ImageListIFrame').contents().find('#ImagesximageGrid_rc_6_2').hide();
$('#ImageListIFrame').contents().find('#ImagesximageGrid_rc_7_2').hide();
$('#ImageListIFrame').contents().find('#ImagesximageGrid_rc_8_2').hide();
$('#ImageListIFrame').contents().find('#ImagesximageGrid_rc_9_2').hide();
$('#ImageListIFrame').contents().find('#ImagesximageGrid_rc_10_2').hide();
$('#ImageListIFrame').contents().find('#ImagesximageGrid_rc_11_2').hide();
$('#ImageListIFrame').contents().find('#ImagesximageGrid_rc_12_2').hide();
$('#ImageListIFrame').contents().find('#ImagesximageGrid_rc_13_2').hide();
$('#ImageListIFrame').contents().find('#ImagesximageGrid_rc_14_2').hide();
$('#ImageListIFrame').contents().find('#ImagesximageGrid_rc_15_2').hide();
}
});
if (width != null)
this._iframe.setWidth(width);
if (height != null)
this._iframe.setHeight(height);
}

//ImageList.path = "{rootPath}/Common/Resources/View/ContainerPage.aspx?tabtype=Images&type={type}&id={id}&isportal=false";
ImageList.path = "{rootPath}/Common/Resources/View/ContainerPage.aspx?tabtype=Images&type={type}&id={id}&isportal=false";

ImageList.prototype =
{

createImageListUrl: function(type, id)
{
return ImageList.path
.replace("{rootPath}", ServerInfo.rootPath)
.replace("{type}", type)
.replace("{id}", id);
},

setFolderId: function(FolderId)
{
$(this._iframe)
.attr("src", this.createImageListUrl(ResourceType.Folder, FolderId));
},

getImages: function()
{
var Name = 1;
var nameList = new Array();

with(this._iframe.contentWindow)
{

var grid = getCGExecuter().getGridUtilities().getGrid(__gridClientId);

for (var rowIndex = 0; rowIndex <grid.Rows.length; rowIndex ++)
{

nameList.push(grid.Rows.rows[rowIndex].getCell(Name).getValue());

}
}

return nameList;
},
/* getGUIDs: function()
{
var Name = 2;
var nameList = new Array();

with(this._iframe.contentWindow)
{

var grid = getCGExecuter().getGridUtilities().getGrid(__gridClientId);
var guidtext;
for (var rowIndex = 0; rowIndex <grid.Rows.length; rowIndex ++)
{
guid = grid.Rows.rows[rowIndex].getCell(Name).getValue();
nameList.push(jQuery.trim(guid.split('<a')[0]));

}
}

return nameList;
}
*/
getGUIDs: function()
{
var Name = 2;
var nameList = new Array();
with(this._iframe.contentWindow)
{

guid = '{{D_GUID}}';
alert("nham"+guid);
nameList.push(jQuery.trim(guid.split('<a')[0]));
}
return nameList;
}
}
/*---------------------------------------------------------------------------------------------------------------
End JAVA_SCRIPT of QUESTIONNAIRE
---------------------------------------------------------------------------------------------------------------*/
</source>

=== Step 3.3 : Create the question for showing the upload form ===

Paste this code below into Javascript tab of that question

<source lang="javascript" line="1">
/*-------------------------------------------------------------------------
Set initial information for the uploading image
-------------------------------------------------------------------------*/
quest.onInit = function()
{
quest.ImageList = new ImageList($("#attachmentContainer").get(0), "800px","400px" );
quest.ImageList.setFolderId('{{D_Current_Folder_Id}}');
$("#attachmentContainer").append($("<input name='QUESTION.D_Image_Guid' type='hidden'>"));
}

/*-------------------------------------------------------------------------
- Validate the question. Automaticaly called.
- You must upload at least 1 image
-------------------------------------------------------------------------*/
function questioncheck()
{
// Subscription form valid variable
var valid = true;
ErrorMessages.getInstance().clearErrorMessages();
var list = quest.ImageList.getImages();
if (list.length < 1)
{
ErrorMessages.getInstance().showErrorMessage('You must upload at least 1 image.');
valid = false;
}
// Return result of validation
var getGuid = quest.ImageList.getGUIDs();
$("input[name$='QUESTION.D_Image_Guid']").val(getGuid);
return valid;
}

/*---------------------------------------------------------------------------------------------------------------
End JAVA_SCRIPT of QUESTION Insert_Image
---------------------------------------------------------------------------------------------------------------*/

</source>
== Source ==
Questionnaire Resource Id on cg.catglobe.com site: 75216

SetResource

2018-07-27T05:09:49Z

Nguyentrantri: fix text

[[Category:Resource_Functions]]

{{HelpFiles}} __FORCETOC__

It is used to set the resource used in
getBoolConstant,
getBooleanConstant,
getNumberConstant,
getStringConstant,
getDateTimeConstant,
getSingleConstant,
getSingleConstantSelectedText,
getMultiConstant,
getMultiConstantSelectedTexts,

== Syntax ==

setResource(string resourceGUID);

== Arguments ==
''resourceGUID'': string.

== Return type ==
Empty

== Example ==

<source lang="javascript">
setResource("F04731D2-23A7-4877-BE75-6E8C027E3B4E");
</source>

Category:Import module

2016-12-23T10:04:33Z

Nguyentrantri:

[[Category:Help_Files]]
==Import module==

The import module of Catglobe can do two things

# Add and update user information into Catglobe
# Add and update data of questionnaire in Catglobe

To access the Import Module you should go to

Tools-> Data -> Data Import Wizard

The wizard can import both new user and questionnaire data, or a combination of both. It can also update existing users’ information and data if you know the required foreign keys of the places to which you want to import.

The following file will lead you through the 5 steps of the import wizard. If you wish to learn more on the rules of importing specific user information and data you can look at the detailed help files under this file! Links will be show where applicable in the text.

== Step 1: Choosing the data you will import ==

In this step we can choose a source file containing the user and questionnaire data we want to import. The only format that is currently supported for import is MS excel (97-2015 formats).

[[File:5849.png|500px|Import1]]

Choose file to import from: Click browse to select a file containing data we want to import. This file must be an .xls or .xlsx file. If not, we will receive an error message and must choose a file of the correct format.

Work sheet: This drop down list will display all the work sheets in the MS excel file we have selected. In other words it is only possible for us to import from one work sheet at a time.

Source Data Preview: Whenever we select a work sheet, the grid below source data preview will show the data inside this work sheet. As it is only for previewing, it will display no more than 20 rows.

Header row: If this check box is checked, the system will understand that the first row of the import file is the header, and the real data is from the second row to end. Otherwise, the system will create headers F1, F2, etc. and all of the content of the work sheet will be imported.

User id column (optional): This drop down list displays all the headers of the file. In case we want to use existing user in the import job, we have to select a column containing users’ id. Otherwise, we should leave it blank. Already in this step we have to decide whether we are importing data to existing users or new users. It is NOT possible to import to both new and existing users in the same import. Please click here to read more on the “User Id” column.

==Step 2: Choosing where to import the data to==

This step allows us to specify some general filters on what we want to import and where the data should be imported to.

[[Image:5850.png|500px|ImportWiza2]]

Choose a group to import users to (optional): When importing users we can choose one group into which the users can be added no matter whether they are new users or existing users. We can search for an existing group by using Search function or create a new group by clicking the Add button (the plus sign). By clicking the Reset button we can clear this field.

If this field does not have a value the system may instead look for group id’s in our imported MS excel data to find out if the imported users should be attached to some group. Using the MS excel gives us the added flexibility of importing each user to different groups. To read more on importing users to groups, please [[_Field:_Group_|click here]].

User name mask: Makes it possible for us to specify how the user name of new created users will look. Please [[_Field:_User_Username_|click here]] to read more on the import of user names.

Import user information: Checking this check box allows us to add core information to new users or to update existing users’ core information. The core information that will be allowed you to import in the next step is:

* User name: [[_Field:_User_Username_|click here]] to learn more!
* Password: [[_Field:_User_Password_|click here]] to learn more!
* First name: [[_Field:_First_name_|click here]] to learn more!
* Middle name: [[_Field:_Middle_name_|click here]] to learn more!
* Last name: [[_Field:_Last_name_|click here]] to learn more!
* E-mail address: [[_Field:_User_Email_|click here]] to learn more!
* Language: [[_Field:_Language_|click here]] to learn more!
* Currency: [[_Field:_Currency_|click here]] to learn more!
* Culture: [[_Field:_Culture_|click here]] to learn more!

Import phone number information: Checking this check box allow us to import/update users’ phone numbers and fax numbers. [[_Field:_Phone_number_types_|Click here]] to read more on what columns in Catglobe you can import these numbers to.

Import address information: Checking this check box allow us to add address information to new users or to update existing users’ address information. The address information that will be allowed you to import in the next step is:

* Address: [[_Field:_User_Address_|click here]] to learn more!
* City: [[_Field:_User_City_|click here]] to learn more!
* Region: [[_Field:_User_Region_|click here]] to learn more!
* Zip code: [[_Field:_User_Zipcode_|click here]] to learn more!
* Postbox: [[_Field:_Postbox_|click here]] to learn more!
* Web site: [[_Field:_Website_|click here]] to learn more!
* Country: [[_Field:_User_CountryId_|click here]] to learn more!

Import points information: Checking this check box allow us to insert or withdraw points to new or existing users points accounts in Catglobe. The point information that will be allowed you to import in the next step is:

* Points: [[_Field:_User_Points_|click here]] to learn more!
* Points timestamp: [[_Field:_Points_timestamp_|click here]] to learn more!
* Points description: [[_Field:_Points_description_|click here]] to learn more!

Import qualifications: Checking this check box allow us to insert or update qualification of new or existing users. The qualification information that will be allowed you to import in the next step is:

* Qualification: [[_Field:_Qualification_|click here]] to learn more!
* Qualification Level: [[_Field:_Qualification_level_|click here]] to learn more!

Generate passwords: If the check box is checked, the system will create random passwords for users. Since you may also choose to import passwords specified in excel and passwords can also be fixed password, please refer to the [[_Field:_User_Password_|following file]] to learn more.

Choose a questionnaire to import data to (optional): If you wish to also import data for the existing or new users you have specified, you need to choose the questionnaire into which this data will be placed. This of course means that you will need to make sure that the data you import fits with the questions available in the questionnaire. It is possible using the import function to add and update data for users, so be careful what you do. Use the button with the magnifying glass to find the questionnaire you wish to import to.

Import multi questions from comma separated format: When this column is checked, then the format of multi questions will be expected to have all true answer options listed by their answer option id, rather than by the traditional binary format. E.g. instead of the format "0101" it should get "2,4" or "4,2". The advantage of the comma separated format is, that the import can also include the users' selection order as part of the information. "4,2" would mean that the user, when answering the multi question, first chose 4 then 2. "2,4" would have meant the opposite, namely that the user first chose 2 then 4, when checking these two options for the multi question.

If you are importing to existing users you must then choose one of three options. These options specify what will happen with existing questionnaire answer sheet of the questionnaire when importing data.

The three options are:

Option 1: To be chosen when you know that each user has only zero or one questionnaire answer sheet for this questionnaire. By selecting this option, system users must be sure that every imported User has only zero or one questionnaire answer sheet for the selected questionnaire. An error will be shown during the validation step if any users have more than one, when you in the final step of the wizard will try to import and the option is not adhered to in Catglobe.

Option 2: To be chosen when you want to delete all existing questionnaire answer sheet for this questionnaire of the user for whom you are importing data. This option is only available if the current user has the necessary navigation access to do this. If not, the option will be disabled and only options 1 and 3 will be available.

Option 3: Select this option if you have a column specified in the MS excel file you stating the id of the questionnaire answer sheet you will be importing to (Resource_Project_Questionnaire_Id in Catglobe database). If you choose this, a drop down list will appear asking you to specify the column where this data exists. If the user to which you are importing has more answer sheets for the questionnaire of course these will not be affected. If any imported record does not have values in this column it will be seen as an error and the import cannot be carried out. If any ID is not recognized when importing, the row in question will be ignored.

When we import we choose specific questions in the questionnaire to import to. The logic of how the data needs to be set up in our import file depends on the question types we are importing to. The different question types that we have are:

* Text question: [[_Question_type:_Text_question_|click here]] to learn more!
* Number question: [[_Question_type:_Number_question_|click here]] to learn more!
* Single question: [[_Question_type:_Single_question_|click here]] to learn more!
* Multi question: [[_Question_type:_Multi_question_|click here]] to learn more!
* Scale question: [[_Question_type:_Grid_scale_question_|click here]] to learn more!
* Grid single question: [[_Question_type:_Grid_single_question_|click here]] to learn more!
* Grid multi question: [[_Question_type:_Grid_multi_question_|click here]] to learn more!
* Grid scale question: [[_Question_type:_Grid_scale_question_|click here]] to learn more!
* Grid text question: [[_Question_type:_Text_question_|click here]] to learn more!
* Multimedia question: [[_Question_type:_Multimedia_question_|click here]] to learn more!
* Open question: [[_Question_type:_Open_question_|click here]] to learn more!

Auto map: When this check box is checked, the system will automatically map the import file’s columns with those in the system if the headers are exactly the same. Each of the help files that you can find related to this guide tells you what that header must be. If any header is not auto-mapped, columns must be mapped one by one.

If we, for example, want to import the following file into the system for an array of users, we will see two different scenarios in step 3 of the wizard depending on whether we chose auto-map or not.

[[Image:487.gif]]

Below is shown how it will look if auto-map is enabled.

[[Image:5853.png|600px|ImportWiz56-2]]

If auto-map is not enabled nothing will be mapped as shown below.

[[Image:5854.png|500px|ImportNoAutoMap]]

Advanced mode: Check this check box led us to the advanced mode containing more detailed information that you may import to users. Generally most of the columns require that you know exactly what you are doing or you may cause some serious problems to the database. If you are not a super-user, we generally advice you not to use this advanced mode feature. The available columns when clicking this check box are:

* Timereg_Enabled: [[_Field:_Timereg_Enabled_|click here]] to learn more!
* Resource_ManHour: [[_Field:_Resource_Manhour_|click here]] to learn more!
* Disabled_Date: [[_Field:_Disabled_|click here]] to learn more!
* Access_Expiration: [[_Field:_Access_Expiration_|click here]] to learn more!
* Protected_Until_Date: [[_Field:_Protected_Until_Date_|click here]] to learn more!
* Discount_Id: [[_Field:_Discount_Id_|click here]] to learn more!
* Work_Setting_Id: [[_Field:_Work_Setting_Id_|click here]] to learn more!
* Timezone_Id: [[_Field:_Timezone_Id_|click here]] to learn more!

Some advanced columns that you can import to the questionnaire answer sheets are:

* Next_Contact_Datetime: [[_Field:_Next_Contact_Datetime_|click here]] to learn more!
* Question_Index_Sequence: [[_Field:_Question_Index_Sequence_|click here]] to learn more!
* Sample_Rule_Id: [[_Field:_Sample_Rule_Id_|click here]] to learn more!
* Status: [[_Field:_Status_|click here]] to learn more!
* Priority: [[_Field:_Priority_|click here]] to learn more!
* Dedicated_User_Id: [[_Field:_Dedicated_User_Id_|click here]] to learn more!
* Estimated_Completed_Time_Seconds: [[_Field:_Estimated_Completion_Time_Seconds_|click here]] to learn more!

===Step 3: Set group access for newly imported users===

This step allows the logged-in user to set group access for newly imported users. These users must be new and imported to database. In order to import new users, user_id in step 1 must be selected. In addition, the logged-in user is required to select at least one of the following options: "import user information", "Import phone number information", "Import address information", "Import point information", "Import qualifications".

The logged in user could reach this step if he has had group navigation access already.

This grid below allows user to add one or more groups. Each group could have one of three permission level: Administrator, Manager or Observer.

[[Image:5851.png|500px|ImportWiz3]]

The newly imported users (non-anonymous users) have to be managed by at least one group. There must be at least one administrator in the selected groups. The current user must belong to at least one of the selected groups.System would show an error message and user could not move to next step if the selected groups are not correct.

'''Add''': Click Add to open a search control to select groups managing these imported users. These group are added with observer level as default.

'''Remove''': Click Remove to remove highlighted groups out of the group access list.

'''Set level for each group''': Click on level column to pull down access level list to select one of them.

[[Image:2662.png]]

'''Set as default''': Click "Set as default" to set group access default.

An alert will tell him that old his defaults will be replaced by the current records. If he says YES

* No record selected : all will be his defaults (save to his preferences)

* Records selected : all selected records will be his defaults (save to his preferences)

* No record there : it means that user intends to clean up his defaults (save to his preferences)

'''Use default''':

An alert tell him that current records will be cleaned and replaced by his defaults. If he says YES

* His defaults will be loaded and bound to the grid.

User's defaults will be loaded at the same time the page is loaded.

===Step 4: Choosing the User Information you will import===

What will default have been mapped and what destination columns are available in step 3 depends fully on the actions you took in step 2. This step is only used for importing the data for user information. All data to import for questionnaires will come in step 5. Please be careful to go through all columns to make sure that they are mapped correctly. You can map more columns by choosing the source column (columns in your MS Excel file) with destination columns (the place the information will go in Catglobe). All destination columns are explained in help files for this guide so please refer to them if you are not sure how to map your data.

[[Image:5855.png|500px|Imp3]]

Beware that it is here possible to map anything with anything. But if the data do not make sense you will in the last step of the wizard be presented with an error and disallowed execution of the import job.

==Step 5: Choosing the questionnaire answers to import==

Step 5 behaves exactly the same as Step 4. The only difference between them is that step 4 is used for specifying what user information to import while step 5 is used for specifying what questionnaire data to import.

[[Image:5857.png|500px|Imp4]]

==Step 6: Validation of import and final execution==

Step 5 will validate all the data given the validation rules supplied for each importable column. If there are no error (although warning message may exist) the finish button will be activated and the import job can be executed. However, if there are any error messages the finish button will be deactivated and you must correct your import rules or import file accordingly.

[[Image:5858.png|500px|ImpFinal]]
__NOTOC__

Random sub question

2015-10-05T10:44:15Z

Nguyentrantri:

= <span style="font-size:x-large;">Random sub question</span> =

{| width="907" class="tableintopic FCK__ShowTableBorders" style="border-collapse: collapse;" border="0" cellspacing="0" cellpadding="2"
|-
| width="180" height="0" |
| width="84" height="0" |
| width="66" height="0" |
| width="576" height="0" |
| width="0" height="0" |
|- align="left" valign="top"
| width="180" |
'''Purpose:'''

| width="727" colspan="4" |
 

|- align="left" valign="top"
| width="180" |
'''Property name:'''

| width="727" colspan="4" |
RANDOMIZE_SUB_QUESTION

|- align="left" valign="top"
| width="180" |
'''Type:'''

| width="727" colspan="4" |
 

|- align="left" valign="top"
| width="180" |
'''Used for questionnaire:'''

| width="727" colspan="4" |
[[File:8153.png]][[File:8152.png]]

|- align="left" valign="top"
| width="180" |
'''Used for questions:'''

| width="84" |
[[File:8153.png]][[File:8152.png]]

| width="66" |
'''Types:'''

| width="577" |
 

|- align="left" valign="top"
| width="180" |
'''Used for sub-questions:'''

| width="727" colspan="4" |
[[File:8153.png]][[File:8152.png]]

|- align="left" valign="top"
| width="180" |
'''Used for answer options:'''

| width="727" colspan="4" |
[[File:8153.png]][[File:8152.png]]

|- align="left" valign="top"
| width="180" |
'''Example:'''

| width="727" colspan="4" |
 

|}
[[Category:Properties]]

Random sub question

2015-10-05T10:43:54Z

Nguyentrantri: Created page with "= <span style="font-size:x-large;">Random sub question</span> = {| width="907" class="tableintopic FCK__ShowTableBorders" style="border-collapse: collapse;" border="0" cellsp..."

Random answer option

2015-10-05T10:41:28Z

Nguyentrantri:

= <span style="font-size:x-large;">Random answer option</span> =

{| width="907" class="tableintopic FCK__ShowTableBorders" style="border-collapse: collapse;" border="0" cellspacing="0" cellpadding="2"
|-
| width="180" height="0" |
| width="84" height="0" |
| width="66" height="0" |
| width="576" height="0" |
| width="0" height="0" |
|- align="left" valign="top"
| width="180" |
'''Purpose:'''

| width="727" colspan="4" |
 

|- align="left" valign="top"
| width="180" |
'''Property name:'''

| width="727" colspan="4" |
RANDOMIZE_ANSWER_OPTION

|- align="left" valign="top"
| width="180" |
'''Type:'''

| width="727" colspan="4" |
 

|- align="left" valign="top"
| width="180" |
'''Used for questionnaire:'''

| width="727" colspan="4" |
[[File:8153.png]][[File:8152.png]]

|- align="left" valign="top"
| width="180" |
'''Used for questions:'''

| width="84" |
[[File:8153.png]][[File:8152.png]]

| width="66" |
'''Types:'''

| width="577" |
 

|- align="left" valign="top"
| width="180" |
'''Used for sub-questions:'''

| width="727" colspan="4" |
[[File:8153.png]][[File:8152.png]]

|- align="left" valign="top"
| width="180" |
'''Used for answer options:'''

| width="727" colspan="4" |
[[File:8153.png]][[File:8152.png]]

|- align="left" valign="top"
| width="180" |
'''Example:'''

| width="727" colspan="4" |
 

|}
[[Category:Properties]]

Random answer option

2015-10-05T10:40:19Z

Nguyentrantri:

Random answer option

2015-10-05T10:39:38Z

Nguyentrantri:

= <span style="font-size: 12px;">Random answer option</span> =

{| width="907" class="tableintopic FCK__ShowTableBorders" style="border-collapse: collapse;" border="0" cellspacing="0" cellpadding="2"
|-
| width="180" height="0" |
| width="84" height="0" |
| width="66" height="0" |
| width="576" height="0" |
| width="0" height="0" |
|- align="left" valign="top"
| width="180" |
'''Purpose:'''

| width="727" colspan="4" |
 

|- align="left" valign="top"
| width="180" |
'''Property name:'''

| width="727" colspan="4" |
RANDOMIZE_ANSWER_OPTION

|- align="left" valign="top"
| width="180" |
'''Type:'''

| width="727" colspan="4" |
 

|- align="left" valign="top"
| width="180" |
'''Used for questionnaire:'''

| width="727" colspan="4" |
[[File:8153.png]][[File:8152.png]]

|- align="left" valign="top"
| width="180" |
'''Used for questions:'''

| width="84" |
[[File:8153.png]][[File:8152.png]]

| width="66" |
'''Types:'''

| width="577" |
 

|- align="left" valign="top"
| width="180" |
'''Used for sub-questions:'''

| width="727" colspan="4" |
[[File:8153.png]][[File:8152.png]]

|- align="left" valign="top"
| width="180" |
'''Used for answer options:'''

| width="727" colspan="4" |
[[File:8153.png]][[File:8152.png]]

|- align="left" valign="top"
| width="180" |
'''Example:'''

| width="727" colspan="4" |
 

|}

Random answer option

2015-10-05T10:39:11Z

Nguyentrantri:

= <br/> =

= Random answer option =

{| width="907" class="tableintopic FCK__ShowTableBorders" style="border-collapse: collapse;" border="0" cellspacing="0" cellpadding="2"
|-
| width="180" height="0" |
| width="84" height="0" |
| width="66" height="0" |
| width="576" height="0" |
| width="0" height="0" |
|- align="left" valign="top"
| width="180" |
'''Purpose:'''

| width="727" colspan="4" |
 

|- align="left" valign="top"
| width="180" |
'''Property name:'''

| width="727" colspan="4" |
RANDOMIZE_ANSWER_OPTION

|- align="left" valign="top"
| width="180" |
'''Type:'''

| width="727" colspan="4" |
 

|- align="left" valign="top"
| width="180" |
'''Used for questionnaire:'''

| width="727" colspan="4" |
[[File:8153.png]][[File:8152.png]]

|- align="left" valign="top"
| width="180" |
'''Used for questions:'''

| width="84" |
[[File:8153.png]][[File:8152.png]]

| width="66" |
'''Types:'''

| width="577" |
 

|- align="left" valign="top"
| width="180" |
'''Used for sub-questions:'''

| width="727" colspan="4" |
[[File:8153.png]][[File:8152.png]]

|- align="left" valign="top"
| width="180" |
'''Used for answer options:'''

| width="727" colspan="4" |
[[File:8153.png]][[File:8152.png]]

|- align="left" valign="top"
| width="180" |
'''Example:'''

| width="727" colspan="4" |
 

|}

Random answer option

2015-10-05T10:38:37Z

Nguyentrantri:

= Random answer option =

{| width="907" class="tableintopic FCK__ShowTableBorders" style="border-collapse: collapse;" border="0" cellspacing="0" cellpadding="2"
|-
| width="180" height="0" |
| width="84" height="0" |
| width="66" height="0" |
| width="576" height="0" |
| width="0" height="0" |
|- align="left" valign="top"
| width="180" |
'''Purpose:'''

| width="727" colspan="4" |
 

|- align="left" valign="top"
| width="180" |
'''Property name:'''

| width="727" colspan="4" |
RANDOMIZE_ANSWER_OPTION

|- align="left" valign="top"
| width="180" |
'''Type:'''

| width="727" colspan="4" |
 

|- align="left" valign="top"
| width="180" |
'''Used for questionnaire:'''

| width="727" colspan="4" |
[[File:8153.png]][[File:8152.png]]

|- align="left" valign="top"
| width="180" |
'''Used for questions:'''

| width="84" |
[[File:8153.png]][[File:8152.png]]

| width="66" |
'''Types:'''

| width="577" |
 

|- align="left" valign="top"
| width="180" |
'''Used for sub-questions:'''

| width="727" colspan="4" |
[[File:8153.png]][[File:8152.png]]

|- align="left" valign="top"
| width="180" |
'''Used for answer options:'''

| width="727" colspan="4" |
[[File:8153.png]][[File:8152.png]]

|- align="left" valign="top"
| width="180" |
'''Example:'''

| width="727" colspan="4" |
 

|}
[[Category:Properties]]

Random answer option

2015-10-05T10:36:35Z

Nguyentrantri:

Random answer option

2015-10-05T10:35:17Z

Nguyentrantri:

= Random answer option =

{| width="907" class="tableintopic FCK__ShowTableBorders cke_show_border" border="0" cellspacing="0" cellpadding="2" style="border-collapse: collapse;"
|-
| width="180" height="0" |
| width="84" height="0" |
| width="66" height="0" |
| width="576" height="0" |
| width="0" height="0" |
|- align="left" valign="top"
| width="180" |
'''Purpose:'''

| width="727" colspan="4" |
 

|- align="left" valign="top"
| width="180" |
'''Property name:'''

| width="727" colspan="4" |
RANDOMIZE_ANSWER_OPTION

|- align="left" valign="top"
| width="180" |
'''Type:'''

| width="727" colspan="4" |
 

|- align="left" valign="top"
| width="180" |
'''Used for questionnaire:'''

| width="727" colspan="4" |
http://wiki.catglobe.com/images/a/af/8153.pnghttp://wiki.catglobe.com/images/d/d8/8152.png

|- align="left" valign="top"
| width="180" |
'''Used for questions:'''

| width="84" |
http://wiki.catglobe.com/images/a/af/8153.pnghttp://wiki.catglobe.com/images/d/d8/8152.png

| width="66" |
'''Types:'''

| width="577" |
 

|- align="left" valign="top"
| width="180" |
'''Used for sub-questions:'''

| width="727" colspan="4" |
http://wiki.catglobe.com/images/a/af/8153.pnghttp://wiki.catglobe.com/images/d/d8/8152.png

|- align="left" valign="top"
| width="180" |
'''Used for answer options:'''

| width="727" colspan="4" |
http://wiki.catglobe.com/images/a/af/8153.pnghttp://wiki.catglobe.com/images/d/d8/8152.png

|- align="left" valign="top"
| width="180" |
'''Example:'''

| width="727" colspan="4" |
 
<div><br/></div>
|}

Random answer option

2015-10-05T10:32:39Z

Nguyentrantri: Blanked the page

Random answer option

2015-10-05T10:31:59Z

Nguyentrantri: Created page with "<div>= No multi =</div><div><br/></div><div>{| width="907" class="tableintopic FCK__ShowTableBorders" style="border-collapse: collapse;" border="0" cellspacing="0" cellpadding..."

<div>= No multi =</div><div><br/></div><div>{| width="907" class="tableintopic FCK__ShowTableBorders" style="border-collapse: collapse;" border="0" cellspacing="0" cellpadding="2"</div><div>|-</div><div>| width="180" height="0" | </div><div>| width="84" height="0" | </div><div>| width="66" height="0" | </div><div>| width="576" height="0" | </div><div>| width="0" height="0" | </div><div>|- align="left" valign="top"</div><div>| width="180" | </div><div>'''Purpose:'''</div><div><br/></div><div>| width="727" colspan="4" | </div><div> </div><div><br/></div><div>|- align="left" valign="top"</div><div>| width="180" | </div><div>'''Property name:'''</div><div><br/></div><div>| width="727" colspan="4" | </div><div>NO_MULTI</div><div><br/></div><div>|- align="left" valign="top"</div><div>| width="180" | </div><div>'''Type:'''</div><div><br/></div><div>| width="727" colspan="4" | </div><div> </div><div><br/></div><div>|- align="left" valign="top"</div><div>| width="180" | </div><div>'''Used for questionnaire:'''</div><div><br/></div><div>| width="727" colspan="4" | </div><div>[[File:8153.png]][[File:8152.png]]</div><div><br/></div><div>|- align="left" valign="top"</div><div>| width="180" | </div><div>'''Used for questions:'''</div><div><br/></div><div>| width="84" | </div><div>[[File:8153.png]][[File:8152.png]]</div><div><br/></div><div>| width="66" | </div><div>'''Types:'''</div><div><br/></div><div>| width="577" | </div><div> </div><div><br/></div><div>|- align="left" valign="top"</div><div>| width="180" | </div><div>'''Used for sub-questions:'''</div><div><br/></div><div>| width="727" colspan="4" | </div><div>[[File:8153.png]][[File:8152.png]]</div><div><br/></div><div>|- align="left" valign="top"</div><div>| width="180" | </div><div>'''Used for answer options:'''</div><div><br/></div><div>| width="727" colspan="4" | </div><div>[[File:8153.png]][[File:8152.png]]</div><div><br/></div><div>|- align="left" valign="top"</div><div>| width="180" | </div><div>'''Example:'''</div><div><br/></div><div>| width="727" colspan="4" | </div><div> </div><div><br/></div><div>|}</div>

GetRandomNumber

2014-05-28T08:13:28Z

Nguyentrantri:

{{HelpFiles}}

==== getRandomNumber ====

Generates a random number.

The random number will be within the range specified(min value <= random number < max value), where 0 is the minimum value for a random number if only a maximum value is given as argument to the function.

'''Syntax'''

getRandomNumber(maximum_value);

getRandomNumber(minimum_value, maximum_value);

'''Arguments'''

minimum_value: Is an expression with the type of number

maximum_value: Is an expression with the type of number

'''Return type'''

number

'''Examples'''

''print("Random number 1: ");''

''print(getRandomNumber(100, 200)); //Return a random number >= 100 and < 200''

''print("Random number 2: ");''

''print(getRandomNumber(200)); //Return a random number < 200''

'''Availability'''

Version 4.8 __NOTOC__

Questionnaire - Javascript Fun Tips

2014-04-01T04:54:44Z

Nguyentrantri:

'''[[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]]'''

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

'''[[Some special questions on COOP Site]]'''

----

<br/>[[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]]

[[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]]

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

JQuery - Tips

2013-10-23T09:39:29Z

Nguyentrantri:

<accesscontrol>Main:MyGroup</accesscontrol>
[[Category:Miscellaneous]]
== JQuery Tips ==

'''1. Optimize performance of complex selectors'''<br/>var subset = $(""); $("input[value^='']", subset);''<br/><br/>'''2. Set Context and improve the performance'''<br/>On the core jQuery function, specify the context parameter when. Specifying the context parameter allows jQuery to start from a deeper branch in the DOM, rather than from the DOM root. Given a large enough DOM, specifying the context parameter should translate to performance gains. $("input:radio", document.forms[0]);<br/><br/>'''3. Live Event Handlers'''<br/>Set an event handler for any element that matches a selector, even if it gets added to the DOM after the initial page load: $('button.someClass').live('click', someFunction);<br/><br/>'''4. To show / hide element'''

$("a").hide();
$("a").show();

<br/>'''5. Check element exists'''

if ($("#someDiv").length) {}

<br/>'''6. Back to top button/link'''

$('#top').click(function() {
$(document).scrollTo(0,500); }

<br/><br/>'''7. Change width of item on many browser'''

$('#input:text[name=QUESTION.Q12.1]).width(500);

<br/><br/>var error_message = "The error was happened" var oldCheck = questioncheck; questioncheck = function() {

//QUESTION.Label1
if (checkLength("QUESTION.Label1",5)){
ErrorMessages.getInstance().clearErrorMessages();
ErrorMessages.getInstance().showErrorMessage(error_message);
return;
}

}

function checkLength(objname,maxlength) {

var ao=$("input:text[name="+objname+"]");
if (ao.val().length>maxlength)
return true;
return false

}<br/><br/>'''8. Get value of question in javascript'''<br/>from_Q8= "{{Q8[0].value}}";

CGScript - Coding guideline

2013-10-18T04:45:58Z

Nguyentrantri:

<accesscontrol>Main:MyGroup</accesscontrol>
= Objects =

Objects in cgscript can be created by doing following this guideline.

First an object must be created. The normal name for this is xxxCGO where xxx is the name of the object in cgscript.

This object must inherit from <code>CgScriptObject</code> and it must have a <code>CgAttribute</code>.

For example, here is the absolute minimal class:
<pre><code>
[Cg(OBJECT_TYPE_NAME, "write the documentation for the class here")]
internal class MyObjectCGO : CgScriptObject
{
private const string OBJECT_TYPE_NAME = "MyObject";
public override string ObjectTypeName
{
get { return OBJECT_TYPE_NAME; }
}
}
</code></pre>
The class must be internal or public, and non-abstract, and must not play with generics. The exception is that it may inherit from a generic baseclass (which then inherits from CgScriptObject), or implement a generic interface.

=== Inheritance ===

A CgScriptObject may utilize inheritance as a normal .NET object. CgScript will not be aware of this, it just sees all inherited methods, properties, etc. as belonging to the class.

== Object functions ==

Functions are exposed as cgscript functions by marking them with the CgAttribute and also marking all the parameters with the CgAttribute (see [[#Parameters]]).

The function must be internal or public, and non-abstract, and must not play with generics.

Overloads are supported, so the same name can be defined multiple times with different parameters. The rules for this is similar to C#s overload resolution (but not identical). If in doubt, don't use fancy parameters.

Example:
<pre><code>
[Cg("ContainsKey", "Determines whether the dictionary contains the specified key with type is a string.")]
public bool ContainsKey([Cg("key", "Check with specific key")]string key)
{
return _dict.ContainsKey(key);
}
</code></pre>
A function may be static, but from inside cgscript it will be exposed as a member function.

== Object properties ==

Properties have almost the same requirements as methods.

Example:
<pre><code>
[Cg("Count", "Gets the number of key/value pairs contained in the dictionary.")]
public int Count
{
get { return _dict.Count; }
}
</code></pre>
The getter and setter may have different visibility, e.g. the getter may be public and the setter may be private. In that case, only the getter is accessible from CgScript.

However, note that this alternative marking of the getter/setter may not do what you expect:
<pre><code>
public int Count
{
[Cg("Count", "Gets the number of key/value pairs contained in the dictionary.")]
get { return _dict.Count; }
}
</code></pre>
This will register the getter as a function (ie. from cgscript you would have to call o.Count() instead of o.Count)

== Object indexer ==

Indexers are a special construction in C# (and VB). They look a little bit like both Properties and Methods. So the syntax for registering them in CgScript is a little special.

The indexer must be marked with a CgAttribute, and the getter/setter must be marked with a CgAttribute also, the name must be <code>get_Item/set_Item</code> respectively in order to use it as an indexer inside CgScript. Furthermore the setter must use the very special "param:" prefix on the CgAttribute to document the value.

Example:
<pre><code>
public IConstant this[[Cg("key", "The key used to lookup the value.")] string key]
{
[Cg("get_Item", "Get an item based on a key.")]
get { return _dict[key]; }
[Cg("set_Item", "Set an item based on a key and a value.")]
[param:Cg("value", "The value to set.")]
set { _dict[key] = value; }
}
</code></pre>
== Parameters ==

CgScript objects support a number of types, that are automatically converted when calling the function and returning from the function:

*Void (For return values only) - Constant.Empty is returned
*string - Automatically converted to and from a StringConstant
*double - Automatically converted to and from a NumberConstant
*int - Automatically converted to and from a NumberConstant
*bool - Automatically converted to and from a BooleanConstant
*CGDateTime - Automatically converted to and from a DateTimeConstant
*Any type that implement IConstant - No conversion is done

Example:
<pre><code>
[Cg("Add", "Adds the specified key and value to the dictionary with type of key is a string.")]
public bool Add([Cg("key", "Add with specific key")] string key,
[Cg("value", "Add with specific value")] IConstant constant)
</code></pre>
There are some special parameter types, that must all NOT be marked with a CgAttribute:

*<code>Interpreter</code> - If you require the interpreter to do something, you can get it by adding a Interpreter parameter. You are probably doing something wrong if you need this. If you do need it, then you should be aware that your object may be shared among several interpreters, and you should therefore NOT store the value anywhere.
*<code>IList<IConstant></code> - This is roughly equivalent to a normal C# method that takes a <code>"params object[]"</code>. This enables you to do advanced scenarios where the parameters from cgscript cannot be predicted. For obvious reasons there can be no other parameters marked with CgAttribute.
*other - If a parameter is not marked with a CgAttribute, it is presumed it is a IoC type that must be resolved when calling the function. This works for Constructors, Methods and Properties.

== Overload resolution ==

To find the right overload, a score is calculated.

A function that takes an <code>IList<IConstant></code> as parameter is always a match, but the lowest priority match.

A function that takes the exact type (or a type with a known conversion) will be a better match than a function that takes a very generic superclass. For example, a function x that has two overloads, one takes an IConstant and another that takes an ArrayConstant, when called with an ArrayConstant, the second overload takes precedence.

Due to the automapping some constructs may have the same overload. For example a function x that has two overloads, one takes an NumberConstant and another that takes an int. These are considered equivalent, and it is totally random which is called.

= Namespace =

Objects as such do not have a namespace, but we decided to simulate it by having namespace objects.

In the symbol table a variable called "Catglobe" is registered, this is an instance of GlobalNamespace.

If you want to add some global function, then implement another class in <code>CatGlobe.Framework.Runtime.Library.GlobalFunctions</code>. It must be a normal <code>CgScriptObject</code>. The class must have no member variables since the instance is shared among all interpreters, and only static getters/setters/methods (although if you forgot to mark them static they will still work).

You then register the class in the namespace you want it to appear. For instance here is the registration of Json in the GlobalNamespace:

<code><pre>
private static readonly JsonNamespace JsonNamespace = new JsonNamespace();
[Cg("Json", "The json namespace")]
public static JsonNamespace Json { get { return JsonNamespace; } }
</pre></code>

Now you can call the functions in this namespace:

<code><pre>
return Catglobe.Json.Parse(Catglobe.Json.Encode({1, ""Hejsa""}));
</pre></code>

And because they are objects, you can also do this:

<code><pre>
object n = Catglobe.Json;
return n.Parse(n.Encode({1, ""Hejsa""}));
</pre></code>

= Functions =

Normal non-object functions - Yet to be written

[[Category:Technical_guidelines]]

Add text before answer option of single question

2013-10-17T03:27:50Z

Nguyentrantri:

== Challenge ==

In order to add text before answer option of single question

As a questionnaire creator

I want to add text before answer option of single question

'''Example'''

I have a single question.

{| border="0"
|-
| align="center" | [[File:OneColumnBefore.JPG|none]]<br/>
| [[File:MultiColumnBefore.JPG|none]]<br/>
|}

<br/>I want to add an text before answer option like this image

{|
|-
| align="center" | [[File:OneColumnAfter.jpg|none]]<br/>
| [[File:MultiColumnAfter.jpg|none]]<br/>
|}

== Solution ==

*Add a Single question to Questionaire editor
*Go to menu Properties -> Question scripts -> Java script tab -> Input script

[[File:AddTextBeforeAOOfSingleQuestion.jpg|none]]

== Code ==

<source lang="javascript">
quest.insertTextBefore = function(aoIndex, text)
{
var that = this;
$(".option_row").each(
function(i)
{
if (i == aoIndex)
{
var tr = $("<tr>").addClass("customized_text")
.append($("<td>").text(text).attr("colSpan",that.cols));
$(this).before(tr);
}
}
);

}

quest.onInit = function()
{
var text = "My Text";
this.insertTextBefore(2, text);
}
</source>

== Question stylesheet ==

<source lang="css">
.customized_text
{
background-color:white;
}
</source>

== Source ==

Questionnaire Resource Id on cg site: 159730

Question: Q_OS_Single_AddTextBeforeAO

Show a single question as a dropdown list inside another text grid question

2013-10-17T03:25:10Z

Nguyentrantri:

== Challenge ==

In order to restrict the value entered in a text grid question<br/>As a questionnaire creator<br/>I want to show a dropdown list inside the text grid

http://wiki.catglobe.com/images/1/1c/QuestionnaireTips_SingleQuestionAsDropdownList.png

== Solution<br/> ==

*Create a text grid question (Q3)
*Create a dummy single question with the same answer options as we want to show inside the text grid question (Q3x)
*Add javascript code to the text grid question to include the single question inside

== Code ==

<source lang="javascript">
function SingleQuestion(q, selectedValue, even)
{
this.label = "QUESTION." + q.label;
this.text = q.text;
this.aoValues = q.aoValues;
this.aoTexts = q.aoTexts;
this.selectedValue = selectedValue;
this.even = even;
}

SingleQuestion.prototype.getHTML =function()
{
var n = this.aoValues.length;
var list = $("<select>").width("400px");
var selected="";
for(var i=0; i<n; i++)
{
if (this.aoValues[i] == this.selectedValue)
selected = "true";
else
selected = "";
list.append($("<option>")
.val(this.aoValues[i])
.text(this.aoTexts[i])
.attr("selected", selected)
);
}
//handle change event to change the value of the single question
var s_label = this.label;
list.change(
function()
{
$("input:hidden").each(
function(i)
{
if ($(this).attr("name") == s_label)
$(this).val(list.val());

}
);

}
);
var row = $("<tr>");
var s;

if (this.even)
s = "even";
else
s = "odd";
row.append($("<td>").text(this.text).addClass("grid_subquestion_text grid_subquestion_"+s));
row.append(
$("<td>").addClass("grid_subquestion_"+ s)
.append(list)
)
if (this.selectedValue == "")
this.selectedValue = this.aoValues[0];
row.append($("<input type = \"hidden\">").attr("name", this.label).val(this.selectedValue));

return row;
}

quest.onInit = function()
{
//question in JSON format
var q3x = {"label":"Q3x","text":"Titel","aoValues":[1,2,3],"aoTexts":["Ejer","Adm. direktør","Økonomichef"]};

//get the previous selected value
var selectedValue = "{{Q3x.Value}}";
var q = new SingleQuestion(q3x, selectedValue, true);
//append the single question inside the grid
$(".grid_inner").append(q.getHTML());

$("input:text").width("400px");
}
</source>

== Code sample ==

Open the qnaire "Js demo - some js samples" (Resource Id: 159684). View the sub question "Q1[0]" on the text grid "Q1"

Show a single question as a dropdown list inside another text grid question

2013-10-17T03:24:32Z

Nguyentrantri:

Show a single question as a dropdown list inside another text grid question

2013-10-17T03:22:14Z

Nguyentrantri:

== Challenge ==

In order to restrict the value entered in a text grid question<br/>As a questionnaire creator<br/>I want to show a dropdown list inside the text grid<br/><br/><img src="/images/1/1c/QuestionnaireTips_SingleQuestionAsDropdownList.png" _fck_mw_filename="QuestionnaireTips SingleQuestionAsDropdownList.png" alt="" />

BEFORE<br/>[[File:/images/1/1c/QuestionnaireTips_SingleQuestionAsDropdownList.png]]<br/><br/>AFTER<br/>[[QuestionnaireTips SingleQuestionAsDropdownList.png]]

== Solution ==

*Create a text grid question (Q3)
*Create a dummy single question with the same answer options as we want to show inside the text grid question (Q3x)
*Add javascript code to the text grid question to include the single question inside

== Code ==

<source lang="javascript">
function SingleQuestion(q, selectedValue, even)
{
this.label = "QUESTION." + q.label;
this.text = q.text;
this.aoValues = q.aoValues;
this.aoTexts = q.aoTexts;
this.selectedValue = selectedValue;
this.even = even;
}

SingleQuestion.prototype.getHTML =function()
{
var n = this.aoValues.length;
var list = $("<select>").width("400px");
var selected="";
for(var i=0; i<n; i++)
{
if (this.aoValues[i] == this.selectedValue)
selected = "true";
else
selected = "";
list.append($("<option>")
.val(this.aoValues[i])
.text(this.aoTexts[i])
.attr("selected", selected)
);
}
//handle change event to change the value of the single question
var s_label = this.label;
list.change(
function()
{
$("input:hidden").each(
function(i)
{
if ($(this).attr("name") == s_label)
$(this).val(list.val());

}
);

}
);
var row = $("<tr>");
var s;

if (this.even)
s = "even";
else
s = "odd";
row.append($("<td>").text(this.text).addClass("grid_subquestion_text grid_subquestion_"+s));
row.append(
$("<td>").addClass("grid_subquestion_"+ s)
.append(list)
)
if (this.selectedValue == "")
this.selectedValue = this.aoValues[0];
row.append($("<input type = \"hidden\">").attr("name", this.label).val(this.selectedValue));

return row;
}

quest.onInit = function()
{
//question in JSON format
var q3x = {"label":"Q3x","text":"Titel","aoValues":[1,2,3],"aoTexts":["Ejer","Adm. direktør","Økonomichef"]};

//get the previous selected value
var selectedValue = "{{Q3x.Value}}";
var q = new SingleQuestion(q3x, selectedValue, true);
//append the single question inside the grid
$(".grid_inner").append(q.getHTML());

$("input:text").width("400px");
}
</source>

== Code sample ==

Open the qnaire "Js demo - some js samples" (Resource Id: 159684). View the sub question "Q1[0]" on the text grid "Q1"

Prioritize sub questions in a text grid question

2013-10-17T03:17:45Z

Nguyentrantri:

== Challenge ==

In order to let the respondent prioritize a list of products

As a questionnaire creator

I want to allow him to enter only values in a list of priorities for each product (one priority is only used once)

'''Example'''<br/>[[File:PrioritizeSQInTextGrid.jpg]]

== Solution ==

*Add a Text grid question to Questionnaire editor like below
*Go to menu Properties -> Question scripts -> Java script tab -> Input script

[[File:PrioritizeSQInTextGrid Code.jpg]]

== Code ==

<source lang="javascript">
function isNumeric_LessThan6(sText)
{
var ValidChars = "12345";
if (sText.length != 1)
return false;

if (ValidChars.indexOf(sText) == -1)
return false;

return true;
}

var normalQuestionCheck = questioncheck;

function extendedQuestionCheck()
{
var valid = normalQuestionCheck();
if (!valid)
return false;

var usedNumbers = "";
ErrorMessages.getInstance().clearErrorMessages();
var msg = "";

$("input:text").each(
function(i)
{
if ($(this).attr("name").indexOf("QUESTION.") == 0)
{
//check the value
var v = $(this).val();
if (!isNumeric_LessThan6(v))
{
msg = "Only 1-5 are allowed as input";
valid = false;
return;
}

if (usedNumbers.indexOf(v) != -1)
{
valid = false;
msg = "One value can only be specified for one row";
return;
}

usedNumbers = usedNumbers + v;
}
}
);
if (!valid)
ErrorMessages.getInstance().showErrorMessage(msg);

return valid;
}

questioncheck = extendedQuestionCheck;
</source>

== Source ==

Questionnaire Resource Id on cg site: 159730

Show a single question as a dropdown list inside another text grid question

2013-10-17T03:16:55Z

Nguyentrantri:

== Challenge ==

In order to restrict the value entered in a text grid question<br/>As a questionnaire creator<br/>I want to show a dropdown list inside the text grid<br/><br/><img src="/images/1/1c/QuestionnaireTips_SingleQuestionAsDropdownList.png" _fck_mw_filename="QuestionnaireTips SingleQuestionAsDropdownList.png" alt="" />

== Solution ==

*Create a text grid question (Q3)
*Create a dummy single question with the same answer options as we want to show inside the text grid question (Q3x)
*Add javascript code to the text grid question to include the single question inside

== Code ==

<source lang="javascript">
function SingleQuestion(q, selectedValue, even)
{
this.label = "QUESTION." + q.label;
this.text = q.text;
this.aoValues = q.aoValues;
this.aoTexts = q.aoTexts;
this.selectedValue = selectedValue;
this.even = even;
}

SingleQuestion.prototype.getHTML =function()
{
var n = this.aoValues.length;
var list = $("<select>").width("400px");
var selected="";
for(var i=0; i<n; i++)
{
if (this.aoValues[i] == this.selectedValue)
selected = "true";
else
selected = "";
list.append($("<option>")
.val(this.aoValues[i])
.text(this.aoTexts[i])
.attr("selected", selected)
);
}
//handle change event to change the value of the single question
var s_label = this.label;
list.change(
function()
{
$("input:hidden").each(
function(i)
{
if ($(this).attr("name") == s_label)
$(this).val(list.val());

}
);

}
);
var row = $("<tr>");
var s;

if (this.even)
s = "even";
else
s = "odd";
row.append($("<td>").text(this.text).addClass("grid_subquestion_text grid_subquestion_"+s));
row.append(
$("<td>").addClass("grid_subquestion_"+ s)
.append(list)
)
if (this.selectedValue == "")
this.selectedValue = this.aoValues[0];
row.append($("<input type = \"hidden\">").attr("name", this.label).val(this.selectedValue));

return row;
}

quest.onInit = function()
{
//question in JSON format
var q3x = {"label":"Q3x","text":"Titel","aoValues":[1,2,3],"aoTexts":["Ejer","Adm. direktør","Økonomichef"]};

//get the previous selected value
var selectedValue = "{{Q3x.Value}}";
var q = new SingleQuestion(q3x, selectedValue, true);
//append the single question inside the grid
$(".grid_inner").append(q.getHTML());

$("input:text").width("400px");
}
</source>

== Code sample ==

Open the qnaire "Js demo - some js samples" (Resource Id: 159684). View the sub question "Q1[0]" on the text grid "Q1"

Show a single question as a dropdown list inside another text grid question

2013-10-17T03:16:33Z

Nguyentrantri:

<h2> Challenge </h2>
<p>In order to restrict the value entered in a text grid question <br />
As a questionnaire creator<br />
I want to show a dropdown list inside the text grid<br />
<br />
<img src="/images/1/1c/QuestionnaireTips_SingleQuestionAsDropdownList.png" _fck_mw_filename="QuestionnaireTips SingleQuestionAsDropdownList.png" alt="" />
</p>
<h2> Solution </h2>
<ul><li>Create a text grid question (Q3)
</li><li>Create a dummy single question with the same answer options as we want to show inside the text grid question (Q3x)
</li><li>Add javascript code to the text grid question to include the single question inside
</li></ul>
<h2>Code</h2>
<p><span class="fck_mw_source" _fck_mw_customtag="true" _fck_mw_tagname="source" lang="javascript">fckLRfunction SingleQuestion(q, selectedValue, even)fckLR{fckLR this.label = "QUESTION." + q.label;fckLR this.text = q.text;fckLR this.aoValues = q.aoValues;fckLR this.aoTexts = q.aoTexts; fckLR this.selectedValue = selectedValue; fckLR this.even = even;fckLR}fckLRfckLRSingleQuestion.prototype.getHTML =function()fckLR{fckLR var n = this.aoValues.length;fckLR var list = $("<select>").width("400px");fckLR var selected="";fckLR for(var i=0; i<n; i++)fckLR { fckLR if (this.aoValues[i] == this.selectedValue)fckLR selected = "true";fckLR elsefckLR selected = "";fckLR list.append($("<option>")fckLR .val(this.aoValues[i])fckLR .text(this.aoTexts[i])fckLR .attr("selected", selected)fckLR );fckLR }fckLR //handle change event to change the value of the single questionfckLR var s_label = this.label;fckLR list.change(fckLR function()fckLR {fckLR $("input:hidden").each(fckLR function(i)fckLR { fckLR if ($(this).attr("name") == s_label)fckLR $(this).val(list.val());fckLR fckLR }fckLR );fckLR fckLR }fckLR );fckLR var row = $("<tr>");fckLR var s;fckLR fckLR if (this.even)fckLR s = "even";fckLR elsefckLR s = "odd";fckLR row.append($("<td>").text(this.text).addClass("grid_subquestion_text grid_subquestion_"+s));fckLR row.append(fckLR $("<td>").addClass("grid_subquestion_"+ s)fckLR .append(list)fckLR )fckLR if (this.selectedValue == "")fckLR this.selectedValue = this.aoValues[0];fckLR row.append($("<input type = \"hidden\">").attr("name", this.label).val(this.selectedValue));fckLRfckLR return row;fckLR}fckLRfckLRquest.onInit = function()fckLR{fckLR //question in JSON formatfckLR var q3x = {"label":"Q3x","text":"Titel","aoValues":[1,2,3],"aoTexts":["Ejer","Adm. direktør","Økonomichef"]};fckLRfckLR //get the previous selected valuefckLR var selectedValue = "{{Q3x.Value}}"; fckLR var q = new SingleQuestion(q3x, selectedValue, true);fckLR //append the single question inside the gridfckLR $(".grid_inner").append(q.getHTML());fckLR fckLR $("input:text").width("400px");fckLR}fckLR</span>
</p>
<h2> Code sample </h2>
<p>Open the qnaire "Js demo - some js samples" (Resource Id: 159684). View the sub question "Q1[0]" on the text grid "Q1"
</p>

Mark answer option with keyboard

2013-10-17T03:16:13Z

Nguyentrantri:

== Challenge ==

In order to allow the respondent to be able to answer a question by hitting a button on his keyboard.

As a questionnaire creator

I want to specify both which key on the keyboard that should be used, and which answer option that should be answered

== Example ==

[[File:MakeAnswerOptionWithKeyboard.jpg]]

== Solution ==

*Add a Single question to Questionnaire editor like below
*Go to menu Properties -> Question scripts -> Java script tab -> Input script

[[File:MakeAnswerOptionWithKeyboard Code.jpg]]

== Code ==

<source lang="javascript">
//which key on the keyboard that should mark the answer option. The code 32 refers to the space key
var keyCodetoReactOn = 32;

//enabels you to find out which numerical codes that belongs to which keys on the keyboard.
//Change false into true, and you will have a dialog that shows you the key code each time you hit a key.
//When you have found out which code that should mark the answer option, you change true back to false (mostly use for debugging)
var displayKeyCode = false;

//information on which answer option that should be marked when the respondent uses his keyboard.
//The answer option list has an index starting with zero when you are referring to answer options with this script.
//The number 0 therefore refers to the answer option with the value 1.
//If you want to refer to an answer option with the value 99, you write 98 in the script.
var answerOptionIndexToCheck = 0;

//the question label of the question where you run the script.
var qLabel = "Q_Single_MakeAOWithKeyboard";

//the text that should be on the Next button.
//Note that this text will be the same for all languages if your questionnaire is programmed in multiple languages.
var buttonText = "Recognize";

//It is advisable that you hide the Next button on questions where you use this script.
// Otherwise the respondent will have two buttons, which can be confusing

function myHandler(e)
{
if (displayKeyCode)
alert(e.keyCode);
if (e.keyCode == keyCodetoReactOn)
recognize();
}
function recognize()
{
quest.options[answerOptionIndexToCheck].checked = true;
document["query"]["QUESTION." + qLabel][answerOptionIndexToCheck].checked = true;
moveForward();
}
function moveForward()
{
document["query"]["dir"].value = "next";
document["query"].submit();
}
question.prototype.getNavigationPanel = function()
{
var sres = "";

if (this.backvisible) sres += "<input type=\"button\" name=\"back\" value=\"" + this.backtext + "\" tabindex=1000 onclick=\"" + this.reference + ".back();\">";
if (this.resetvisible) sres += "<input type=\"button\" name=\"reset\" value=\"" + this.resettext + "\" tabindex=1001 onclick=\"" + this.reference + ".reset();\">";
if (this.closevisible) sres += "<input type=\"button\" name=\"close\" value=\"" + this.closetext + "\" tabindex=1002 onclick=\"" + this.reference + ".close();\">";
sres += "<input type=\"button\" name=\"spaceHandler\" onclick=\"recognize();\" onkeydown=\"return myHandler(event)\" value=\"" + buttonText + "\" tabindex=0>";
if (this.nextvisible) sres += "<input type=\"submit\" name=\"next\" onkeydown=\"return myHandler(event)\" value=\"" + this.nexttext + "\" tabindex=0>";
return sres;
}
question.prototype.onInit = function()
{
document["query"]["spaceHandler"].focus();
}
</source>

== Source ==

Questionnaire Resource Id on cg site: 159730

Add an extra row before a sub question in a grid

2013-10-17T03:13:29Z

Nguyentrantri:

== Add an extra row before a sub question in a grid ==

In order to categorize sub questions in a grid question

As a questionnaire creator

I want to add extra rows to the grid

==== Example ====

I have a single grid question.

[[File:AddExtraRow1.jpg]]

I want to have an extra row to group some sub questions together.

[[File:AddExtraRow2.jpg]]

==== Solution ====

*Add a Single grid question to Questionnaire editor
*Go to menu Properties -> Question scripts -> Add code to Java script tab

[[File:AddExtraRowCode.jpg]]

==== Code ====

<source lang="javascript">
//add a row before a sub question in the grid
//subQuestionIndex: the index of sub question which we should add a row before
//cssClass: the stylesheet that would be applied to the new row
//text: name of the sub question group
//includeAnswerOptionTexts: if it is true, answer option texts will be included in the new row
quest.addRowBefore = function(subQuestionIndex, cssClass, text, includeAnswerOptionTexts)
{
//get number of columns
var n = $(".grid_inner")[0].rows[0].cells.length;
$(".grid_inner").find("tr").each(
function(i)
{
if (i == subQuestionIndex + 1)
{
if (!includeAnswerOptionTexts)
{
$(this).before( $("<tr>")
.append($("<td colspan="+n+">").text(text).addClass(cssClass))
);
}
else
{
var tr = $("<tr>").append($("<td>").text(text).addClass(cssClass));
for (var j=0; j<quest.questions[0].options.length; j++)
{
tr.append($("<td>").text(quest.questions[0].options[j].text).addClass(cssClass));
}
$(this).before(tr);
}
}
}
)
}

quest.onInit = function()
{
//insert a cell before Don't know on header
var dontKnow_value = 3;
this.addRowBefore(2, "extra_row_header", "Alcohol drinks", true);
}
</source>

==== Source ====

Questionnaire Resource Id on cg site: 159730

Showing Answer Option in tab

2013-10-17T03:10:57Z

Nguyentrantri:

== Showing answer option in tab ==

We have a single question which has a lot of answer options. We want to show answer options in Alphabetical tab

[[File:Tab20120116.png]]

== Solution ==

Using Java Script property of question.

There are 2 type of alphabetical tabs.

#'''No tab is selected as default'''
#'''An extra tab showing all answer options which is selected as default'''

== Code 1: No tab is selected by default ==

<source lang="javascript">

/// Maximum number of column in tab.
var columnPerRow = 3;

//answer option list to display outside of the tabs
var excludeAOs = [998,999];

Array.prototype.contains = function(item)
{
var i;
for(i=0; i<this.length; i++)
{
if (this[i] == item)
return true;
}
return false;
}

//Overrider Array to find an item easier
Array.prototype.indexOf = function(character)
{
for (var i = 0; i < this.length; i++)
if (this[i] == character)
return i;
return -1;
}

quest.getHTML = function()
{
if (this.type != 1 && this.type != 2)
return;

//This code used to set data to question.options
ans = this.answer.split("_|_");
for (i = 0; i < ans.length; i++)
{
ans[i] = ans[i].split("_:_");
}

for (i = 0; i < ans[0].length; i++)
{
if (ans[0][i].length > 0)
{
for (j = 0; j < this.options.length; j++)
{
if (this.options[j].value == ans[0][i])
{
this.options[j].checked = true;
if (ans.length > 1 && typeof this.options[j].open != "undefined" && typeof ans[1][i] != "undefined")
this.options[j].open = ans[1][i];
}
}
}
}

var optionType = this.type == 1 ? 1 : 3;

var sres = "";
sres += "<table border=" + this.bordersize + " class=\"question_outer\" cellpadding=\"0\" cellspacing=\"0\">";
if (this.countdown > 0 && this.showcountdowndisplay)
{
sres += "<tr><td><div id=\"countdowndisplay\"></div></td></tr>";
}
sres += "<tr><td id=\"question_text\">" + this.text + "</td></tr>";
sres += "<tr><td align=\"center\">";

//Generate list of tabs
var tabList = new Array();
tabList.push(" #");
for (var i = 0; i < this.options.length; i++) {
if (tabList.indexOf(this.options[i].text.trim().substr(0, 1).toUpperCase()) == -1)
tabList.push(this.options[i].text.trim().substr(0, 1).toUpperCase());
}

//Sort Alphabetical
tabList.sort();

sres += "<div id='example_tab' class='ui-tabs ui-widget ui-widget-content ui-corner-all'>";
//Generate tab header UI
sres += "<ul class='ui-tabs-nav ui-helper-reset ui-helper-clearfix ui-widget-header ui-corner-all'>";
for (var i = 0; i < tabList.length; i++) {
var tabHeaderContent = document.createElement("li");
sres += "<li class='ui-state-default ui-corner-top'>";
sres += "<a href='#tab_" + i + "'><span>" + tabList[i] + "</span></a></li>";
}
sres += "</ul>";

sres += "<div id='tab_" + 0 + "' class='ui-tabs-panel ui-widget-content ui-corner-bottom'></div>";

var answerOptionNotToIncluded = new Array();

for (var i = 1; i < tabList.length; i++) {
var tabContent = "";
tabContent += "<div id='tab_" + i + "' class='ui-tabs-panel ui-widget-content ui-corner-bottom'>";

//generate content for tab
tabContent += "<table><tbody><tr>";
var indexOfItemInTab = 1;
var currentRow = 1;
for (var j = 0; j < this.options.length; j++) {
if (this.options[j].text.trim().substr(0, 1).toUpperCase() != tabList[i])
continue;

if (excludeAOs.contains(this.options[j].value)) {
answerOptionNotToIncluded.push(this.options[j]);
continue;
}

tabContent += this.options[j].getHTML(optionType);
indexOfItemInTab++;
if (indexOfItemInTab > columnPerRow * currentRow) {
tabContent += "</tr><tr>";
currentRow++;
}
}

if (this.options.lenght == 0)
tabContent = "<td> </td>";
tabContent += "</tr></tbody></table></div>";

if ($(tabContent).find("input").length <= 0)
__emptyTabSearchString = "a[href*='tab_" + i + "']";
else
sres += tabContent;
}
if (answerOptionNotToIncluded.length > 0)
{
sres += "</div></td></tr><tr><td><table id='extra_options'>";
for(var i=0; i<answerOptionNotToIncluded.length; i++)
{
sres += "<tr>" + answerOptionNotToIncluded[i].getHTML(optionType) + "</tr>";
}
sres += "</table></td></tr></table>";
}
else
sres += "</div></td></tr></table>";

return sres;
};

var normaloptClick = optclick;
this.optclick = function(slbl, lidx, blnk)
{
var currentAOValue = quest.options[lidx].value;
var inputType = quest.type == 1 ? "radio" : "checkbox";

var openInput, currentAOInput;

currentAOInput = $("input[type='" + inputType + "'][value='" + currentAOValue + "']")[0];

if (excludeAOs.contains(currentAOValue))
return normaloptClick(slbl, lidx, blnk);

//If user click on the link instead of the radiobutton/checkbox then check/uncheck the radio/checkbox
if (blnk && currentAOInput.type == "checkbox")
currentAOInput.checked = !currentAOInput.checked;
else if (blnk)
currentAOInput.checked = true;

openInput = document["query"][slbl + ".Open." + currentAOValue];
if ((typeof openInput) != "undefined")
{
if (currentAOInput.checked)
{
openInput.disabled = false;
openInput.focus();
}
else
{
openInput.value = "";
openInput.disabled = true;
}
}
var o;
for(var i=0; i<quest.options.length; i++)
{
o = quest.options[i];
if (o.single && currentAOValue != o.value)
{
$("input[type='" + inputType + "'][value='" + o.value + "']").attr("checked", false);
}
}
}

quest.onInit = function()
{
if (typeof(__emptyTabSearchString) != "undefined")
$(__emptyTabSearchString).parent().remove();

$("#example_tab").tabs();
$("a[href='#tab_0']").parent().css("display", "none");

// set Next invisible onload
//setVisibility(false);
$("#extra_options").hide();
};
</source>

== Code 2: Extra tab showing all answer options ==

<source lang="javascript">

/// Maximum number of column in tab.
var columnPerRow = 3;

//answer option list to display outside of the tabs
var excludeAOs = [998,999];

Array.prototype.contains = function(item)
{
var i;
for(i=0; i<this.length; i++)
{
if (this[i] == item)
return true;
}
return false;
}

//Overrider Array to find an item easier
Array.prototype.indexOf = function(character)
{
for (var i = 0; i < this.length; i++)
if (this[i] == character)
return i;
return -1;
}

quest.getHTML = function()
{
if (this.type != 1 && this.type != 2)
return;

//This code used to set data to question.options
ans = this.answer.split("_|_");
for (i = 0; i < ans.length; i++)
{
ans[i] = ans[i].split("_:_");
}

for (i = 0; i < ans[0].length; i++)
{
if (ans[0][i].length > 0)
{
for (j = 0; j < this.options.length; j++)
{
if (this.options[j].value == ans[0][i])
{
this.options[j].checked = true;
if (ans.length > 1 && typeof this.options[j].open != "undefined" && typeof ans[1][i] != "undefined")
this.options[j].open = ans[1][i];
}
}
}
}

var optionType = this.type == 1 ? 1 : 3;

var sres = "";
sres += "<table border=" + this.bordersize + " class=\"question_outer\" cellpadding=\"0\" cellspacing=\"0\">";
if (this.countdown > 0 && this.showcountdowndisplay)
{
sres += "<tr><td><div id=\"countdowndisplay\"></div></td></tr>";
}
sres += "<tr><td id=\"question_text\">" + this.text + "</td></tr>";
sres += "<tr><td align=\"center\">";

//Generate list of tabs
var tabList = new Array();
tabList.push(" All");
for (var i = 0; i < this.options.length; i++) {
if (tabList.indexOf(this.options[i].text.trim().substr(0, 1).toUpperCase()) == -1)
tabList.push(this.options[i].text.trim().substr(0, 1).toUpperCase());
}

//Sort Alphabetical
tabList.sort();

sres += "<div id='example_tab' class='ui-tabs ui-widget ui-widget-content ui-corner-all'>";
//Generate tab header UI
sres += "<ul class='ui-tabs-nav ui-helper-reset ui-helper-clearfix ui-widget-header ui-corner-all'>";
for (var i = 0; i < tabList.length; i++) {
var tabHeaderContent = document.createElement("li");
sres += "<li class='ui-state-default ui-corner-top'>";
sres += "<a href='#tab_" + i + "'><span>" + tabList[i] + "</span></a></li>";
}
sres += "</ul>";

var answerOptionNotToIncluded = new Array();

for (var i = 0; i < tabList.length; i++) {
var tabContent = "";
if(i==0)tabContent += "<div id='tab_" + i + "' class='ui-tabs-panel ui-widget-content ui-corner-bottom'>";
else tabContent += "<div id='tab_" + i + "' class='ui-tabs-panel ui-tabs-hide'>";

//generate content for tab
tabContent += "<table><tbody><tr>";
var indexOfItemInTab = 1;
var currentRow = 1;
for (var j = 0; j < this.options.length; j++) {
if (i != 0 && this.options[j].text.trim().substr(0, 1).toUpperCase() != tabList[i])
continue;
var optionInput = this.options[j].getHTML(optionType);
if (i == 0) {
while (optionInput.indexOf(this.label) != -1) {
optionInput = optionInput.replace(this.label, "TabAllAnswer");
}
}
if (i!=0 && excludeAOs.contains(this.options[j].value)) {
answerOptionNotToIncluded.push(this.options[j]);
continue;

}

tabContent += this.options[j].getHTML(optionType);
indexOfItemInTab++;
if (indexOfItemInTab > columnPerRow * currentRow) {
tabContent += "</tr><tr>";
currentRow++;
}
}

if (this.options.lenght == 0)
tabContent = "<td> </td>";
tabContent += "</tr></tbody></table></div>";

if ($(tabContent).find("input").length <= 0)
__emptyTabSearchString = "a[href*='tab_" + i + "']";
else
sres += tabContent;
}
if (answerOptionNotToIncluded.length > 0)
{
sres += "</div></td></tr><tr><td><table id='extra_options'>";
for(var i=0; i<answerOptionNotToIncluded.length; i++)
{
sres += "<tr>" + answerOptionNotToIncluded[i].getHTML(optionType) + "</tr>";
}
sres += "</table></td></tr></table>";
}
else
sres += "</div></td></tr></table>";

return sres;
};

var normaloptClick = optclick;
this.optclick = function(slbl, lidx, blnk)
{
var currentAOValue = quest.options[lidx].value;
var inputType = quest.type == 1 ? "radio" : "checkbox";

var openInput, currentAOInput;

currentAOInput = $("input[type='" + inputType + "'][value='" + currentAOValue + "']")[0];

if (excludeAOs.contains(currentAOValue))
return normaloptClick(slbl, lidx, blnk);

//If user click on the link instead of the radiobutton/checkbox then check/uncheck the radio/checkbox
if (blnk && currentAOInput.type == "checkbox")
currentAOInput.checked = !currentAOInput.checked;
else if (blnk)
currentAOInput.checked = true;

openInput = document["query"][slbl + ".Open." + currentAOValue];
if ((typeof openInput) != "undefined")
{
if (currentAOInput.checked)
{
openInput.disabled = false;
openInput.focus();
}
else
{
openInput.value = "";
openInput.disabled = true;
}
}
var o;
for(var i=0; i<quest.options.length; i++)
{
o = quest.options[i];
if (o.single && currentAOValue != o.value)
{
$("input[type='" + inputType + "'][value='" + o.value + "']").attr("checked", false);
}
}
}

quest.onInit = function()
{
if (typeof(__emptyTabSearchString) != "undefined")
$(__emptyTabSearchString).parent().remove();

$("#example_tab").tabs();
//$("a[href='#tab_0']").parent().css("display", "none");

// set Next invisible onload
//setVisibility(false);
$("#extra_options").hide();
};
</source>

== Source ==

Questionnaire Resource Id on cg.catglobe.com site: 164079 (Questions: Q_1_No_tab_is_selected_by_default & Q_2_Extra_tab_showing_all_answer_options)

Add text before answer option of single question

2013-10-17T03:10:12Z

Nguyentrantri:

== Challenge ==

In order to add text before answer option of single question

As a questionnaire creator

I want to add text before answer option of single question

'''Example'''

I have a single question.

{| border="0"
|-
| align="center" | <img src="/images/a/a3/OneColumnBefore.JPG" _fck_mw_filename="OneColumnBefore.JPG" alt="" /><br/>
| <img src="/images/0/08/MultiColumnBefore.JPG" _fck_mw_filename="MultiColumnBefore.JPG" alt="" />
|}

<br/>I want to add an text before answer option like this image

{|
|-
| align="center" | <img src="/images/2/2f/OneColumnAfter.jpg" _fck_mw_filename="OneColumnAfter.jpg" alt="" />
| <img src="/images/6/69/MultiColumnAfter.jpg" _fck_mw_filename="MultiColumnAfter.jpg" alt="" />
|}

== Solution ==

*Add a Single question to Questionaire editor
*Go to menu Properties -> Question scripts -> Java script tab -> Input script

<img src="/images/5/56/AddTextBeforeAOOfSingleQuestion.jpg" _fck_mw_filename="AddTextBeforeAOOfSingleQuestion.jpg" alt="" />

== Code ==

<source lang="javascript">
quest.insertTextBefore = function(aoIndex, text)
{
var that = this;
$(".option_row").each(
function(i)
{
if (i == aoIndex)
{
var tr = $("<tr>").addClass("customized_text")
.append($("<td>").text(text).attr("colSpan",that.cols));
$(this).before(tr);
}
}
);

}

quest.onInit = function()
{
var text = "My Text";
this.insertTextBefore(2, text);
}
</source>

== Question stylesheet ==

<source lang="css">
.customized_text
{
background-color:white;
}
</source>

== Source ==

Questionnaire Resource Id on cg site: 159730

Question: Q_OS_Single_AddTextBeforeAO

Add text before answer option of single question

2013-10-17T03:09:49Z

Nguyentrantri:

<h2> Challenge </h2>
<p>In order to add text before answer option of single question
</p><p>As a questionnaire creator
</p><p>I want to add text before answer option of single question
</p><p><b>Example</b>
</p><p>I have a single question.
</p>
<table border="0">

<tr>
<td align="center"><img src="/images/a/a3/OneColumnBefore.JPG" _fck_mw_filename="OneColumnBefore.JPG" alt="" />
</td>
<td> <img src="/images/0/08/MultiColumnBefore.JPG" _fck_mw_filename="MultiColumnBefore.JPG" alt="" />
</td></tr></table>
<p><br />
I want to add an text before answer option like this image
</p>
<table>
<tr>
<td align="center"><img src="/images/2/2f/OneColumnAfter.jpg" _fck_mw_filename="OneColumnAfter.jpg" alt="" />
</td>
<td> <img src="/images/6/69/MultiColumnAfter.jpg" _fck_mw_filename="MultiColumnAfter.jpg" alt="" />
</td></tr></table>
<h2> Solution </h2>
<ul><li>Add a Single question to Questionaire editor
</li><li>Go to menu Properties -> Question scripts -> Java script tab -> Input script
</li></ul>
<p><img src="/images/5/56/AddTextBeforeAOOfSingleQuestion.jpg" _fck_mw_filename="AddTextBeforeAOOfSingleQuestion.jpg" alt="" />
</p>
<h2> Code </h2>
<p><span class="fck_mw_source" _fck_mw_customtag="true" _fck_mw_tagname="source" lang="javascript" line="1">fckLRquest.insertTextBefore = function(aoIndex, text)fckLR{fckLR var that = this;fckLR $(".option_row").each(fckLR function(i)fckLR {fckLR if (i == aoIndex)fckLR {fckLR var tr = $("<tr>").addClass("customized_text")fckLR .append($("<td>").text(text).attr("colSpan",that.cols)); fckLR $(this).before(tr);fckLR }fckLR }fckLR );fckLRfckLR}fckLRfckLRquest.onInit = function()fckLR{fckLR var text = "My Text";fckLR this.insertTextBefore(2, text);fckLR}fckLR</span>
</p>
<h2> Question stylesheet </h2>
<p><span class="fck_mw_source" _fck_mw_customtag="true" _fck_mw_tagname="source" lang="css">fckLR.customized_textfckLR{fckLR background-color:white;fckLR}fckLR</span>
</p>
<h2>Source</h2>
<p>Questionnaire Resource Id on cg site: 159730
</p><p>Question: Q_OS_Single_AddTextBeforeAO
</p>

Show single questions as dropdown lists in their own pages

2013-10-17T03:09:36Z

Nguyentrantri:

== Challenge ==

As a questionnaire creator

In order not to have the answer option list taking much space when viewing the question

I want to show answer options as a drop down list

'''Example'''

Before

[[File:Single default view.png]] 

After

[[File:Single as drop down.png]] 

== Solution ==

*Hide answer option rows
*Create a drop down list containing all answer options, add it to the option table

== Code ==

*Create SingleQuestion class

<source lang="javascript">
function SingleQuestion(q, selectedValue)
{
if (q.label.indexOf("QUESTION.") != -1)
this.label = q.label;
else
this.label = "QUESTION." + q.label;

this.aoValues = q.aoValues;
this.aoTexts = q.aoTexts;
this.selectedValue = selectedValue;
}

SingleQuestion.prototype.createDropDownList = function()
{
var n = this.aoValues.length;
var list = $("<select id='dropDownList'>");
list.append($("<option>")
.val("")
.text("Select...")
.attr("selected", "true"));
var selected="";
for(var i=0; i<n; i++)
{
if (this.aoValues[i] == this.selectedValue)
selected = "true";
else
selected = "";
list.append($("<option>")
.val(this.aoValues[i])
.text(this.aoTexts[i])
.attr("selected", selected)
);
}
//handle change event to change the value of the single question
var s_label = this.label;
list.change(
function()
{
$("input[name='" + s_label + "']").val($(this).val());
}
);
return list;
}

SingleQuestion.prototype.validate = function()
{
ErrorMessages.getInstance().clearErrorMessages();
if ($("input[name='" + this.label + "']").val() == "")
{
ErrorMessages.getInstance().showErrorMessage(quest.requiredtext);
return false;
}
return true;

}
</source>

*Add the drop down list to the option table

<source lang="javascript">
quest.onInit = function()
{
$(".option_row").remove();
var q = {'label':'Q3', 'aoTexts':['C2','C3','C4','C5','C6','C7','C8','T1','T2','T3','T4','T5','T6','T7','T8','T9','T10','T11','T12','L1','L2','L3','L4','L5','S1','S2','S3','S4',"Don't know"], 'aoValues':[1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29
]};
var qS = new SingleQuestion(q, "{{Q3.Value}}");
var oldValue = "{{Q3.Value}}";
$("input[name='" + qS.label + "']").val(oldValue);

$(".option_table").append($("<tr>").append($("<td>").append(qS.createDropDownList())).addClass("option_row"));
$("#dropDownList").val(oldValue);
quest.qS = qS;

$(".QuestionSpace >p").attr("align", "center");
}

questioncheck = function()
{
return quest.qS.validate();
}

</source>

== Source ==

Questionnaire resource id on cg site: 164079(Question: Q_Show_single_questions_as_dropdown_lists_in_their)