ClassQue Advanced User's Guide
This is a guide to some of the more advanced features of ClassQue.
These features are illustrated using the ClassQue Simulator.
This simulator is a single program that shows t teacher window and a
class of eight students, three of whom have signed in.
You can start the simulator from the included calssquesimulation.jar
file or from the web by accessing the following web page:
If all goes well, starting the simulator this will bring up four windows,
a teacher and three students.
Response Display Formats
In the main teacher (or assistant) window, the menu Display -> Responses
has three options: Summary, By Name, and By Answer.
Figure 1 shows the results for the three types of response display
for Choice, Checkbox and Integer queries.
Figure 1: The three types of display for Choice, Checkbox, and Integer queries.
|Display Response Type|
|Query Type||Summary||By Name||By Answer|
The Summary Display
- Each answer is listed with the number of students
that gave that answer.
- For Choice and Checkbox queries,
all possible answers are shown.
- For Integer queries, only those values that at least
one student has given are shown.
The By Name Display
- Each student that answered the query is shown along with the answer given.
- For Checkbox queries, multiple answer can be chosen by a
student and all chosen answer are listed.
- If the seating panel is hidden
(Display -> Queries and Shares -> Queries Only),
the student names are replaced by numbers to anonymize the answers.
The number represents the order in which the answers were submitted.
This display is ideal for showing to the class.
The By Answer Display
- Results are listed by answer.
- For Choice queries,
the possible answers are the choices given and are numbered
in the order they are listed, the first being answer-1, the second being
This is followed by the number of students who have given that answer.
Under this is the text of the answer.
Only answers actually given by students are shown.
- For Checkbox queries, an answer is a subset of the
The first set actually chosen by a student is labeled answer-1, the second
is labeled answer-2, etc.
Since boxes can be checked or unchecked, many
possible sets are temporary, but are still given answer numbers.
Only those sets that correspond to current student answers are shown.
- For Integer queries, the display is the same as for
the Summary display.
Except for Choice and Checkbox summaries,
the student name or the answer is displayed as a link.
Click on that link will turn on or off the display of reviews of that answer.
For freeform and code types of queries,
these all do the same thing.
A list of students is given, each with that student's answer, similar to
the Name response type below.
Once a student gives an answer to a query (referred to as a response),
that response may be reviewed by one
or more teachers, assistants, or other students.
In all but the Summary display for Choice and Checkbox,
the reviews for a given
response can be displayed by clicking on the name or answer link.
This toggles the display of the reviews for that response.
Alternatively, the all reviews can be displayed in these modes by using:
Display -> Review -> Show Reviews
and turned off with
Display -> Review -> Hide Reviews
Reviews are displayed with the same formatting they were entered in.
Lines too long for the window in which they are displayed will be truncated.
You can force these reviews to wrap using
Display -> Review -> Wrap Reviews
or turn off the wrapping of reviews with
Display -> Review -> No Wrap Reviews
A teacher or assistant can review a response in several ways.
When responses to a query are being shown (except for Summary display
for Choice and Checkbox) an additional Review link
can be shown with each response.
The Review link is turned on with
Display -> Review -> Show Review Link
and turned off with
Display -> Review -> Hide Review Link
Clicking on the Review link will bring up a review window for that
A review window shows the question and answer being reviewed.
Type your review in the box labeled Comment.
When done, push the Send button.
You can show quick review links with
Display -> Review -> Show Correction Link
This will show two additional links in the response window labeled
Correct and Incorrect.
Clicking on one of these creates a corresponding one-word review.
For Choice, Checkbox, and Integer queries,
a review is associated with an answer, not with a student.
When a review is generated for one of these, the review is attached to
the responses of all students that gave that answer.
A teacher can allow students to see their reviews with
Student Options -> Review -> Allow See
This causes a See Reviews button to appear on the student's main
Pushing this button brings up a window that shows all of the reviews of
the student's current answer.
The window should refresh automatically when new reviews are generated,
or the student can push the Refresh button to get all current reviews.
A teacher can allow students to generate reviews for other student's answers
Student Options -> Review -> Allow Create
This causes a Create Review button to be displayed.
Pushing this button brings up a window that allows students to request
to review answers of other students to the current query.
Reviews are anonymous from the student's point of view.
Students do not see whose answer they are reviewing and cannot see
which students wrote reviews for their answers.
Reviews generated by the teacher or assistant are marked accordingly
so student and distinguish these from student reviews.
A share consists of a common area in which a group of students
can enter text, along with a chat area.
- A share can have any number of members.
- The members can be students or teachers.
- A share has an owner, usually the creator of the share.
- The owner (or a teacher) can write to the share at any time.
- Others must request write permission.
Figure 2 shows a share window.
Figure 2: A student share window.
Student Created Shares
A teacher can allow students to create shares using
Student Options -> Share -> Allow Create
This gives the students a Create Share button.
When a share is created, it is given a name at the time of creation.
Each share must have a unique owner-name combination.
Students need to be invited before they can join a share.
The owner of the share (or a teacher) may invite others to join the share.
Students can invite users to join the share using the Invite
menu option of the share.
This brings up a list of checkboxes, one for each student.
After students have been invited they can join the share using the
Join Share button on their main window.
This button appears if a teacher has done:
Student Options -> Share -> Allow Join
The Join Share button brings up a list of shares that the student has
been invited to.
Each share is references by the share owner and the share name.
The student owner of a share can remove student users or destroy the share.
A teacher can join any share (without invitation) using:
Windows -> Share -> Join Share
This will bring up a list of all shares that the teacher does not currently
A teacher share window is similar to the student window except that it
has an Options menu item instead of Invite and Remove.
The options are:
- Remove Frame:
The teacher's window for this share is destroyed and the
teacher is no longer a member of this share. The teacher can rejoin the
share at a later time.
- Remove Users:
Shows a list of current users of this share and allows the
teacher to selectively remove some of them.
- Remove All Users:
Removes all student users from the share, including the owner.
- Change Owner:
Allows the teacher to select a different owner from the
current users of this share.
- Invite Users:
Shows a list of students who are not currently users or
invited, and allows the teacher to invite them.
- Add Users:
Similar to invite, but forces these students to join the share.
- Change Title:
Change the title of the share.
The owner or a teacher can write in the main share window at any time.
All users see the same contents of this window as changes are made.
The share frame shows the owner and the name of the share below the menu.
Below this is the current writer of the share.
Only one user can write at a time.
A student user who is not the owner, must push the Request Write
menu item before writing.
This changes the menu item to End Write which the student can select
when done writing.
At any time the owner (or a teacher) can begin writing and lock out other users
until they request write again.
At any time a student user can push the Submit button to make a
permanent copy of the current contents of the share window in the log file.
A teacher user has a similar button labeled Log.
Shares have a chat feature.
Use the Show Chat menu item to show a chat window below the main window.
On the teacher share, the chat window replaces the share window.
The chat window has two parts, one for entering text, and one for showing
a history of all text entered.
After typing in the chat window, push the Send button to send the
contents to all users of the share.
Each entry is labeled with the name of the user that entered the text.
When the chat area is show, the share frame has three parts: the main share
window, the chat entry area, and the chat history area.
You can change the relative size of these by dragging the boundaries with the
Teacher Created Shares
A teacher can create a share using
Windows -> Share -> Create New Share
This creates a share with the teacher as the owner.
The teacher can then invite or add users to the share.
The teacher can use
Windows -> Share -> Combine Shares
to combine all of the shares that the teacher belongs to into a single
This frame has two additional menu items: Join and Layout.
The Join menu item lists all of the shares that the teacher does not
belong to and allows the teacher to join these and add them to the combined
The Layout menu item allows for selecting the number of columns of
The Group Manager
The group manager allows a teacher to divide the class in to groups, each
group having its own share.
Figure 3 shows a group manager frame created with
Windows -> Share -> Group Manager
The right side of the frame shows the groups.
Each group has a group number (starting with group 1), a size, and a name.
The group name is just the Group Base Name followed by the group number.
Below the list of groups are two additional entries, called unassigned
and group leaders.
The left side of the frame shows a list of student whoa re currently signed in.
Each is preceded by the number of the group that student has been assigned to.
If you click on one of the group names, that group name is shown in red
and the members of the group are highlighted in the student list.
Members are shown in red with the owner in green.
If you click on unassigned, the unassigned students are shown in red.
Clicking on group leaders shows the group leaders in green.
Figure 3: Two versions of the group manage window, one using distribute by size and the other using distribute by number.
Two methods are provided for automatically dividing up the class into groups
Choose one with the Distribute by menu item.
Once groups are created (either by using Distribute by Size or by
setting the number of groups), the teacher can move students around in the
You can change the group that a student has been assigned.
CLick on the group in``name in the Group List.
Will show that name in red.
Current members of the group are shown in red or green.
The green member is the group leader.
Click on another student to add it to this group.
- Distribute by size:
The teacher selects preferred, minimum, and maximum group sizes and pushes
the Distribute by Size button.
This randomly divides the students into groups.
Depending on the parameters, some students may not be able to be put into a
group without violating the size requirements set.
- Distribute by Number:
The teacher first sets the number of groups and then pushes the
Distribute by Number button.
This randomly assigns the students into this number of groups as evenly as
Click on unassigned in the Group List
and the unassigned students will appear in red.
Click on another student to remove it from its current group.
Click on group leaders and the group leaders will appear in green.
Click on any student who is in a group and that student becomes the current
leader of his/her group.
There are two Actions available from the menu.
Remove Students removes all students from the groups.
Create Sjares creates shares from the current groups.
The students.txt configuration file
The teacher uses the student.txt configuration file to describe the
students in the class.
The first line of the file contains the name of the course.
Additional lines describe the students, one per line.
A student line starts with an optional seat number and blank
followed by the last name of the student, a comma, and the rest of the name
of the student.
The name can be followed by an optional colon and a sequence of keyword-value
pairs in the form keyword=value.
If the value contains blanks, the entire value string should be
enclosed in double quotes.
The program calculates the following information from the student line,
using defaults when no explicit value is given.
The following table shows the values calculated and the keyword to
override the default calculation method.
|Value||Rule for calculating default||Keyword|
The string after the optional seat number
and before the first comma.|
Leading and trailing blanks are removed, but not internal blanks.
The string after the last name and until the next blank with leading
and trailing blanks removed.
The string after the first name until the end of the line or a colon.|
Leading and trailing blanks are removed, but not internal blanks.
The first letter of the first name followed by the last name with blanks
up to a maximum of 8 characters, converted to lower case.
The last name followed by an underscore, followed by the first name,|
followed by the extension .JPG with all blanks removed.
The login name followed by "@" and the default email domain from the
report configuration file.|
Additonal Windows Menu Options
Student List Window
Windows -> Student List
to display a window containing a list of students.
The list is generated from the teacher's students.txt and from the
students who have signed in.
Six different types of lists are controlled by the Type menu option.
Most of these can be sorted in different ways using the Sort menu
option. Save Report can save a report in a file. The report inclused
all of the report types.
In the simulator, the Create Students allows you to create
The Student List lists the students with the ones signed in first.
It allows you to remove students who are logged in. In the simulator you
can also sign in (add) a student.
The Students Signed In lists shows only the students signed in.
It shows their first name, last name, login name, assigned seat adn actual
seat. Similarly, the Students Not Signed In lists those students who
are not currently signed in.
The Students In Correct Seats and Students In Incorrect Seats
show the corresponding lists. The Students Not In List shows those
students who have signed in but do not appear in the treacher list.
Windows -> Pictures
to display pictures of the students in the class.
Students who are currently connected will have their names displayed
with a yellow background. Pictures must be stored in the
pictures subdirectory of the teacher's directory, the one from
which the teacher program is run. Pictures can be in GIF, JPG, or PNG
format, but the default picture file name is generated from the student
name with .JPG appended. If you use a different extension on the
picture filename, or use a different naming convention, then the name of
each student picture file must be included in the corrsponding line of the
students.txt configuratiobn file.
Windows -> Messages
to display the Send Message To Students frame.
Messages can be sent to individual students or groups of students. The message
appears at the top of the student's window and will stay there until acknowledged.
Messages are of two types, those which just need to be acknowledged, and
those that require a response.
The left window of Figure 4 shows the Send Message To Students frame
in its default configuration. Seats with students who have signed in
are shown in yellow.
Clicking on one of these changes it to blue,
selecting that stdudent to receive the message. Select any combination
of students, enter the message, and push Send. The selected blue seats will
change to pink. When a studet responds, the color changes to green.
The right window of Figure 4 shows a message that has been sent to
students in seats 1 and 26. The student at seat 1 has responded,
but the on in seat 26 has not.
student only need to acknowledge having recieved the message.
By clicking the Ack button at the bottom of the frame, it will
change to Reply. This requires students to send a reply back.
If the message requires a reply, clicking on a green seat will show the
Figure 4: Two versions of the Send Message To Students frame, one by seat number and the other by name.
The window on the right of Figure 4
shows the result of clicking the By Seat button, which is changed
to By Name. Now students to receive the message can be chosen
by clicking on their name under click to add. They can be removed
by clicking on their name onder click to remove. You are allowed
to choose students who have not yet logged in. In this case, messages will
be held and delivered to them when they log in. Once the message has been
sent, the state of the message is displayed next to the student name.
The possible states are pending for students who have not yet signed
in, sent for messages that have been sent but not acknowledged,
and replied for those that have sent a reply. Clicking on the
name of a student who has replied shows the reply that was sent.
The right windowof Figure 4 show a reply-type message has been sent
to three students, on of whom has replied and one has not yet logged in.
Figure 5 show student windows corresponding to a message that requires only
an acknowledgement (on the left) and one that require a reply (on the right).
Figure 5: Two versions of the student window after a message has been
sent. The first message only requires an acknowledgement. The second requires a reply.
This pops up a teacher's review window, allowing a teacher to enter reviews.
This feature lets you see which students have password set and allows
you to see or clear the passwords. Passwords are usualy only used when
student log in through a wbe interface.
This option promts for a file name.
The contents of the selected file is included in some of the
reports that can be sent to the students.
This options shows all of the ClassQue frames and allows you to pin one
fram to another so that moving the parent causes the child to be moved along
The brings up a help request list window as shown in the figure.
If the Student Option called Allow Help is set, students
get a Request Help button. When they push this button, they appear
in the help request list. After help has been given the teacher can remove
the student from the list. If more than one teacher is active, each teacher
see the same list. Pushing the Set Pending button for a student
changes it to remove pending and indicatates that the student is
receiving help. A change in one teacher's Help Request List
is reflected in the corresponding list for other teachers.
This brings up a window that shows all queries, similar to the
All Queries window of the Query Creator.
This has 2 options and is only available from the simulator.
The options are Resume and Resume from server.
The first will prompt for a state log generated by the server and will
resume the program based on that log. You must move a state log file from
the server to the local machine to use this option.
The Resume frmo Server option requires a
Classque Master Server to have been set up. It queries the
server and allows the user to choose one the the previous classes to resume.
A password is required. The master server password gives you access to all
logs. A teacher password gives you access to those courses that use
that teacher password. Setup and use of the master server is described
This has two options Default Reports and Todays's Report.
Each prompts the user for a file and that file will be used as the default
or temporary report configuration file for that class. A temporary
report configuration file is use once and discarded.
This has three options: Server Terminate Info,
Keep Server Alive 10 minutes, and
Keep Server Alive 1 hour. The first shows when the
server is sechedule to terminate and the others allow you to
adjust this time.
This is available only from the simulator and can create a new teacher or
a new assistant.
Display Menu Options
This displays a toolbar in the teacher stats window that allows quick
access to some of the features controlled by menus and some additional
features not included in the menus. Each tollbar item has a tooltip
to help understand what it does. Some toolbar items turn a feature
on or off, in which case they have a red border when the feature is on.
The toolbar item (in order from left to right) are:
- Increase Font Size
- Decrease Font Size
- Normal Font Size
- Show Reviews - on or off
- Show Review Link - on or off
- Show Grade Link - on or off
- Show Correct Link - on or off
- Shoe Evaluation Link - on or off
- Set Response Summary Mode
- Set Response By Student Mode
- Set Response by Answer Mode
- Force Update
- Set Start Discussion
- Stop or Resume Answers
- Set Anonymous mode
- Toggle Show Seating Chart
- Repack frame
- Dock or Undock the Response Window
- Remove the Toolbar
Update Now refreshes the response list.
The other option lets you Set Manual Update if
Auto Update is active, or Set Auto Update if manual update is active.
Auto Update behavies differently for ardinary queries and surveys.
For ordinary queries, updates occur only when students send an answer.
For queries, updates occur every 5 seconds.
Queries and Shares
Chooses between showing queries or shares.
There are two options of queries, is to display the queries only or to also
display the seating chart.
When the seating chart is hidden, the names of the students in the responses
There are two options for shares, either showing only submitted shares
or showing the current state of each share.
This chooses between the three types of response displays:
Summary, By Student, or By Answer.
Allow you to show a Wrap button, a Size button, or
an Update button.
The Wrap button allows you to turn on or off the wrapping of reviews.
The Size button allows you to easily change the size of the font used
in the response display.
The Update button allows you to froce an update.
This allows you to turn on or off five features of the response display:
showing reviews, wrapping reviews, showing the review link, hiding review
links for reviewed responses, and showing the correction links.
Hiding review links for reviewed responses allows the review links
(including correction links)
to be hidden once a teacher has reviewed the response.
This feature is useful if you want to quickly correct all responses.
This has three options: Normal Size, Larger Size,
and Smaller Size.
They allow for change the size of the font used in the response display.
There are three sets of student options.
The Share options, the Review options,
and the Help options have already been discussed.
There are three options under the Query menu.
The first is chooses between Browse All and
The default is Browse Current which allows the teacher to look at
the responses for the current query, or for the current survey is a survey
The alternative is Browse All, which allows you to look at responses
from all past queries.
The next option allows you to display or hide an Export link which can
appear in the response list
(except the summary mode for choices and checkboxes).
Clicking on the Export link brings up a window containing the response
of that student.
All formatting is removed so that the contents of the window can be moved
elsewhere using the clipboard.
This is the preferred method of moving code into a program.
The last option is Start Discussion.
This is used to indicate the time at which the teacher starts discussing
the current question.
The logging of the student answers takes this into account and treats
students answers that were generated after this time in a different manner
as student notes rather than as actual responses.