The source QPL program for Jims's demonstration is shown below.
teststuff.pgm
*****************************************************************************
** PROGRAM: teststuff.pgm DATE: 2004-11-26 **
** AUTHOR: Jim Loschiavo JOB: **
** **
** TITLE: QPL Examples **
** **
** PURPOSE: To help designers to program formats in qpl. **
** **
** **
** **
** **
** **
*****************************************************************************
*** Other Useful CONVERT Options:
*** /u - do not include user names with open-ended comments in Summary Stats report
*** /v - do not include question names on local HTML version of your questionnaire nor in the Summary Stats report
*** /vt - include text from VOID questions in the Summary Stats report
*** /dv <vaname> - do not inlclude this list of questions in the Summary Stats report or in the SAS or SPSS programs
** CONVERT Options: /d /f /l /u /v /vt /dv idnum email
** BUILD Options: /s= /d= /p= /u=
**** VERY IMPORTANT - no blank lines allowed above this line !!!!!
*****************************************************************************
** Global Settings
.TITLE = "Examples of QPL Question Types, etc."
**** The next line makes sure you get new name of GAO in appropriate places.
.SUBTITLE = "U.S. Government Accountability Office"
**** the next command changes the size of record from normal = 200 to
**** allow for a TYPE=STRING with .ANSWER = 256
.CARD = 300
*** The next command makes the "submit" button at end to equal "Exit"
*** By default it will always say "Submit" in local setting, but on the
*** website if it has more than one section, the button becomes "Exit"
*** it only stays as "Submit" for a one section survey on the web.
.210 ="Exit"
*** the next command is changing default of GOTO command
.172 = "Go to question"
.171 = "Go to section:"
.170 = "Go here"
*** the next command is changing the default of NEXT command
.173 = "Skip to question"
.175 = "Skip to section:"
.174 = "Skip here"
*** the next command is changing the default instruction for the TYPE=MULT question
.195 ="(Check only one answer.)"
*** the next command is changing the default instruction for the TYPE=CHECK question
.194 ="(Check all that apply.)"
*** the next command is changing the default instruction for the TYPE=LDATE question
.201 = "(Enter date using all whole numbers in the YYYY-MM-DD format.)"
*****************************************************************************
** Hidden, prepopulated questions
.QUESTION=IDNUM, TYPE=NUMBER
0Case identification number (need to also add: /dv idnum to Convert Options above)
.ANSWER=5
.NEXT
.QUESTION=EMAIL, TYPE=STRING
0email (need to also add email to /dv idnum in Convert Options above to read: /dv idnum email)
.ANSWER=50
.NEXT
*****************************************************************************
** Questions
********* Introduction Section **********************************************
.QUESTION=INTRO1A, TYPE=VOID
.SUBTITLE="Introduction Optional Beginning"
#Welcome to the U.S. GAO Survey on "Enter Subject of Survey Here".
To begin the survey, please click on the "Next Section" button
in the center of the screen. (Note: Some designers wish to start with this short
page or screen, while others do not use this approach. It is optional.)
.ANSWER
\
.NEXT
.QUESTION=INTRO1B, TYPE=VOID
.SUBTITLE = ">More Information for Beginning"
#\<i\>The first few pages the respondent sees after login
contain basic information and instructions.\</i\>
Information about the survey might include:
\<ul\>
\<li\>What GAO is\</li\>
\<li\>Content, requester, and purpose of the survey request\</li\>
\<li\>Why the survey request is important; an appeal to respond\</li\>
\<li\>Who is being asked to complete the survey, and how they were selected\</li\>
\<li\>How the respondent's answers will be maintained and reported; confidentiality status; security/access control of the survey\</li\>
\<li\>Voluntary/mandatory status of survey\</li\>
\<li\>Burden - how long it will take to complete the questionnaire, what records might be needed.\</li\>
\<li\>How the respondent can get a copy of the report\</li\>
\</ul\>
\<b\>Note: Do not put deadlines or time frames for responses in the body of the survey.
Those change often and making the change within a survey takes time and is problematic
to an ongoing live effort. It is best to put such information in the activating and follow-up
emails.\</b\>
General instructions on using the web survey might include how to:
\<ul\>
\<li\>Scroll to see all the questions on a page that doesn't fit on one screen
\<li\>move back and forth between pages
\<li\>leave the questionnaire and come back later
\<li\>print a blank or filled-in copy of the questionnaire
\<li\>contact someone from GAO to get help
\<li\>indicate that final answers are ready and can be used by GAO
\<li\>how to answer questions using the radio buttons, check boxes, and text boxes
\</ul\>
.ANSWER
\
.NEXT
.QUESTION=INTRO1C, TYPE=VOID
.SUBTITLE = ">Introduction - Example from Former Project"
#\<b\>You will need to use the scroll bar
on the right hand side of the screen to read all the information
on each page of this survey.\</b\>
The U.S. Government Accountability Office (GAO), an independent agency of Congress,
is conducting a review of management issues at the Federal Energy Regulatory
Commission (FERC). As part of our study, we are soliciting the views of the
FERC staff in the Office of Markets, Tariffs, and Rates and related sections
of the Office of General Counsel to obtain their opinions about a variety of
topics relating to the work of the FERC.
Most of the questions in this survey can be answered by checking boxes
or filling in blanks. Space has been provided at the end of the survey
for any additional comments. The survey should take about 30 minutes
to complete.
GAO will take steps to prevent the disclosure of individually identified data
from this survey. Only GAO staff assigned to this study can access and view
your responses. \<b\>No one at the FERC will see your individual responses.\</b\>
The PIN number associated with the survey is included only to allow you to
access the survey and enter your responses, and to aid us in our follow-up
efforts. Survey results will be reported in summary form. If individual
answers are discussed in our report, no information will be included that
could be used to identify individual respondents.
Your participation is very important and we urge you to complete this survey.
We cannot provide meaningful information to the Congress on these issues
without your frank and honest answers.
Thank you for your time and assistance.
.ANSWER
\
.NEXT
.QUESTION=INTRO2A, TYPE=VOID
.SUBTITLE=">Bold, Underline, Italics, Line Breaks, and Non-breaking Spaces"
#Bold: \  \  \  \  \  \  \<b\> This is in bold. \</b\>\<br\>
Underline: \  \  \<u\> This is underlined. \</u\>\<br\>
Italics: \  \  \  \  \  \<i\> This is in italics \</i\>\<br\>
All 3 above: \  \<b\>\<u\>\<i\>This is in bold, underlined, and italics.\</i\>\</u\>\</b\>\<br\>
1 Line Break: \<br\> \  \  \  \  \  \  \ 
\  \  \  This comes after a break.\<br\>
2 Line Breaks: \  \  \  \  \ 
\  \  \  \  \  This comes after two breaks. \<br\>
5 Non-breaking spaces between the 2 words "Joe Smith" below:\<br\>
\  \  \  \  \  \  \  \  \  \  Joe
\  \  \  \  Smith \<br\>
.ANSWER
\
.NEXT
.QUESTION=INTRO2A1, TYPE=VOID
.SUBTITLE="Pop-Up Information Box"
#Use the PopUp() function as shown below to create a small browser window
with information you saved in an HTML file. Typically, this would be
extra information that some respondents may need when completing a
question, such as a definition of terms used in the questionnaire.
See also \<a href=\"javascript:PopUp('qpl_sample_popup_text.htm', 400, 300);\" title=\"See definitions\"\>definitions\</a\> of terms.
The sample file, \<i\>qpl_sample_popup_text.htm\</i\>, that is put in your project directory
when you start a new project, may be used as a template for your information file. The numbers
used in the PopUp() function set the height and width in pixels of the pop-up
browser window.
.ANSWER
\
.NEXT
************* end of introduction section ****************************************
************* persons to contact for help, completed button reminder ***********
************** and navigation instructions section *****************************
.QUESTION=INTRO2B, TYPE=VOID
.SUBTITLE=">Contact Information"
#Use this version if you decide to HAVE the "bottom" menu.
If you have any questions or are experiencing difficulties responding
to the survey, please contact either of the following individuals:
John Doe \<br\>
Phone: (202)512-0000, 9:00 am - 5:00 pm (EDT) \<br\>
E-mail: doej@gao.gov
Jane Smith \<br\>
Phone: (202)512-0001, 7:00 am - 4:00 pm (EDT) \<br\>
E-mail: smithj@gao.gov
If you need to be reminded about these persons during later parts of this survey,
Click on the "?" button at the bottom of the screen or click on the caption:
"Contact Information" on the left menu. Either option will reveal these same
persons.
However, only the "?" button will include an email hot link. Clicking on
the hot link in most cases will automatically open up your email system and have
the proper email in the "To:" address. Then you only need to fill in your
question and send the message.
.ANSWER
\
.NEXT
.QUESTION=INTRO2C, TYPE=VOID
.SUBTITLE="Contact Information (Alternate)"
#Use this alternative if you decide to NOT have the "bottom" menu.
If you have any questions or are experiencing difficulties responding
to the survey, please contact either of the following individuals:
John Doe \<br\>
Phone: (202)512-0000, 9:00 am - 5:00 pm (EDT) \<br\>
E-mail: \<a href='mailto:doej\@gao.gov'\>doej@gao.gov\</a\>
Jane Smith \<br\>
Phone: (202)512-0001, 7:00 am - 4:00 pm (EDT) \<br\>
E-mail: \<a href='mailto:smithj\@gao.gov'\>smithj@gao.gov\</a\>
If you need to be reminded about these persons during later parts of this survey,
Click on the caption: "Contact Information" on the left menu. It will reveal these same
persons with an email hot link.
Clicking on the hot link in most cases will automatically
open up your email system and have the proper email in the "To:" address. Then you only
need to fill in your question and send the message.
.ANSWER
\
.NEXT
.QUESTION=INTRO3, TYPE=VOID
.SUBTITLE="Indicating You Have Completed the survey"
#The last question in the last section asks you to indicate if
you have completed this survey. By clicking on "complete," this
tells us that your answers are official and final.
\<b\>Your answers will not be used unless you have done this.\</b\>
Please note we will not send follow up e-mails to those who have checked the
"Complete" button.
.ANSWER
\
.NEXT
.QUESTION=INTRO4, TYPE=VOID
.SUBTITLE="Navigating, Exiting, and Printing the survey"
#\<b\>Please do not use the "Enter" key on your keyboard to navigate
through the survey. \</b\>
\<u\>To read to the bottom of a section\</u\>: Use the scroll bar
on the right hand side of the section.
\<u\>To move from section to section\</u\>: Use either the (1) "Next
section" and "Previous section" buttons at the end of each section or
(2) menu bar on the left side of the screen. Do not use the "Enter"
key on your keyboard to navigate through the survey.
\<u\>To exit\</u\>: Click on the "Exit" button at the end of each screen.
\<b\>Always use the "Exit" button to close the survey. If you do
not, you will lose the information you entered in that section.\</b\>
\<u\>To restart your survey:\</u\> Log on to the survey
using your user name and password. The survey will restart at the
point where you exited.
\<u\>To change your answers\</u\>: To change an answer marked with a
"button" (circle), click on another answer. To "uncheck" a checked box, click on the box
again (this will "uncheck" it), then check the box(es) you wish to check.
To change what is in a text box, click in the box and then delete and type over.
\<u\>Note\</u\>: You cannot use your browser's
Back button to backup and make changes. Use the previous section button or
click on a side caption in the left margin instead. You can change your
answers, even after logging off, by logging on again (see above).
\<u\>To skip non applicable questions\</u\>: If the response you wish to choose has a
highlighted \<b\>(Go to Q#.)\</b\> next to it, instead of clicking on the circle, you
should click on the highlighted \<b\>(Go to Q#.)\</b\>. When you do that
the circle to the left of the response will be automatically filled
in and you will be taken to the next applicable part of the survey.
\<u\>To answer open-ended questions\</u\>: Click anywhere inside the
box and begin typing. When you reach the limit of the open space, keep
typing and the box will automatically expand.
\<u\>To print your responses\</u\>: Click on the "Print" button
at the end of each section. You cannot print the entire survey
at one time.
\<u\>Suggestion\</u\>: Print this section to have for future reference.
.ANSWER
\
.NEXT
********************* end of navigation instructions section **********************
.QUESTION=INFO1, TYPE=VOID
.SUBTITLE=">Check Only One or TYPE=Mult Questions"
#Multiple Choice Questions
Multiple choice questions, which allow the respondent to
select only one answer from a list, are the backbone of a
self-administered web survey. Typically,
they will make up the great majority of questions in a survey.
These questions can be used to make conditional skips to
any question in the survey, according to which answer was
selected. When the respondent selects an answer and clicks
on the skip instruction, his or her browser will automatically
skip to the question that has been linked to that answer. Thus,
multiple choice questions also can be used to screen respondents
and direct them into appropriate lines of questions. GOTO examples appear
later.
Each Check Only One question needs as a minimum these commands:\<br\>
\ \ \ .QUESTION = variable name, TYPE=MULT\<br\>
\ \ \ .ANSWER = default answer number, or = variable name\<br\>
\ \ \ answer line format tag \<br\>
\ \ \ .NEXT \<br\>
The TYPE command must be set to "MULT."
By default, multiple choice questions will be presented in
a vertical layout with each answer listed on a separate
row with a leading radio button.
You may optionally use format tags to tell the QPL
converter to display a question in a horizontal format.
Here, the question text is displayed in the column on
the left and the answers are used as column headings.
Further, you may stack several questions together to
create a "matrix" where the radio buttons are inserted
in the intersection between the question text and the
column headings. This is covered in more depth later on
under "Matrix Type".
ANSWER Command
The ANSWER command is required and is used to separate
the question text from the list of responses. You may
also use it to set the default answer for the MULT type
(i.e., the answer that will be checked the first time
the respondent sees the questionnaire), and
copy an answer list (including the default answer setting)
from a previous question.
The last item in the list will be checked unless you set the
default to another number. For example, if you have three
items in your list and you want the second item to be checked,
you would set the ANSWER command to 2.
You may also set the ANSWER command to 0 (zero) if you do not
want any answers to be checked by default. Once the respondent
clicks on an answer, that response will be checked.
The respondent may move a check mark, but the respondent may
not uncheck all of the responses (i.e., to put the question
back into its original, unchecked state). Therefore, you
should always use the last category to let the respondent
indicate an answer that is not any of the above, such as
"Don't know," or "No response."
At least one answer line is required. There is no limit on
the number of answer lines you may use, but each answer must
be typed on a separate line and be less than 240 characters long
(even less if bolding, italics, or underlining is involved).
.ANSWER
\
.NEXT
.QUESTION=Q01, TYPE=MULT
.SUBTITLE="Check Only One - No Answers Initially Checked Example"
You may set the ANSWER command to 0 (zero) if you do not
want any answers to be checked by default. Once the respondent
clicks on an answer, that response will be checked. The respondent
may move a check mark, but the respondent may not uncheck all of
the responses (i.e., to put the question back into its original,
unchecked state.)(.ANSWER=0).
Do You Like TV Dinners?
.ANSWER=0
Yes
No
Don’t know
.NEXT
.QUESTION=Q02, TYPE=MULT
.SUBTITLE="Check Only One - Last response Checked by Default"
No particular answer has been set in this question so it will be
displayed with the last item, "Don't know," checked by default (.ANSWER ).
Do You Like TV Dinners?
.ANSWER
Yes
No
Don’t know
.NEXT
.QUESTION=Q03, TYPE=MULT
.SUBTITLE="Check Only One - First Answer Initially Checked Example"
This question will be displayed with the first item, "Yes" checked because its
ANSWER command is set to 1 (.ANSWER=1).
Do You Like TV Dinners?
.ANSWER = 1
Yes
No
Don’t know
.NEXT
.QUESTION = Q04, TYPE=MULT
.SUBTITLE="Check Only One - Uses Answer Format Like First Question Example"
This question will display the same answer list as question Q01, and no responses
will be checked by default because Q01's ANSWER command was set to 0 (.ANSWER = q01).
GOTO commands, however, are not copied. If you need to use GOTO commands, you must
repeat the answer list again and insert the GOTO commands after each response
that needs it.
Do You Like TV Dinners?
.ANSWER = Q01
.NEXT
.QUESTION=Q05, TYPE=MULT
.SUBTITLE="Check Only One - Shows Use of ! to Get Grey Background for an Answer"
You may specially highlight an answer line by putting the exclamation mark (!)
format tag at the beginning of the answer line. This will cause that answer to
be displayed with a grey background.
Do You Like TV Dinners?
.ANSWER
Yes
No
!Don’t know
.NEXT
.QUESTION=INFO2, TYPE=VOID
.SUBTITLE=">Check All That Apply or TYPE=Check Questions"
#Check-All-That-Apply Questions
Check-all-that-apply questions allow the respondent to select
more than one response from a list of answers, or to select
none of the answers. While they are programmed similar to
multiple choice questions, they are different because multiple
choice questions only allow one answer to be selected.
Each Check All That Apply question needs as a minimum these commands:\<br\>
\ \ \ .QUESTION = variable name, TYPE=CHECK\<br\>
\ \ \ .ANSWER = variable name\<br\>
\ \ \ answer line format tag \<br\>
\ \ \ .NEXT \<br\>
The TYPE command must be set to "CHECK" for check all that apply questions.
By default, check-all-that-apply questions will be presented in a
vertical layout with each answer listed on a separate row with a
leading square button.
You may optionally use a format tag to tell the QPL converter to display
the question in a horizontal format. Here, the question text is displayed
in the column on the left and the answers are used as column headings.
Further, you may stack several questions together to create a "matrix"
where the square buttons are inserted in the intersection between the
question text and the column headings. See also question 9 below.
ANSWER Command
The ANSWER command is required and is used to separate the question
text from the list of responses.
No items are checked by default.
You may also use it to copy an answer list from a previous question.
At least one answer line is required. There is no limit on
the number of answer lines you may use, but each answer must
be typed on a separate line and be less than 240 characters long.
.ANSWER
\
.NEXT
.QUESTION = Q06, TYPE=CHECK
This is an example of a simple Check All That Apply Question.
What are your favorite colors?
.ANSWER
Red
Orange
Yellow
Green
Blue
Indigo
Violet
None
.NEXT
.QUESTION=Q07, TYPE=CHECK
You may also use the Answer command to copy an answer
list from a previous question (.ANSWER = q06).
Copying the answer lists can save programming time and computer
memory because the answer list needs to be written only once.
If changes need in the list need to be made while you are developing
your questionnaire, only the original list needs to be edited.
The changes will be copied to the other questions automatically.
As with Check Only One questions the GOTO commands are not automatically
copied. They must be taken care of separately.
What are your mother's favorite colors?
.ANSWER = Q06
.NEXT
.QUESTION=Q08, TYPE=CHECK
You may specially highlight an answer line by putting the exclamation mark (!)
format tag at the beginning of the answer line. This will cause that answer to
be displayed with a grey background.
What are your favorite colors?
.ANSWER
Red
Orange
Yellow
Green
Blue
Indigo
Violet
!Don't know
.NEXT
.QUESTION=Q09, TYPE=VOID
.SUBTITLE="Ranking Type Question Using Up to 3 Choices Example"
Further, you may stack several questions together to create a "matrix"
where the square buttons are inserted in the intersection between the
question text and the column headings.
Rank the following items as from question 9
as the most negative, the most positive, and
the most challenging (Select up to 3 only)?\<br\>
09a Travel for the project\<br\>
09b On-the-Job training \<br\>
09c External training\<br\>
09d Documentation efforts\<br\>
09e Writing the report
.ANSWER
(Select up to 3 answers only for each row listed below.)
.NEXT
.QUESTION=Q09A, TYPE=CHECK
=1a. Most Negative
.ANSWER
09a.
09b.
09c.
09d.
09e.
None
.NEXT
.QUESTION=Q09B, TYPE=CHECK
+1b. Most Positive
.ANSWER=q09a
.NEXT
.QUESTION=Q09C, TYPE=CHECK
+1c. Most Challenging
.ANSWER=q09a
.NEXT
.QUESTION=Q10, TYPE=CHECK
.SUBTITLE="Avoid the check all that apply style"
Based on recent research it has been
determined that the results from this type question
(check all that apply) is not as accurate as having
separate yes / no / no answer ones. Nancy Kingsbury
is strongly in favor of NOT using this style BUT instead
to use the next ONE (Matrix, Yes/No/No Answer).
Which of these Sports do you like?
.ANSWER
Baseball
Basketball
Football
Golf
Other (name below)
.NEXT
.QUESTION=Q10A, TYPE=STRING
#If "other", please specify:
.ANSWER =50
.NEXT
.QUESTION=Q11, TYPE=VOID
.SUBTITLE="Use this Matrix yes - no - na type"
This is preferable to the check all that
apply type question. Please use this style at all times if possible.
Which of these sports do you like?
.ANSWER
(Select one answer for each row listed below.)
.NEXT
.QUESTION=Q11A, TYPE=MULT
=1a. Baseball
.ANSWER=0
Yes
No
No answer
.NEXT
.QUESTION=Q11B, TYPE=MULT
+1b. Basketball
.ANSWER=q11a
.NEXT
.QUESTION=Q11C, TYPE=MULT
+1c. Football
.ANSWER=q11a
.NEXT
.QUESTION=Q11D, TYPE=MULT
+1d. Golf
.ANSWER=q11a
.NEXT
.QUESTION=Q11E, TYPE=MULT
+1e. Other (describe below)
.ANSWER=q11a
.NEXT
.QUESTION=Q11F, TYPE=STRING
+1If "other", please specify:
.ANSWER =50
.NEXT
.QUESTION=INFO3, TYPE=VOID
.SUBTITLE=">Matrix Type Question Formats"
#The following applies only to Check only one type questions (type = mult)
It does not apply to questions with 3 or less columns or responses.
For all Check only one type questions, we require there to be at least one response
of the type: No Answer, Don't Know, No basis to judge, Not Applicable, etc. Therefore,
the following Matrix formats do not include the option to not have the last one or two
columns with a darker shading.
.ANSWER
\
.NEXT
.QUESTION=Q12, TYPE=VOID
.SUBTITLE = "Matrix with option zero"
No alternating light gray and white backgrounds for each row.
No display of a number for each row.
Display of right-most column with a dark gray shade.
.ANSWER
(Check only one answer for each row below.)
.NEXT
.QUESTION = Q12A, TYPE=MULT
=0How do you feel today?
.ANSWER = 9
Very Good
Good
Fair
Poor
Very Poor
Don't know
No response
.NEXT
.QUESTION = Q12B, TYPE=MULT
+0How did you feel yesterday?
.ANSWER = q12a
.NEXT
.QUESTION = Q12C, TYPE=MULT
+0How do you think you will feel tomorrow?
.ANSWER = q12a
.NEXT
.QUESTION=Q13, TYPE=VOID
.SUBTITLE = "Matrix with option one"
Alternating light gray and white backgrounds for each row.
No display of a number or letter for each row. The letters a.,
b., and c. were typed into the code.
Display of right-most column with a dark gray shade.
.ANSWER
(Check only one answer for each row below.)
.NEXT
.QUESTION = Q13A, TYPE=MULT
=1a.How do you feel today?
.ANSWER = 9
Very Good
Good
Fair
Poor
Very Poor
Don't know
No response
.NEXT
.QUESTION = Q13B, TYPE=MULT
+1b. What's your mom's favorite color?
.ANSWER = q13a
.NEXT
.QUESTION = Q13C, TYPE=MULT
+1c. What's your dad's favorite color?
.ANSWER = q13a
.NEXT
.QUESTION=Q14, TYPE=VOID
.SUBTITLE = "Matrix with option two"
No alternating light gray and white backgrounds for each row.
Display of a number for each row.
Display of right-most column with a dark gray shade.
.ANSWER
(Check only one answer for each row below.)
.NEXT
.QUESTION = Q14A, TYPE=MULT
=2How do you feel today?
.ANSWER = 9
Very Good
Good
Fair
Poor
Very Poor
Don't know
No response
.NEXT
.QUESTION = Q14B, TYPE=MULT
+2How do you feel today?
.ANSWER = Q14a
.NEXT
.QUESTION = Q14C, TYPE=MULT
+2What's your dad's favorite color?
.ANSWER = Q14a
.NEXT
.QUESTION=Q15, TYPE=VOID
.SUBTITLE ="Matrix with option three"
Alternating light gray and white backgrounds for each row.
Display of a number for each row.
Display of right-most column with a dark gray shade.
.ANSWER
(Check only one answer for each row below.)
.NEXT
.QUESTION = Q15A, TYPE=MULT
=3How do you feel today?
.ANSWER = 9
Very Good
Good
Fair
Poor
Very Poor
Don't know
No response
.NEXT
.QUESTION = Q15B, TYPE=MULT
+3What's your mom's favorite color?
.ANSWER = Q15a
.NEXT
.QUESTION = Q15C, TYPE=MULT
+3What's your dad's favorite color?
.ANSWER = Q15a
.NEXT
.QUESTION=Q16, TYPE=VOID
.SUBTITLE ="Matrix with option four"
No alternating light gray and white backgrounds for each row.
No Display of a number for each row.
Display of two right-most columns with a dark gray shade.
.ANSWER
(Check only one answer for each row below.)
.NEXT
.QUESTION = Q16A, TYPE=MULT
=4How do you feel today?
.ANSWER = 9
Very Good
Good
Fair
Poor
Very Poor
Don't know
No response
.NEXT
.QUESTION = Q16B, TYPE=MULT
+4What's your mom's favorite color?
.ANSWER = Q16a
.NEXT
.QUESTION = Q16C, TYPE=MULT
+4What's your dad's favorite color?
.ANSWER = Q16a
.NEXT
.QUESTION=Q17, TYPE=VOID
.SUBTITLE ="Matrix with option five"
Alternating light gray and white backgrounds for each row.
No display of a number for each row.
Display of two right-most columns with a dark gray shade.
.ANSWER
(Check only one answer for each row below.)
.NEXT
.QUESTION = Q17A, TYPE=MULT
=5How do you feel today?
.ANSWER = 9
Very Good
Good
Fair
Poor
Very Poor
Don't know
No response
.NEXT
.QUESTION = Q17B, TYPE=MULT
+5What's your mom's favorite color?
.ANSWER = Q17a
.NEXT
.QUESTION = Q17C, TYPE=MULT
+5What's your dad's favorite color?
.ANSWER = Q17a
.NEXT
.QUESTION=Q18, TYPE=VOID
.SUBTITLE ="Matrix with option six"
No alternating light gray and white backgrounds for each row.
Display of a number for each row.
Display of two right-most columns with a dark gray shade.
.ANSWER
(Check only one answer for each row below.)
.NEXT
.QUESTION = Q18A, TYPE=MULT
=6How do you feel today?
.ANSWER = 9
Very Good
Good
Fair
Poor
Very Poor
Don't know
No response
.NEXT
.QUESTION = Q18B, TYPE=MULT
+6What's your mom's favorite color?
.ANSWER = Q18a
.NEXT
.QUESTION = Q18C, TYPE=MULT
+6What's your dad's favorite color?
.ANSWER = Q18a
.NEXT
.QUESTION=Q19, TYPE=VOID
.SUBTITLE ="Matrix with option seven"
Alternating light gray and white backgrounds for each row.
Display of a number for each row.
Display of two right-most columns with a dark gray shade.
.ANSWER
(Check only one answer for each row below.)
.NEXT
.QUESTION = Q19A, TYPE=MULT
=7How do you feel today?
.ANSWER= 9
Very Good
Good
Fair
Poor
Very Poor
Don't know
No response
.NEXT
.QUESTION = Q19B, TYPE=MULT
+7What's your mom's favorite color?
.ANSWER = Q19a
.NEXT
.QUESTION = Q19C, TYPE=MULT
+7What's your dad's favorite color?
.ANSWER = Q19a
.NEXT
.QUESTION=Q20, TYPE=VOID
.SUBTITLE ="Matrix with option with no number (default = three)"
Alternating light gray and white backgrounds for each row.
Display of a number for each row.
Display of right-most column with a dark gray shade.
.ANSWER
(Check only one answer for each row below.)
.NEXT
.QUESTION = Q20A, TYPE=MULT
=How do you feel today?
.ANSWER = 9
Very Good
Good
Fair
Poor
Very Poor
Don't know
No response
.NEXT
.QUESTION = Q20B, TYPE=MULT
+What's your mom's favorite color?
.ANSWER = Q20a
.NEXT
.QUESTION = Q20C, TYPE=MULT
+What's your dad's favorite color?
.ANSWER = Q20a
.NEXT
.Question = INTRO5A, TYPE=VOID
.SUBTITLE=">Matrix Option to Provide Side Captions in One Question"
#The following is taken from an actual survey which goes on with many
more categories. We provided enough to give you the idea in case you
wish to do something similarly.
.ANSWER
\ 
.NEXT
.Question = INTRO5, TYPE=VOID
.SUBTITLE="Your Satisfaction or Dissatisfaction with Various Aspects of Your Job"
#21. Currently, how satisfied or dissatisfied are you with each of the
\ \ \ \ following aspects of your job with the SEC?
.ANSWER
(Check one box in each row.)
.NEXT
.Question = Q21A1, TYPE=MULT
.SUBTITLE="Your Compensation"
=3Your total pay (excluding benefits)
.ANSWER =0
Very\<br\>satisfied
Generally\<br\>satisfied
Neither\<br\>satisfied\<br\>nor\<br\>dissatisfied
Generally\<br\>dissatisfied
Very\<br\>dissatisfied
Not applicable/\<br\>No basis\<br\>to judge
.NEXT
.QUESTION=Q21A2, TYPE=MULT
+Your total pay (excluding benefits) compared to pay for similar jobs
within the federal government
.ANSWER=q21a1
.NEXT
.QUESTION=Q21A3, TYPE=MULT
+Your total pay (excluding benefits) compared to pay for similar jobs
outside of the federal government
.ANSWER=q21a1
.NEXT
.QUESTION=Q21A4, TYPE=MULT
+Your federal employee benefits program in general
.ANSWER=q21a1
.NEXT
.QUESTION=Q21A5, TYPE=MULT
+Student loan repayment program
.ANSWER=q21a1
.NEXT
.Question = INTRO6, TYPE=VOID
.SUBTITLE=">"
#21. Currently, how satisfied or dissatisfied are you with each of the
\ \ \ \ following aspects of your job with the SEC?
.ANSWER
(Check one box in each row.)
.NEXT
.QUESTION=Q21B1, TYPE=MULT
.SUBTITLE="Your Job"
=Your overall job
.ANSWER=q21a1
.NEXT
.QUESTION=Q21B2, TYPE=MULT
+The meaningfulness of your work
.ANSWER=q21a1
.NEXT
.QUESTION=Q21B3, TYPE=MULT
+The extent to which your work is made use of by the SEC
.ANSWER=q21a1
.NEXT
.QUESTION=Q21B4, TYPE=MULT
+The extent to which your job makes use of your skills and abilities
.ANSWER=q21a1
.NEXT
.Question = INTRO7, TYPE=VOID
.SUBTITLE=">"
#21. Currently, how satisfied or dissatisfied are you with each of the
\ \ \ \ following aspects of your job with the SEC?
.ANSWER
(Check one box in each row.)
.NEXT
.QUESTION=Q21C1, TYPE=MULT
.SUBTITLE="The Balance Between Your Work and Personal Life"
=Your ability to balance your work and personal life
.ANSWER=q21a1
.NEXT
.QUESTION=Q21C2, TYPE=MULT
+Your ability to work on a part-time basis
.ANSWER=q21a1
.NEXT
.QUESTION=Q21C3, TYPE=MULT
+Your ability to work using a "flexitime" schedule (i.e., either starting early or staying
late or a compressed schedule of fewer than 10 workdays per pay period)
.ANSWER=q21a1
.NEXT
.QUESTION=Q21C4, TYPE=MULT
+Your ability to work using a "flexiplace" arrangement (i.e., working a portion of the time
at home or at another location)
.ANSWER=q21a1
.NEXT
.QUESTION=Q21C5, TYPE=MULT
+The extent to which you can take advantage of family/personal leave (e.g., maternity/ paternity leave)
opportunities without it being detrimental to your career
.ANSWER=q21a1
.NEXT
.QUESTION=Q21C6, TYPE=MULT
+The extent to which leave and flexible work policies are consistently applied within your division
or office
.ANSWER=q21a1
.NEXT
.QUESTION=Q21C7, TYPE=MULT
+Amount of annual leave you are eligible for
.ANSWER=q21a1
.NEXT
.QUESTION=Q21C8, TYPE=MULT
+Amount of sick leave you are eligible for
.ANSWER=q21a1
.NEXT
.QUESTION=Q22, TYPE=MULT
.SUBTITLE=">Using Go To Commands"
I changed the default instruction from:
(GO TO QUESTION ) To: (Go to Q ). See global
command section of teststuff.pgm file.
Do you like Sports?
.ANSWER
Yes
No
.goto=q24
I have no idea what this is all about! I could go on and on.
.goto=q24
No answer
.goto=q24
.NEXT
.QUESTION=Q23, TYPE=MULT
.SUBTITLE="Go To Instructions With a Break Example"
If you would like the default "go to" instruction or one you provide to begin on a new line,
use this code at the end of the preceding line: "forward slash <br forward slash >".
See difference between the "go to" in this and the previous question.
(Note: I also used the break line code between the two sentences to break that up.)
Do you really like Sports?
.ANSWER=3
Yes
No
.goto q24
I have no idea what this is all about!\<br\> I could go on and on.
.goto=q24
No response
.goto=q24
.NEXT
.QUESTION = Q24, TYPE=NUMBER=2
.SUBTITLE="Number Questions"
The number question type has several features that help the respondent enter the correct number.
"Don't know" responses may be entered by leaving the field blank or the check box or boxes option
that is shown later. Only numbers may be entered. Any alpha characters will be stripped away
when saved to the database. For example, an entry like $34k will be saved as "34".
Responses will be rounded to the number of decimal places you specify.
\<b\>Specifying Decimal Places\</b\>
The NUMBER argument can take a sub-argument that specifies the
number of decimal places or a special format for the number.
You may specify a number that has up to nine decimal places.
If you want to use an integer, you may either set the number of
decimal places to zero or omit specifying any decimal places.
This example sets the number width to 4 and 2 decimal places
using "Type = number =2" (specifies 2 decimal places) and
the ".ANSWER = 4" (specifies the width of 4).
This limits the range of numbers that the respondent may enter from -9.99 to 99.99.
.ANSWER = 4
.NEXT
.QUESTION = Q25, TYPE=NUMBER = "##.##"
.SUBTITLE="Number where you do the width and decimals in the type option"
Format strings use the pound sign (#) to represent digits and period (.) to represent
the decimal point. This example also creates a four digit number which includes
two decimal digits (.QUESTION=q25, TYPE=NUMBER="##.##").
This also limits the range of numbers that the respondent may enter from -9.99 to 99.99.
In this and previous example no answer text line was used, so the field will be
blank when this question is displayed in the browser.
.ANSWER
.NEXT
.QUESTION = Q26, TYPE=NUMBER = "$ ###.##"
.SUBTITLE="Placing Label On Left of Input Box"
You may also use the format string to add extra labels on the left of
the number input box.
Example: ".QUESTION = Q26, TYPE=NUMBER = "$ ###.##" which places
the "$" to the left of the empty block allowing a dollar value from
"-99.99 to 999.99."
.ANSWER
.NEXT
.QUESTION = Q27, TYPE=NUMBER = "## Years"
.SUBTITLE="Placing Label On Right of Input Box"
You may also use the format string to add extra labels on the right
of the number input box.
Example: ".QUESTION = Q27, TYPE=NUMBER = "## Years" which places
the "Years" to the right of the empty block allowing a number from -9 to 99."
.ANSWER
.NEXT
.QUESTION = Q28, TYPE=NUMBER = "## \<i\>Years\</i\>"
.SUBTITLE="Having a Number Input Box Label as Italics or Bold"
You may also use the format string to add features such as "italics" (bold).
If you use HTML tags in your format, as shown below, you must escape all of
the special HTML characters. Use this example: (.QUESTION = Q28,
TYPE = NUMBER = "## forward slash < i or b forward slash > Years forward slash
< forward slash i or b backward slash >") where an i will italicize
\<i\>Years\</i\> and a b will bold \<b\>Years\</b\>.
.ANSWER
.NEXT
.QUESTION = Q29, TYPE=NUMBER
.SUBTITLE="Example of Using the Copy Answer Formats Feature"
Copying the answer formats can save programming time and computer
memory because the answer format needs to be written only once.
If you need to change the format, only the original format needs
to be edited. The change will be copied to the other questions automatically.
Example:( .QUESTION = Q29, TYPE=NUMBER, and .ANSWER = q26).
In this example, question Q29 is set to a four-digit number, including
two decimal places, a "$" to the left, and a blank response because its ANSWER command is
set to question Q26.
.ANSWER = Q26
.NEXT
.QUESTION = Q30, TYPE=NUMBER = 2
.SUBTITLE="Example of Having a Number Appear in the Input Box"
Default Answer for NUMBER questions will default to a blank, or missing response
if no answer text line is used to specify a default response.
In this example, the default response has been set to 12.34 (.question = q30, TYPE=NUMBER=2),
(.ANSWER=4), and (in the line between .ANSWER and .NEXT place 1234).
The respondent may change this number to another response by editing it. This question
will be displayed in the respondent's browser as shown below.
.ANSWER=4
1234
.NEXT
.QUESTION=Q31, TYPE=NUMBER="Phone Number: ##########"
.SUBTITLE="Example of TYPE=NUMBER Phone number"
What is your phone number, including your area code?
(Click in the box and then enter a 10-digit whole number only.)
.ANSWER=10
.NEXT
.QUESTION=Q32, TYPE=VOID
.SUBTITLE="Example of 3-part way of doing phone number"
This example allows one to help reduce errors when respondents
enter a 10-digit phone number by breaking it into 3 parts.
It also makes use of one of the newest features of having a right label
next to the input box. The label on the left of the input box
is there because of the matrix formatted row.
What is your phone number?
.ANSWER
(Please enter it in 3 parts below.)
.NEXT
.QUESTION= Q32A, TYPE= number="### (3-digit whole number)"
+0Area Code:
.ANSWER
.NEXT
.QUESTION= Q32B, TYPE=NUMBER="### (3-digit whole number)"
+0Middle Part:
.ANSWER
.NEXT
.QUESTION= Q32C, TYPE=NUMBER="#### (4-digit whole number)"
+0Last Part:
.ANSWER
.NEXT
.QUESTION=Q33, TYPE=NUMBER
.SUBTITLE=">Number Not Known or Not Applicable 2 Check Boxes Example"
It is desirable to give respondents a mechanism to respond to each
question rather than leaving questions blank. To find out if a number
is not applicable, you can ask respondents to use a check box when
they have no numeric answer. It is like saying "not applicable" in
a "check only one" question:
According to your institution's policy or SOP, what is the maximum
number of days sponsors can take to determine whether or not to file for
patent protection?
(\<STRONG\>Enter 1 to 5-digit whole numbers only.\</STRONG\>)
.ANSWER=5
.NEXT
.QUESTION=Q33NO, TYPE=CHECK
=0
.ANSWER
Check below if\<br\>you don't know\ \ \ \ \ \
Check below if \<br\>your office does not\<br\>collect this information
.NEXT
.QUESTION=Q34, TYPE=NUMBER
.SUBTITLE="Number Not Known One Check Box Example"
It is desirable to give respondents a mechanism to respond to each
question rather than leaving questions blank. To find out if a number
is not applicable, you can ask respondents to use a check box when
they have no numeric answer. It is like saying "not applicable" in
a "check only one" question:
According to your institution's policy or SOP, what is the maximum
number of days sponsors can take to determine whether or not to file for
patent protection?
(\<STRONG\>Enter 1 to 5-digit whole numbers only.\</STRONG\>)
.ANSWER=5
.NEXT
.QUESTION=Q34NO, TYPE=CHECK
=0
.ANSWER
Check below if\<br\>you don't know\ \ \ \ \ \
.NEXT
.QUESTION=Q35, TYPE=ldate
.SUBTITLE=">Example of TYPE=ldate with default date YYYY"
What is the date you were born?
(Click in the box below and then type over the
existing date with the correct one in the same format of YYYY-MM-DD.)
Note: I changed the default instruction a bit. Also I
have entered a default date to show them the format.
.ANSWER
19540101
.NEXT
.QUESTION=Q36, TYPE=VOID
.SUBTITLE="Example of 2 part date - mm yyyy"
Sometimes people only want the month and year entered. The following is an example
of doing just that.
On what date did you begin your last project?
.ANSWER
\
.NEXT
.QUESTION= Q36A, TYPE=NUMBER="## (2-digit month)"
+0Month:
.ANSWER
.NEXT
.QUESTION= Q36B, TYPE=NUMBER="#### (4-digit year)"
+0Year:
.ANSWER
.NEXT
.QUESTION=Q37, TYPE=VOID
.SUBTITLE=">Alternative No.1 to Actual or Estimate Numbers"
The following two questions are two different ways to accomplish a similar
data input request, to have options to give either an estimate or and actual
dollar entry. Also, to provide a way to indicate "Don't Know", etc.
In federal fiscal year (FFY) 2003 (October 1, 2002 though
September 30, 2003), how many children, involved with your state’s child welfare
agency, were in each of the following categories?
Please provide unduplicated head counts. While answers based on actual data are preferred,
estimates are acceptable. After each category's answer, please identify whether your
answers are actual counts or estimated counts by placing a check mark in the appropriate box.
If you do not know or cannot estimate the number of children for any of the categories, please
leave that item blank and check the appropriate box marked "Do not know or cannot estimate".
.ANSWER
(For each category listed below, please enter a 1 to 10-digit whole number only and check only one box.)
.NEXT
.QUESTION=Q37A1, TYPE=NUMBER
=5a. Total children (ICWA and non-ICWA) in foster care for at least part of the year.
.ANSWER = 10
.NEXT
.QUESTION=Q37A2, TYPE=CHECK
=0
.ANSWER
Check here if \<b\>Actual\<b\>\ \ \
Check here if \<b\>Estimate\<b\>\ \ \
Check here if \<b\>Do not know or cannot estimate\<b\>
.NEXT
.QUESTION=Q37B1, TYPE=NUMBER
+5b. Total children (ICWA and non-ICWA) who entered foster care during the year (a subset of question a. above).
.ANSWER = 10
.NEXT
.QUESTION=Q37B2, TYPE=CHECK
=0
.ANSWER
Check here if \<b\>Actual\<b\>\ \ \
Check here if \<b\>Estimate\<b\>\ \ \
Check here if \<b\>Do not know or cannot estimate\<b\>
.NEXT
.QUESTION=Q37C1, TYPE=NUMBER
+5c. American Indian children in foster care for at least part of the year.
.ANSWER = 10
.NEXT
.QUESTION=Q37C2, TYPE=CHECK
=0
.ANSWER
Check here if \<b\>Actual\<b\>\ \ \
Check here if \<b\>Estimate\<b\>\ \ \
Check here if \<b\>Do not know or cannot estimate\<b\>
.NEXT
.QUESTION=Q38, TYPE=VOID
.SUBTITLE="Alternative No.2 to Actual or Estimate Numbers"
In federal fiscal year (FFY) 2003 (October 1, 2002 though
September 30, 2003), how many children, involved with your state’s child welfare
agency, were in each of the following categories?
Please provide unduplicated head counts. While answers based on actual data are preferred,
estimates are acceptable. After each category's answer, please enter your
answers in the actual or estimated number box.
If you do not know or cannot estimate the number of children for any of the categories, please
leave that item blank.
\<STRONG\>(For each category listed below, please enter a 1 to 10-digit whole number only.)\</STRONG\>
.ANSWER
\
.NEXT
.QUESTION=Q38A1, TYPE=VOID
=0a. Total children (ICWA and non-ICWA) in foster care for at least part of the year.
.ANSWER
\
.NEXT
.QUESTION= Q38A2, TYPE=NUMBER
+0\ \ \ \ \ \ \<b\>Actual Number:\<b\>
.ANSWER=10
.NEXT
.QUESTION= Q38A3, TYPE=NUMBER
+0\ \ \ \ \ \ \<b\>Estimated Number:\<b\>
.ANSWER=10
.NEXT
.QUESTION=Q38B1, TYPE=VOID
+0b. Total children (ICWA and non-ICWA) who entered foster care during the year \<br\>(a subset of question a. above).
.ANSWER
\
.NEXT
.QUESTION= Q38B2, TYPE=NUMBER
+0\ \ \ \ \ \ \<b\>Actual Number:\<b\>
.ANSWER=10
.NEXT
.QUESTION= Q38B3, TYPE=NUMBER
+0\ \ \ \ \ \ \<b\>Estimated Number:\<b\>
.ANSWER=10
.NEXT
.QUESTION=Q38C1, TYPE=VOID
+0c. American Indian children in foster care for at least part of the year.
.ANSWER
\
.NEXT
.QUESTION= Q38C2, TYPE=NUMBER
+0\ \ \ \ \ \ \<b\>Actual Number:\<b\>
.ANSWER=10
.NEXT
.QUESTION= Q38C3, TYPE=NUMBER
+0\ \ \ \ \ \ \<b\>Estimated Number:\<b\>
.ANSWER=10
.NEXT
.QUESTION=Q39, TYPE=STRING
.SUBTITLE=">Example of TYPE=STRING with 80 chars of space"
If you have any comments on the survey not covered,
Click in the box below and type them in.
You will have 80 characters of space. Continue passed the end of
the box and your text will scroll until the 80th character is reached.
.ANSWER=80
.NEXT
.QUESTION=Q40, TYPE=STRING
.SUBTITLE="Example of TYPE=STRING with 50 chars of space"
If you have any comments on the survey not covered,
Click in the box below and type them in.
You will have only 50 characters of space.
.ANSWER=50
.NEXT
.QUESTION=Q41, TYPE=STRING
.SUBTITLE="Example of string with width of 256 chars"
If you have any comments on the survey not covered,
Click in the box below and type them in. You will have
256 characters of space regardless of the text box size.
Continue typing past the end of the box and your text will
scroll.
Note: you can change string width to any length provided that
you also adjust the .CARD= command under global commands to
equal some number greater than your largest string.
.ANSWER=256
.NEXT
.QUESTION=Q42, TYPE=openend
.SUBTITLE=">Example of TYPE=openend with .ANSWER=40"
If you have any comments on the survey not covered,
Click in the box below and type them in.
You will have 40 blank lines to start with. If you need more, just
continue typing and the text will scroll until you are finished.
Whatever number you put next to ".ANSWER=" will provide
you with a text box with that many blank lines.
.ANSWER=40
.NEXT
.QUESTION=Q43, TYPE=openend
.SUBTITLE="Example of TYPE=openend with default size box"
If you have any comments on the survey not covered,
Click in the box below and type them in.
You will have 7 blank lines to start with. If you need more, just
continue typing and the text will scroll until you are finished.
The default box size is 7 blank lines (.ANSWER without a number).
.ANSWER
.NEXT
.QUESTION=FINISH, TYPE=MULT
.SUBTITLE=">When The Survey Is Complete"
\<i\>\<B\>When you have completed this survey, please check the
"Completed" box below.\</B\>
\</i\> Clicking "Completed" is equivalent to "mailing" your
survey -- it lets us know that you are finished, and that you want us to use your
answers. It also lets us know not to send
you any follow-up messages reminding you to complete your survey.
.ANSWER
Completed
Not completed
.NEXT
.QUESTION=BYE, TYPE=VOID
.SUBTITLE="Thank You"
#\<B\>Thank you for your participation.\</B\>
Click on the \<b\>Exit\</b\> button below to exit the survey. Then close
the Thank You window that opens. Next click on the small "X"
in the upper right hand corner of your screen to return to your desktop.
.ANSWER
\
.NEXT
