Catglobe Wiki - User contributions [en]

CG0129inz - FÆRGEN A/S Kundepanel - Import email info to base questionnaire

2012-07-03T08:13:38Z

Cg huyphong:

== General information ==

{| border="1" class="VerticalTable"
|-
! style="background-color: rgb(244, 219, 165); text-align: center;" | <br>
! style="background-color: rgb(244, 219, 165); text-align: center;" | <br>
|-
| Site<br>
| inzights.catglobe.com<br>
|-
| Catinét project no<br>
| 0129inz<br>
|-
| Client<br>
|
|}

== How to send out reminders ==

=== Goal ===

This is a standard setup to import the file which contains the email address to the base questionnaire then send the invitation to the imported email.

=== How to do ===

The general solution is to execute the .exe program to upload the csv file. After it is uploaded, the workflow script will validate and import the uploaded info to the base questionnaire.

==== Step 1 : Create the list of email address ====

We create the ".csv" file containing the email address like

[[Image:File_containing_the_email_address.jpg]]

==== Step 2 :Prepare the workflow script for solving the uploaded data ====

<source lang="javascript">
array a = Workflow_getParameters();
string csvData = a[0];
number importtype = convertToNumber(a[1]);
number DCSRid = 1497858; // DCS : used for filtering the email. The real value should be : 1497858
number PQRid = 1289245; // PQRid: used for the imported PQ. The real value should be : 1289245
number MailtemplateRid = 1497895; // MailtemplateRid: used for the mail template. The real value should be : 1497895
DCS_use(DCSRid);
DCS_rebuild();

number InvitationBmRid = 0;
number info_wfrid = 1293521; //CG0129inz - FÆRGEN A/S Kundepanel - get info from the record on csv file
number Creategroup_wfrid = 1308275; //CG0129inz - FÆRGEN A/S Kundepanel - Create group of recipients
number validate_info_wfrid = 1497863; //CG0129inz - FÆRGEN A/S Kundepanel - Validate the email csv info
//number optimize_wfRid = 1497864; //CG0129inz - FÆRGEN A/S Kundepanel - Optimize the email csv record
number optimize_wfRid = 1605713; //CG0129inz - FÆRGEN A/S Kundepanel - Optimize the email csv record - ver 2
number createQAS_wfRid= 1497865; //CG0129inz - FÆRGEN A/S Kundepanel - create qas n base qnaire
number import_wfRid= 1497867; //CG0129inz - FÆRGEN A/S Kundepanel - Import email data
number Bulkmail_wfRid = 1541304; // CG0129inz - FÆRGEN A/S Kundepanel - Do the mailout for recipients

// Create the new groups containing the respondent
number groupTemplateResourceId = 773261; // standard group
number parentResourceId = 1297798; // CG0129inz- Færgen KundeForum - group import
number EmailgroupRid = Workflow_call(Creategroup_wfrid, {"CG0129inz - Færgen KundeForum - Import email to Base qnaire", parentResourceId , groupTemplateResourceId });

array currentdatetime = getCurrentDateTime(Timezone_Romance_Standard_Time);
number currentvalue = currentdatetime[DateTime_Year]*10000 + currentdatetime[DateTime_Month]*100 + currentdatetime[DateTime_Day];

//start get the upload csv file
string empt = empty;
CsvReader csv = new CsvReader(csvData, true, ";", "'", "\"", empt, true, false);
number fieldCount = csv.FieldCount;
array addToSurvey;
array headers = csv.Headers;
while(csv.ReadNextRecord()) {
Dictionary csvinfo = Workflow_call(info_wfrid, {fieldCount, headers, csv});
if (Workflow_call(validate_info_wfrid, {csvinfo,DCSRid})== true)
{
addToSurvey.Add(csvinfo);
}
}
//addJournal(1497860,54,"Comment","before optimize_wfRid " + convertToString(addToSurvey));
if (isEmpty(addToSurvey) == false)
{
//Remove the duplicate email
addToSurvey = Workflow_call(optimize_wfRid,{addToSurvey});

//create qas and import
addToSurvey = Workflow_call(createQAS_wfRid,{PQRid,EmailgroupRid,addToSurvey});
Workflow_call(import_wfRid,{addToSurvey,PQRid,importtype});
//send bulkmail
InvitationBmRid = Workflow_call(Bulkmail_wfRid,{"CG0129inz - Færgen KundeForum - Email Import To Base Qnaire Invitation",PQRid,MailtemplateRid,EmailgroupRid});

}
addJournal(1497860,54,"Comment","Import for " + convertToString(currentvalue) + " is done. The bulkmailRid "+ convertToString(InvitationBmRid) + " was sent out.");
</source>

==== Step 3 : Execute the program to upload the file ====

Open the command line, then Execute "SendFileToCatglobe.exe". This program will need the params like below :

* username : input the username for logging to the site where we input the workflow
* password : input the password for logging to the site where we input the workflow
* workflowrid : input the workflow resource id which we will execute when the file is uploaded
* url : the site URL where we input the workflow
* filename : the name of imported file. As usually, I always put the file in the same location with the program.
* import type : currently, we only support 2 types : "email" (value = 6) and "Aftale kunde" (value = 7)
Here is example :

[[Image:The_program_executed.jpg]]

[[category:Production guidelines]]

CG0129inz - FÆRGEN A/S Kundepanel - Import email info to base questionnaire

2012-07-03T08:12:04Z

Cg huyphong: /* Step 3 : Execute the program to upload the file */

== General information ==

{| border="1" class="VerticalTable"
|-
! style="background-color: rgb(244, 219, 165); text-align: center;" | <br>
! style="background-color: rgb(244, 219, 165); text-align: center;" | <br>
|-
| Site<br>
| inzights.catglobe.com<br>
|-
| Catinét project no<br>
| 0129inz<br>
|-
| Client<br>
|
|}

== How to send out reminders ==

=== Goal ===

This is a standard setup to import the file which contains the email address to the base questionnaire then send the invitation to the imported email.

=== How to do ===

The general solution is to execute the .exe program to upload the csv file. After it is uploaded, the workflow script will validate and import the uploaded info to the base questionnaire.

==== Step 1 : Create the list of email address ====

We create the ".csv" file containing the email address like

[[Image:File_containing_the_email_address.jpg]]

==== Step 2 :Prepare the workflow script for solving the uploaded data ====

<source lang="javascript">
array a = Workflow_getParameters();
string csvData = a[0];
number importtype = convertToNumber(a[1]);
number DCSRid = 1497858; // DCS : used for filtering the email. The real value should be : 1497858
number PQRid = 1289245; // PQRid: used for the imported PQ. The real value should be : 1289245
number MailtemplateRid = 1497895; // MailtemplateRid: used for the mail template. The real value should be : 1497895
DCS_use(DCSRid);
DCS_rebuild();

number InvitationBmRid = 0;
number info_wfrid = 1293521; //CG0129inz - FÆRGEN A/S Kundepanel - get info from the record on csv file
number Creategroup_wfrid = 1308275; //CG0129inz - FÆRGEN A/S Kundepanel - Create group of recipients
number validate_info_wfrid = 1497863; //CG0129inz - FÆRGEN A/S Kundepanel - Validate the email csv info
//number optimize_wfRid = 1497864; //CG0129inz - FÆRGEN A/S Kundepanel - Optimize the email csv record
number optimize_wfRid = 1605713; //CG0129inz - FÆRGEN A/S Kundepanel - Optimize the email csv record - ver 2
number createQAS_wfRid= 1497865; //CG0129inz - FÆRGEN A/S Kundepanel - create qas n base qnaire
number import_wfRid= 1497867; //CG0129inz - FÆRGEN A/S Kundepanel - Import email data
number Bulkmail_wfRid = 1541304; // CG0129inz - FÆRGEN A/S Kundepanel - Do the mailout for recipients

// Create the new groups containing the respondent
number groupTemplateResourceId = 773261; // standard group
number parentResourceId = 1297798; // CG0129inz- Færgen KundeForum - group import
number EmailgroupRid = Workflow_call(Creategroup_wfrid, {"CG0129inz - Færgen KundeForum - Import email to Base qnaire", parentResourceId , groupTemplateResourceId });

array currentdatetime = getCurrentDateTime(Timezone_Romance_Standard_Time);
number currentvalue = currentdatetime[DateTime_Year]*10000 + currentdatetime[DateTime_Month]*100 + currentdatetime[DateTime_Day];

//start get the upload csv file
string empt = empty;
CsvReader csv = new CsvReader(csvData, true, ";", "'", "\"", empt, true, false);
number fieldCount = csv.FieldCount;
array addToSurvey;
array headers = csv.Headers;
while(csv.ReadNextRecord()) {
Dictionary csvinfo = Workflow_call(info_wfrid, {fieldCount, headers, csv});
if (Workflow_call(validate_info_wfrid, {csvinfo,DCSRid})== true)
{
addToSurvey.Add(csvinfo);
}
}
//addJournal(1497860,54,"Comment","before optimize_wfRid " + convertToString(addToSurvey));
if (isEmpty(addToSurvey) == false)
{
//Remove the duplicate email
addToSurvey = Workflow_call(optimize_wfRid,{addToSurvey});

//create qas and import
addToSurvey = Workflow_call(createQAS_wfRid,{PQRid,EmailgroupRid,addToSurvey});
Workflow_call(import_wfRid,{addToSurvey,PQRid,importtype});
//send bulkmail
InvitationBmRid = Workflow_call(Bulkmail_wfRid,{"CG0129inz - Færgen KundeForum - Email Import To Base Qnaire Invitation",PQRid,MailtemplateRid,EmailgroupRid});

}
addJournal(1497860,54,"Comment","Import for " + convertToString(currentvalue) + " is done. The bulkmailRid "+ convertToString(InvitationBmRid) + " was sent out.");
</source>

==== Step 3 : Execute the program to upload the file ====

Open the command line, then Execute "SendFileToCatglobe.exe". This program will need the params like below :

* username : input the username for logging to the site where we input the workflow
* password : input the password for logging to the site where we input the workflow
* workflowrid : input the workflow resource id which we will execute when the file is uploaded
* url : the site URL where we input the workflow
* filename : the name of imported file. As usually, I always put the file in the same location with the program.
* import type : currently, we only support 2 types : "email" (value = 6) and "Aftale kunde" (value = 7)
Here is example :

[[File:The_program_executed.jpg]]

[[category:Production guidelines]]

File:The program executed.jpg

2012-07-03T08:10:52Z

Cg huyphong:

CG0129inz - FÆRGEN A/S Kundepanel - Import email info to base questionnaire

2012-07-03T08:07:46Z

Cg huyphong: /* Step 3 : Execute the program to upload the file */

== General information ==

{| border="1" class="VerticalTable"
|-
! style="background-color: rgb(244, 219, 165); text-align: center;" | <br>
! style="background-color: rgb(244, 219, 165); text-align: center;" | <br>
|-
| Site<br>
| inzights.catglobe.com<br>
|-
| Catinét project no<br>
| 0129inz<br>
|-
| Client<br>
|
|}

== How to send out reminders ==

=== Goal ===

This is a standard setup to import the file which contains the email address to the base questionnaire then send the invitation to the imported email.

=== How to do ===

The general solution is to execute the .exe program to upload the csv file. After it is uploaded, the workflow script will validate and import the uploaded info to the base questionnaire.

==== Step 1 : Create the list of email address ====

We create the ".csv" file containing the email address like

[[Image:File_containing_the_email_address.jpg]]

==== Step 2 :Prepare the workflow script for solving the uploaded data ====

<source lang="javascript">
array a = Workflow_getParameters();
string csvData = a[0];
number importtype = convertToNumber(a[1]);
number DCSRid = 1497858; // DCS : used for filtering the email. The real value should be : 1497858
number PQRid = 1289245; // PQRid: used for the imported PQ. The real value should be : 1289245
number MailtemplateRid = 1497895; // MailtemplateRid: used for the mail template. The real value should be : 1497895
DCS_use(DCSRid);
DCS_rebuild();

number InvitationBmRid = 0;
number info_wfrid = 1293521; //CG0129inz - FÆRGEN A/S Kundepanel - get info from the record on csv file
number Creategroup_wfrid = 1308275; //CG0129inz - FÆRGEN A/S Kundepanel - Create group of recipients
number validate_info_wfrid = 1497863; //CG0129inz - FÆRGEN A/S Kundepanel - Validate the email csv info
//number optimize_wfRid = 1497864; //CG0129inz - FÆRGEN A/S Kundepanel - Optimize the email csv record
number optimize_wfRid = 1605713; //CG0129inz - FÆRGEN A/S Kundepanel - Optimize the email csv record - ver 2
number createQAS_wfRid= 1497865; //CG0129inz - FÆRGEN A/S Kundepanel - create qas n base qnaire
number import_wfRid= 1497867; //CG0129inz - FÆRGEN A/S Kundepanel - Import email data
number Bulkmail_wfRid = 1541304; // CG0129inz - FÆRGEN A/S Kundepanel - Do the mailout for recipients

// Create the new groups containing the respondent
number groupTemplateResourceId = 773261; // standard group
number parentResourceId = 1297798; // CG0129inz- Færgen KundeForum - group import
number EmailgroupRid = Workflow_call(Creategroup_wfrid, {"CG0129inz - Færgen KundeForum - Import email to Base qnaire", parentResourceId , groupTemplateResourceId });

array currentdatetime = getCurrentDateTime(Timezone_Romance_Standard_Time);
number currentvalue = currentdatetime[DateTime_Year]*10000 + currentdatetime[DateTime_Month]*100 + currentdatetime[DateTime_Day];

//start get the upload csv file
string empt = empty;
CsvReader csv = new CsvReader(csvData, true, ";", "'", "\"", empt, true, false);
number fieldCount = csv.FieldCount;
array addToSurvey;
array headers = csv.Headers;
while(csv.ReadNextRecord()) {
Dictionary csvinfo = Workflow_call(info_wfrid, {fieldCount, headers, csv});
if (Workflow_call(validate_info_wfrid, {csvinfo,DCSRid})== true)
{
addToSurvey.Add(csvinfo);
}
}
//addJournal(1497860,54,"Comment","before optimize_wfRid " + convertToString(addToSurvey));
if (isEmpty(addToSurvey) == false)
{
//Remove the duplicate email
addToSurvey = Workflow_call(optimize_wfRid,{addToSurvey});

//create qas and import
addToSurvey = Workflow_call(createQAS_wfRid,{PQRid,EmailgroupRid,addToSurvey});
Workflow_call(import_wfRid,{addToSurvey,PQRid,importtype});
//send bulkmail
InvitationBmRid = Workflow_call(Bulkmail_wfRid,{"CG0129inz - Færgen KundeForum - Email Import To Base Qnaire Invitation",PQRid,MailtemplateRid,EmailgroupRid});

}
addJournal(1497860,54,"Comment","Import for " + convertToString(currentvalue) + " is done. The bulkmailRid "+ convertToString(InvitationBmRid) + " was sent out.");
</source>

==== Step 3 : Execute the program to upload the file ====

Open the command line, then Execute "SendFileToCatglobe.exe". This program will need the params like below :

* username : input the username for logging to the site where we input the workflow
* password : input the password for logging to the site where we input the workflow
* workflowrid : input the workflow resource id which we will execute when the file is uploaded
* url : the site URL where we input the workflow
* filename : the name of imported file. As usually, I always put the file in the same location with the program.
* import type : currently, we only support 2 types : "email" (value = 6) and "Aftale kunde" (value = 7)
Here is example : SendFileToCatglobe.exe administrator cg 1309940 http://heisenberg5801.catglobe.com 2011111Copy.csv 6

[[category:Production guidelines]]

CG0129inz - FÆRGEN A/S Kundepanel - Import email info to base questionnaire

2012-07-03T07:55:51Z

Cg huyphong: /* Step 2 :Prepare the workflow script for solving the uploaded data */

== General information ==

{| border="1" class="VerticalTable"
|-
! style="background-color: rgb(244, 219, 165); text-align: center;" | <br>
! style="background-color: rgb(244, 219, 165); text-align: center;" | <br>
|-
| Site<br>
| inzights.catglobe.com<br>
|-
| Catinét project no<br>
| 0129inz<br>
|-
| Client<br>
|
|}

== How to send out reminders ==

=== Goal ===

This is a standard setup to import the file which contains the email address to the base questionnaire then send the invitation to the imported email.

=== How to do ===

The general solution is to execute the .exe program to upload the csv file. After it is uploaded, the workflow script will validate and import the uploaded info to the base questionnaire.

==== Step 1 : Create the list of email address ====

We create the ".csv" file containing the email address like

[[Image:File_containing_the_email_address.jpg]]

==== Step 2 :Prepare the workflow script for solving the uploaded data ====

<source lang="javascript">
array a = Workflow_getParameters();
string csvData = a[0];
number importtype = convertToNumber(a[1]);
number DCSRid = 1497858; // DCS : used for filtering the email. The real value should be : 1497858
number PQRid = 1289245; // PQRid: used for the imported PQ. The real value should be : 1289245
number MailtemplateRid = 1497895; // MailtemplateRid: used for the mail template. The real value should be : 1497895
DCS_use(DCSRid);
DCS_rebuild();

number InvitationBmRid = 0;
number info_wfrid = 1293521; //CG0129inz - FÆRGEN A/S Kundepanel - get info from the record on csv file
number Creategroup_wfrid = 1308275; //CG0129inz - FÆRGEN A/S Kundepanel - Create group of recipients
number validate_info_wfrid = 1497863; //CG0129inz - FÆRGEN A/S Kundepanel - Validate the email csv info
//number optimize_wfRid = 1497864; //CG0129inz - FÆRGEN A/S Kundepanel - Optimize the email csv record
number optimize_wfRid = 1605713; //CG0129inz - FÆRGEN A/S Kundepanel - Optimize the email csv record - ver 2
number createQAS_wfRid= 1497865; //CG0129inz - FÆRGEN A/S Kundepanel - create qas n base qnaire
number import_wfRid= 1497867; //CG0129inz - FÆRGEN A/S Kundepanel - Import email data
number Bulkmail_wfRid = 1541304; // CG0129inz - FÆRGEN A/S Kundepanel - Do the mailout for recipients

// Create the new groups containing the respondent
number groupTemplateResourceId = 773261; // standard group
number parentResourceId = 1297798; // CG0129inz- Færgen KundeForum - group import
number EmailgroupRid = Workflow_call(Creategroup_wfrid, {"CG0129inz - Færgen KundeForum - Import email to Base qnaire", parentResourceId , groupTemplateResourceId });

array currentdatetime = getCurrentDateTime(Timezone_Romance_Standard_Time);
number currentvalue = currentdatetime[DateTime_Year]*10000 + currentdatetime[DateTime_Month]*100 + currentdatetime[DateTime_Day];

//start get the upload csv file
string empt = empty;
CsvReader csv = new CsvReader(csvData, true, ";", "'", "\"", empt, true, false);
number fieldCount = csv.FieldCount;
array addToSurvey;
array headers = csv.Headers;
while(csv.ReadNextRecord()) {
Dictionary csvinfo = Workflow_call(info_wfrid, {fieldCount, headers, csv});
if (Workflow_call(validate_info_wfrid, {csvinfo,DCSRid})== true)
{
addToSurvey.Add(csvinfo);
}
}
//addJournal(1497860,54,"Comment","before optimize_wfRid " + convertToString(addToSurvey));
if (isEmpty(addToSurvey) == false)
{
//Remove the duplicate email
addToSurvey = Workflow_call(optimize_wfRid,{addToSurvey});

//create qas and import
addToSurvey = Workflow_call(createQAS_wfRid,{PQRid,EmailgroupRid,addToSurvey});
Workflow_call(import_wfRid,{addToSurvey,PQRid,importtype});
//send bulkmail
InvitationBmRid = Workflow_call(Bulkmail_wfRid,{"CG0129inz - Færgen KundeForum - Email Import To Base Qnaire Invitation",PQRid,MailtemplateRid,EmailgroupRid});

}
addJournal(1497860,54,"Comment","Import for " + convertToString(currentvalue) + " is done. The bulkmailRid "+ convertToString(InvitationBmRid) + " was sent out.");
</source>

==== Step 3 : Execute the program to upload the file ====

Open the command line, then Execute "SendFileToCatglobe.exe". This program will need the params like below :

* username : input the username for logging to the site where we input the workflow
* password : input the password for logging to the site where we input the workflow
* workflowrid : input the workflow resource id which we will execute when the file is uploaded
* url : the site URL where we input the workflow
* filename : the name of imported file. As usually, I always put the file in the same location with the program.

Here is example :

[[Image:Execute_the_program.jpg]]

[[category:Production guidelines]]

Sms send

2012-04-17T04:05:15Z

Cg huyphong: /* Sms_send */

{{HelpFiles}}

==== Sms_send ====

This function makes it possible to send SMS messages to users.

'''Syntax'''

Sms_send(''userResourceIds, smsoutprovidername, message, [fromresourceid]'')

'''Arguments'''

''userResourceId:'' array of resource ids of the users who are to receive the SMS

''smsoutprovidername'': the name of the provider which will be used to send the SMS. Look for the ones available in your lists of SMS providers and copy the exact name from there.

''message'': the text that you want to send to the users. Should be a string of max 160 characters or it may get truncated.

''fromresourceid'': (optional) used to determine the source resource, which is again used to determine which keywords to use in the mail template, and also determines which SENT box the message ends up in. Default is current user.

'''Return type'''

An array of status codes will be returned as result of the function. There will exist one status for each user to which an SMS was sent. The status codes are:

{| width="907" cellpadding="2" border="1" class="tableintopic" style="border-collapse: collapse; border: 1px solid #010101"
|- align="left" valign="top"
| width="48" bgcolor="#FACEAA" style="border: 1px solid #010101" |
Code

| width="288" bgcolor="#FACEAA" style="border: 1px solid #010101" |
Constant name

| width="571" bgcolor="#FACEAA" style="border: 1px solid #010101" |
Description

|- align="left" valign="top"
| width="48" style="border: 1px solid #010101" |
0

| width="288" style="border: 1px solid #010101" |
SMS_STATUS_SUCCESSFUL

| width="571" style="border: 1px solid #010101" |
Sent successfully

|- align="left" valign="top"
| width="48" style="border: 1px solid #010101" |
1

| width="288" style="border: 1px solid #010101" |
SMS_STATUS_NO_VALID_PHONE_NUMBER

| width="571" style="border: 1px solid #010101" |
No valid phone number is found to receive the message or user does not have at least 1 phone number

|- align="left" valign="top"
| width="48" style="border: 1px solid #010101" |
2

| width="288" style="border: 1px solid #010101" |
SMS_STATUS_MESSAGE_TOO_LONG

| width="571" style="border: 1px solid #010101" |
The message length exceeds 160 characters

|- align="left" valign="top"
| width="48" style="border: 1px solid #010101" |
3

| width="288" style="border: 1px solid #010101" |
SMS_STATUS_NOT_USER_RESOURCE

| width="571" style="border: 1px solid #010101" |
The type of given resource is not type of user

|- align="left" valign="top"
| width="48" style="border: 1px solid #010101" |
4

| width="288" style="border: 1px solid #010101" |
SMS_STATUS_USER_DOES_NOT_EXIST

| width="571" style="border: 1px solid #010101" |
The given user does not exist

|- align="left" valign="top"
| width="48" style="border: 1px solid #010101" |
5

| width="288" style="border: 1px solid #010101" |
SMS_STATUS_USER_DELETED

| width="571" style="border: 1px solid #010101" |
This user has been deleted

|- align="left" valign="top"
| width="48" style="border: 1px solid #010101" |
6

| width="288" style="border: 1px solid #010101" |
SMS_STATUS_USER_DISABLED

| width="571" style="border: 1px solid #010101" |
This user has been disabled

|- align="left" valign="top"
| width="48" style="border: 1px solid #010101" |
7

| width="288" style="border: 1px solid #010101" |
SMS_STATUS_MISSING_RESOURCE_ACCESS

| width="571" style="border: 1px solid #010101" |
Current user does not have at least observer access to given user 

|}

'''Examples'''

array users = {1234567,1234568,1234569};

string smsprovidername = "TeleCo";

string msg = "The project has been completed";

Sms_send(users,smsprovidername,msg);

'''Availability'''

Version 5.8.1 __NOTOC__ <br>

[[Category:Email_and_SMS_Functions]]

Questionnaire - Javascript Fun Tips

2012-02-15T04:50:36Z

Cg huyphong:

== Examples list==

[[Basic_Hints|Basic Hints]]

----

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

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

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

[[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 single questions as dropdown lists in their own pages]]

[[Show language selector page]]

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

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

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

[[Convert closed question TextBox into TextArea]]

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

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

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

[[Category:Miscellaneous]]

Change progress bar images of questionnaire

2012-02-14T07:40:14Z

Cg huyphong:

== Change progress bar images of questionnaire layout ==

We have 12 images used for progress bar in questionnaire layout. To change them, we will override the function quest.progress.getHTML().

@Note: The way I used below is only used in Questionnaire layout template because in "Questionnaire layout template" we can insert javascript inside HTML tab.

Step 1: Upload 12 images in any folder, better if you store them in the Images tab of Questionnaire layout editor to handle easly in future.

Step 2: Get their links and replace in the javascript below (in step 3).

Step 3: Paste this code below (include open and close SCRIPT tag) into HTML tab of Questionnaire layout editor.

Questionnaire on cg.catglobe.com site: '''Javascript demo 04''' (172339)<br>

<source lang="javascript">

<SCRIPT type=text/javascript>
if (typeof quest != "undefined")
{
//Replace your image links here
quest.progress.images[0] = "/Images/GetImage.aspx?rid=5b9cb0ba-aec2-4dab-9e40-4f2c9b65f439";
quest.progress.images[1] = "/Images/GetImage.aspx?rid=b345753b-0421-4057-80b8-1a352381be39";
quest.progress.images[2] = "/Images/GetImage.aspx?rid=e53d9e52-0626-4e89-8585-6eda036b1404";
quest.progress.images[3] = "/Images/GetImage.aspx?rid=a5c7bc2f-295b-45c4-9b27-f4680fc09d26";
quest.progress.images[4] = "/Images/GetImage.aspx?rid=17e47887-4e55-45dc-b318-c6bd0649bab6";
quest.progress.images[5] = "/Images/GetImage.aspx?rid=17bcf8b5-ffd5-4242-ad35-86692c58024a";
quest.progress.images[6] = "/Images/GetImage.aspx?rid=3d6b6526-8731-4bc1-a40a-9dac1abe4f7f";
quest.progress.images[7] = "/Images/GetImage.aspx?rid=f8c61240-c39b-49b5-ab80-ade5e8a94ad0";
quest.progress.images[8] = "/Images/GetImage.aspx?rid=b52bf511-5bdc-4427-b750-bf4e757572a2";
quest.progress.images[9] = "/Images/GetImage.aspx?rid=575979f6-b780-45a6-adf4-cc1f564c8084";
quest.progress.images[10] = "/Images/GetImage.aspx?rid=2027ea23-b428-4a87-80ee-f180966beb8d";
quest.progress.images[11] = "/Images/GetImage.aspx?rid=5ce8fa51-e815-4007-a77e-c66e11f370e5";

quest.progress.getHTML = function()
{
var i, j;
var sres = "";
if (this.images.length > 0) this.step = 100 / this.images.length;
sres += "<table border="+this.bordersize+">";
sres += "<tr><td>";
sres += "<table border=0 cellspacing=0 cellpadding=0>";
sres += "<tr>";
if (this.type == 0) {
j = 0;
for (i = 0; i < this.pct; i += this.step) {
sres += "<td><img src=\"" + this.images[j++]+ "\"></td>";
}
}
else {
j = Math.floor(this.pct / this.step);
if (j >= this.images.length && j > 0) j = this.images.length - 1;
sres += "<td><img src=\"" + this.images[j]+"\"></td>";
}
sres += "</tr>";
sres += "</table>";
sres += "</td></tr>";
sres += "</table>";
return sres;
}
}
</SCRIPT>
</source>

== Another solution to change the progress bar ==

Open the js of the question, paste this below code and update the number of the progress you want like below :

<source lang="javascript">
quest.progress.pct = 90;
</source>

Show more than one singe question in the same page

2012-02-14T07:19:58Z

Cg huyphong:

== Challenge ==

In order to save time clicking Next<br>As a questionnaire creator<br>I want to show more than one single questions in the same page<br>

'''Example'''

[[Image:MultiSingleQuestions.png]]

== Solution ==

Create a page question to put the questions on

Set single questions to dummy questions

Add javascript to the page question

NOTICE: different languages have different texts, remember to add scripts for each language with corresponding texts

== Code ==

There are 2 parts of script:

*Common script for creating an HTML table for each single question: this part should be left '''unchanged''', and could be added to either questionnaire's script property or the page question's script property. It is recommended to put in questionnaire's property so that it can be shared among different questions.

<br/>
<source lang="javascript">
function Single(q)
{
this.text = q.text;
this.label = "QUESTION." + q.label;
this.shortLabel = q.label;
this.aoValues = q.aoValues;
this.aoTexts = q.aoTexts;
this.selectedValue = q.selectedValue;
}

//initialise HTML for all single questions
Single.prototype.getHTML = function()
{
//add outer table
var outerTable = $("<table>").addClass("question_outer");

//question text
outerTable.append($("<tr>").append($("<td id = 'question_text'>").append($("<p>").attr("align", "center").text(this.text))));

//option table
var optionTable = $("<table>").addClass("option_table");
outerTable.append($("<tr>").append($("<td>").append(optionTable)));

var i;
var n = this.aoValues.length;

var tr;
for(i=0;i<n;i++)
{
tr = this.createRow(i);
optionTable.append(tr);
}

outerTable.append($("<input type='hidden'>").attr("name", this.label).val(this.selectedValue));

return outerTable;
}

//create row for each answer options
Single.prototype.createRow = function(i)
{
var even;
if(i % 2 == 0)
even = "even";
else
even = "odd";

var name = this.label;
var ao = this.aoValues[i];
var id = name + "_" + ao;

var checked = "";
if(ao == this.selectedValue) checked = "checked";

var tr = $("<tr>").addClass("option_row option_row_" + even);
tr.append($("<td>").addClass("answer_option_cell"));
tr.append($("<table>").append($("<tr>")));

var radiob = $("<td>").attr("align","center")
.append($("<input type='radio' id='" + id + "' name='" + this.shortLabel + "' value='" + ao + "' onclick='javascript:optclickcustom(\"" + name + "\", " + ao + ", " + false + ");'" + checked + ">"));
var aotext = $("<td>").attr("align","left")
.append($("<a class='option_link' href='javascript:optclickcustom(\"" + name + "\", " + ao + ", " + true + ");'>"+this.aoTexts[i]+"</a>"));
tr.append(radiob).append(aotext);

return tr;
}

Single.prototype.validate = function()
{
var a = true;
if ($("input:hidden[name='" + this.label + "']").val() == "")
{
var a = false;
showError(quest.requiredtext.replace(".",": ") + this.text);
}
return a;
}

function showError(e)
{
ErrorMessages.getInstance().showErrorMessage(e);
}

function optclickcustom(name, value, bool)
{
var id = name + "_" + value;
$("input:hidden[name='" + name + "']").val(value);
if (bool)
$("input[id='" + id + "']").attr("checked", true);
}

</source>
<br/>
*The second script part needs to be <b>modified</b> by the questionnaire creator to fit the real questionnaire. It must be added to the page question's javascript.
<br/>
<source lang="javascript">
var qH1;
var qH2;
var qH3;

quest.onInit = function()
{
//------CONFIGURATION PART---------------
var q1 = {
'label': 'Q1',//question's label
'text':'Q1',//question's text
'aoTexts': ['AO1', 'AO2'],//answer options' texts
'aoValues': [1,2],//answer options' values
'selectedValue':"{{Q1.value}}"//previously selected value, please remember to use EXACT texts, do not use loops to generate values
};

var q2 = {
'label': 'Q2',
'text':'Q2',
'aoTexts': ['AO1', 'AO2', 'AO3'],
'aoValues': [1,2,3],
'selectedValue':"{{Q2.value}}"
};

var q3 = {
'label': 'Q3',
'text':'Q3',
'aoTexts': ['AO1', 'AO2', 'AO3', 'AO4'],
'aoValues': [1,2,3,4],
'selectedValue':"{{Q3.value}}"
};

//create object to get HTML
qH1 = new Single(q1);
qH2 = new Single(q2);
qH3 = new Single(q3);

var table = $("<table cellspacing='10'>").attr("align","center");

var tr = $("<tr>");
tr.append($("<td>").append(qH1.getHTML()));
table.append(tr);

var tr = $("<tr>");
tr.append($("<td>").append(qH2.getHTML()));
table.append(tr);

var tr = $("<tr>");
tr.append($("<td>").append(qH3.getHTML()));
table.append(tr);

$("#page_question_text").append(table);
$(".question_outer").width("100%");
}

//Check if all questions have values
questioncheck = function()
{
ErrorMessages.getInstance().clearErrorMessages();
return qH1.validate() && qH2.validate() && qH3.validate();
}
</source>

==Code sample ==

Open the qnaire "Js demo - some js samples" (Resource Id: 159684). View the Question "ShowMoreSingleQuestion"

Show more than one singe grid in the same page

2012-02-14T04:52:03Z

Cg huyphong: /* Code */

== Challenge ==

In order to save time clicking Next<br>As a questionnaire creator<br>I want to show more than one single grid questions in the same page<br>

'''Example'''

[[Image:Show 3 single grids in the same page.png]]

== Solution ==

Create a page question to put the grid questions on

Set grid questions to dummy questions

Add javascript to the page question

NOTICE: different languages have different texts, remember to add scripts for each language with corresponding texts

== Code ==
There are 2 parts of script:
*Common script for creating an HTML table for each single grid question: this part should be left <b>unchanged</b>, and could be added to either questionnaire's script property or the page question's script property. It is recommended to put in questionnaire's property so that it can be shared among different questions.
<br/>
<source lang="javascript">
function SingleGrid(q)
{
this.text = q.text;
this.label = "QUESTION." + q.label;
this.shortLabel = q.label;
this.subQuestions = q.subQuestions;
this.aoValues = q.aoValues;
this.aoTexts = q.aoTexts;
this.selectedValues = q.selectedValues;
}

SingleGrid.prototype.getHTML = function()
{
var outerTable = $("<table>").addClass("grid_outer");

//question text
outerTable.append($("<tr>")
.append($("<td id='grid_question_text'>").append($("<p>").text(this.text)))
);

//inner table
var innerTable = $("<table>").addClass("grid_inner");
outerTable.append($("<tr>").append($("<td>").append(innerTable)));

//answer option header
var aoheader = $("<tr>");
aoheader.append($("<td>").addClass("grid_empty_cell"));

var i;
var n = this.aoTexts.length;
for(i=0;i<n;i++)
{
aoheader.append($("<td id='grid_answeroption_text_"+ (i+1) +"'>").addClass("grid_answeroption_text").text(this.aoTexts[i]));
}

innerTable.append(aoheader);

//sub questions
n = this.subQuestions.length;

var tr;

for(i=0; i<n; i++)
{
tr = this.createRow(i);
innerTable.append(tr);
outerTable.append($("<input type='hidden'>").attr("name", this.label + "." + i).val(this.selectedValues[i]));
}

return outerTable;
}

SingleGrid.prototype.createRow = function(i)
{
var even;
if (i %2 == 0)
even = "even";
else
even = "odd";

var tr = $("<tr>");
tr.append($("<td id='grid_subquestion_text_"+(i+1) + "'>").addClass("grid_subquestion_text grid_subquestion_"+even).text(this.subQuestions[i]));

for(j=0; j<this.aoValues.length;j++)
{
tr.append(this.createCell(i,j));
}
return tr;
}

SingleGrid.prototype.createCell = function(sIndex, aoIndex)
{
var even;
if (sIndex %2==0)
even = "even";
else
even = "odd";

var ao = this.aoValues[aoIndex];
var name = this.label + "." + sIndex;

var checked = "";
if (ao == this.selectedValues[sIndex])
checked = "checked";

var result = $("<td>")
.addClass("grid_subquestion_" + even)
.attr("align", "center").attr("valign", "center")
.append(
$("<input type='radio' name='"+this.shortLabel + "." + sIndex + "' value='"+ ao +"' onclick='javascript:optClick(\""+name +"\", "+ ao +");'"+checked +">")
);

return result;
}

SingleGrid.prototype.validate = function()
{
var i,n;
n = this.subQuestions.length;
var b = true;
for(i=0; i<n; i++)
{
if ($("input[name='"+this.label+"." + i + "']").val() == "")
{
b = false;
showError(quest.requiredtext.replace(".", ": ") + this.subQuestions[i]);
}
}
return b;
}

function showError(e)
{
ErrorMessages.getInstance().showErrorMessage(e);
}

function optClick(name, value)
{
$("input:hidden[name='"+name +"']").val(value);
}

</source>
<br/>
*The second script part needs to be <b>modified</b> by the questionnaire creator to fit the real questionnaire. It must be added to the page question's javascript.
<br/>
<source lang="javascript">
var qH1;
var qH2;
var qH3;

quest.onInit = function()
{
//------CONFIGURATION PART---------------
// Instead of delcaring the param like below, we can use JSON
var q1 = {
'label': 'Q1',//question's label
'text':'Q1',//question's text
'subQuestions': ['Q1 - 1', 'Q1 - 2'],//sub questions' texts
'aoTexts': ['AO1', 'AO2'],//answer options' texts
'aoValues': [1,2],//answer options' values
'selectedValues':["{{Q1[0].Value}}", "{{Q1[1].Value}}"]//previously selected value, please remember to use EXACT texts, do not use loops to generate values
};

var q2 = {
'label': 'Q2',
'text':'Q2',
'subQuestions': ['Q2 - 1', 'Q2 - 2', 'Q2 - 3'],
'aoTexts': ['AO1', 'AO2'],
'aoValues': [1,2],
'selectedValues':["{{Q2[0].Value}}", "{{Q2[1].Value}}", "{{Q2[2].Value}}"]
};

var q3 = {
'label': 'Q3',
'text':'Q3',
'subQuestions': ['Q3 - 1', 'Q3 - 2'],
'aoTexts': ['AO1', 'AO2', 'AO3'],
'aoValues': [1,2,3],
'selectedValues':["{{Q3[0].Value}}", "{{Q3[1].Value}}"]
};
//---------------------------------------------

//create wrapper object for grid questions so that we can get HTML out
qH1 = new SingleGrid(q1);
qH2 = new SingleGrid(q2);
qH3 = new SingleGrid(q3);

var table = $("<table cellspacing='10'>");

var tr = $("<tr>");
tr.append($("<td>").append(qH1.getHTML()));
table.append(tr);

tr = $("<tr>");
tr.append($("<td>").append(qH2.getHTML()));
table.append(tr);

tr = $("<tr>");
tr.append($("<td>").append(qH3.getHTML()));
table.append(tr);

$("#page_question_text").append(table);
$(".grid_outer").width("100%");
}

//Check if all questions have values
questioncheck = function()
{
ErrorMessages.getInstance().clearErrorMessages();
return qH1.validate() && qH2.validate() && qH3.validate();
}
</source>

== Code sample ==

Open the qnaire "Js demo - some js samples" (Resource Id: 159684). View the Question "ShowSingleGridInPage"

Show language selector page

2012-02-14T03:52:34Z

Cg huyphong:

==Introduction==
In order to let the respondents choose a language to view the questionnaire<br/>
As a questionnaire creator<br/>
I want to show a language selection page as below<br/>
<br/>
[[Image:Language_selector.png]]

==Solution==
*Add a page question to show the flags, hide Next and Back button
*In order to use store the selected language for future reference, we need to create a single question D_CurrentLanguage with languages as options
*In order to change the language, we need to make a post request to server with parameters:
**dir = changelanguage
**languageselector = the selected language's ISO code
*In order to go Next after setting the language, we need to submit the form again with "next" as parameter "dir"'s value
===HTML Code===
<source lang="html4strict">
<div align="center">
<table>
<tr>
<td>
<img style="border: 0" height="50" width="50" src="../../Images/GetImage.aspx?rid=9e152350-ae1e-47c7-bf0d-0a6f07df3679" onclick="Question.onLanguageSelect(1);">

</td>
<td>
Welcome, please choose your language (United Kingdom)
</td>
</tr>
<tr>
<td>
<img style="border: 0" height="50" width="50" src="../../Images/GetImage.aspx?rid=06ac1811-1aa5-4b19-9186-b46153d91106" onclick="Question.onLanguageSelect(2);">

</td>
<td>
Welcome, please choose your language (United States)
</td>
</tr>
<tr>
<td>
<img style="border: 0" height="50" width="50" src="../../Images/GetImage.aspx?rid=a3dd8263-817b-4f11-bd87-defb13b7cf68" onclick="Question.onLanguageSelect(3);">

</td>
<td>
Bienvenue - Choisissez votre pays (France)
</td>
</tr>
<tr>
<td>
<img style="border: 0" height="50" width="50" src="../../Images/GetImage.aspx?rid=e9e6fa0f-af1b-401b-89a1-5d5a9535e13c" onclick="Question.onLanguageSelect(4);">

</td>
<td>
Welcome, please choose your language (Deutschland)
</td>
</tr>
<tr>
<td>
<img style="border: 0" height="50" width="50" src="../../Images/GetImage.aspx?rid=4057e800-0de6-43a1-b737-dbe0642cd414" onclick="Question.onLanguageSelect(5);">

</td>
<td>
Welcome, please choose your language (Nederland)
</td>
</tr>
</table>
</div>
</source>
===Javascript===
<source lang=javascript>
quest.myOnInit = function()
{
$('img').css("cursor","pointer");
$('<input type="hidden">')
.attr('id', 'languageSelector')
.attr('name', 'languageselector')
.appendTo($('#page_question_text'));
$('#page_question_text').append($("<input type='hidden'>").attr('name','QUESTION.D_CurrentLanguage'));
}

Question =
{

onLanguageSelect: function(option)
{
$("input[name='QUESTION.D_CurrentLanguage']").val(option);
var isoCode;
switch(option)
{
case 1:
isoCode = "en-UK";
break;
case 2:
isoCode = "en-US";
break;
case 3:
isoCode = "fr-FR";
break;
case 4:
isoCode = "de-DE";
break;
case 5:
isoCode = "nl-NL";
break;
default:
break;
}

$('#languageSelector').val(isoCode);

var myurl = $("form").attr("action");
var mydata = "dir=changelanguage&languageselector="+isoCode;
$.ajax({
type: "POST",
url: myurl,
data: mydata,
success: function(msg)
{
document.query.dir.value = "next";
document.query.submit();
},
error:function(msg)
{
}
});

}
}
</source>

==Code sample==

Open the qnaire "Js demo - some js samples" (Resource Id: 159684). View the setup of the Question "LanguageSelector"

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

2012-02-13T09:40:51Z

Cg huyphong:

== 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/>
[[Image: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"

Show flash movies on questionnaire viewer

2012-02-13T08:53:58Z

Cg huyphong:

== Challenge ==

In order to view multiple flash movies in questionnaire viewer (which is similar to flash movies we already have in my portal, for further information please look at: [http://wiki.catglobe.com/index.php/Movie_player_element http://wiki.catglobe.com/index.php/Movie_player_element])

As a questionnaire creator

I want to show a list of supported flash movies (.flv) by Catglobe

'''Example'''

I have an single grid question like below

[[Image:FlashPlayer.Jpeg]]

== Solution ==

*Upload the new flash movies to the CG server (or any resource you want) and get their links

*Create a new single grid question named<br>*Add&nbsp;javascript to the question to show a list of flash movies on above of grid

== Code ==

=== Create Movie clip viewer object ===

<source lang="javascript">
var MovieclipViewer3 =
{
onInit: function(clip, element, linkText)
{
MovieclipViewer3.flash = CGFlashPlayers.initialize("xpflash", "http://fire.catglobe.com/Script/CGFlashPlayer/CGFlashPlayer.swf", 298,265);
$(element).html(MovieclipViewer3.flash.toString());
MovieclipViewer3.flash.ParentDom = $(element);

var p = $("<p>");
$(p).append($("<u>" + linkText + "</u>").css("cursor","pointer").css("font-style", "italic").click(
function()
{
getPlayList();
}
));
$(element).append($("<br/>"));
$(element).append($(p));
$(element).append($("<br/>"));

MovieclipViewer3.flash.visiblePlaylistButton(false);
MovieclipViewer3.flash.visibleControlBar(false);
MovieclipViewer3.flash.registerEvent(CGFlashPlayers.Events.OnPlayListReady, MovieclipViewer3.onPlayListReady);
MovieclipViewer3.flash.registerEvent(CGFlashPlayers.Events.OnStop, MovieclipViewer3.onStop);

// Prepare the play list
MovieclipViewer3.flash.openPlayList(clip);
},
onPlayListReady: function()
{
MovieclipViewer3.flash.play();
},
onStop: function()
{
getPlayList();
}
}
</source>

=== Create movies list ===

<source lang="javascript">
function getPlayList()
{
var clipLinks = new Array();
//be careful when using the below links because you must ensure that the user who answers this answer sheet has resource access on these attachments.
clipLinks[0] = "http://fire.catglobe.com/Attachments/GetAttachment.aspx?id=369842";
clipLinks[1] = "http://fire.catglobe.com/Attachments/GetAttachment.aspx?id=369843";
clipLinks[2] = "http://fire.catglobe.com/Attachments/GetAttachment.aspx?id=369844";
clipLinks[3] = "http://fire.catglobe.com/Attachments/GetAttachment.aspx?id=369845";
clipLinks[4] = "http://fire.catglobe.com/Attachments/GetAttachment.aspx?id=369846";
var clipNames = new Array();
clipNames[0] = "Clip 1";
clipNames[1] = "Clip 2";
clipNames[2] = "Clip 3";
clipNames[3] = "Clip 4";
clipNames[4] = "Clip 5";
var content = $(".playlist");
$(content).html("");
var p = $("<p>").css("padding-bottom", "5");
var ul = $("<ul>");
$(content).append($(p));
$(p).append($(ul));
for(var i= 0; i<clipLinks.length; i++)
{
$(ul).append($("<li>").text(clipNames[i]).css("cursor","pointer").css("font-style", "italic").val(i)
.click(
function()
{
MovieclipViewer3.onInit(clipLinks[this.value],content, "<<< Back to main list");
}
)
)
}
}
</source>

=== Create a div storing movies list ===

<source lang="javascript">
quest.onInit = function()
{
if (document.createElement && document.getElementsByTagName) {
var head = document.getElementsByTagName('head')[0];

var script = document.createElement('script');
script.setAttribute('type', 'text/javascript');
script.setAttribute('src','http://fire.catglobe.com/Script/CGFlashPlayer/CGFlashPlayer.js');

head.appendChild(script);
} else {
alert('Your browser can\'t deal with the DOM standard. That means it\'s old. Go fix it!');
}
//alert(quest.getHTML());
$(".grid_outer").before(
$("<table>").width("100%").attr("align", "center")
.append(
$("<tr>").css("background-color", "white")
.append(
$("<td>").attr("align", "center")
.append(
$("<div>")
.addClass("playlist")
)
)
)
)
getPlayList();
}
</source>

==Code sample==

Open the qnaire "Js demo - some js samples" (Resource Id: 159684). View the Question "Q_singlegridplayer"

Show flash movies on questionnaire viewer

2012-02-13T08:52:03Z

Cg huyphong:

== Challenge ==

In order to view multiple flash movies in questionnaire viewer (which is similar to flash movies we already have in my portal, for further information please look at: [http://wiki.catglobe.com/index.php/Movie_player_element http://wiki.catglobe.com/index.php/Movie_player_element])

As a questionnaire creator

I want to show a list of supported flash movies ( .flv )by Catglobe

'''Example'''

I have an single grid question like below

[[Image:FlashPlayer.Jpeg]]

== Solution ==

*Upload the new flash movies to the CG server (or any resource you want) and get their links

*Create a new single grid question named<br>*Add&nbsp;javascript to the question to show a list of flash movies on above of grid

== Code ==

=== Create Movie clip viewer object ===

<source lang="javascript">
var MovieclipViewer3 =
{
onInit: function(clip, element, linkText)
{
MovieclipViewer3.flash = CGFlashPlayers.initialize("xpflash", "http://fire.catglobe.com/Script/CGFlashPlayer/CGFlashPlayer.swf", 298,265);
$(element).html(MovieclipViewer3.flash.toString());
MovieclipViewer3.flash.ParentDom = $(element);

var p = $("<p>");
$(p).append($("<u>" + linkText + "</u>").css("cursor","pointer").css("font-style", "italic").click(
function()
{
getPlayList();
}
));
$(element).append($("<br/>"));
$(element).append($(p));
$(element).append($("<br/>"));

MovieclipViewer3.flash.visiblePlaylistButton(false);
MovieclipViewer3.flash.visibleControlBar(false);
MovieclipViewer3.flash.registerEvent(CGFlashPlayers.Events.OnPlayListReady, MovieclipViewer3.onPlayListReady);
MovieclipViewer3.flash.registerEvent(CGFlashPlayers.Events.OnStop, MovieclipViewer3.onStop);

// Prepare the play list
MovieclipViewer3.flash.openPlayList(clip);
},
onPlayListReady: function()
{
MovieclipViewer3.flash.play();
},
onStop: function()
{
getPlayList();
}
}
</source>

=== Create movies list ===

<source lang="javascript">
function getPlayList()
{
var clipLinks = new Array();
clipLinks[0] = "http://fire.catglobe.com/Attachments/GetAttachment.aspx?id=369842";
clipLinks[1] = "http://fire.catglobe.com/Attachments/GetAttachment.aspx?id=369843";
clipLinks[2] = "http://fire.catglobe.com/Attachments/GetAttachment.aspx?id=369844";
clipLinks[3] = "http://fire.catglobe.com/Attachments/GetAttachment.aspx?id=369845";
clipLinks[4] = "http://fire.catglobe.com/Attachments/GetAttachment.aspx?id=369846";
var clipNames = new Array();
clipNames[0] = "Clip 1";
clipNames[1] = "Clip 2";
clipNames[2] = "Clip 3";
clipNames[3] = "Clip 4";
clipNames[4] = "Clip 5";
var content = $(".playlist");
$(content).html("");
var p = $("<p>").css("padding-bottom", "5");
var ul = $("<ul>");
$(content).append($(p));
$(p).append($(ul));
for(var i= 0; i<clipLinks.length; i++)
{
$(ul).append($("<li>").text(clipNames[i]).css("cursor","pointer").css("font-style", "italic").val(i)
.click(
function()
{
MovieclipViewer3.onInit(clipLinks[this.value],content, "<<< Back to main list");
}
)
)
}
}
</source>

=== Create a div storing movies list ===

<source lang="javascript">
quest.onInit = function()
{
if (document.createElement && document.getElementsByTagName) {
var head = document.getElementsByTagName('head')[0];

var script = document.createElement('script');
script.setAttribute('type', 'text/javascript');
script.setAttribute('src','http://fire.catglobe.com/Script/CGFlashPlayer/CGFlashPlayer.js');

head.appendChild(script);
} else {
alert('Your browser can\'t deal with the DOM standard. That means it\'s old. Go fix it!');
}
//alert(quest.getHTML());
$(".grid_outer").before(
$("<table>").width("100%").attr("align", "center")
.append(
$("<tr>").css("background-color", "white")
.append(
$("<td>").attr("align", "center")
.append(
$("<div>")
.addClass("playlist")
)
)
)
)
getPlayList();
}
</source>

==Code sample==

Open the qnaire "Js demo - some js samples" (Resource Id: 159684). View the Question "Q_singlegridplayer"

Set focus on question text in the top

2012-02-10T08:21:51Z

Cg huyphong:

== Challenge ==

If the question text is to big or answer option is long then the respondent can not see the begining of the question text.

== Solution ==

*In questionnaire template editor, choose the question you want edit and then go to the Properties - Edit question properties - Language dependent - Select javascript property

== Code ==
<source lang="javascript">

quest.init = function(){
$("input[name$='Q_LongQuestionText_new']").focus();
//$("#page_question_text").scrollTop(0); -> applied for page question
this.onInit();
}
</source>

==Code sample==

Open the qnaire "Js demo - some js samples" (Resource Id: 159684). View the Question "Q_LongQuestionText_new"

Hide sub question text column in a grid question

2012-02-10T04:41:29Z

Cg huyphong:

== Challenge ==

In order not to show sub question texts in a grid question

As a questionnaire creator

I want to hide the sub question text column

'''Example'''

When creating a scale grid question, its sub question text is displayed as a column in the grid.

[[Image:QuestionTips HideText 1.jpg]]

I want to hide that column because it has no use in my context.

[[Image:QuestionTips HideText 2.jpg]] 

== Solution ==

The style sheet applied to sub question text cells is grid_subquestion_text, therefore we need to search all the elements using that style sheet class and hide them.

== Code ==
<source lang="javascript" line="1">
quest.onInit = function()
{
$(".grid_subquestion_text").hide();
}
</source>

==Code sample ==

Open the qnaire template of the qnaire "Js demo - some js samples" (Resource Id: 159684). View the Question "Q_ScaleGrid"

Show a text grid and a single question in the same page

2012-02-10T03:39:23Z

Cg huyphong:

== Challenge ==

In order to allow the respondent to skip a text grid question

As a questionnaire creator

I want to show several options at the end of a text grid question, on which the respondents can click to skip the text grid question.

(This is quite similar to question of Open type)

'''Example'''

When there is no checkbox checked, the text boxes in the grid are enabled so that we can enter the texts.

[[Image:QuestionTips TextGrid Enabled.jpg]] 

When a checkbox is checked, the textboxes are disabled.

[[Image:QuestionTips TextGrid Disabled.jpg]] 

== Solution ==

*Create 2 questions: TextGrid and Single
*Single is set as a dummy question
*Add javascript to TextGrid to include Single's HTML to the question's HTML
*Make sure when clicking a checkbox, other checkboxes are unchecked and the textboxes are disabled
*Check if there is an option selected or no textbox is left empty when clicking Next
*Load the saved value when loading the question
*Save the value entered to the two questions

== Code ==

===== We should create a SingleQuestion object containing functions to generate its own HTML and handle its checkbox click events. =====

<source lang="javascript" line="1">
var SingleQuestion = {
onInit: function(_label, _answerOptionValues, _answerOptionTexts)
{
this.label = "QUESTION." + _label;
this.aoValues = _answerOptionValues;
this.aoTexts = _answerOptionTexts;
this.selectedValue = "";
},
optClick: function(value)
{
if (this.selectedValue == value)//click the checkbox twice => unchecked
{
this.selectedValue = "";
$("input:text").attr("disabled", "");
$("input:checkbox").attr("checked", "");
}
else
{
//disable all other inputs
this.selectedValue = value;
$("input:text").attr("disabled", "disabled");

$("input:checkbox").each(
function(i)
{
if ($(this).val() == value)
$(this).attr("checked", "checked");
else
$(this).attr("checked", "");
}
);
}
},
getHTML: function()
{
var t = $("<table>");
var n = this.aoValues.length;
for (var i = 0; i<n; i++)
{
t.append(this.getHTML_AO(i));
}
t.append($("<input type = \"hidden\">").attr("name", this.label).val(""));
return t;
},
getHTML_AO: function(index)
{
var value = this.aoValues[index];
var text = this.aoTexts[index];
return $("<tr>")
.append(
$("<td>").width("16px").attr("valign", "top")
.append(
$("<input type=\"checkbox\">").attr("name", this.label).val(value).click(
function()
{
SingleQuestion.optClick(value);
}
)
)
)
.append(
$("<td>").append($("<a class=\"option_link\" href=\"javascript:SingleQuestion.optClick(" + value + ");\">" + text + "</a>"))
);
}
}
</source>

===== TextGridQuestion object is created, storing the code of validating its value before clicking Next =====

<source lang="javascript" line="1">
var TextGridQuestion =
{
onInit: function(_quest)
{
this.quest = _quest;
},
questionCheck: function()
{
acont = new Array();
msg = "";
cont = true;

for (i=0; i < this.quest.questions.length; i++)
acont[i] = (trim(document["query"][this.quest.questions[i].label].value) != "");

msg = this.quest.ingridrequiredtext+"\n";
for (i = 0; i < this.quest.questions.length; i++)
{
// If the sub question is not visible or answering this
// sub question is not answered and not required to be
// then we continue with the next sub question
if(!this.quest.questions[i].visible || (!this.quest.questions[i].required && !acont[i]))
continue;

if(this.quest.questions[i].required && !acont[i])
{
tmp = this.quest.questions[i].text;
tmp = tmp.replace(/(<!\-\-|\-\->)/ig, "");
tmp = tmp.replace(/ /ig, " ");
msg += " - '"+trim(tmp.replace(/<[^>]*>/ig, ""))+"'\n";
cont = false;
continue;
}
}

if (!cont)
{
ErrorMessages.getInstance().showErrorMessage(msg);
return false;
}
return true;
}
}
</source>

===== We also need to override questioncheck function in order not to use the default check of questionnaire viewer, which will give an error when no sub question in the text grid is answered, which is not correct in our case =====

<source lang="javascript" line="1">
this.questioncheck = function()
{
ErrorMessages.getInstance().clearErrorMessages();
if (SingleQuestion.selectedValue != "")
return true;

return TextGridQuestion.questionCheck();
}
</source>

===== Finally, we need to override quest.onInit function to execute the changes =====

<source lang="javascript" line="1">
quest.onInit = function()
{
var single = "{{Single.Value}}";
var aoV = new Array();
aoV[0] = 1;
aoV[1] = 2;
var aoT = new Array();
aoT[0] = "I do not want to give those information";
aoT[1] = "I do not have time for this"
SingleQuestion.onInit("Single", aoV, aoT);

//look for the outer grid
$(".grid_outer").append(
$("<tr>").css("background-color", "white").append($("<td>").append(SingleQuestion.getHTML()))
);

if (single != "")
{
SingleQuestion.optClick(single);
}

TextGridQuestion.onInit(this);
$("input:text").width("200px");
}
</source>

== Code sample ==

Open the qnaire "Js demo - some js samples" (Resource Id: 159684). View the Question "Q_TextGrid"

Show more than one questions in the same page

2012-02-09T07:22:37Z

Cg huyphong: /* Code example */

= Introduction =

There is a common need of showing more than one questions in the same page, but unfortunately it is not supported by the current editor (we hope it will be possible with the new viewer in a near future)

In the mean time, we need to have some work-arround tips to make it work.

= Solution 1 : (old setup and not in use any longer) =

The main idea is that when we want to display a question not in its own page, there must be an input element added to that page's html with name following a specific format: non grid question should have name as QUESTION.question_label, grid questions use names as QUESTION.question_label.grid_index.<br/>
It is very important that questions to be displayed in other pages must be made as DUMMY.<br/>
Multi/Multi grid questions are special cases, it is not good enough if we only add checkboxes with the right name format, we also need to add one hidden input for each multi/multi grid's sub questions.

<b>Example 1:</b>

I want to show my single question labeled Q1 in another question with radio buttons, I need to make sure the HTML contains the following code for each answer option.

<source lang=html4strict>
<tr>
<td width="16px" valign="top" align="center">
<input type="radio" value="1" name="QUESTION.Q1">
</td>
<td valign="top" align="left">
Answer option text 1
</td>
</tr>

</source>

<b>Example 2:</b><br/>
I want to show a single grid question label Q1 in another question, I need to make sure the HTML contains the following code for each answer option and each sub question. Q1 has 2 answer options<br/>
<source lang=html4strict>
<tr>
<td width="16px" valign="top" align="center">
<input type="radio" value="1" name="QUESTION.Q1.0">
</td>
<td width="16px" valign="top" align="center">
<input type="radio" value="2" name="QUESTION.Q1.0">
</td>

</tr>

</source>

<b>Example 3:</b><br/>
I want to show a multi question label Q1 in another question, Q1 has 2 answer options, I need to make sure the HTML contains the following code for each answer option. <br/>
<source lang=html4strict>
<tr>
<td width="16px" valign="top" align="center">
<input type="checkbox" value="1" name="QUESTION.Q1">
</td>
<td width="16px" valign="top" align="center">
Answer option 1
</td>
</tr>
</source>

Furthermore, we need to add an hidden input element like this.<br/>
<source lang=html4strict>
<input type="hidden" name="QUESTION.Q1"></input>
</source>

There are basically 3 ways of changing a question's HTML.

== Use HTML ==
This one is obvious, you can use HTML Editor to edit a question's text to include other questions.<br/>
Due to the fact that non-page questions have specific generated HTML code based on their answer options, it is usually hard to inject other questions and to make it look nice enough. <br/>
This method is usualy used when using a page question to display other questions, and it is convenient to use when the requirements are complex and the texts are not likely to change much. This one is the fastest solution among 3<br/>
The disadvantage of this method is that it is difficult to modify if the HTML is too complex.

== quest.onInit ==
This function is called after the HTML of the question is generated, therefore it is the best to use JQuery to insert the elements added to the HTML.<br/>
It would be useful to use tools like Firebug to know the ids/names of the elements where we want to insert.<br/>
This solution should be used when there is not much to change the existing HTML of the question, for example: we want to show a text grid question in another text grid question which has the same set of sub question texts.

== quest.getHTML ==
This method is to override the HTML generated by the system. This is similar to the first solution, but different in several things: this can be used with any question types; it might be more difficult to start with and not as obvious; it is effective when there are lots of elements that should be generated are similar to each others (use loops)

== Code sample ==
Open the qnaire "Js demo - some js samples" (Resource Id: 159684). View the Question "Showhtmlcode"

= Solution 2 : =

The main idea is that when we want to display a question not in its own page, we will use 1 dummy question to store all question text, answer option text that we need to put and input them as JSON format. After that, we will load the value on this question via jquery to initialize the questions. <br/>
It is very important that questions to be displayed in other pages must be made as DUMMY.<br/>

For e.g, I will add the text grid question for validating the email into another text grid question :
== Step 1 : Create a dummy text grid question for storing the email value==

[[File:Text_grid_question.jpg]]

== Step 2 : Create a dummy text question for storing the JSON ==

<source lang=html4strict>
string language = Context_getSelectedLanguage();
string label;
number i;
number n;
string result = "var q = {";
string js;
array q;
//-------GENERATE JSON FOR Email QUESTION ----------
q = Question_getQuestion("D_Email", language);
js = "{"
+ "\\\"label\\\":\\\"D_Email.0\\\","
+ "\\\"text\\\":\\\"" + decodeHtmlEntities(stripHtml(q[QUESTION_SUB_QUESTIONS][0][SUBQUESTION_TEXT])) + "\\\""
+ "}";
result = result + "\\\"email0\\\":" + js + ",";

js = "{"
+ "\\\"label\\\":\\\"D_Email.1\\\","
+ "\\\"text\\\":\\\"" + decodeHtmlEntities(stripHtml(q[QUESTION_SUB_QUESTIONS][1][SUBQUESTION_TEXT])) + "\\\""
+ "}";
result = result + "\\\"email1\\\":" + js ;
result = result + "}";
D_InitializeJSON = result;

</source>

== Step 3 : Load the JSON on the destination question ==
On the destination question , open its JS tab and input the code like below :

<source lang=html4strict>
eval("{{D_InitializeJSON}}");

function TextQuestion(q, selectedValue)
{
if (q.label.indexOf("QUESTION.") != -1)
this.label = q.label;
else
this.label = "QUESTION." + q.label;

this.selectedValue = selectedValue;
this.text = q.text;
$("input[name='" + this.label + "']").val(selectedValue);
}

TextQuestion.prototype.getHTML_Row = function(even)
{
var row = $("<tr>");
var s;

if (even)
s = "even";
else
s = "odd";
row.append($("<td>").text(this.text).addClass("grid_subquestion_text grid_subquestion_"+s));
var input = $("<input type = 'text'>");
input.attr("name", this.label).val(this.selectedValue);
row.append(
$("<td>").addClass("grid_subquestion_"+ s)
.append(input)
);

return row;
}

quest.onInit = function()
{
$(".grid_inner").append(new TextQuestion(q.email0, "{{D_Email[0].Value}}").getHTML_Row(true));
$(".grid_inner").append(new TextQuestion(q.email1, "{{D_Email[1].Value}}").getHTML_Row(false));

$("input:text").width("400px");
$(".grid_inner").find("tr").each(
function(i)
{
if(i>3) i+=1;
if(i%2==0)
$(this).children().removeClass("grid_subquestion_odd").addClass("grid_subquestion_even");
else
$(this).children().removeClass("grid_subquestion_even").addClass("grid_subquestion_odd");
}
);
}

var defaultQuestionCheck = questioncheck;
var questioncheck = function()
{
ErrorMessages.getInstance().clearErrorMessages();
var b =true;
if (!defaultQuestionCheck())
return false;
var email = $("input[name$='QUESTION.D_Email.0']").val();
if (!validateEmail(email))
{
ErrorMessages.getInstance().showErrorMessage(ErrorMessage_InvalidEmailFormat);
b= false;
}

if ($("input[name$='QUESTION.D_Email.1']").val() != email)
{
ErrorMessages.getInstance().showErrorMessage(ErrorMessage_EmailNotMatch);
b= false;
}
return b;
}
</source>

== Code sample ==
Open the qnaire "Js demo - some js samples" (Resource Id: 159684). View the Question "Q1"

=Testing=
Remember to always test your work on these following cases:
*Display correctly as expected
*Save the right value in the right place
*Display previously saved values
*Validate inputs
*Update previously saved values

Show more than one questions in the same page

2012-02-09T07:22:18Z

Cg huyphong: /* Code example */

= Introduction =

There is a common need of showing more than one questions in the same page, but unfortunately it is not supported by the current editor (we hope it will be possible with the new viewer in a near future)

In the mean time, we need to have some work-arround tips to make it work.

= Solution 1 : (old setup and not in use any longer) =

The main idea is that when we want to display a question not in its own page, there must be an input element added to that page's html with name following a specific format: non grid question should have name as QUESTION.question_label, grid questions use names as QUESTION.question_label.grid_index.<br/>
It is very important that questions to be displayed in other pages must be made as DUMMY.<br/>
Multi/Multi grid questions are special cases, it is not good enough if we only add checkboxes with the right name format, we also need to add one hidden input for each multi/multi grid's sub questions.

<b>Example 1:</b>

I want to show my single question labeled Q1 in another question with radio buttons, I need to make sure the HTML contains the following code for each answer option.

<source lang=html4strict>
<tr>
<td width="16px" valign="top" align="center">
<input type="radio" value="1" name="QUESTION.Q1">
</td>
<td valign="top" align="left">
Answer option text 1
</td>
</tr>

</source>

<b>Example 2:</b><br/>
I want to show a single grid question label Q1 in another question, I need to make sure the HTML contains the following code for each answer option and each sub question. Q1 has 2 answer options<br/>
<source lang=html4strict>
<tr>
<td width="16px" valign="top" align="center">
<input type="radio" value="1" name="QUESTION.Q1.0">
</td>
<td width="16px" valign="top" align="center">
<input type="radio" value="2" name="QUESTION.Q1.0">
</td>

</tr>

</source>

<b>Example 3:</b><br/>
I want to show a multi question label Q1 in another question, Q1 has 2 answer options, I need to make sure the HTML contains the following code for each answer option. <br/>
<source lang=html4strict>
<tr>
<td width="16px" valign="top" align="center">
<input type="checkbox" value="1" name="QUESTION.Q1">
</td>
<td width="16px" valign="top" align="center">
Answer option 1
</td>
</tr>
</source>

Furthermore, we need to add an hidden input element like this.<br/>
<source lang=html4strict>
<input type="hidden" name="QUESTION.Q1"></input>
</source>

There are basically 3 ways of changing a question's HTML.

== Use HTML ==
This one is obvious, you can use HTML Editor to edit a question's text to include other questions.<br/>
Due to the fact that non-page questions have specific generated HTML code based on their answer options, it is usually hard to inject other questions and to make it look nice enough. <br/>
This method is usualy used when using a page question to display other questions, and it is convenient to use when the requirements are complex and the texts are not likely to change much. This one is the fastest solution among 3<br/>
The disadvantage of this method is that it is difficult to modify if the HTML is too complex.

== quest.onInit ==
This function is called after the HTML of the question is generated, therefore it is the best to use JQuery to insert the elements added to the HTML.<br/>
It would be useful to use tools like Firebug to know the ids/names of the elements where we want to insert.<br/>
This solution should be used when there is not much to change the existing HTML of the question, for example: we want to show a text grid question in another text grid question which has the same set of sub question texts.

== quest.getHTML ==
This method is to override the HTML generated by the system. This is similar to the first solution, but different in several things: this can be used with any question types; it might be more difficult to start with and not as obvious; it is effective when there are lots of elements that should be generated are similar to each others (use loops)

== Code example ==
Open the qnaire "Js demo - some js samples" (Resource Id: 159684). View the Question "Showhtmlcode"

= Solution 2 : =

The main idea is that when we want to display a question not in its own page, we will use 1 dummy question to store all question text, answer option text that we need to put and input them as JSON format. After that, we will load the value on this question via jquery to initialize the questions. <br/>
It is very important that questions to be displayed in other pages must be made as DUMMY.<br/>

For e.g, I will add the text grid question for validating the email into another text grid question :
== Step 1 : Create a dummy text grid question for storing the email value==

[[File:Text_grid_question.jpg]]

== Step 2 : Create a dummy text question for storing the JSON ==

<source lang=html4strict>
string language = Context_getSelectedLanguage();
string label;
number i;
number n;
string result = "var q = {";
string js;
array q;
//-------GENERATE JSON FOR Email QUESTION ----------
q = Question_getQuestion("D_Email", language);
js = "{"
+ "\\\"label\\\":\\\"D_Email.0\\\","
+ "\\\"text\\\":\\\"" + decodeHtmlEntities(stripHtml(q[QUESTION_SUB_QUESTIONS][0][SUBQUESTION_TEXT])) + "\\\""
+ "}";
result = result + "\\\"email0\\\":" + js + ",";

js = "{"
+ "\\\"label\\\":\\\"D_Email.1\\\","
+ "\\\"text\\\":\\\"" + decodeHtmlEntities(stripHtml(q[QUESTION_SUB_QUESTIONS][1][SUBQUESTION_TEXT])) + "\\\""
+ "}";
result = result + "\\\"email1\\\":" + js ;
result = result + "}";
D_InitializeJSON = result;

</source>

== Step 3 : Load the JSON on the destination question ==
On the destination question , open its JS tab and input the code like below :

<source lang=html4strict>
eval("{{D_InitializeJSON}}");

function TextQuestion(q, selectedValue)
{
if (q.label.indexOf("QUESTION.") != -1)
this.label = q.label;
else
this.label = "QUESTION." + q.label;

this.selectedValue = selectedValue;
this.text = q.text;
$("input[name='" + this.label + "']").val(selectedValue);
}

TextQuestion.prototype.getHTML_Row = function(even)
{
var row = $("<tr>");
var s;

if (even)
s = "even";
else
s = "odd";
row.append($("<td>").text(this.text).addClass("grid_subquestion_text grid_subquestion_"+s));
var input = $("<input type = 'text'>");
input.attr("name", this.label).val(this.selectedValue);
row.append(
$("<td>").addClass("grid_subquestion_"+ s)
.append(input)
);

return row;
}

quest.onInit = function()
{
$(".grid_inner").append(new TextQuestion(q.email0, "{{D_Email[0].Value}}").getHTML_Row(true));
$(".grid_inner").append(new TextQuestion(q.email1, "{{D_Email[1].Value}}").getHTML_Row(false));

$("input:text").width("400px");
$(".grid_inner").find("tr").each(
function(i)
{
if(i>3) i+=1;
if(i%2==0)
$(this).children().removeClass("grid_subquestion_odd").addClass("grid_subquestion_even");
else
$(this).children().removeClass("grid_subquestion_even").addClass("grid_subquestion_odd");
}
);
}

var defaultQuestionCheck = questioncheck;
var questioncheck = function()
{
ErrorMessages.getInstance().clearErrorMessages();
var b =true;
if (!defaultQuestionCheck())
return false;
var email = $("input[name$='QUESTION.D_Email.0']").val();
if (!validateEmail(email))
{
ErrorMessages.getInstance().showErrorMessage(ErrorMessage_InvalidEmailFormat);
b= false;
}

if ($("input[name$='QUESTION.D_Email.1']").val() != email)
{
ErrorMessages.getInstance().showErrorMessage(ErrorMessage_EmailNotMatch);
b= false;
}
return b;
}
</source>

== Code sample ==
Open the qnaire "Js demo - some js samples" (Resource Id: 159684). View the Question "Q1"

=Testing=
Remember to always test your work on these following cases:
*Display correctly as expected
*Save the right value in the right place
*Display previously saved values
*Validate inputs
*Update previously saved values

Show more than one questions in the same page

2012-02-09T07:21:40Z

Cg huyphong: /* Code example */

= Introduction =

There is a common need of showing more than one questions in the same page, but unfortunately it is not supported by the current editor (we hope it will be possible with the new viewer in a near future)

In the mean time, we need to have some work-arround tips to make it work.

= Solution 1 : (old setup and not in use any longer) =

The main idea is that when we want to display a question not in its own page, there must be an input element added to that page's html with name following a specific format: non grid question should have name as QUESTION.question_label, grid questions use names as QUESTION.question_label.grid_index.<br/>
It is very important that questions to be displayed in other pages must be made as DUMMY.<br/>
Multi/Multi grid questions are special cases, it is not good enough if we only add checkboxes with the right name format, we also need to add one hidden input for each multi/multi grid's sub questions.

<b>Example 1:</b>

I want to show my single question labeled Q1 in another question with radio buttons, I need to make sure the HTML contains the following code for each answer option.

<source lang=html4strict>
<tr>
<td width="16px" valign="top" align="center">
<input type="radio" value="1" name="QUESTION.Q1">
</td>
<td valign="top" align="left">
Answer option text 1
</td>
</tr>

</source>

<b>Example 2:</b><br/>
I want to show a single grid question label Q1 in another question, I need to make sure the HTML contains the following code for each answer option and each sub question. Q1 has 2 answer options<br/>
<source lang=html4strict>
<tr>
<td width="16px" valign="top" align="center">
<input type="radio" value="1" name="QUESTION.Q1.0">
</td>
<td width="16px" valign="top" align="center">
<input type="radio" value="2" name="QUESTION.Q1.0">
</td>

</tr>

</source>

<b>Example 3:</b><br/>
I want to show a multi question label Q1 in another question, Q1 has 2 answer options, I need to make sure the HTML contains the following code for each answer option. <br/>
<source lang=html4strict>
<tr>
<td width="16px" valign="top" align="center">
<input type="checkbox" value="1" name="QUESTION.Q1">
</td>
<td width="16px" valign="top" align="center">
Answer option 1
</td>
</tr>
</source>

Furthermore, we need to add an hidden input element like this.<br/>
<source lang=html4strict>
<input type="hidden" name="QUESTION.Q1"></input>
</source>

There are basically 3 ways of changing a question's HTML.

== Use HTML ==
This one is obvious, you can use HTML Editor to edit a question's text to include other questions.<br/>
Due to the fact that non-page questions have specific generated HTML code based on their answer options, it is usually hard to inject other questions and to make it look nice enough. <br/>
This method is usualy used when using a page question to display other questions, and it is convenient to use when the requirements are complex and the texts are not likely to change much. This one is the fastest solution among 3<br/>
The disadvantage of this method is that it is difficult to modify if the HTML is too complex.

== quest.onInit ==
This function is called after the HTML of the question is generated, therefore it is the best to use JQuery to insert the elements added to the HTML.<br/>
It would be useful to use tools like Firebug to know the ids/names of the elements where we want to insert.<br/>
This solution should be used when there is not much to change the existing HTML of the question, for example: we want to show a text grid question in another text grid question which has the same set of sub question texts.

== quest.getHTML ==
This method is to override the HTML generated by the system. This is similar to the first solution, but different in several things: this can be used with any question types; it might be more difficult to start with and not as obvious; it is effective when there are lots of elements that should be generated are similar to each others (use loops)

== Code example ==
Open the qnaire "Js demo - some js samples" (Resource Id: 159684). View the Question "Showhtmlcode"

= Solution 2 : =

The main idea is that when we want to display a question not in its own page, we will use 1 dummy question to store all question text, answer option text that we need to put and input them as JSON format. After that, we will load the value on this question via jquery to initialize the questions. <br/>
It is very important that questions to be displayed in other pages must be made as DUMMY.<br/>

For e.g, I will add the text grid question for validating the email into another text grid question :
== Step 1 : Create a dummy text grid question for storing the email value==

[[File:Text_grid_question.jpg]]

== Step 2 : Create a dummy text question for storing the JSON ==

<source lang=html4strict>
string language = Context_getSelectedLanguage();
string label;
number i;
number n;
string result = "var q = {";
string js;
array q;
//-------GENERATE JSON FOR Email QUESTION ----------
q = Question_getQuestion("D_Email", language);
js = "{"
+ "\\\"label\\\":\\\"D_Email.0\\\","
+ "\\\"text\\\":\\\"" + decodeHtmlEntities(stripHtml(q[QUESTION_SUB_QUESTIONS][0][SUBQUESTION_TEXT])) + "\\\""
+ "}";
result = result + "\\\"email0\\\":" + js + ",";

js = "{"
+ "\\\"label\\\":\\\"D_Email.1\\\","
+ "\\\"text\\\":\\\"" + decodeHtmlEntities(stripHtml(q[QUESTION_SUB_QUESTIONS][1][SUBQUESTION_TEXT])) + "\\\""
+ "}";
result = result + "\\\"email1\\\":" + js ;
result = result + "}";
D_InitializeJSON = result;

</source>

== Step 3 : Load the JSON on the destination question ==
On the destination question , open its JS tab and input the code like below :

<source lang=html4strict>
eval("{{D_InitializeJSON}}");

function TextQuestion(q, selectedValue)
{
if (q.label.indexOf("QUESTION.") != -1)
this.label = q.label;
else
this.label = "QUESTION." + q.label;

this.selectedValue = selectedValue;
this.text = q.text;
$("input[name='" + this.label + "']").val(selectedValue);
}

TextQuestion.prototype.getHTML_Row = function(even)
{
var row = $("<tr>");
var s;

if (even)
s = "even";
else
s = "odd";
row.append($("<td>").text(this.text).addClass("grid_subquestion_text grid_subquestion_"+s));
var input = $("<input type = 'text'>");
input.attr("name", this.label).val(this.selectedValue);
row.append(
$("<td>").addClass("grid_subquestion_"+ s)
.append(input)
);

return row;
}

quest.onInit = function()
{
$(".grid_inner").append(new TextQuestion(q.email0, "{{D_Email[0].Value}}").getHTML_Row(true));
$(".grid_inner").append(new TextQuestion(q.email1, "{{D_Email[1].Value}}").getHTML_Row(false));

$("input:text").width("400px");
$(".grid_inner").find("tr").each(
function(i)
{
if(i>3) i+=1;
if(i%2==0)
$(this).children().removeClass("grid_subquestion_odd").addClass("grid_subquestion_even");
else
$(this).children().removeClass("grid_subquestion_even").addClass("grid_subquestion_odd");
}
);
}

var defaultQuestionCheck = questioncheck;
var questioncheck = function()
{
ErrorMessages.getInstance().clearErrorMessages();
var b =true;
if (!defaultQuestionCheck())
return false;
var email = $("input[name$='QUESTION.D_Email.0']").val();
if (!validateEmail(email))
{
ErrorMessages.getInstance().showErrorMessage(ErrorMessage_InvalidEmailFormat);
b= false;
}

if ($("input[name$='QUESTION.D_Email.1']").val() != email)
{
ErrorMessages.getInstance().showErrorMessage(ErrorMessage_EmailNotMatch);
b= false;
}
return b;
}
</source>

== Code example ==
Open the qnaire "Js demo - Show more than one questions in the same page" (Resource Id: 159684). View the Question "Q1"

=Testing=
Remember to always test your work on these following cases:
*Display correctly as expected
*Save the right value in the right place
*Display previously saved values
*Validate inputs
*Update previously saved values

CG0129inz - FÆRGEN A/S Kundepanel - Import email info to base questionnaire

2012-02-06T07:14:32Z

Cg huyphong:

== General information ==

{| border="1" class="VerticalTable"
|-
! style="background-color: rgb(244, 219, 165); text-align: center;" | <br>
! style="background-color: rgb(244, 219, 165); text-align: center;" | <br>
|-
| Site<br>
| inzights.catglobe.com<br>
|-
| Catinét project no<br>
| 0129inz<br>
|-
| Client<br>
|
|}

== How to send out reminders ==

=== Goal ===

This is a standard setup to import the file which contains the email address to the base questionnaire then send the invitation to the imported email.

=== How to do ===

The general solution is to execute the .exe program to upload the csv file. After it is uploaded, the workflow script will validate and import the uploaded info to the base questionnaire.

==== Step 1 : Create the list of email address ====

We create the ".csv" file containing the email address like

[[Image:File_containing_the_email_address.jpg]]

==== Step 2 :Prepare the workflow script for solving the uploaded data ====

<source lang="javascript">
array a = Workflow_getParameters();
string csvData = a[0];

number DCSRid = 1497859; // DCS : used for filtering the email. The real value should be : 1497858
number EmailgroupRid = 1497862; // EmailgroupRid : used for contatining the import Email.
number PQRid = 1497857; // PQRid: used for the imported PQ. The real value should be : 1289245
number bulkmailId = 1548; // bulkmailId : used for sending the invitation. The real value should be : 1549
DCS_use(DCSRid);
DCS_rebuild();
//Sub workflows for data resolve
number info_wfrid = 1293521; //CG0129inz - FÆRGEN A/S Kundepanel - get info from the record on csv file
number validate_info_wfrid = 1497863; //CG0129inz - FÆRGEN A/S Kundepanel - Validate the email csv info
number optimize_wfRid = 1497864; //CG0129inz - FÆRGEN A/S Kundepanel - Optimize the email csv record
number createQAS_wfRid= 1497865; //CG0129inz - FÆRGEN A/S Kundepanel - create qas n base qnaire
number import_wfRid= 1497867; //CG0129inz - FÆRGEN A/S Kundepanel - Import email data

array currentdatetime = getCurrentDateTime(Timezone_Romance_Standard_Time);
number currentvalue = currentdatetime[DateTime_Year]*10000 + currentdatetime[DateTime_Month]*100 + currentdatetime[DateTime_Day];

//start get the upload csv file
string empt = empty;
CsvReader csv = new CsvReader(csvData, true, ";", "'", "\"", empt, true, false);
number fieldCount = csv.FieldCount;
array addToSurvey;
array headers = csv.Headers;
while(csv.ReadNextRecord()) {
Dictionary csvinfo = Workflow_call(info_wfrid, {fieldCount, headers, csv});
if (Workflow_call(validate_info_wfrid, {csvinfo,DCSRid})== true)
{
addToSurvey.Add(csvinfo);
}
}
if (isEmpty(addToSurvey) == false)
{
//Remove the duplicate email
addToSurvey = Workflow_call(optimize_wfRid,{addToSurvey});
//create qas and import
addToSurvey = Workflow_call(createQAS_wfRid,{PQRid,EmailgroupRid,addToSurvey});
Workflow_call(import_wfRid,{addToSurvey,PQRid});
//send bulkmail
string guid = getResourceGuid(Resource_Type_BulkMail , bulkmailId);
number bulkmailRid = getResourceUniqueIdFromGuid(guid);
BulkMail_send(bulkmailRid);
}
addJournal(1497860,54,"Comment","Import for " + convertToString(currentvalue) + " is done");
</source>

==== Step 3 : Execute the program to upload the file ====

Open the command line, then Execute "SendFileToCatglobe.exe". This program will need the params like below :

* username : input the username for logging to the site where we input the workflow
* password : input the password for logging to the site where we input the workflow
* workflowrid : input the workflow resource id which we will execute when the file is uploaded
* url : the site URL where we input the workflow
* filename : the name of imported file. As usually, I always put the file in the same location with the program.

Here is example :

[[Image:Execute_the_program.jpg]]

[[category:Production guidelines]]

File:Execute the program.jpg

2012-02-06T07:14:05Z

Cg huyphong:

CG0129inz - FÆRGEN A/S Kundepanel - Import email info to base questionnaire

2012-02-06T07:05:56Z

Cg huyphong: Created page with "== General information == {| border="1" class="VerticalTable" |- ! style="background-color: rgb(244, 219, 165); text-align: center;" | <br> ! style="background-color: rgb(244,..."

File:File containing the email address.jpg

2012-02-06T06:58:33Z

Cg huyphong:

SendEmail

2012-02-03T09:32:20Z

Cg huyphong: /* sendEmail */

[[Category:Email_and_SMS_Functions]]
{{HelpFiles}}

====sendEmail====

Sends an email to another user. If the email has merge fields, it will be merged before sending.

''(Note: all emails can be tracked in the communicator module)''

'''Syntax'''

sendEmail(''email, alias, subject, body[,fromemail]'')

'''Arguments'''

''email:'' Is an expression of string type. It is the receiver’s email address.

''alias:'' Is an expression of string type. It is the receiver’s alias name.

''subject:'' Is an expression of string type. This is the email’s subject.

''body:'' Is an expression of string type. This is the email’s content.

''fromemail:'' Is an expression of string type. This is the From email’s address.

'''Return type'''

empty

'''Examples'''

sendEmail(“some_email@somemail.com”, "somebody", "test", "This is a test");

or

sendEmail("some_email@somemail.com", "somebody", "test", "This is a test","phong@maysunshine.vn");

'''Availability'''

Version 4.8
__NOTOC__

Show more than one questions in the same page

2012-01-16T04:57:54Z

Cg huyphong: /* Solutions 2 : */

= Introduction =

There is a common need of showing more than one questions in the same page, but unfortunately it is not supported by the current editor (we hope it will be possible with the new viewer in a near future)

In the mean time, we need to have some work-arround tips to make it work.

= Solution 1 : (old setup and not in use any longer) =

The main idea is that when we want to display a question not in its own page, there must be an input element added to that page's html with name following a specific format: non grid question should have name as QUESTION.question_label, grid questions use names as QUESTION.question_label.grid_index.<br/>
It is very important that questions to be displayed in other pages must be made as DUMMY.<br/>
Multi/Multi grid questions are special cases, it is not good enough if we only add checkboxes with the right name format, we also need to add one hidden input for each multi/multi grid's sub questions.

<b>Example 1:</b>

I want to show my single question labeled Q1 in another question with radio buttons, I need to make sure the HTML contains the following code for each answer option.

<source lang=html4strict>
<tr>
<td width="16px" valign="top" align="center">
<input type="radio" value="1" name="QUESTION.Q1">
</td>
<td valign="top" align="left">
Answer option text 1
</td>
</tr>

</source>

<b>Example 2:</b><br/>
I want to show a single grid question label Q1 in another question, I need to make sure the HTML contains the following code for each answer option and each sub question. Q1 has 2 answer options<br/>
<source lang=html4strict>
<tr>
<td width="16px" valign="top" align="center">
<input type="radio" value="1" name="QUESTION.Q1.0">
</td>
<td width="16px" valign="top" align="center">
<input type="radio" value="2" name="QUESTION.Q1.0">
</td>

</tr>

</source>

<b>Example 3:</b><br/>
I want to show a multi question label Q1 in another question, Q1 has 2 answer options, I need to make sure the HTML contains the following code for each answer option. <br/>
<source lang=html4strict>
<tr>
<td width="16px" valign="top" align="center">
<input type="checkbox" value="1" name="QUESTION.Q1">
</td>
<td width="16px" valign="top" align="center">
Answer option 1
</td>
</tr>
</source>

Furthermore, we need to add an hidden input element like this.<br/>
<source lang=html4strict>
<input type="hidden" name="QUESTION.Q1"></input>
</source>

There are basically 3 ways of changing a question's HTML.

== Use HTML ==
This one is obvious, you can use HTML Editor to edit a question's text to include other questions.<br/>
Due to the fact that non-page questions have specific generated HTML code based on their answer options, it is usually hard to inject other questions and to make it look nice enough. <br/>
This method is usualy used when using a page question to display other questions, and it is convenient to use when the requirements are complex and the texts are not likely to change much. This one is the fastest solution among 3<br/>
The disadvantage of this method is that it is difficult to modify if the HTML is too complex.

== quest.onInit ==
This function is called after the HTML of the question is generated, therefore it is the best to use JQuery to insert the elements added to the HTML.<br/>
It would be useful to use tools like Firebug to know the ids/names of the elements where we want to insert.<br/>
This solution should be used when there is not much to change the existing HTML of the question, for example: we want to show a text grid question in another text grid question which has the same set of sub question texts.

== quest.getHTML ==
This method is to override the HTML generated by the system. This is similar to the first solution, but different in several things: this can be used with any question types; it might be more difficult to start with and not as obvious; it is effective when there are lots of elements that should be generated are similar to each others (use loops)

== Code example ==
Open the qnaire "Js demo - Show more than one questions in the same page" (Resource Id: 159684). View the Question "Showhtmlcode"

= Solution 2 : =

The main idea is that when we want to display a question not in its own page, we will use 1 dummy question to store all question text, answer option text that we need to put and input them as JSON format. After that, we will load the value on this question via jquery to initialize the questions. <br/>
It is very important that questions to be displayed in other pages must be made as DUMMY.<br/>

For e.g, I will add the text grid question for validating the email into another text grid question :
== Step 1 : Create a dummy text grid question for storing the email value==

[[File:Text_grid_question.jpg]]

== Step 2 : Create a dummy text question for storing the JSON ==

<source lang=html4strict>
string language = Context_getSelectedLanguage();
string label;
number i;
number n;
string result = "var q = {";
string js;
array q;
//-------GENERATE JSON FOR Email QUESTION ----------
q = Question_getQuestion("D_Email", language);
js = "{"
+ "\\\"label\\\":\\\"D_Email.0\\\","
+ "\\\"text\\\":\\\"" + decodeHtmlEntities(stripHtml(q[QUESTION_SUB_QUESTIONS][0][SUBQUESTION_TEXT])) + "\\\""
+ "}";
result = result + "\\\"email0\\\":" + js + ",";

js = "{"
+ "\\\"label\\\":\\\"D_Email.1\\\","
+ "\\\"text\\\":\\\"" + decodeHtmlEntities(stripHtml(q[QUESTION_SUB_QUESTIONS][1][SUBQUESTION_TEXT])) + "\\\""
+ "}";
result = result + "\\\"email1\\\":" + js ;
result = result + "}";
D_InitializeJSON = result;

</source>

== Step 3 : Load the JSON on the destination question ==
On the destination question , open its JS tab and input the code like below :

<source lang=html4strict>
eval("{{D_InitializeJSON}}");

function TextQuestion(q, selectedValue)
{
if (q.label.indexOf("QUESTION.") != -1)
this.label = q.label;
else
this.label = "QUESTION." + q.label;

this.selectedValue = selectedValue;
this.text = q.text;
$("input[name='" + this.label + "']").val(selectedValue);
}

TextQuestion.prototype.getHTML_Row = function(even)
{
var row = $("<tr>");
var s;

if (even)
s = "even";
else
s = "odd";
row.append($("<td>").text(this.text).addClass("grid_subquestion_text grid_subquestion_"+s));
var input = $("<input type = 'text'>");
input.attr("name", this.label).val(this.selectedValue);
row.append(
$("<td>").addClass("grid_subquestion_"+ s)
.append(input)
);

return row;
}

quest.onInit = function()
{
$(".grid_inner").append(new TextQuestion(q.email0, "{{D_Email[0].Value}}").getHTML_Row(true));
$(".grid_inner").append(new TextQuestion(q.email1, "{{D_Email[1].Value}}").getHTML_Row(false));

$("input:text").width("400px");
$(".grid_inner").find("tr").each(
function(i)
{
if(i>3) i+=1;
if(i%2==0)
$(this).children().removeClass("grid_subquestion_odd").addClass("grid_subquestion_even");
else
$(this).children().removeClass("grid_subquestion_even").addClass("grid_subquestion_odd");
}
);
}

var defaultQuestionCheck = questioncheck;
var questioncheck = function()
{
ErrorMessages.getInstance().clearErrorMessages();
var b =true;
if (!defaultQuestionCheck())
return false;
var email = $("input[name$='QUESTION.D_Email.0']").val();
if (!validateEmail(email))
{
ErrorMessages.getInstance().showErrorMessage(ErrorMessage_InvalidEmailFormat);
b= false;
}

if ($("input[name$='QUESTION.D_Email.1']").val() != email)
{
ErrorMessages.getInstance().showErrorMessage(ErrorMessage_EmailNotMatch);
b= false;
}
return b;
}
</source>

== Code example ==
Open the qnaire "Js demo - Show more than one questions in the same page" (Resource Id: 159684). View the Question "Q1"

=Testing=
Remember to always test your work on these following cases:
*Display correctly as expected
*Save the right value in the right place
*Display previously saved values
*Validate inputs
*Update previously saved values

Show more than one questions in the same page

2012-01-16T04:55:49Z

Cg huyphong: /* Solutions 1 : (old setup and not in use any longer) */

= Introduction =

There is a common need of showing more than one questions in the same page, but unfortunately it is not supported by the current editor (we hope it will be possible with the new viewer in a near future)

In the mean time, we need to have some work-arround tips to make it work.

= Solution 1 : (old setup and not in use any longer) =

The main idea is that when we want to display a question not in its own page, there must be an input element added to that page's html with name following a specific format: non grid question should have name as QUESTION.question_label, grid questions use names as QUESTION.question_label.grid_index.<br/>
It is very important that questions to be displayed in other pages must be made as DUMMY.<br/>
Multi/Multi grid questions are special cases, it is not good enough if we only add checkboxes with the right name format, we also need to add one hidden input for each multi/multi grid's sub questions.

<b>Example 1:</b>

I want to show my single question labeled Q1 in another question with radio buttons, I need to make sure the HTML contains the following code for each answer option.

<source lang=html4strict>
<tr>
<td width="16px" valign="top" align="center">
<input type="radio" value="1" name="QUESTION.Q1">
</td>
<td valign="top" align="left">
Answer option text 1
</td>
</tr>

</source>

<b>Example 2:</b><br/>
I want to show a single grid question label Q1 in another question, I need to make sure the HTML contains the following code for each answer option and each sub question. Q1 has 2 answer options<br/>
<source lang=html4strict>
<tr>
<td width="16px" valign="top" align="center">
<input type="radio" value="1" name="QUESTION.Q1.0">
</td>
<td width="16px" valign="top" align="center">
<input type="radio" value="2" name="QUESTION.Q1.0">
</td>

</tr>

</source>

<b>Example 3:</b><br/>
I want to show a multi question label Q1 in another question, Q1 has 2 answer options, I need to make sure the HTML contains the following code for each answer option. <br/>
<source lang=html4strict>
<tr>
<td width="16px" valign="top" align="center">
<input type="checkbox" value="1" name="QUESTION.Q1">
</td>
<td width="16px" valign="top" align="center">
Answer option 1
</td>
</tr>
</source>

Furthermore, we need to add an hidden input element like this.<br/>
<source lang=html4strict>
<input type="hidden" name="QUESTION.Q1"></input>
</source>

There are basically 3 ways of changing a question's HTML.

== Use HTML ==
This one is obvious, you can use HTML Editor to edit a question's text to include other questions.<br/>
Due to the fact that non-page questions have specific generated HTML code based on their answer options, it is usually hard to inject other questions and to make it look nice enough. <br/>
This method is usualy used when using a page question to display other questions, and it is convenient to use when the requirements are complex and the texts are not likely to change much. This one is the fastest solution among 3<br/>
The disadvantage of this method is that it is difficult to modify if the HTML is too complex.

== quest.onInit ==
This function is called after the HTML of the question is generated, therefore it is the best to use JQuery to insert the elements added to the HTML.<br/>
It would be useful to use tools like Firebug to know the ids/names of the elements where we want to insert.<br/>
This solution should be used when there is not much to change the existing HTML of the question, for example: we want to show a text grid question in another text grid question which has the same set of sub question texts.

== quest.getHTML ==
This method is to override the HTML generated by the system. This is similar to the first solution, but different in several things: this can be used with any question types; it might be more difficult to start with and not as obvious; it is effective when there are lots of elements that should be generated are similar to each others (use loops)

== Code example ==
Open the qnaire "Js demo - Show more than one questions in the same page" (Resource Id: 159684). View the Question "Showhtmlcode"

= Solutions 2 : =

The main idea is that when we want to display a question not in its own page, we will use 1 dummy question to store all question text, answer option text that we need to put and input them as JSON format. After that, we will load the value on this question via jquery to initialize the questions. <br/>
It is very important that questions to be displayed in other pages must be made as DUMMY.<br/>

For e.g, I will add the text grid question for validating the email into another text grid question :
== Step 1 : Create a dummy text grid question for storing the email value==

[[File:Text_grid_question.jpg]]

== Step 2 : Create a dummy text question for storing the JSON ==

<source lang=html4strict>
string language = Context_getSelectedLanguage();
string label;
number i;
number n;
string result = "var q = {";
string js;
array q;
//-------GENERATE JSON FOR Email QUESTION ----------
q = Question_getQuestion("D_Email", language);
js = "{"
+ "\\\"label\\\":\\\"D_Email.0\\\","
+ "\\\"text\\\":\\\"" + decodeHtmlEntities(stripHtml(q[QUESTION_SUB_QUESTIONS][0][SUBQUESTION_TEXT])) + "\\\""
+ "}";
result = result + "\\\"email0\\\":" + js + ",";

js = "{"
+ "\\\"label\\\":\\\"D_Email.1\\\","
+ "\\\"text\\\":\\\"" + decodeHtmlEntities(stripHtml(q[QUESTION_SUB_QUESTIONS][1][SUBQUESTION_TEXT])) + "\\\""
+ "}";
result = result + "\\\"email1\\\":" + js ;
result = result + "}";
D_InitializeJSON = result;

</source>

== Step 3 : Load the JSON on the destination question ==
On the destination question , open its JS tab and input the code like below :

<source lang=html4strict>
eval("{{D_InitializeJSON}}");

function TextQuestion(q, selectedValue)
{
if (q.label.indexOf("QUESTION.") != -1)
this.label = q.label;
else
this.label = "QUESTION." + q.label;

this.selectedValue = selectedValue;
this.text = q.text;
$("input[name='" + this.label + "']").val(selectedValue);
}

TextQuestion.prototype.getHTML_Row = function(even)
{
var row = $("<tr>");
var s;

if (even)
s = "even";
else
s = "odd";
row.append($("<td>").text(this.text).addClass("grid_subquestion_text grid_subquestion_"+s));
var input = $("<input type = 'text'>");
input.attr("name", this.label).val(this.selectedValue);
row.append(
$("<td>").addClass("grid_subquestion_"+ s)
.append(input)
);

return row;
}

quest.onInit = function()
{
$(".grid_inner").append(new TextQuestion(q.email0, "{{D_Email[0].Value}}").getHTML_Row(true));
$(".grid_inner").append(new TextQuestion(q.email1, "{{D_Email[1].Value}}").getHTML_Row(false));

$("input:text").width("400px");
$(".grid_inner").find("tr").each(
function(i)
{
if(i>3) i+=1;
if(i%2==0)
$(this).children().removeClass("grid_subquestion_odd").addClass("grid_subquestion_even");
else
$(this).children().removeClass("grid_subquestion_even").addClass("grid_subquestion_odd");
}
);
}

var defaultQuestionCheck = questioncheck;
var questioncheck = function()
{
ErrorMessages.getInstance().clearErrorMessages();
var b =true;
if (!defaultQuestionCheck())
return false;
var email = $("input[name$='QUESTION.D_Email.0']").val();
if (!validateEmail(email))
{
ErrorMessages.getInstance().showErrorMessage(ErrorMessage_InvalidEmailFormat);
b= false;
}

if ($("input[name$='QUESTION.D_Email.1']").val() != email)
{
ErrorMessages.getInstance().showErrorMessage(ErrorMessage_EmailNotMatch);
b= false;
}
return b;
}
</source>

== Code example ==
Open the qnaire "Js demo - Show more than one questions in the same page" (Resource Id: 159684). View the Question "Q1"

=Testing=
Remember to always test your work on these following cases:
*Display correctly as expected
*Save the right value in the right place
*Display previously saved values
*Validate inputs
*Update previously saved values

Show more than one questions in the same page

2012-01-16T04:28:33Z

Cg huyphong: /* Solutions 2 : */

= Introduction =

There is a common need of showing more than one questions in the same page, but unfortunately it is not supported by the current editor (we hope it will be possible with the new viewer in a near future)

In the mean time, we need to have some work-arround tips to make it work.

= Solutions 1 : (old setup and not in use any longer) =

The main idea is that when we want to display a question not in its own page, there must be an input element added to that page's html with name following a specific format: non grid question should have name as QUESTION.question_label, grid questions use names as QUESTION.question_label.grid_index.<br/>
It is very important that questions to be displayed in other pages must be made as DUMMY.<br/>
Multi/Multi grid questions are special cases, it is not good enough if we only add checkboxes with the right name format, we also need to add one hidden input for each multi/multi grid's sub questions.

<b>Example 1:</b>

I want to show my single question labeled Q1 in another question with radio buttons, I need to make sure the HTML contains the following code for each answer option.

<source lang=html4strict>
<tr>
<td width="16px" valign="top" align="center">
<input type="radio" value="1" name="QUESTION.Q1">
</td>
<td valign="top" align="left">
Answer option text 1
</td>
</tr>

</source>

<b>Example 2:</b><br/>
I want to show a single grid question label Q1 in another question, I need to make sure the HTML contains the following code for each answer option and each sub question. Q1 has 2 answer options<br/>
<source lang=html4strict>
<tr>
<td width="16px" valign="top" align="center">
<input type="radio" value="1" name="QUESTION.Q1.0">
</td>
<td width="16px" valign="top" align="center">
<input type="radio" value="2" name="QUESTION.Q1.0">
</td>

</tr>

</source>

<b>Example 3:</b><br/>
I want to show a multi question label Q1 in another question, Q1 has 2 answer options, I need to make sure the HTML contains the following code for each answer option. <br/>
<source lang=html4strict>
<tr>
<td width="16px" valign="top" align="center">
<input type="checkbox" value="1" name="QUESTION.Q1">
</td>
<td width="16px" valign="top" align="center">
Answer option 1
</td>
</tr>
</source>

Furthermore, we need to add an hidden input element like this.<br/>
<source lang=html4strict>
<input type="hidden" name="QUESTION.Q1"></input>
</source>

There are basically 3 ways of changing a question's HTML.

== Use HTML ==
This one is obvious, you can use HTML Editor to edit a question's text to include other questions.<br/>
Due to the fact that non-page questions have specific generated HTML code based on their answer options, it is usually hard to inject other questions and to make it look nice enough. <br/>
This method is usualy used when using a page question to display other questions, and it is convenient to use when the requirements are complex and the texts are not likely to change much. This one is the fastest solution among 3<br/>
The disadvantage of this method is that it is difficult to modify if the HTML is too complex.

== quest.onInit ==
This function is called after the HTML of the question is generated, therefore it is the best to use JQuery to insert the elements added to the HTML.<br/>
It would be useful to use tools like Firebug to know the ids/names of the elements where we want to insert.<br/>
This solution should be used when there is not much to change the existing HTML of the question, for example: we want to show a text grid question in another text grid question which has the same set of sub question texts.

== quest.getHTML ==
This method is to override the HTML generated by the system. This is similar to the first solution, but different in several things: this can be used with any question types; it might be more difficult to start with and not as obvious; it is effective when there are lots of elements that should be generated are similar to each others (use loops)

== Code example ==
Open the qnaire "Js demo - Show more than one questions in the same page" (Resource Id: 159684). View the Question "Showhtmlcode"

= Solutions 2 : =

The main idea is that when we want to display a question not in its own page, we will use 1 dummy question to store all question text, answer option text that we need to put and input them as JSON format. After that, we will load the value on this question via jquery to initialize the questions. <br/>
It is very important that questions to be displayed in other pages must be made as DUMMY.<br/>

For e.g, I will add the text grid question for validating the email into another text grid question :
== Step 1 : Create a dummy text grid question for storing the email value==

[[File:Text_grid_question.jpg]]

== Step 2 : Create a dummy text question for storing the JSON ==

<source lang=html4strict>
string language = Context_getSelectedLanguage();
string label;
number i;
number n;
string result = "var q = {";
string js;
array q;
//-------GENERATE JSON FOR Email QUESTION ----------
q = Question_getQuestion("D_Email", language);
js = "{"
+ "\\\"label\\\":\\\"D_Email.0\\\","
+ "\\\"text\\\":\\\"" + decodeHtmlEntities(stripHtml(q[QUESTION_SUB_QUESTIONS][0][SUBQUESTION_TEXT])) + "\\\""
+ "}";
result = result + "\\\"email0\\\":" + js + ",";

js = "{"
+ "\\\"label\\\":\\\"D_Email.1\\\","
+ "\\\"text\\\":\\\"" + decodeHtmlEntities(stripHtml(q[QUESTION_SUB_QUESTIONS][1][SUBQUESTION_TEXT])) + "\\\""
+ "}";
result = result + "\\\"email1\\\":" + js ;
result = result + "}";
D_InitializeJSON = result;

</source>

== Step 3 : Load the JSON on the destination question ==
On the destination question , open its JS tab and input the code like below :

<source lang=html4strict>
eval("{{D_InitializeJSON}}");

function TextQuestion(q, selectedValue)
{
if (q.label.indexOf("QUESTION.") != -1)
this.label = q.label;
else
this.label = "QUESTION." + q.label;

this.selectedValue = selectedValue;
this.text = q.text;
$("input[name='" + this.label + "']").val(selectedValue);
}

TextQuestion.prototype.getHTML_Row = function(even)
{
var row = $("<tr>");
var s;

if (even)
s = "even";
else
s = "odd";
row.append($("<td>").text(this.text).addClass("grid_subquestion_text grid_subquestion_"+s));
var input = $("<input type = 'text'>");
input.attr("name", this.label).val(this.selectedValue);
row.append(
$("<td>").addClass("grid_subquestion_"+ s)
.append(input)
);

return row;
}

quest.onInit = function()
{
$(".grid_inner").append(new TextQuestion(q.email0, "{{D_Email[0].Value}}").getHTML_Row(true));
$(".grid_inner").append(new TextQuestion(q.email1, "{{D_Email[1].Value}}").getHTML_Row(false));

$("input:text").width("400px");
$(".grid_inner").find("tr").each(
function(i)
{
if(i>3) i+=1;
if(i%2==0)
$(this).children().removeClass("grid_subquestion_odd").addClass("grid_subquestion_even");
else
$(this).children().removeClass("grid_subquestion_even").addClass("grid_subquestion_odd");
}
);
}

var defaultQuestionCheck = questioncheck;
var questioncheck = function()
{
ErrorMessages.getInstance().clearErrorMessages();
var b =true;
if (!defaultQuestionCheck())
return false;
var email = $("input[name$='QUESTION.D_Email.0']").val();
if (!validateEmail(email))
{
ErrorMessages.getInstance().showErrorMessage(ErrorMessage_InvalidEmailFormat);
b= false;
}

if ($("input[name$='QUESTION.D_Email.1']").val() != email)
{
ErrorMessages.getInstance().showErrorMessage(ErrorMessage_EmailNotMatch);
b= false;
}
return b;
}
</source>

== Code example ==
Open the qnaire "Js demo - Show more than one questions in the same page" (Resource Id: 159684). View the Question "Q1"

=Testing=
Remember to always test your work on these following cases:
*Display correctly as expected
*Save the right value in the right place
*Display previously saved values
*Validate inputs
*Update previously saved values

Show more than one questions in the same page

2012-01-16T04:22:25Z

Cg huyphong: /* Solutions 2 : */

= Introduction =

There is a common need of showing more than one questions in the same page, but unfortunately it is not supported by the current editor (we hope it will be possible with the new viewer in a near future)

In the mean time, we need to have some work-arround tips to make it work.

= Solutions 1 : (old setup and not in use any longer) =

The main idea is that when we want to display a question not in its own page, there must be an input element added to that page's html with name following a specific format: non grid question should have name as QUESTION.question_label, grid questions use names as QUESTION.question_label.grid_index.<br/>
It is very important that questions to be displayed in other pages must be made as DUMMY.<br/>
Multi/Multi grid questions are special cases, it is not good enough if we only add checkboxes with the right name format, we also need to add one hidden input for each multi/multi grid's sub questions.

<b>Example 1:</b>

I want to show my single question labeled Q1 in another question with radio buttons, I need to make sure the HTML contains the following code for each answer option.

<source lang=html4strict>
<tr>
<td width="16px" valign="top" align="center">
<input type="radio" value="1" name="QUESTION.Q1">
</td>
<td valign="top" align="left">
Answer option text 1
</td>
</tr>

</source>

<b>Example 2:</b><br/>
I want to show a single grid question label Q1 in another question, I need to make sure the HTML contains the following code for each answer option and each sub question. Q1 has 2 answer options<br/>
<source lang=html4strict>
<tr>
<td width="16px" valign="top" align="center">
<input type="radio" value="1" name="QUESTION.Q1.0">
</td>
<td width="16px" valign="top" align="center">
<input type="radio" value="2" name="QUESTION.Q1.0">
</td>

</tr>

</source>

<b>Example 3:</b><br/>
I want to show a multi question label Q1 in another question, Q1 has 2 answer options, I need to make sure the HTML contains the following code for each answer option. <br/>
<source lang=html4strict>
<tr>
<td width="16px" valign="top" align="center">
<input type="checkbox" value="1" name="QUESTION.Q1">
</td>
<td width="16px" valign="top" align="center">
Answer option 1
</td>
</tr>
</source>

Furthermore, we need to add an hidden input element like this.<br/>
<source lang=html4strict>
<input type="hidden" name="QUESTION.Q1"></input>
</source>

There are basically 3 ways of changing a question's HTML.

== Use HTML ==
This one is obvious, you can use HTML Editor to edit a question's text to include other questions.<br/>
Due to the fact that non-page questions have specific generated HTML code based on their answer options, it is usually hard to inject other questions and to make it look nice enough. <br/>
This method is usualy used when using a page question to display other questions, and it is convenient to use when the requirements are complex and the texts are not likely to change much. This one is the fastest solution among 3<br/>
The disadvantage of this method is that it is difficult to modify if the HTML is too complex.

== quest.onInit ==
This function is called after the HTML of the question is generated, therefore it is the best to use JQuery to insert the elements added to the HTML.<br/>
It would be useful to use tools like Firebug to know the ids/names of the elements where we want to insert.<br/>
This solution should be used when there is not much to change the existing HTML of the question, for example: we want to show a text grid question in another text grid question which has the same set of sub question texts.

== quest.getHTML ==
This method is to override the HTML generated by the system. This is similar to the first solution, but different in several things: this can be used with any question types; it might be more difficult to start with and not as obvious; it is effective when there are lots of elements that should be generated are similar to each others (use loops)

== Code example ==
Open the qnaire "Js demo - Show more than one questions in the same page" (Resource Id: 159684). View the Question "Showhtmlcode"

= Solutions 2 : =

The main idea is that when we want to display a question not in its own page, we will use 1 dummy question to store all question text, answer option text that we need to put and input them as JSON format. After that, we will load the value on this question via jquery to initialize the questions. <br/>
It is very important that questions to be displayed in other pages must be made as DUMMY.<br/>

For e.g, I will add the text grid question for validating the email into another text grid question :
== Step 1 : Create a dummy text grid question for storing the email value==

[[File:Text_grid_question.jpg]]

== Step 2 : Create a dummy text question for storing the JSON ==

<source lang=html4strict>
string language = Context_getSelectedLanguage();
string label;
number i;
number n;
string result = "var q = {";
string js;
array q;
//-------GENERATE JSON FOR Email QUESTION ----------
q = Question_getQuestion("D_Email", language);
js = "{"
+ "\\\"label\\\":\\\"D_Email.0\\\","
+ "\\\"text\\\":\\\"" + decodeHtmlEntities(stripHtml(q[QUESTION_SUB_QUESTIONS][0][SUBQUESTION_TEXT])) + "\\\""
+ "}";
result = result + "\\\"email0\\\":" + js + ",";

js = "{"
+ "\\\"label\\\":\\\"D_Email.1\\\","
+ "\\\"text\\\":\\\"" + decodeHtmlEntities(stripHtml(q[QUESTION_SUB_QUESTIONS][1][SUBQUESTION_TEXT])) + "\\\""
+ "}";
result = result + "\\\"email1\\\":" + js ;
result = result + "}";
D_InitializeJSON = result;

</source>

== Step 3 : Load the JSON on the destination question ==
On the destination question , open its JS tab and input the code like below :

<source lang=html4strict>
eval("{{D_InitializeJSON}}");

function TextQuestion(q, selectedValue)
{
if (q.label.indexOf("QUESTION.") != -1)
this.label = q.label;
else
this.label = "QUESTION." + q.label;

this.selectedValue = selectedValue;
this.text = q.text;
$("input[name='" + this.label + "']").val(selectedValue);
}

TextQuestion.prototype.getHTML_Row = function(even)
{
var row = $("<tr>");
var s;

if (even)
s = "even";
else
s = "odd";
row.append($("<td>").text(this.text).addClass("grid_subquestion_text grid_subquestion_"+s));
var input = $("<input type = 'text'>");
input.attr("name", this.label).val(this.selectedValue);
row.append(
$("<td>").addClass("grid_subquestion_"+ s)
.append(input)
);

return row;
}

quest.onInit = function()
{
$(".grid_inner").append(new TextQuestion(q.email0, "{{D_Email[0].Value}}").getHTML_Row(true));
$(".grid_inner").append(new TextQuestion(q.email1, "{{D_Email[1].Value}}").getHTML_Row(false));

$("input:text").width("400px");
$(".grid_inner").find("tr").each(
function(i)
{
if(i>3) i+=1;
if(i%2==0)
$(this).children().removeClass("grid_subquestion_odd").addClass("grid_subquestion_even");
else
$(this).children().removeClass("grid_subquestion_even").addClass("grid_subquestion_odd");
}
);
}

var defaultQuestionCheck = questioncheck;
var questioncheck = function()
{
ErrorMessages.getInstance().clearErrorMessages();
var b =true;
if (!defaultQuestionCheck())
return false;
var email = $("input[name$='QUESTION.D_Email.0']").val();
if (!validateEmail(email))
{
ErrorMessages.getInstance().showErrorMessage(ErrorMessage_InvalidEmailFormat);
b= false;
}

if ($("input[name$='QUESTION.D_Email.1']").val() != email)
{
ErrorMessages.getInstance().showErrorMessage(ErrorMessage_EmailNotMatch);
b= false;
}
return b;
}
</source>

=Testing=
Remember to always test your work on these following cases:
*Display correctly as expected
*Save the right value in the right place
*Display previously saved values
*Validate inputs
*Update previously saved values

File:Text grid question.jpg

2012-01-16T04:11:13Z

Cg huyphong:

Show more than one questions in the same page

2012-01-13T07:50:40Z

Cg huyphong:

Show more than one questions in the same page

2012-01-13T07:33:49Z

Cg huyphong: /* Solutions */

TopAnswers

2012-01-04T04:58:03Z

Cg huyphong:

[[Category:Questionnaire_Functions]]
{{HelpFiles}}

====Question_getTopSelectedAnswers====

Returns an array of answers using an existing multi question, where the returned array will be a subset of the original question values filtered using a position and length parameter.

'''Syntax'''

Question_getTopSelectedAnswers(''questionName,position,length[,index]'')

'''Arguments'''

''questionName'': String - An existing multi question label or multi grid question label in the context questionnaire.

''position'': Number from 0 and up. Defines the first answer that will be included in the new array from the original data.

''length: ''Number from 1 and up. Defines the number of answers to be included in the new array as starting from the position in the original data.

''index'': A sub question index to be used for multi grid questions. If omitted, we will get array returned from all sub questions of the multi grid question.

'''Return type'''

array

'''Examples'''

Question_getTopSelectedAnswers(originalmulti,1,1)

// given that the ''originalmulti'' question is Multi question

... [1,2,3,4,5] then returned array becomes [2]

... [5,4,3,2,1] then returned array becomes [4]

... [1,2,3] then returned array becomes [2]

... [5,4,3] then returned array becomes [4]

... [1,2] then returned array becomes [2]

... [2] then returned array becomes []

'''Availability'''

Version 5.6
__NOTOC__

SetRPQStatus

2012-01-04T04:12:37Z

Cg huyphong:

[[Category:Questionnaire_Functions]]
{{HelpFiles}}

====setRPQStatus====

Sets the status for the current questionnaire answer sheet context.

'''Syntax'''

setRPQStatus(''new_status'')

'''Arguments'''

''new_status'': Is a numeric (non-decimal) expression. It can be a built-in constant:

RPQ_Status_Normal = 1,

RPQ_Status_QuotaFull = 2,

RPQ_Status_OutsideTarget = 3,

RPQ_Status_InterviewFailed = 4,

RPQ_Status_InterviewSucceeded = 5

'''Return type'''

empty

'''Example'''

setRPQStatus(RPQ_Status_QuotaFull);

'''Availability'''

Version 5.0
__NOTOC__

SetProjectQuestionnaireStatus

2012-01-03T11:16:53Z

Cg huyphong:

[[Category:Questionnaire_Functions]]
{{HelpFiles}}

====setProjectQuestionnaireStatus====

Set the status of the current questionnaire. The project questionnaire context is required

'''Syntax'''

setProjectQuestionnaireStatus(''status'')

'''Arguments'''

''status'': is a number expression. It should be one of the pre-defined enumerations:

ProjectQuestionnaire_Status_NotSet : 0

ProjectQuestionnaire_Status_Closed : 1

ProjectQuestionnaire_Status_Paused : 2

ProjectQuestionnaire_Status_Open : 3

ProjectQuestionnaire_Status_OpenForTest : 4

'''Return type'''

empty

'''Example'''

setProjectQuestionnaireStatus(ProjectQuestionnaire_Status_Open);

'''Availability'''

Version 5.2
__NOTOC__

ReturnFromGoto

2012-01-03T10:53:40Z

Cg huyphong:

[[Category:Questionnaire_Functions]]
=returnFromGoto=

Go back to the context that call the gotoQuestionnaire or gotoQuestion functions.

'''Syntax'''

returnFromGoto()

'''Arguments'''

none

'''Return type'''

empty

'''Availability'''

Version 5.8

Quota updateQuotaForAllQASs

2012-01-03T10:43:25Z

Cg huyphong:

[[Category:Questionnaire_Functions]]
{{HelpFiles}}

====Quota_updateQuotaForAllQASs====

To update specified quota through all QASs of questionnaire..

'''Syntax'''

empty Quota_updateQuotaForAllQASs(string quotaName[,number PQResourceId]);

'''Arguments'''

- quotaName : the name of quota.

- PQResourceId : Resource Id of questionnaire to which quota belongs. If it is empty, the project questionnaire context is required

'''Return type'''

None.

'''Example'''

Quota_updateQuotaForAllQASs("male");

'''Availability'''

Version 5.8
__NOTOC__

Quota updateQuota

2012-01-03T10:39:27Z

Cg huyphong:

[[Category:Questionnaire_Functions]]
{{HelpFiles}}

====Quota_updateQuota====

To update the specified quota through the specified QAS. This function requires the project questionnaire context

'''Syntax'''

empty Quota_updateQuota(string quotaName).

'''Arguments'''

quotaName : the name of quota.

'''Return type'''

None.

'''Example'''

setRPQId(28428305);//RPQId of questionnaire "hquest108"

Quota_updateQuota("female");

'''Availability'''

Version 5.8
__NOTOC__

Quota updateAllQuotas

2012-01-03T10:25:24Z

Cg huyphong:

[[Category:Questionnaire_Functions]]
{{HelpFiles}}

====Quota_updateAllQuotas====

To update all quotas of questionnaire through the specified QAS. This function requires the project questionnaire context

'''Syntax'''

empty Quota_updateAllQuotas()

'''Arguments'''

None.

'''Return type'''

None.

'''Example'''

setRPQId(28428305);//RPQId of questionnaire "hquest108"

Quota_updateAllQuotas();

'''Availability'''

Version 5.8
__NOTOC__

Quota targetReached

2012-01-03T10:16:40Z

Cg huyphong:

[[Category:Questionnaire_Functions]]
{{HelpFiles}}

====Quota_targetReached====

To check whether one quota of a questionnaire reaches its target..

'''Syntax'''

bool Quota_targetReached(string quotaName[, number PQResourceId])

'''Arguments'''

- quotaName : the name of quota.

- PQResourceId : Resource id of questionnaire to which quota belongs.If it is empty, the project questionnaire context is required

'''Return type'''

bool

'''Example'''

bool a= Quota_targetReached("male",34806989);

'''Availability'''

Version 5.8
__NOTOC__

Quota new

2012-01-03T09:57:42Z

Cg huyphong:

{{HelpFiles}}

==== Quota_new ====

To create a new quota object.

'''Syntax'''

array Quota_new(string quotaName, number quotaTarget, string quotaExpression[, number PQResourceId])

'''Arguments'''

- quotaName : the name of new quota.

- quotaTarget : the target of quota.

- quotaExpression : the expression of quota.

- PQResourceId : Resource Id of questionnaire to which quota belongs. If it's empty, the project questionnaire context is needed

'''Return type'''

array

{| width="651" class="tableintopic" style="border: 1px solid rgb(1, 1, 1); border-collapse: collapse;" border="1" cellspacing="0" cellpadding="2"
|- align="left" valign="top"
| width="318" style="border: 1px solid rgb(1, 1, 1);" bgcolor="#bfbfbf" |
'''Index'''

| width="116" style="border: 1px solid rgb(1, 1, 1);" bgcolor="#bfbfbf" |
'''Data type'''

| width="217" style="border: 1px solid rgb(1, 1, 1);" bgcolor="#bfbfbf" |
'''Initial value'''

|- align="left" valign="top"
| width="318" style="border: 1px solid rgb(1, 1, 1);" |
[OBJECT_TYPE]

| width="116" style="border: 1px solid rgb(1, 1, 1);" |
number

| width="217" style="border: 1px solid rgb(1, 1, 1);" |
Quota object

|- align="left" valign="top"
| width="318" style="border: 1px solid rgb(1, 1, 1);" |
[QUOTA_ID]

| width="116" style="border: 1px solid rgb(1, 1, 1);" |
number

| width="217" style="border: 1px solid rgb(1, 1, 1);" |
0

|- align="left" valign="top"
| width="318" style="border: 1px solid rgb(1, 1, 1);" |
[QUOTA_NAME]

| width="116" style="border: 1px solid rgb(1, 1, 1);" |
string

| width="217" style="border: 1px solid rgb(1, 1, 1);" |
Entered value

|- align="left" valign="top"
| width="318" style="border: 1px solid rgb(1, 1, 1);" |
[QUOTA_TARGET]

| width="116" style="border: 1px solid rgb(1, 1, 1);" |
number

| width="217" style="border: 1px solid rgb(1, 1, 1);" |
Entered value

|- align="left" valign="top"
| width="318" style="border: 1px solid rgb(1, 1, 1);" |
[QUOTA_EXPRESSION]

| width="116" style="border: 1px solid rgb(1, 1, 1);" |
string

| width="217" style="border: 1px solid rgb(1, 1, 1);" |
Entered value

|- align="left" valign="top"
| width="318" style="border: 1px solid rgb(1, 1, 1);" |
[QUOTA_QUESTIONNAIRE_RESOURCE_ID]

| width="116" style="border: 1px solid rgb(1, 1, 1);" |
number

| width="217" style="border: 1px solid rgb(1, 1, 1);" |
Entered value ( current PQ resource id if no entered value)

|- align="left" valign="top"
| width="318" style="border: 1px solid rgb(1, 1, 1);" |
[QUOTA_DESCRIPTION]

| width="116" style="border: 1px solid rgb(1, 1, 1);" |
string

| width="217" style="border: 1px solid rgb(1, 1, 1);" |
empty string

|- align="left" valign="top"
| width="318" style="border: 1px solid rgb(1, 1, 1);" |
[QUOTA_PRESTRATIFICATION]

| width="116" style="border: 1px solid rgb(1, 1, 1);" |
bool

| width="217" style="border: 1px solid rgb(1, 1, 1);" |
FALSE

|- align="left" valign="top"
| width="318" style="border: 1px solid rgb(1, 1, 1);" |
[QUOTA_DISABLED]

| width="116" style="border: 1px solid rgb(1, 1, 1);" |
bool

| width="217" style="border: 1px solid rgb(1, 1, 1);" |
FALSE

|- align="left" valign="top"
| width="318" style="border: 1px solid rgb(1, 1, 1);" |
[QUOTA_CURRENT]

| width="116" style="border: 1px solid rgb(1, 1, 1);" |
number (read only)

| width="217" style="border: 1px solid rgb(1, 1, 1);" |
0

|- align="left" valign="top"
| width="318" style="border: 1px solid rgb(1, 1, 1);" |
[QUOTA_ONGOING]

| width="116" style="border: 1px solid rgb(1, 1, 1);" |
number (read only)

| width="217" style="border: 1px solid rgb(1, 1, 1);" |
0

|}

'''Example'''

array a = Quota_new("Arkitekt",5,"Q3 == [1-5]",5310088);

print(a);

OR

array a = Quota_new("Arkitekt",5,"Q3 == [1-5]");

print(a);

//{26,0,Arkitekt,5,Q3 == [1-5],5310088,,False,False,0,0}

'''Availability'''

Version 5.8

[[Category:Questionnaire_Functions]]

Quota getQuotaByName

2012-01-03T09:34:33Z

Cg huyphong:

[[Category:Questionnaire_Functions]]
{{HelpFiles}}

====Quota_getQuotaByName====

To get information of quota by name.

'''Syntax'''

array Quota_getQuotaByName(string quotaName[, number PQResourceId])

'''Arguments'''

- quotaName : the name of new quota.

- PQResourceId : Resource Id of questionnaire to which quota belongs. If it is empty, the project questionnaire context is needed

'''Return type'''

array

'''Example'''

array a = Quota_getQuotaByName("Arkitekt, textilindustri",5310088);

print(a);

//{26,5915,Arkitekt, textilindustri,1000,Q3 == [5] ,5310088,,False,False,9,1}

'''Availability'''

Version 5.8
__NOTOC__

Quota getAllQuotas

2012-01-03T09:23:28Z

Cg huyphong:

[[Category:Questionnaire_Functions]]
{{HelpFiles}}

====Quota_getAllQuotas====

To get information of all quotas in questionnaire. ( view Quota_new)

'''Syntax'''

array Quota_getAllQuotas([number PQResourceId])

'''Arguments'''

PQResourceId : Resource Id of questionnaire to which quotas belong. If it is empty, the project questionnaire context is needed

'''Return type'''

array

'''Example'''

array a= Quota_getAllQuotas(34806989);

print(a);

//{{26,5915,Arkitekt, textilindustri,1000,Q3 == [5] ,5310088,,False,False,9,1},{26,5912,Bank, Egendomsmäklare och advokat,1000,Q3 == [2] ,5310088,,False,False,12,0},{26,5913,Bilhandlare och –uthyrare, möbler,1000,Q3 == [3] ,5310088,,False,False,9,0},{26,5914,Frisör, galleri, modebutik,1000,Q3 == [4] ,5310088,,False,False,3,0},{26,5830,GNF,1000,GNF_Dummy == [1] ,5310088,,False,False,26,0},{26,5911,Turism, hotell och restaurang,1000, Q3 == [1] ,5310088,,False,False,5,0}}

'''Availability'''

Version 5.8
__NOTOC__

Quota deleteQuota

2012-01-03T09:13:02Z

Cg huyphong:

[[Category:Questionnaire_Functions]]
{{HelpFiles}}

====Quota_deleteQuota====

To delete a quota.

'''Syntax'''

empty Quota_deleteQuota(string quotaName[, number PQResourceId])

'''Arguments'''

- quotaName : the name of quota.

- PQResourceId : Resource Id of questionnaire to which quotas belong.If it's empty, the project questionnaire context is needed

'''Return type'''

None

'''Example'''

Quota_deleteQuota("male",34806989);

or

Quota_deleteQuota("male");

'''Availability'''

Version 5.8
__NOTOC__

Quota deleteAllQuotas

2012-01-03T09:05:31Z

Cg huyphong:

[[Category:Questionnaire_Functions]]
{{HelpFiles}}

====Quota_deleteAllQuotas====

To delete all quotas in questionnaire.

'''Syntax'''

empty Quota_deleteAllQuotas([ number PQResourceId]);

'''Arguments'''

PQResourceId : Resource Id of the questionnaire to which quotas belong. If it is empty, the project questionnaire context needs to be specified

'''Return type'''

None.

'''Example'''

Quota_deleteAllQuotas(34806989);

or

Quota_deleteAllQuotas();

'''Availability'''

Version 5.8
__NOTOC__

Quota deleteAllQuotas

2012-01-03T09:04:57Z

Cg huyphong:

[[Category:Questionnaire_Functions]]
{{HelpFiles}}

====Quota_deleteAllQuotas====

To delete all quotas in questionnaire.

'''Syntax'''

empty Quota_deleteAllQuotas([ number PQResourceId]);

'''Arguments'''

PQResourceId : Resource Id of the questionnaire to which quotas belong. If it is empty, the project questionnaire context needs to be specified

'''Return type'''

None.

'''Example'''

Quota_deleteAllQuotas([34806989]);

'''Availability'''

Version 5.8
__NOTOC__

Quota deleteAllQuotas

2012-01-03T08:57:46Z

Cg huyphong:

[[Category:Questionnaire_Functions]]
{{HelpFiles}}

====Quota_deleteAllQuotas====

To delete all quotas in questionnaire.

'''Syntax'''

empty Quota_deleteAllQuotas([ number PQResourceId]);

'''Arguments'''

PQResourceId : Resource Id of the questionnaire to which quotas belong. If it is empty, you will next project

'''Return type'''

None.

'''Example'''

Quota_deleteAllQuotas([34806989]);

'''Availability'''

Version 5.8
__NOTOC__

QuestionnaireAnswerSheetExists

2012-01-03T08:22:35Z

Cg huyphong:

[[Category:Questionnaire_Functions]]
{{HelpFiles}}

====questionnaireAnswerSheetExists====

Checks if a answer sheet exists by its user id and questionnaire id.

'''Syntax'''

questionnaireAnswerSheetExists (''pqId, userId'')

or when we know the user context:

questionnaireAnswerSheetExists (''pqId'')

'''Arguments'''

''pqId: number. Is the project questionnaire id which is being checked if the user has an answer sheet.''

''userId: number. Is the user id which is being checked in regards to finding whether he has an answer sheet for the questionnaire.''

'''Return type'''

bool

'''Examples'''

bool b = questionnaireAnswerSheetExists(1234,345678);

print(b);

'''Availability'''

Version 5.5
__NOTOC__

Questionnaire save

2012-01-03T04:47:29Z

Cg huyphong:

[[Category:Questionnaire_Functions]]
{{HelpFiles}}

====Questionnaire_save====

To save a new questionnaire or update information of an old questionnaire.

'''Syntax'''

empty Questionnaire_save(array questionnaire)

'''Arguments'''

questionnaire : the questionnaire object

'''Return type'''

None

'''Example'''

array a= Questionnaire_new("new questionnaire",34409965, 34822447,34779240,34775455);

Questionnaire_save(a);

or

array a= Questionnaire_getQuestionnaireByResourceId(34806989 );

a[QUESTIONNAIRE_NAME] = "New name for questionnaire";

Questionnaire_save(a);

'''Availability'''

Version 5.8
__NOTOC__

Questionnaire getQuestionnaireByResourceId

2012-01-03T04:27:35Z

Cg huyphong:

[[Category:Questionnaire_Functions]]
{{HelpFiles}}

====Questionnaire_getQuestionnaireByResourceId====

To get information of a questionnaire by resource id. (view the questionnaire object on Questionnaire_new)

'''Syntax'''

array Questionnaire_getQuestionnaireByResourceId (number questionnaireResourceId)

'''Arguments'''

questionnaireResourceId : resource id of questionnaire.

'''Return type'''

array

'''Example'''

array a= Questionnaire_getQuestionnaireByResourceId(34806989);

print (a);

//{11,34806989,phong questionnaire 2,34409965,37246022,37257113,True,False,False,True,,36784747,,3,0,B2B CSN 01,{1,1,1,0,0,0,0,1,40},{1,1,1,0,0,0,0,1,40},{9999,12,31,23,59,59,999,52,40},{9999,12,31,23,59,59,999,52,40},0,phong questionnaire 2}

'''Availability'''

Version 5.8
__NOTOC__