User Manual.doc by Ei7wPM6x

VIEWS: 0 PAGES: 29

									  mokik
User Manual
                                Table of Contents
Section A: PC-Based Application................................................................................... 2
  Getting Started .......................................................................................................... 2
  A.1 Adding a New Course .......................................................................................... 3
  A.2 Deleting an Existing Course................................................................................ 5
  A.3 Opening the Course’s Main Screen ..................................................................... 6
  A.4 Sending a Question .............................................................................................. 8
  A.5 Receiving the Responses ...................................................................................... 9
  A.6 Saving the Scores ............................................................................................... 11
  A.7 Starting Automatic Attendance ........................................................................ 12
  A.8 Stopping Automatic Attendance ....................................................................... 13
  A.9 Manually Attending Students ........................................................................... 13
  A.10 Removing a Student from the Current Lecture .............................................. 15
  A.11 Adding New Students to a Course .................................................................. 16
  A.12 Editing Existing Student Information ............................................................ 18
  A.13 View and Modify Student Attendance Records............................................... 20
  A.14 Assigning a Mobile Device to a Student .......................................................... 21
  A.15 Changing the Settings of a Course .................................................................. 22
  A.16 Cleaning up and Exiting .................................................................................. 22
Section B: Mobile-Based Application .......................................................................... 23
  Getting started ......................................................................................................... 24




             1
Section A: PC-Based Application
Welcome to the user manual for the PC-Based application. This section will
explain, step by step, how to operate and handle mokik® on the instructor’s
side. It will explain each feature and how to perform it using informative
figures. Please note that you must have a PC with Bluetooth to make full use
of the application’s features and connect with the mobile application.

Minimum System Specifications:

Operating System: Windows XP/Vista, Mac OS X, Linux

Processor: 1.0 GHz

RAM: 128 MB

Hard Drive: 10 MB

Bluetooth-chipset present

Getting Started:
1.) Unzip the archive to any destination
2.) Open the folder called “mokik”
3.) Double-click on “mokik.jar” to run the application




        2
A.1 Adding a New Course

1.) Start the application and the following startup screen will appear.




                                                                          A table showing the
                                                                          courses that were
                                                                          created by the
                                                                          instructor




                                                                          Click to exit the
                                                                          application




2.) Click on “New Course”.




         3
Click File  Exit to go to                                                       Click “Help” to view help
startup screen                                                                   message

Figure ).
                                                                                 Text field to enter course
Text field to enter section                                                      name
number

                                                                                 Text field to enter course
                                                                                 ID
Selection menu to choose
the semester

                                                                                Text field to enter the
                                                                                academic year



Text field to enter the                                                         Text fields to enter absence
number of tardies for one                                                       and tardy timeouts in
absence                                                                         minutes



Click to add the course

                                                                                Click to go back to the
                                                                                startup screen




            3.) Fill in the information for your new course.

            4.) Click on “Add Course” to add the course and return to the startup screen.




                          4
A.2 Deleting an Existing Course

1.) Start the application and the following startup screen will appear.




                                                                          A table showing the
                                                                          courses that were
                                                                          created by the
                                                                          instructor




                                                                          Click to exit the
                                                                          application




2.) Select a course from the table.

3.) Click on “Delete” and confirm deletion to delete the course.




          5
A.3 Opening the Course’s Main Screen

1.) Start the application and the following startup screen will appear.




                                                                          A table showing the
                                                                          courses that were
                                                                          created by the
                                                                          instructor




                                                                          Click to exit the
                                                                          application




2.) Select a course from the table.

3.) Click on “Select” to open the Main Screen (see figure next page).




          6
               A text area for the
               instructor to write a    A text field to     A text field                                     Shows
               question                 include a           to include a                                     the
                                        score for the       question              Click to receive the
                                                                                                             number of
                                        question            timeout               answers from the
                                                                                                             students
                                                                                  students’ mobiles
                                                                                                             in class




                                                                                                           A list of
 Click to
                                                                                                           students
 send the
                                                                                                           currently
 question to
                                                                                                           attending
 the
 students’                                                                                                 the lecture
 mobiles


4 possible
answer                                                                                                     Click to
choices for                                                                                                start taking
the question                                                                                               automatic
above                                                                                                      attendance

                                                                                                            Click to
Statistical                                                                                                 remove a
pie chart to                                                                                                student
view                                                                                                        from the
students’                                                                                                   list
responses

                                                                                                           Click to
                                                                                                           manually
                                                                                                           add a
                                                                                                           student
                                                                                                           (see )
                                       The Main Screen for a Course



                                                          Click to edit student          Click to add new
                                                          information (see )             students to the course
                                                                                         (see )




                         7
            A.4 Sending a Question

            1.) Open the main screen for a course (see pg.6)

            2.) Type in a question in the “Send Question” box

            3.) If you want a timeout for the question, tick the question timeout checkbox
                and type in a timeout. (A timeout for a question means that after the
                specified amount of time, the answer of the student will be automatically
                saved). If you do not require a timeout and want to receive the answers at
                your call then deselect the checkbox.

            4.) If you want a score for the question, tick the score checkbox and type in a
                score. If you do not require a score then deselect the checkbox.

            5.) Click on “Send Question” to send the question to all mobiles on the list.




                                                                                              Enter
Type                                                                                          timeout
question                                                                                      here (if
here                                                                                          required)



                                                                                              Enter
                                                                                              score here
Click                                                                                         (if
“Send                                                                                         required)
Question”


                                                                                              Questions
                                                                                              will be
                                                                                              sent to all
                                                                                              students
                                                                                              with
                                                                                              mobiles on
                                                                                              the list




                     8
A.5 Receiving the Responses

1.) After sending a question (see pg.8) the following message will appear if at
    least one student on the list has a mobile. (Otherwise go to step 3).




2.) Click “OK”.

3.) Wait for the following message to appear as answers are being received.




4.) Click “No” to ignore the responses of students with no mobiles (Go to step 8).

5.) Click “Yes” to include the answers of students with no mobiles. This will
    open the following dialog.




         9
List of
students with
no mobile                                                                            Choose the
phones                                                                               answer
                                                                                     choice for the
                                                                                     student




                                                                               Click to go back
                                                                               to main screen
                                                                               with no
Click to save                                                                  changes made
the students’
choices




      6.) Select the answer choice desired by each student. (Leaving the selection
          empty means the student does not want to respond).

      7.) Click on “Save Choices” to save the students’ choices

      8.) Select the correct answer using the radio buttons.

      9.) The chart will be drawn on the main screen showing the statistics for the
          five possible answers (Choices A, B, C, D, and No Response)




                10
A.6 Saving the Scores

Note: This can only be performed when a score has been chosen for the question.

1.) After sending a question (see pg.8) and receiving the responses (see pg.9),
    click on the “Save Score” button on the main screen.

2.) Confirm the decision to save the scores. Scores will be added by the
    specified amount to the records of students who have answered the
    question correctly (i.e. have chosen the same answer as the one indicated
    by the instructor).
                                                                 Click on
                                                                 “Save Score”
                                                                 to save the
                                                                 scores




       11
A.7 Starting Automatic Attendance

1.) Open the main screen for a course (see pg.6)

2.) Click on “Start” in the attendance panel of the main screen to start
    recording attendance. Students with their mobiles in the vicinity will be
    added to the list automatically (Bluetooth must be ON for the mobiles).

   Students arriving before the tardy timeout (see pg.4) will be rendered present.

   Students arriving after the tardy timeout (see pg.4) but before the absent
   timeout will be rendered tardy.

   Students arriving after the absent timeout (see pg.4) will be rendered absent.




                                                                                After clicking
                                                                                “Start”,
                                                                                students will
                                                                                begin to be
                                                                                added to the
                                                                                list




       12
A.8 Stopping Automatic Attendance

1.) After starting attendance (see pg.12), click on “Stop” in the attendance
    panel of the main screen to stop taking attendance automatically.

A.9 Manually Attending Students

1.) Open the main screen for a course (see pg.6)

2.) Click on the “Manual” button in the attendance panel of the main screen.




                                                                               Click on
                                                                               “Manual”
                                                                               to take
                                                                               attendance
                                                                               manually




This will open a new dialog displaying a list of students with no mobile
phones or who have not been added to the list for some other reason.




       13
List of
                                                                                                     Choose the state
students with
                                                                                                     of the student:
no mobile
                                                                                                     Present, absent,
phones
                                                                                                     or tardy




                                                                                                     Click to go back
                                                                                                     to main screen
                                                                                                     with no changes
                                                                                                     made




Click to add
the selected
student to the
list




                3.) Select the state of the students to be added: present, tardy, or absent.

                4.) Click on “Add to List” to add these students to the list and return to the main screen.




                        14
A.10 Removing a Student from the Current Lecture

1.) Open the main screen for a course (see pg.6)

2.) Select a student to remove from the list

3.) Click on “Remove” in the attendance panel




                                                                        Click on
                                                                        “Remove” to
                                                                        remove a
                                                                        student from the
                                                                        list




Note: Students that have been removed cannot be added again automatically.
      To add them again, you must add them manually (see pg.13).




       15
A.11 Adding New Students to a Course

1.) Open the main screen for the course (see pg.6).

2.) Click on “New” in the student panel of the main screen.




                                                                           Click on “New”
                                                                           to add new
                                                                           students to a
                                                                           course




3.) A new dialog will appear for you to enter the number of students you want
   to add.




4.) Click “OK”

       16
             5.) A screen will appear with a table for you to enter the information of the
                new students.



                                                                                                    Add
                                                                                                    student
                                                                                                    information
Click to find                                                                                       here
and assign the
student’s
mobile

                                                                                                      Click to
                                                                                                      select all
                                                                                                      students
                                                                                                      in table




                                                                                                     Click to
                                                                                                     return to
                                                                                                     main
                                                                                                     screen

Click to add
the students to
the course




             6.) After entering all student information and assigning their mobile addresses (see
                 pg.21), click on “Add Students” to add their records to the course.




                     17
A.12 Editing Existing Student Information

1.) Open the main screen for the course (see pg.6).

2.) Click on “Update” in the student panel of the main screen.




                                                                             Click on
                                                                             “Update” to
                                                                             update student
                                                                             information




3.) A screen will appear showing all the information of students in the course.




       18
                                                                                                      Can edit
Click to find                                                                                         student’s
and assign the                                                                                        score,
student’s mobile                                                                                      absence/tardy
                                                                                                      count and
                                                                                                      name


 Click delete
 highlighted
 student from                                                                                          Click to
 the course                                                                                            view
                                                                                                       student’s
                                                                                                       attendance
Click to save                                                                                          record
any changes
made
                                                                                                      Click to
                                                                                                      return to
Click to select all                                                                                   the main
students in the                                                                                       screen
table




                4.) You can change the name of the student, assign a new mobile (see pg.21), modify
                    the student’s score, delete a student, or view and change the student’s
                    attendance record (see pg.20).

                5.) Click on “Save Changes” to save any changes made to the records.




                        19
             A.13 View and Modify Student Attendance Records

             1.) Open the update screen from the main screen (see pg.18).

             2.) Select a student to view his/her attendance records.

             3.) Click on “View Attendance Record” to open a new screen.




Click to remove                                                                                       List of the
the absent or                                                                                         dates on
tardy from the                                                                                        which the
student’s record                                                                                      student was
                                                                                                      absent or late




Click to change
the state from
                                                                                                       Click to
absent to tardy or
                                                                                                       return to
vice versa
                                                                                                       the update
                                                                                                       screen




             4.) Select a row to modify or delete.

             5.) You can toggle the state of the student (by clicking “Toggle State”) or remove the
                 absence/tardy from the record (by clicking on “Remove”). Changes are saved
                 automatically.

             6.) Click on “Back” to go back to the update screen.



                     20
       A.14 Assigning a Mobile Device to a Student

       1.) Open the new student screen (see pg.16) or the update screen (see pg.18)

       2.) Select a student from the table.

       3.) Click on “Assign” to open a new screen.




                                                                                       Table that lists all
Click to select the
                                                                                       mobiles within the
highlighted mobile
                                                                                       vicinity
as the student’s
mobile




                                                                                      Click to return to the
                                                                                      “Add Students” screen


Click to refresh
table contents




       4.) Select a desired device from the table.

       5.) Click on “Select” to select this device as the student’s mobile phone.




                      21
A.15 Changing the Settings of a Course

1.) Open the main screen for a course (see pg.6)

2.) From the menu bar, click on File  Settings to open a new window.




3.) Edit the tardy timeout, absent timeout, and the number of tardies for one
    absence for the course.

4.) Click “Save” to save changes or “Cancel” to exit without saving.



A.16 Cleaning up and Exiting

1.) When you are finished with lecture, to save the attendance for this
    lecture, click on File  Save Attendance Records from the menu bar.

2.) Click on File  Exit, to close the main screen and return to the startup
    screen.




       22
Section B: Mobile-Based Application
The mobile clicker application is an application used in “Mokik” project on
the mobile devices. The application is capable of connecting to the “Mokik”
application on the laptop in order to receive questions from the laptop and
answer them then send the answers back to the laptop application. Note that
the application is specific to the “Mokik” project only and won’t work on any
other application.

       The mobile clicker application is Java-based application. It should
work on any device that supports Java and has Bluetooth device in it. The
application was tested successfully on Nokia, Sony Ericsson, and Motorola
mobile devices. We will explain the steps of installing and using the mobile
clicker application on the following pages.



Installing the application:

   1.) Send the “Mobile_Clicker.jar” file to your mobile using Bluetooth,
       infrared, USB cable, or any way of connection between the laptop and
       the mobile.
   2.) Open the received Jar file. In Sony Ericsson mobiles, it would ask you
       if you want to install the application now. In Nokia mobiles, you may
       find the Jar file in the messaging in the Inbox. In case you are given a
       warning message, press “Continue” or “Yes”. Proceed with the
       installation steps until the application is installed successfully.
   3.) The application may be found in the “My own” folder or in the main
       menu folder in Nokia mobiles. In Sony Ericsson mobiles, you will be
       asked to put the application in the “Games” or the “Application”
       section. Choose the “Application” section. The Mobile Clicker program
       has been installed successfully on your mobile device.




       23
Getting started:
   Make sure that the Bluetooth is activated before you open the
      program. If the Bluetooth is not activated, the program will not open.

   1.) Once the application opens, you will be asked if you want to allow the
       application “Mobile Clicker” to use the Bluetooth connectivity. You
       should press “Yes” or the application won’t be allowed to use the
       Bluetooth connectivity functions.




       24
2.) After you press “Yes”, You will be given the following screen:




3.) Press “Exit” if you want to exit from the Mobile Clicker Application.




    25
4.) Press “Show Address” and you will be shown your unique Bluetooth
                               address.




 You may need this feature since it sometimes fails when it tries to find
 your friendly Bluetooth name. So, you may use this feature to let the
 instructor knows about your Bluetooth address to assign your
 Bluetooth device to your name in the database in his laptop.




  26
Receiving questions:

     The application is capable of receiving more than one question after
      each other without getting answers for them. So, when the instructor
      send a question, this question will be shown to you with the choices he
      wrote (or default choices in case he did not input choices in his laptop
      application). Check the next screen.




     Note that if the instructor assigned a timer to the question, the
      question will disappear from the mobile’s screen after that amount of
      time.




       27
   You should press “Save answer” to save your answer or it will be
    considered as “No response”. If you want to answer as “No response”,
    press the “Exit” button and the previous screen will be shown. Note
    that you will be shown your absence, tardy, and score count in this
    case. Also, the statement “Please wait” will be replaced by the
    statement “Thanks for answering”. Check the next screen.




          Press “Exit” to exit from the program.




     28

								
To top