QAS new: Difference between revisions
More actions
No edit summary  | 
				|||
| Line 136: | Line 136: | ||
| width="467" style="border:1px solid #010101;" |    | | width="467" style="border:1px solid #010101;" |    | ||
1: CATI_MAIN, 2: CATI_ONGOING, 3: CATI_APPOINMENT, 4: CATI_FINISHED, 5: CATI_RETRY  | 1: CATI_MAIN, 2: CATI_ONGOING, 3: CATI_APPOINMENT, 4: CATI_FINISHED, 5: CATI_RETRY  | ||
NOTE! If the QAS is actually part of a CATI run, then this item should only be updated when the value is CATI_FINISHED, or when the CATI is not running, otherwise the CATI system may get confused.  | |||
|- align="left" valign="top"  | |- align="left" valign="top"  | ||
| width="292" style="border:1px solid #010101;" |    | | width="292" style="border:1px solid #010101;" |    | ||
Revision as of 10:38, 13 February 2012
QAS_new
Create a questionnaire answer sheet object
Syntax
QAS_new(questionnaireResourceId, userResourceId)
or
QAS_new(questionnaireResourceId)
Arguments
- questionnaireResourceId: is a number expression. It is the questionnaire's resource id
 - userResourecId: is a number expression. It is the user's resource id
 
Return value
An array, it is a questionnaire answer sheet object, which contains the following items:
| 
 Index  | 
 Data type  | 
 Value  | 
| 
 QAS_ID  | 
 number  | 
 Primary key  | 
| 
 QAS_QUESTIONNAIRE_RESOURCE_ID  | 
 number  | 
 Questionnaire's resource id  | 
| 
 QAS_USER_RESOURCE_ID  | 
 number  | 
 User's resource id  | 
| 
 QAS_TEST  | 
 bool  | 
 If it is a test answer sheet  | 
| 
 QAS_STATUS  | 
 number  | 
 Questionnaire answer sheet's status, it should be compared to/assigned with defined constants (see getRPQStatus function for more information)  | 
| 
 QAS_COMPLETED  | 
 bool  | 
 If the answer sheet is completed  | 
| 
 QAS_STARTDATE  | 
 array  | 
 Start date  | 
| 
 QAS_ENDDATE  | 
 array  | 
 End date  | 
| 
 QAS_CATI_APPOINTMENT  | 
 array  | 
 Next contact datetime  | 
| 
 QAS_CATI_LIST_TYPE  | 
 number  | 
 1: CATI_MAIN, 2: CATI_ONGOING, 3: CATI_APPOINMENT, 4: CATI_FINISHED, 5: CATI_RETRY NOTE! If the QAS is actually part of a CATI run, then this item should only be updated when the value is CATI_FINISHED, or when the CATI is not running, otherwise the CATI system may get confused.  | 
| 
 QAS_CATI_TIMES_CALLED  | 
 number  | 
 times called  | 
Example
array qas1 = QAS_new(33702597);
qas1[QAS_TEST] = true;
QAS_save(qas1);
array qas2 = QAS_new(33702597, 53468);
QAS_save(qas2);
Availability
Version 5.6