callweb.cgi

home features DOCUMENTATION pricing contact us
technical documentationCATI documentation cookbook robot

Appendix J

System variables

In utility modules like cwfreq and cwnav, all lists of variables, questions and fields begin with a series of entries which start with an underscore (e.g., _telkey, _date); they are system variables which are available in every CallWeb project. The meaning of these system variables is explained in the following table.

System variable

Meaning

_telkey

Unique identifier of the case; this is the case "number". It can contain up to 64 characters, including only letters and numbers.

_proj

Name of the project to which each case is associated.

_demo

Binary flag (0|1) indicating whether a case was opened in demo mode. Obsolete.

_lang

Language in which the most recent displayed page was shown. This is a two-letter code.

_typeint

Type of interview. See the Survey type pound instruction

_cetordre

List of questions in the questionnaire, ordered for this case based on PERMUTATIONs. This list is created when the case is first accessed. It is deleted if the questionnaire is re-compiled with a structural change.

_cedossier

Encoded value of the _telkey. It ensures that the _telkey information stored in the HTML page has not been tempered with.

_cetecran

Name of the question most recently displayed. For multi-question pages, it is the name of the first question on the page.

_h1

String of date-time values documenting each time the questionnaire was initially opened in the callweb module. The system variables _date and _hour are derived from _h1.

_h2

String documenting the cumulative duration of each session in the callweb module. It is expressed in seconds. The system variables _seconds and _minutes are derived from _h2.

_h3

String of date-time values documenting each time the case was modified in cwnav.

_prepops

String of date-time values documenting each time the case was affected by a prepopulation operation. The system variable _lastprepop is derived from _prepops.

_verrou

Date-time value indicating when a lock was last taken on the case. This works in tandem with the Seconds locked pound instruction.

_telephone

Prepopulated telephone number, for CATI purposes.

_gmtoffset

Time zone of the prepopulated telephone number, expressed in hours from Greenwich.

_cetappel

Data structure documenting each call made in CATI mode.

_stock

Data structure containing a variety of information on the case such as the permutation order for response categories.

_bin

User controlled variable. Anything can be put in this field using a URL option or a CALCUL.

_dernierprepop _lastprepop

Most recent prepopulation date-time. See _prepops above.

_date

Date of the most recent access to the case. See _h1.

_week _semaine

Date of the most recent access to the case expressed as a week date. See _date and the week_start installation option.

_heure _hour

Hour of the most recent access to the case. See _h1.

_minutes

Total duration, in minutes, of all accesses to the case. See _h2 above.

_secondes _seconds

Total duration, in seconds, of all accesses to the case. See _h2 above.

_nappels _ncalls

Number of calls documented in the CATI call history. See _cetappel above.

_res

Call result code of the most recent CATI call. See _cetappel above.

_dateappel _calldate

Date of the most recent CATI call. See _cetappel above.

_heureappel _callhour

Hour of the most recent CATI call. See _cetappel above.

_tempsappel _calltime

Date-time of the most recent CATI call formatted as YYYYMMDDHHMMSS. See _cetappel above.

_interviewer

Name of the interviewer who registered the most recent CATI call result. See _cetappel above.

_daterv _appdate

Date of the appointment set on the most recent CATI call. See _cetappel above.

_heurerv _apphour

Hour of the appointment set on the most recent CATI call. See _cetappel above.

_commentaires _comments

Comments left by the interviewer on the most recent CATI call. See _cetappel above.