In this article
During the launch of a survey or when generating the database for a Professional Panel, a validation is conducted to check if any reserved Forsta or JScript keywords have been used as Question IDs. As a result of this validation process either a warning will be displayed (when launching a survey in Survey Designer) or the task will be aborted (when generating the database for a Professional Panel survey).
The following Reserved Keywords must not be used as Question IDs:
Note: These Keywords are not case-sensitive, so for example neither "ANY" nor "any" can be used as a Question ID. Question IDs can however start with these character strings, so for example "Anyone" can be used.
| A |
| abstract |
| action |
| aggregated |
| all |
| and |
| any |
| avg |
| B |
| between |
| boolean |
| break |
| by |
| byte |
| C |
| callback |
| case |
| caseid |
| catch |
| CatiExtendedStatus |
| channels |
| char |
| class |
| combined_sourceid |
| comment |
| con |
| conn |
| const |
| contains |
| continue |
| convert |
| count |
| createddate |
| D |
| date |
| datebetween |
| debugger |
| default |
| delete |
| DialType |
| do |
| double |
| E |
| else |
| enum |
| env |
| eq |
| extends |
| F |
| false |
| FilterStatus |
| FilterStatusDate |
| FilteredBySurveyId |
| final |
| finally |
| FirstEmailedDate |
| float |
| floor |
| for |
| function |
| G |
| ge |
| goto |
| group |
| gt |
| I |
| id |
| if |
| implements |
| import |
| in |
| instanceof |
| int |
| interface |
| interview_end |
| interview_end_time |
| interview_start |
| interview_start_time |
| interviewer |
| interviewerid |
| in_use |
| isfalse |
| istrue |
| iterationid |
| its |
| L (except for use under special conditions) |
| lastchannel |
| lastcomplete |
| lastdevicetype |
| lastrenderingmode |
| last_handled |
| last_touched |
| LastUpdated |
| le |
| long |
| loopstate |
| lt |
| N |
| native |
| ne |
| never_again |
| new |
| none |
| noofemailssent |
| not |
| not_in_quota |
| notin |
| null |
| O |
| or |
| order |
| P |
| package |
| page |
| panelid |
| PanelistCreatedDate |
| panelistid |
| PanelistModifiedDate |
| password (can only be used in respondent lists) |
| PValDate |
| PValInHier |
| PValNum |
| PValStr |
| PValStrArr |
| private |
| projectid |
| protected |
| public |
| Q |
| question |
| R |
| recoding |
| respid |
| responseid |
| return |
| rid |
| right |
| rolling |
| round |
| rowguide |
| S |
| sample_category |
| select |
| short |
| _sid_ |
| sid |
| smtpstatus |
| source_projectid |
| source_responseid |
| state |
| static |
| status |
| string |
| super |
| surveylink |
| switch |
| synchronized |
| T |
| this |
| throw |
| throws |
| to |
| todate |
| transient |
| tries |
| true |
| try |
| typeof |
| U |
| unique_sourceid |
| userid (can only be used in respondent lists) |
| V |
| var |
| void |
| volatile |
| W |
| while |
| with |
CATI-Specific Reserved Keywords
Some reserved keywords are specific to CATI (Computer-Assisted Telephone Interviewing) fields. To utilize these variables, you must include CATI as one of the interviewing channels.
| RespondentName |
| TelephoneNumber |
| TimeZoneId |
Special Cases
invalidResp - This is a special case. A question with invalidResp as its qid can be used to exclude certain records from reporting, for example if you suspect the survey respondent has just provided random answers. Responses with this flag set to 1 (TRUE) will not be written to hubs in SmartHub and “reporting data”, so will not be included in Reportal, Instant Analytics, Discovery Analytics, Fieldwork Reports or Studio. It will not affect "real-time" hitlists or Reportal reports using BitStream, or response rate reports/survey metrics in Professional Authoring/Survey Designer. The invalidResp variable does not lead to any changes in the survey engine/quota system – users will have to update quota targets accordingly when invalidating responses (e.g. increasing targets). The invalidResp variable will be available in data exports and in the data editor in Professional Authoring, and through APIs, and data with this flag set will be included when using APIs, or when Professional Users do data exports or look at data in the survey data editor. See also the separate SmartHub User Guide.
Restrictions
The following can only be used in respondent lists:
| userid |
| password |
| language |
The following cannot be used with a Contact DB:
| ContactId |
| ValidPeriod_From |
| ValidPeriod_To |
| IsCurrent |
| Modified |
| Created |
If the following are used as question ids, issues will arise when generating BitStream files. These should therefore not be used if reporting or sampling with BitStream files:
| AUX |
| CON |
| NUL |
| PRN |
| COM1 |
| COM2 |
| COM3 |
| COM4 |
| COM5 |
| COM6 |
| COM7 |
| COM8 |
| COM9 |
| LPT1 |
| LPT2 |
| LPT3 |
| LPT4 |
| LPT5 |
| LPT6 |
| LPT7 |
| LPT8 |
| LPT9 |
These are all supported by SmartHub/Reporting Data).
The iPhone and Android phone layout JavaScript depends on the class name "question" for identifying the container div to be changed when paging through questions. If anything with the class "question" is added to a survey, it will break touch rendering mode. The CSS class name "question" is therefore a reserved word.