abhay-vaidya / webwork Goto Github PK

WeBWorK is a proof-of-concept Java desktop application for courses that incorporate multiple-choice quizzes and assignments.

• Assignment Creation with unlimited number of multiple-choice questions
• Assignment editing
• Multiple tries to complete assignments
• Viewing and exporting assignment results
• Assignment remark system
• Course feedback system

• Due to the usage of an external library, JavaMail, if the program is being run through an IDE, the user must reconfigure their Java build path to access the library. The API is found as 5 jar files in the lib folder in the project and you must add them to your build path.
• Go to ApplicationDriver.java under the controllers package
• Run ApplicationDriver.java and you will see a login/register interface

• For first-time users, you must register your account by typing in your valid email address and password
• You will have to check the Instructor checkbox before clicking Register
• You will be presented with a screen to ask you input your first name, last name and passcode to finish your registration
• As an instructor, you will need to provide a valid passcode for the course in order to register as an instructor successfully. If you are the first instructor, you are considered the admin and will be required to set the passcode for all other instructors.
• You will see a popup window notifying you of a successful registration after you have entered all the information properly and submit.

• After you have registered successfully, you will be able to log in to the instructor dashboard using the same email address and password that you registered with (it is not necessary to check the instructor box)

• Open the assignment creation panel by clicking the + Add Assignment button at the top right corner
• Select a due date of the assignment by clicking the drop-down box on the left top
• Enter the assignment number you are going to create
• Manually enter each problem corresponding multiple choice options
• Preset the solution for each question by clicking the corresponding radio button for the correct multiple choice option
• After you have entered all the required information for the question, you can click Add this Problem to add the problem to the problem set
• If you have not entered all the required information before clicking Add this Problem, you will get a popup notification to ask you fulfill all the required text
• Repeatedly do the steps above until you have added all the problems to the problem set for the current assignment
• Click the Create button after you have entered all your problems to finish creating the assignment
• As an instructor, you can release and unrelease assignments by clicking the labeled buttons corresponding to the appropriate assignments

• Click Edit button on the dashboard beside the assignment that you wish to edit
• Use the drop-down menu to select the question you want to modify
• Once selected, you can edit the problem, the multiple choices, and its solution on the panel directly. Click Save Edited Problem once you are done editing.
• If you wish to delete a question, select the question you wish to delete from the drop-down menu, then click Remove problem
• If you wish to add a new question to this assignment, you need to click Clear to clear all the default text in the boxes first. Enter the new assignment question, multiple choice options and its solution to the corresponding text fields and then click Add new problem.
• After you have completed all necessary changes to the assignment, you need to click Save to save all your changes. After you click Save, the application will take you back to the dashboard.
• Now your edited assignment will return be listed as Unreleased. You may now click Release to release the assignment to the students once more.

• The class average of each closed assignment is displayed on the dashboard automatically after the assignment due date has passed. You can check out the class average under the Closed assignments session.
• If you would like to export a copy of an excel spreadsheet which includes all the students' performances for a given assignment, click Export Mark for the assignment data you would like to review. A file-chooser window will open after clicking Export Mark, you can save the copy of the document to anywhere on your computer by choosing a directory. The new assignment details result file will replace the old file if the file has already existed in the directory you chose.
• If you would like to get a summary of the performance of an individual student, you can search for their results by clicking Search Student. After clicking Search Student, it will open a search panel where you need to enter the student number into the text field and then click Search. All the marks that this student has achieved in the past assignments will be displayed on the display panel.

• All the remark requests would be sent to your email directly through this application system once the student clicks the remark button on their student panel. Check your emails to view all the remark requests.
• If you want to approve a remark request, you can go to your dashboard and click the Remark button. Enter the student number and the assignment number which you are handling, and the student's final mark to the text box. Click Adjust Mark to save the changes to the database and the application system will send an email to notify the student of the change of his/her mark automatically. Click Cancel if you would like to go back to the dashboard.

• You can view student feedback by clicking the View Feedback button at the top corner of the dashboard.

• Enter your valid student email address and password, click Register.
• You will see a screen to ask you to input your first name, last name and student number to complete your registration process.
• You will see a pop-up window says Registration Successful after you have entered all the information properly when you register.

• After you have registered successfully, you will be able to log in to the student dashboard using the same email address and password that you registered with

• Click Open on the assignment you want to start
• Answer each question by selecting a multiple choice option
• Click Save and Close if you have not finished the assignment
• Click Submit and Grade to grade your assignment and get your mark
• If you click Save and Close, the application will auto-fill your previous saved answers for each question and set it as the default option when you open the assignment again next time.

• The application will auto grade your assignment after you click Submit and Grade. There will be a submission summary to notify you which questions you have got right and which questions you have got wrong for the current submission. Your final mark of this assignment will get adjusted if your current try is better than the highest mark you have got in the history.
• You can view each assignment submission summary after the deadline for the assignment passed. Find your Closed assignments and click the Result button on the assignment result you want to review. You will be able to see your final mark, average mark, number of tries, and time spent as feedback. Click Done after reviewing it and the application would take you back to the dashboard.

• Click the Remark button beside the assignment you wish to get remarked
• Explain why you want a remark in the message box and then click Submit to request a remark
• The remark will be sent to instructors directly by email and you will be notified if your grade has been changed

• You can communicate with your professors or TAs by sending them feedback messages. The Give Feedback button is at the right corner of the dashboard. Click Give Feedback button to write a feedback message.