A survey has three integral elements. Every
survey must have:
A
survey name
At
least one group
At
least one question
Optional elements to a survey
include:
A
list of answers to applicable questions
Modifiable
labels
Conditions
that determine whether a question should or should not be displayed
The Survey Name is the
name of the survey, and the place where various options are set that relate
to the survey as a whole. Options such as the “Definition” message, the “description”
of the survey, contact information for the survey administrator, what “format”
the survey will appear in, and so forth.
Each survey divides the
questions into groups.
This allows for logical organisation of
the survey into groupings of similar questions. A group has a title
and an optional description. You must have at least one group in each
survey, even if you don’t wish to divide the survey into
multiple groups.
Questions
are the core of
your survey and fit into a group, as explained above. There are no
technical limits to the number of questions you can have in your
survey, or the number of questions per group. Questions include the
actual question itself, as well as settings that determine what type
of answer you expect. You can also include a short
“help”
explanation for each question and determine whether the question is
mandatory (ie: must be answered before continuing).
Question
Types
There are two kind of questions:
1. questions that allow ASSESSMENTS
2. questions that DON'T allow
assessment:
ASSESSMENT
Using these kind of questions authors can benefit the assessment function of
the tool.
List Allows you to add a series of possible answers / options from which
the survey participant may choose only 1 Eg: Where do you sleep?
Bed
Couch
Floor
List
with Comment Allows you to add a series of possible answers / options from which
the survey participant may choose only one. The question includes an area
to explain the choice. Eg: Where do you sleep? Please explain why you
sleep there.
Bed
Couch
Floor
Array
(5 Point Choice) Allows you to present your participant with a list of possible
answers/options which they may then rank between 1 and 5 Eg: To what extent do you agree with the following
comments (1=Strongly Agree, 5=Strongly Disagree)
- Elephants look better with large ears
1 2 3 4 5
- The Southern Hemisphere is groovy
1 2 3 4 5
- My ears hurt when it is cold
1 2 3 4 5
Array
(10 Point Choice) The same as above, only with 10 instead of 5
NO ASSESSMENT Using these kind
of questions authors can only gather users' choices and can't benefit the assessment
function of the tool.
5
Point Choice: Allow a single rating of between 1 and 5 for the question at hand. Eg: How much do you like fried eggs (1 for none,
5 for lots)
Date: Enter a date Eg: What is your birthdate
Gender: Offers participants a pre-defined gender option: Eg: Are you male or female?
Multiple
Options Allows you to add a series of possible answers/options from which
the survey participant may choose any that apply (ie: none, one or more). Eg: Where do you like to sleep (choose any that
apply)
Bed
Couch
Floor
Multiple
Options with Comment Allows you to add a series of possible answers/options from which
the survey participant may choose any that apply, as well as add a comment
explaining each choice! Eg: Where do you like to sleep (choose any that
apply). Please explain each one you choose.
Bed
Couch
Floor
Multiple
Short Text Allows you to ask for multiple short text
answers to match a series of pre-defined titles.
Eg: What are your three favourite books?
Book 1
Book 2
Book 3
Numerical
Input Requires an answer that contains only numbers. These questions
will only accept the following characters: 1 2 3 4 5 6 7 8 9 0 , . Eg: What is your age in years?
Ranking Allows you to present your participants with a list of possible
answers/options, which they may then rank in order of preference Eg: Please rank the following movies in order of
your preference:
Short
Free Text Allows a short answer (100 Characters Maximum)
Long
Free Text Allows a long text answer
Yes/No Presents the participant with a simple Yes / No option
Array
(Yes/No/Uncertain) Allows you to present your participant with a list of possible
answers/options against which they may respond “Yes”, “Uncertain” or “No” Eg: Do you agree with the following proposals:
- All staff should wear a pink uniform Yes
Uncertain No
- Coffee Breaks should be only 5 minutes
Yes Uncertain No
- My boss should be sacked
Yes Uncertain No
Array
(Increase/Same/Decrease) As above, only presenting the options Increase/Same/Decrease.
Array
(Flexible Labels) An array of flexible labels allows you to select from a pre-defined
label (see section 5) as your headings, and let your participants respond
to a series of possible answers/options using those headings. Eg: Please rate the following proposals:
- My left arm is longer than my right Preposterous
Unlikely Possibly Definitely
- The magnetism of the earth is changing
Preposterous Unlikely Possibly Definitely
- My socks stay up all day Preposterous
Unlikely Possibly Definitely
Array
(Flexible Lables by Column) Basically the same as the Array (Flexible Labels) question, except
the answers and labelset are displayed in columns instead of rows. So, for
the same example as previously it would be laid out like: Eg: Please rate the following proposals:
Preposterous My left arm
is longer than my right The magnetism of the earth is
changing My socks stay up all day
Unlikely
My left arm is longer than my right The magnetism of the
earth is changing My socks stay up all day
Possible
My left arm is longer than my right The magnetism of the
earth is changing My socks stay up all day
Definitely
My left arm is longer than my right The magnetism of the
earth is changing My socks stay up all day
Boilerplate This is not really a question at all, but more of a place holder
that has the qualities of a question. No "answer" can be collected to a
boilerplate question, however the question text will display as in other
questions. You can use this in conjunction with the conditions tool to make
comments or statements that display based on answers to previous questions.
Creating
Surveys
Creating
a NEW SURVEY
To create a new survey click on the
button
at the right hand side of the administration button bar.
The "Create New Survey" screen will
appear below. Following is a description of each field:
Title:
This is the brief descriptive name of the survey (ie: "Teamwork", or
"Communication"). This title will be displayed on every page of the
public survey script.
Description:
This allows you to enter a description of the survey. (ie: "A survey
to collect your ideas on the next round of enterprise bargaining" or
"A survey to find out the popularity of chocolate ice cream"). You can
use html markup in this section.
Definition:
This allows you to enter a text that will display when a participant
first logs into your public survey screen. You can use html markup in
this section.
Administrator:
This is the name of the contact person who administrates the survey.
It will be included in any emails sent out inviting participants to
respond.
Admin
Email: This is the email address
of the administrator (as above) and is used as the 'reply to:' address
on any emails sent out.
Fax
To: This field is used to give a fax number on the "printable
survey" - ie: when you want to send someone a hardcopy because they
cannot use the online survey.
Format:
Choose from "One at a time", "Group at a time" or "All in one".
Question
by question Public survey will display one question per
page.
Group
by group Public survey will display all questions in a
group per page.
Group at a time surveys still have a separate "welcome" page and
"submit" page, like "One at a time" surveys.
All
in one Public survey will display all questions in one
single page
All in one surveys do not have a "welcome" page or "submit" page
- the welcome message and submit button all appear on the same page.
Use
Cookies?: If you choose "Use Cookies" and your survey does
not use a tokens table to control participant access, then a cookie
will be saved to the client computer of each survey participant once
they have submitted a survey. This cookie will stop the same computer
from accessing the survey more than once. There are inherent limitations
in the 'security' strenght of such a system, but on a general basis
it allows public surveys to retain some control over multiple entries.
The default value is "no".
Allow Saves?: If you
set this option to "Yes" then users can save unsubmitted surveys and return
to them later.
Show [<< Prev] button:
This option defaults to yes, however if you set it to "No" then users
will not have the option of moving to a previous page while completing
the survey.
Notification: Options
to allow the administrator to be emailed when each individual survey response
is saved. You can choose from:
No
email notification - self explanatory
Basic
email notification - an email is sent informing the administrator
that a survey response has been saved
Send
email notification with response codes - sends the full
answers to the survey after saving
Anonymous:
This allows you to determine whether responses to your survey are matched
up with information from your surveys tokens table, or kept 'anonymous'.
The default is yes. If you choose "No" for anonymous, you must also
have a tokens table for your survey when you activate it.
Invitation Email Subject:
The subject line for the invitation email that gets sent out when tokens
are used with your survey.
Invitation Email:
This is the text for the invitation email that gets sent out when tokens
are used with your survey. This is initially filled by the default invitation
message (from the language files) but you can modify it to suit yourself.
Of course if you don't plan to use tokens on your survey, whatever is
in this field is irrelevent.
You can use the following "form" fields to insert individualised information
in each email:
{FIRSTNAME}
- gets replaced with the token table's "firstname" value
{LASTNAME}
- gets replaced with the token table's "lastname" value
{SURVEYNAME}
- gets replaced with your surveys name
{SURVEYDESCRIPTION}
- gets replaced with your surveys description
{ATTRIBUTE_1}
- gets replaced with the token table's "attribute_1" value
{ATTRIBUTE_2}
- gets replaced with the token table's "attribute_2" value
{SURVEYURL} -
gets replaced with the fully qualified URL to this particular survey
Note
that these "form fields" apply to the following email fields.
Email Reminder Subject:
The subject line for the reminder email that gets sent out from the tokens
tool
Email Reminder: This
is the text for the reminder email that gets sent out when tokens are
used with your survey. See "invitation email" for specific details on
how this field is used.
Confirmation Email Subject:
When tokens are used, this is the subject line of the email that gets
automatically sent to participants after completion of the survey
Confirmation Email: This
is the text of the email that gets sent to users after completion of the
survey.
Allow Public Registration:
If you use tokens to control access to your survey, the only people who
can use the survey are those who have an entry and a unique token from
the token table. If you would like to use the tokens but allow public
registration, use this field. Setting "Yes" to this will allow a visitor
to your Survey URL to register their name and email address. The script
will create a new entry in your tokens table for this person, then send
them an invitation email. The script will ensure that only one person
per email address can complete your survey.
Public Registration Email Subject:
This is the subject line for the invitation email sent to members of the
public who register for a survey.
Public Registration Email:
This is the text for the invitation email sent to members of the public
who register for a survey.
Token attribute names:
The tokens table has two "spare" fields for storing additional information
about users. When using the public registration system, you can use these
two fields to give your attribute fields a nice name for the public. So,
if you are using "attribute_1" to store the participants department name,
you can label it appropriately.
Datestamp?:
This field allows you to determine whether the survey will datestamp all
responses. If you choose "Yes", then when a response is submitted, a field
will be included in that response indicating the time and date that the
response was made.
Language: A list
of the possible language files will be shown next to this option. Changing
the language setting here will change the default language used when participants
use the public survey scripts (but will not change the administration
language).
Expires:
This is the last date on which the public survey script will let people
participate. (Read this twice... if you set it for the 31 of December,
then people will no longer be able to use the survey script on the 1st
of January).
End URL: This URL
will be presented as a link at the end of the survey, and allows you to
direct your participants back to your home page (or, in fact, anywhere).
URL Descrip: The
description for the link using the End URL.
Automatically Load URL when survey
complete: If you choose "Yes" for this option, the script will
automatically load the URL as set in "End URL" after completion of the
survey, instead of displaying the usual "Completed" page. NOTE: Do not use this if you are using assessments.
Importing
a Survey If you have previously exported a survey, you can import it from
the "New Survey" screen. Click on the browse button to choose the sql file,
and then click on the button. The import process
reads a 'sql' file created by the tool and 'intelligently' renumbers the
survey, group, question, answer and condition id's so that they all match
each other. See section on Exporting a Survey
for more information.
(B)
Creating a NEW GROUP
Before you can add
any questions to your survey you must create a group. If
you will only have one group in your survey, then how you name this group
is irrelevant (except of course for show). If, however, you are going to
have multiple groups, you should note that the survey questions will be
displayed by group, and the groups will be displayed in alphabetical
order. So, if you really need the groups to be displayed in
a particular order, consider naming them with an alphabetic start such as
"A) Questions about you" and "B) Questions about health".
Doing it this way will ensure that your groups are displayed in order. If,
for example, you entered the group names as "Questions about you"
and "Questions about health", the "Questions about health"
group will display first, because alphabetically it comes first. PHPSurveyor
is designed to do this deliberately, because it allows you to add extra
groups in later, and arrange their positioning by adjusting the title. For
example, you could squeeze an extra group between the two by naming it "A1)
Questions about your history".
You can create as many groups as you like.
Groups can also include a "description".
This field allows you to publish an explanatory note for any set of questions.
If you add a description, then when the public are using the public survey
system, they will be presented with that explanation before commencing any
of the questions in that group. If you do not include any text here, then
public participants will simply move on to the first question in the group
with no stop.
Create a new group by clicking on the
icon in the Survey Button Bar.
(C)
Adding a QUESTION
Once you have created
your groups, you can start adding questions within each
group. Create a new question by clicking on the add icon ()
on the right hand side of the "Group" menu bar.
When adding a question, you will be asked for a "Question Code", the "Question",
"Help" and a "Question Type". All new questions are assigned to the Group
you were viewing when you clicked "Add Question", however you can change
the group the question belongs too at a later point.
Question
Code: Your ID, or number or code for the question. This
field is important, because the entry in this will determine the positioning
of the question in your survey. Again, numbering this "Q1", and following
questions "Q2" and "Q3" will ensure that they appear in the correct
order. Using this system allows you to add in extra questions as an
afterthought by giving them a code such as "Q1a". Try to be consistent
with your coding in this field. Planning makes this process a lot easier.
Question:
This is the actual question being asked. There is no real limit to the
length of the question here, however if you want to explain the question,
leave that for the next field.
Help:
This is an optional field. It is useful if a question needs some explanation,
or you want to explain how it should be answered. When you put text
in this field, a "Question Mark" icon appears on the survey entry screens,
and clicking on this allows the survey participant (or data entry person)
to read the help.
Question
Type: This determines the type of response the survey allows.
View the "Question Types" section
for a description of the various options available.
Validation: This feature is
available on all free text type questions ("Short Free Text", "Long
Free Text", "Date" or "Numerical"). You can use standard Perl Regex
expressions in this field to validate the responses to the question,
and if the responses don't validate against this expression, the user
will be prompted to try again before they can progress.
Perl Regex expressions must start and finish with a forward slash ("/").
Other?
Depending upon your chosen 'question type' this option may
appear. It allows you to specify that an "other" option be presented
in some of the list question types.
Mandatory? For
all question types, except the text ones, this setting allows you to
require users to answer the question, before they can move on to the
next question.
You
can create as many questions as you like.
When you have created a question that uses pre-determined answers (ie: dropdown
list) you can then add answers to that question.
(D)
Setting Conditions (Branching)
A question can be
set to display ONLY IF certain conditions are met. You can set these conditions
by clicking on the icon in the question button bar,
when viewing a question.
When you choose "Set Conditions"
a new window will appear allowing you to delete or create conditions for
the current question. An example is show below.
Condition
Designer
Only
show question 02-07b
IF
02-07:
Have workers or former workers.. (qid510)
Equals
Yes
(YES)
Copy
Conditions
Condition
Question
copy to
Add
Condition
Question
Answer
Equals
Existing
Conditions
The top part of the window shows any conditions
already set for this question, and the bottom part allows you to
create new conditions.
New Conditions To create a new condition, click on the question (left hand column)
that you wish to use for your condition. When you have chosen a question the
Answer section on the right hand side will display the possible answers for
that question. Choose the answer that you want to use, then click on the "Add
Condition" button. You can choose multiple answers in one go by using the CTRL
button and clicking on more than one answer in the right hand select list.
Multiple
Conditions You can set more than one
condition to apply for a
question. Conditions can be based on more than one previous question.
So, for example, you can set a question to display only if the answer
to Question 1 is "Y" and question 2 is "N". Or
only if the answer to Question 1 is "Y" or "No answer"
and the answer to question 2 is "N".
Copying
Conditions
to Later Questions It is not uncommon for a group of questions to have the same condition.
If you set a condition for one question, you can copy this condition to any
subsequent question from the conditions designer. Once a condition has been
set, the following screen will be displayed:
Copy
Conditions
Condition
Question
copy to
The select box on the left displays
the conditions already set on this question, and the select box on the right
shows all subsequent questions in the survey. Highlight all the conditions on
the left side that you wish to copy (using the CTRL key to select multiples)
and then highlight all the questions you wish to copy these conditions to on
the right hand side (using the CTRL key to select multiples). The click on the
"Copy Conditions" button to copy them across. It is usually best to leave this
until you have finished entering all your survey questions, and are satiisfied
with the question order.
Things to
watch out for If you set conditions on a question that, itself, has conditions, then
there may arise occasions where the survey behaves in ways you might not have
predicted. So if you are designing a complicated survey with large numbers of
conditions, make sure you test the survey for as many different combinations
of results as you can think of. In the above example, a question is displayed
'Do you like being male?' which has conditions set, and which will only display
if the answer to "what is your gender?" is "M". If you were to add a condition
to this question requiring a specific answer from the "Do you like being male?"
question, then this question will never display, because the question "Do you
like being male" will not be presented. If this seems confusing, don't worry
too much, because when you are designing your survey the logics of these conditions
will make themselves far more clear.
There are a few basic rules you should
keep in mind before setting conditions on a question.
Once a single
condition has been set for a question, that question WILL NOT DISPLAY
unless that condition is met.
Conditions can
only be set based on questions that appear BEFORE
the question on which the condition is
set.
Multiple conditions based on a single
earlier question are evaluated using boolean "OR" principles. Multiple
conditions based on multiple earlier questions are based on boolean "AND"
principles. This is important because it means you cannot (for example)
set a condition that a question will only display if either previous question
a is "Y" OR previous question b is "N".
You can modify conditions even after
a survey has been activated. This should be done with caution, as there
is no "consistency checking" applied here.
(E) Adding ANSWERS
Various question types require you to add a list of 'answers' from which the
survey participant chooses, or which are used as headings for responses. To
add answers to one of these question types click on the
icon in question button bar.
When adding an answer you will be asked for an "Answer Code", an "Answer" and
whether that answer is the "Default".
Answer
Code: This is the data that will usually be exported to your
spreadsheet when compiling results. You may choose whatever code you want
(5 character maximum). The code can only contain standard alpha-numeric
characters. Please
note that if you want to use assessment the system doesn't allow to assign
the same number for different answer code: Correct: 2 I cooperate with one or several colleagues on predictable previously
defined tasks. 1 I work with one or several colleagues on varying tasks. The tasks
are previously defined, though there is flexibility for own initiative.
I actively participate in complex team working relations. 0 We perform tasks that follow a given general structure, but there
is an extensive margin for variation. Uncorrect: 2 I cooperate with one or several colleagues on predictable previously
defined tasks. 0 I work with one or several colleagues on varying tasks. The tasks
are previously defined, though there is flexibility for own initiative.
I actively participate in complex team working relations. 0 We perform tasks that follow a given general structure, but there
is an extensive margin for variation.
Tip: if more than an answer is scored 0, you can assign a "00"
or "000" as a right code for a null value.
Answer:
The answer that will be displayed.
Sortorder:
You can use the "Up" and "Dn" buttons next to each answer to change
the position of that answer in the list.
Default:
One answer from all can be chosen as the default answer (ie: this one will
be chosen and entered into your survey results unless it is changed). Change
the Default field to "Y" if you want this answer to be the default answer.
If you don't choose any default answer the survey result will record nothing
if one of the answers is not specifically chosen.
(F)
Exporting a survey
The
button in
the survey button bar will dump all the groups, questions,
answers and conditions for your survey into a standard sql dump file. This dump
file can be used with the 'Import Survey' feature.
Testing
a Survey
You can test a survey at any
point while you are creating it, by choosing the
button in the 'Survey' section of the web page. This allows you to check how
the survey looks and feels, before you actually initialise it. When testing
a survey your responses will not be saved.
Assessments are rules which evaluate
the responses to the survey immediately after it is submitted, and can then
display text based on that.
As an example,
consider
the following. You have two questions in your survey, the first
question asks if the user smokes: "Do you smoke?". The question has 3
possible answers, "Yes more than 10 per day" with an answer code of
"10", "Yes, but less than 10 per day" with an answer code of "5" and
"No, I don't smoke at all" with an answer code of "0".
The second question
"Do
you exercise?" has three possible answers; "Yes, I exercise for at
least half an hour three times a week" with a value of "0", "Yes, I
exercise every now and then" with a value of "5" and "No, I don't ever
do any exercise" with a value of "10".
If we were to add the
totals of the values for each possible answer at the end of the survey,
we'd have a good indication of the general health of the respondent.
Someone who smokes and doesn't ever do any exercise will have scored 10
in each of their answers, giving a sum of 20 when we add the values
together. Someone who doesn't smoke and exercises regularly will have
scored 0 in each of the answers with a total of 0 when we add the
values together.
The assessments tool
allows you to set some rules based on the summed values of the
questions in the survey, either for the Total survey, or for each Group
within the survey.
If we visit the
assessments tool from the survey administration toolbar, we can create
some assessments for this survey. From this screen you can view, edit
or delete existing assessments or create new assessments.
If
you create any assessments in this page, for the currently
selected survey, the assessment will be performed at the end of the
survey after submission
ID
SID
Scope
Group
Minimum
Maximum
Heading
Message
URL
Actions
11
35
T
94
20
20
You are very unhealthy
You are very
unhealthy.
You should stop smoking and start exercising
http://www.healthy.com/
Add
Scope
Group
Minimum
Maximum
Heading
Message
URL
In the "Add/Edit" box
you
can choose the following:
Scope:
The scope
of the assessment. Choose either "Total" which will create an
assessment based on the sum of all the answers in the entire survey, or
"Group" which will create an assessment based on the sum of all the
answers in a group (chosen in the next row) Group:
If the scope of this assessment is for the current
"Group", this is where you choose which group to assess. Minimum:
The minimum "sum" of answers to which this assessment
will apply Maximum:
The maximum "sum" of answers to which this assessment
will apply Heading:
The heading of the assessment which will display if
this assessment is shown Message:
The actual message for this assessment (it may
include html code) URL:
A URL link which will display with this asssessment.
You can create as many
assessments as you like, and you can create more than one assessment to
display for a given score.
It is important to note that if
you use assessments, you must ensure that you have not chosen to autoload the
URL at the end of the survey in the general survey setup, because the assessments
only show on the final "completed" page after submitting a survey.
Activating
a Survey
Once
you are
happy with the structure of your survey you can activate
it.
Activating a survey does a number of
things.
It creates a
separate MySQL table
to hold all survey responses, and gives each possible answer to the
survey a field in that table.
It allows people to enter data into
that table, and
gives you access to other features for the survey, including browse and
token facilities.
It
gives you access to the "tokens" feature. Once a survey is activated,
the "tokens" button will be available (see section on Tokens).
If your
survey is set to "not anonymous", a tokens table will be created
automatically.
Before
you
activate a survey you should note the
following points:
When the survey is initialised you can
change the text
for questions, answers, the survey etc, but not the type of question or
the type of answer.
You
cannot add new questions or delete questions. Nor can you add answers
to any of the array or multiple choice questions,
however you
can add answers to the basic list type questions.
Activate a
survey by clicking on the
button in the survey button bar.
Browsing
Survey Responses
Once a survey has
been activated, and survey responses have been submitted, you will
want to be able to view those responses, maybe edit some of them (or
possibly delete some), export them, get some information about the
responses received so far, and so on. All of this is done through the
"browse" function.
When
your survey is active, a 'Browse' button (
)will appear in
the Survey Information portion of the main admin screen. Clicking
this button will open the "Browse" screen. An example is
shown below.
Browse
Responses: CPSU EB2003
Survey
The main
screen
(Survey Summary) gives you just a quantity of responses to this
survey so far. The other options are described below:
Admin:
Return to the main admin screen for surveys
Survey
Summary: Just show the total responses so far (initial screen)
Browse
All: Display all the results to the survey (note: the browse shows
full descriptive question names, but only abbreviated answers. See section
below (editing and deleting responses).
Browse
last 50: Display the last 50 responses
to the survey, ordered from most recent to least recent.
When you are browsing responses, the first entry for each row (the "id"
number will be a hyperlinked number. Clicking on this hyperlink allows you
to veiw that specific response on an individual basis. From here you can
edit or delete a response. See section below (editing
and deleting responses).
Editing
and Deleting
Responses When viewing your reponses, you
will be able to view
a specific response by clicking on the id number. An example of
'browse' responses is shown below.
id
What
is your Employment
Type?
What
are your Hours
of Work?
What
is your Spread
of Hours?
What
is your Gender?
What
is your Classification?
What
is your Top
Priority for outcomes of the
next Enterprise Agreement? This might be something
new, an improvement to existing
conditions, or ongoing inclusion of a condition you value.
What
is your Top
Priority for outcomes of the
next Enterprise Agreement? This might be something
new, an improvement to existing
conditions, or ongoing inclusion of a condition you value. (comment)
Possibility of further tertiary
study and working that in with my current job.
Clicking
on the hyperlinked id number will present the 'view record' screen:
Viewing
Answer ID 1
id
1
What
is your Employment Type?
Full
Time [A]
What
are your Hours of Work?
76
Hours Per
Fortnight [A]
What
is your Spread of Hours?
9
to 5 [A]
What
is your Gender?
Female [F]
What
is your Classification?
Administrative
Officer [A]
Do
you manage staff
in your
current job?
No [N]
What
is your Region/Division?
Health Sector [H]
What
is your Top Priority
for
outcomes of the next Enterprise Agreement? This might be something
new, an improvement to existing
conditions, or ongoing inclusion of a condition you value.
Increased Salaries [I]
What
is your Top Priority
for
outcomes of the next Enterprise Agreement? This might be something
new, an improvement to existing
conditions, or ongoing inclusion of a condition you value.
[Comment]
Please pay us more money.
From this point you
can choose to "Edit" or "Delete" this response.
Deleting
the
responses is, of course, fairly self-explanatory - and as anyone who
regularly runs surveys would know, is not recommended, unless you've
got a pretty good reason (ie: a doubled up entry, or some
sufficiently serious reason as to why it should be deleted). Don't
click on this button thinking it will give you a second chance. If
you click "Delete", the entry will
be deleted with
no second guessing or second checks.
Editing
the response is also fairly
self-explanatory. It will take you to
a 'data-entry' screen with the responses provided, and allow you to
make and save any modifications. Again, in a survey you generally
don't want to make changes to the responses made by the participants
- but hey - it's your survey. Do what you want!
Tokens
On many occassions you will want to invite
a group of people to participate in your survey, keep track of who has completed
the survey, and ensure that each person can only participate once. Tokens
can be setup once a survey has been activated. The tokens feature allows you
to do the following:
Generate
a unique token number for each participant
Send an
email invitation to each person in your list, either
en-masse or individually
Send
a reminder email to each person in your list who has not yet responded,
either en-masse or individually
Track who
from your list has responded
Restrict
access against people who have not got a token, and those with a token who
have already voted.
Edit/change any details in your list
Once you enable tokens for a
survey, then the only people who can access the survey are those who
have been issued a token number. Access to the public script will
rely on the participant being able to provide their unique token id.
Tokens can be
matched to surveys that have been set up as "not-anonymous".
This is determined when creating a survey. If a survey is not
anonymous (or 'tracked') then the token list can be used to find the
particular response that an individual has made to the survey. If the
survey is anonymous, then no link is available between the tokens
table and the responses.
The following is a
brief rundown of the menu options in the tokens screen:
admin:
Returns to the main survey admin screen;
summary:
Displays just the brief summary of tokens in the table (no. of tokens, how
many have been sent an invite, how many have responded). Also provides access
to the 'Database Admin functions' (see below). This is
the default screen;
browse:
Displays the complete list of participants in the tokens table. From the
browse screen you can edit or delete individual entries in the token table
as well as perform a number of other useful functions (see browse section
below)
add:
Allows you to add an entry to the tokens table;
invite:
Sends bulk email invitations to all participants in the tokens table who
have not already been sent an invitation.
remind:
Sends bulk email reminders to all participants in the tokens table who have
not yet responded, but have been sent their first invitation.
tokenify:
A new word for the english language, specifically invented for this script.
Creates unique tokens for all individual entries in the tokens table that
do not yet have one.
Database
Admin While the summary
screen shows a brief
summary of tokens in the table, it also provides access to the
"Database Admin" features which include:
clear
invites: Sets all records that
an
invitation has been sent out to 'N'. Obviously shouldn't normally be
used.
clear
tokens: Clears all tokens.
Similarly
shouldn't normally be used.
droptokens:
Allows you to remove the tokens feature from your
script. Deletes the entire table and all records, and allows the survey
to be accessed by anybody who knows the URL.
Using
the browse screen The browse screen will show
you a list of
all entries in the tokens table, as well as giving you some 'action'
buttons that can perform specific tasks for that individual entry.The top
row of the table gives options for displaying a number of records,
and a starting point.
The second row of the table includes the
field name, and a green arrow that - if clicked - will refresh the
screen showing the tokens ordered by that field.
The last row of
the table lets you move backwards or forwards through your list
(based on the settings at the top).
Showing
records starting at
ID
First
Last
Email
Token
Invite?
Done?
attribute_1
attribute_2
Action
1
a
a
a@a.org
0829007266
Y
Y
2
b
b
b@b.org
1371896219
Y
3
c
c
c@c.org
R193857398
Y
Y
The "Action" column gives a list of
specific tasks that can be performed on that individual entry.
E:
Edit this entry
D:
Delete this entry
S:
Do the survey using this entries unique token
R:
Send a reminder to this individual entry (only available if invite has already
been sent)
I:
Send an invitation to this individual entry (only available if invite has
not already been sent)
V:
If the survey is a 'tracked' (ie: not anonymous) survey, the "V" button
will appear, allowing you to view the response from this individual entry.
Allowing
Public Registration You may want to open your survey to the public, but utilise the sort
of respondent control available when using tokens. If you initialise your tokens
table, and have chosen to Allow Public Registration in the main survey setup,
people who visit your survey's URL without a token, will be given the opportunity
to register. If they provide an email address that is not already in the current
survey's tokens table, an entry in the tokens table will be created, and they
will be emailed an invitation containing their unique Token. All tokens provided
to "registering" visitors will begin with the letter "R".
License
This program is opensource software under
the terms of the GNU General Public License.
button
at the right hand side of the administration button bar.
icon in the question button bar,
when viewing a question.
IF 
icon in question button bar.
When adding an answer you will be asked for an "Answer Code", an "Answer" and
whether that answer is the "Default".
button 
button in the survey button bar.
ID