WeBWorK FAQ

This process sets up link(s) to WeBWorK from Brightspace. Students must click on the link in order for them to get their information into WeBWorK. You can still add students separately through WeBWorK's class list editor, but their grades will only sync to Brightspace if their account was creted automatically through a link from Brightspace. By creating the link the homework grades will sync once a day to Brigghtspace.

Student accounts will be automatically created in WeBWorK, so it is important that you first clean out the class list in your WeBWorK class if you have students in it from previous semester:
Accounts Manager => Delete => Delete how many? (selected users) => select all users by clicking on the top check box => Take Action
You cannot delete yourself, don't worry.

New student will also get assigned ALL homework sets that have "visible" flag. If you used a WeBWorK class in a prior semester, probably all homework sets are visible with deadlines in the past, and solutions available. Most likely you don’t want all these homework sets assigned to new students like this. To make all (old) homework sets invisible do the following:
Sets Manager => Publish => Choose which sets to be affected: all sets => Choose visibility of the sets to be affected: Hidden => Take Action!
Make sure you make the homework sets visible again one-by-one when you assign them to students:
Sets Manager => Check box next to set to be made visible => Publish => Choose which sets to be affected: selected sets => Choose visibility of the sets to be affected: Visible => Take Action!

Please note that passing back grade to different Brightspace courses from a single WeBWorK course is not possible, What you have to do is ask COLTT to merge your sections into one Brightspace sections. In Brightspace: "Get Help" => "Contact COLTT" => "Create Case" => "Request Service". Make sure to specify which section you want to be the "parent course".


Do this in Brightspace:

Do this in your corresponding WeBWorK course in a separate browser tab:

Go back to Brightspace and repeat the previous process:

There are several ways to create homework sets.

This is a quick way to create a new empty homework set and to immediately start adding problems to it from the extensive library of problems. To create "Assignment A" do the following:

  1. Library Browser => next to "Create a New Set in This Course:" type Assignment_A (note that underscores are needed instead of spaces!)
  2. Click "Create a New Set in This Course:"
  3. Make sure there is confirmation of successful process with green background
  4. The name of the new set should appear next to "Add problems to Target Set: "
  5. The next step is to add questions to the newly created set.
  6. Note that your assignment will not be accessible to students until you assign it to them.

To create "Assignment B" do the following:

  1. Hmwk Sets Editor => Create => Name the new set: Assignment_B (note that underscores are needed instead of spaces!)
  2. Create as what type of set: a new empty set
  3. Click => Take Action!
  4. Make sure there is confirmation of successful process with green background
  5. The next step is to add questions to the newly created set.
  6. Note that your assignment will not be accessible to students until you assign it to them.

To copy "Assignment A" to "Assignment B" do the following:

  1. Hmwk Sets Editor => Create => Name the new set: Assignment_B (note that underscores are needed instead of spaces!)
  2. Create as what type of set: a duplicate of the first selected set
  3. Check box next to "Assignment A" (make sure there is no other assignment is selected!),
  4. Click => Take Action!
  5. make sure there is confirmation of successful process with green background
  6. Note that your assignment will not be accessible to students until you assign it to them.

If you or someone else has previously exported a homework set to a set definition file, you can turn that file back into a homework set.

  1. The set definition file (*.def) should be uploaded using the File Manager into the templates directory of the course.
  2. Hmwk Sets Editor => Import => specify how many and which one(s).
  3. You can also shift the opening/closing dates, but they have to be checked later anyway.
  4. Click => Take Action!
  5. make sure there is confirmation of successful process with green background
  6. Unless you choose "Assign this set to which users?: all current users", the assignment will not be accessible to students until you assign it to them.

Directly renaming a homework set is not possible. What the instructor has to do is copy the set to have a new name and then delete the old set. Deleting the old sets deletes all corresponding student records for the old set and it cannot be undone.

To copy "Assignment A" to "Assignment B" do the following:

  1. Hmwk Sets Editor => Create => Name the new set: Assignment_B (note that underscores are needed instead of spaces!)
  2. Create as what type of set: a duplicate of the first selected set
  3. Check box next to "Assignment A" (make sure there is no other assignment is selected!),
  4. Click => Take Action!
  5. make sure there is confirmation of successful process with green background

To delete the old "Assignment A" do the following:

  1. Hmwk Sets Editor => Delete => Delete how many?: Selected sets
  2. Check box next to "Assignment A" (make sure there is no other assignment is selected!),
  3. Click => Take Action!
  4. make sure there is confirmation of successful process with green background

In order to add problems to a homework set from the extensive Open Problem Library do the following.

  1. From the Library Browser, select a Target Set in which to place problems.
  2. Select Subject: Chapter: Section: according to your needs. It might take a few seconds for webwork to show the different choices in the drop-down menus.
  3. Alternatively, you can also select one of the specific (favorite) university libraries. To switch back from a specific library to the Subject/Chapter/Section you have to click on the "Open Problem Library" button.
  4. Click "View Problems"
  5. From the list of question select some and click on the "Add" button next to them.
  6. Note that you might have to click on "Next page" if htere is a very long list of problems.
  7. Don't forget to view the homework set once problems are added to it.

The Blackboard-WeBWorK bridge only creates student accounts in WeBWorK. For this reason you want to add Learning Assistants (LAs) or Teaching Assistants (TAs) directly to your WeBWorK class. These accounts are referred to as Teaching Assistant (TA) in WeBWorK. The grade of these directly added accounts will not sync to Blackboard.

  1. The first step adds a simple student account that later you have to elevate to TA
    1. Classlist Editor => Add => Add how many students? (change the 1 if needed) => Take Action!
    2. Fill in Last Name, First Name
    3. Leave "Student ID field" empty. This forces the TA to use their official university password.
    4. Login Name: their university email but without the @utrgv.edu
    5. Email Address: Specifying email address for TAs is very useful. TAs get all student emails sent using the "Email Instructor" button. These email contain a link that points directly to the students' question, which makes answering questions much easier.
    6. Other fields are optional. Perhaps you want to add a comment that they are TAs.
    7. At this point you can assign homework sets to them.
    8. Click "Add Students" ad the bottom of the page.
    9. Note that this only adds student accounts to your class list.
  2. Elevating a student account to TA
    1. Classlist Editor => Edit => check the box next to the LA/TA (you can select several) => make sure "Edit Which Users?" shows "selected users" => Take Action!
    2. In the rightmost column change "Permission Level" to "ta" => click "Take Action!"

WeBWorK uses PGML (PG Markup Language) for its problems. See Introduction to PGML for a short introduction. This page also contains links to further references. You can start writing your own question by adding a blank template problem to a problem set.

  1. Hmwk Sets Editor => Click the number in the column "Edit Problems" next ot the homework set you want to add yor own question.
  2. Check the box at the bottom of the page next to "Add 1 blank problem template(s) to end of homework set"
  3. Click on "Save Changes"
  4. Click the pencil button next to the newly created question that has source file with name blankProblem.pg
  5. Note that you cannot save edited problem files with the name blankProblem.pg, so the next steps should be:
  6. Click on "NewVersion"
  7. Make sure the "Replace current problem" is checked.
  8. Leave unchecked the box "Open in new window".
  9. Specify a new name in the box next to "Save file to: [TMPL]" => "Take Action"
  10. Edit the "Setup" part and the part between BEGIN_PGML and END_PGML
  11. To see how the question renders use the "Update" button with "Open in new window" checked.

You can embed any web page, including Desmos pages or youtube video pages into WeBWorK questions using "iframes". Note that these instructions do not cover the embedding of Desmos scripts. You have to know whether you want to insert the web page into a WeBWorK questions written in the "old" PG language (contains the line BEGIN_TEXT), or the newer PGML (PG Markup Language) (contains the line BEGIN_PGML).

  1. PG Language
    1. Insert above the BEGIN_TEXT line the following code:
       $link_to_my_page=MODES(TeX=>"Interactive graph should be viewed online", 
      HTML=>"<iframe src='https://www.desmos.com/calculator/5hedmvhiru' 
      width='1000px' height='500px' style='border: 1px solid #ccc' frameborder=0> </iframe>");
      
    2. After BEGIN_TEXT, in the main text insert the code
      $link_to_my_page
  2. PGML
    1. Insert above the BEGIN_PGML line the following code:
       $link_to_my_page=MODES(TeX=>"Interactive graph should be viewed online",
      HTML=>"<iframe src='https://www.desmos.com/calculator/5hedmvhiru'
      width='1000px' height='500px' style='border: 1px solid #ccc' frameborder=0> </iframe>");
      
    2. After BEGIN_PGML, in the main text insert the code
       [$link_to_my_page]* 

Independently from WeBWorK grades, the achievements feature rewards students for doing various tasks in WeBWorK. Receiving achievements like "On One Hand" (10 Points: Finish a homework set with less than 5 incorrect submissions.) and "Back For More" (10 Points: Retry a problem after an 8 hour break.) will make working in the homework system more fun. In addition to achievements students will also level up from Level 1-Initiate to Level 10-Professor. Achievements have to be assigned to students similarly to homework sets. To assign the available achievements to students

If you add more students to the class you have to do the following to assign the achievements to them:

By selecting "preserve existing data" you ensure that existing students do not loose their achievements. More information can be found about the achievements feature in WeBWorK at the page https://webwork.maa.org/wiki/Achievements.

Using the RLB with WeBWorK is possible, but it has several limitations.

  1. Students have to go though Blackboard's option of using RLB.
  2. The Blackboard link to the WeBWorK test does not work with homework set level connection, so the whole WeBWorK course has to be linked instead of individual assignments.
  3. Since course level link enables students to log into WeBWorK directly, you might want to create a proctored test that requires procotor username and password, and then you have to provide this information to students at some point (probably in the Blackboard test link).
  4. Even with a proctor username and password, students can share this information with each other and solve the test by directly logging into WeBWorK without going through Blackboard's LBR test. It is suggested that you check for students the WeBWorK log file and the Blackboard RLB information to see that the time spent in WeBWorK matches the time spent in the Blackboard test with the RLB.

Using the RLB with a WeBWorK Test

  1. Set up a proctor account in your WeBWorK class: See "Adding Learning Assistants to WeBWorK". Alternatively, you can also specify a "secret" proctoruser name and password, (the password can be omitted), and elevate the account to "grade_proctor".
  2. Edit the WeBWorK test and change the "Assignment type" to "proctored gateway/quiz" => "Save Changes".
  3. The proctored gateway/quiz has a lot of option that you have to carefully consider and change.
  4. In Blackboard create a test
    Assesments => Test => Create a New Test => fill out information => Submit
  5. Add a a question to the test. You can add a "file response" type question if you want them to upload their scanned work.
    Create Question => File Response => fill in details => Question Text:
    Link to WebWorK Test: https://webwork.utrgv.edu/webwork2/name_of_your_course/proctored_quiz_mode/name_of_your_test
    Change name_of_your_course and name_of_your_test accordingly
    It is best not show the link, but to insert the link to show the text "Link to WeBWorK Test"
    You also have to provide students here with the proctor username and proctor password so that they can complete the test on their own in WeBWorK.
    The question should also contain instructions for the students to close WeBWorK and to come back to the Blackboard Test after they finished the test. You might want to insert in the question an honor statement to which the students have to answer yes once they come back from WeBWorK.
  6. After adding the question to the test click OK at the bottom right corner.
  7. You should get back to the "Create Test" page where you can now choose the newly created test in the menu "Add an Existing Test" => Submit => fill in additional details.
  8. Enable Respondus for the test:
    • In the left-hand-side menu of Blackboard under Course Management => Course Tools => Respondus LcokDown Browser
    • Choose the test => Settings
    • Require Respondus LockDown Browser for this exam => Advanced Settings => Allow access to specific external web domains => Enter https://webwork.utrgv.edu
    • Require Respondus Monitor for this exam
    • Save + Close
  9. Things to watch out for:
    • Since this Blackboard-RLB-WeBWorK combination requires linking the WeBWorK course to Blackboard through a single course level link, student can also log in to WeBWorK directly avoiding Blackboard. Even with proctor password they could start the test through RLB, but then abandon it and continue it through directly loggin in to WeBWorK without RLB. You can check student activity in WeBWorK by going through File Manager => up one directory from templates => logs directory => login.log => View. The file login.log can be very large, and you might have to search it for specific usernames.
    • To avoid students looking at old assignments in WeBWorK you can adit the assignments and make them not visible.
    • Make sure the questions are numbered consecutively from one. Gateway/quizzes do not work if a number is skipped.
    • If you edit the gateway/quiz after it was assigned to students you have to unassign it and then reassign it again so that changes go through to students.
    • You might want to do some exam previewes for students to make sure things work.
    • A way to try out yourself the exam is by creating an instructor account with a secret login name and password in the WeBWorK course, then loggin in with that delet your university account in your WeBWorK course, and then using the student preview in Blackboard let WeBWorK create a new student account for you.

While the default answer entry is still through keyboard (2^6, 3/4, sqrt(5), infinity, etc), you can turn on a feature to help with typing answers.

You can experiment which one you like better.

You can enable Reduced Scoring by following the links:

If you enabled Reduced Scoring then you will also have to enable it for individual assignments and set their Reduced Scoring Dates by editing the set data:

Instructor can check login history of users:


Technical Questions