Difference between revisions of "Blackboard"

From WeBWorK_wiki
Jump to navigation Jump to search
Line 29: Line 29:
 
=== Prepare WeBWorK ===
 
=== Prepare WeBWorK ===
 
* Enable the webwork webservice. To do so put the following lines in your webwork.apache2-config file. It is very likely that these lines are already in that file waiting to be uncommented.
 
* Enable the webwork webservice. To do so put the following lines in your webwork.apache2-config file. It is very likely that these lines are already in that file waiting to be uncommented.
  +
 
<syntaxhighlight lang="apache">
 
<syntaxhighlight lang="apache">
 
PerlModule WebworkSOAP
 
PerlModule WebworkSOAP
Line 75: Line 76:
 
{{Warning|For security purposes, it is strongly recommended that you change this key to something less guessable on production servers.}}
 
{{Warning|For security purposes, it is strongly recommended that you change this key to something less guessable on production servers.}}
   
Install the Building Block
+
=== Install the Building Block ===
  +
  +
TODO
  +
  +
=== Configure the Building Block ===
  +
  +
There are some settings that the Blackboard administrator must set in the administration settings for the building block:
  +
  +
* '''Enter webserver location''': [base url]/WebworkSOAP, e.g. http://webwork.math.missouri.edu/WebworkSOAP
  +
* '''Enter webserver RPC location''': [base url]/webwork2_rpc e.g. http://webwork.math.missouri.edu/webwork2_rpc
  +
* '''Enter weberver site url location''': [base url]/webwork2 e.g. http://webwork.math.missouri.edu/webwork2
  +
* '''Enter the SOAP Authorization Key''': SOAP authorization key from WeBWorK (See above)
  +
* '''Enter the SOAP Classes Permission''': Minimum WeBWorK permission level for webservice users. Enter 0 here.
  +
* '''Enter the SOAP User Status''': Required WeBWorK user status for webservice users. Enter C here.
  +
   
Configure the Building Block
 
   
 
[[Category:Developers]]
 
[[Category:Developers]]

Revision as of 13:18, 13 July 2011

Creating a Blackboard Plugin to mimic the behavior of the Moodle "bridge1" plugin was begun in 2008 at the University of Rochester. The connection between the CMS and WeBWorK is minimal.

  • Single sign in
    • Students sign in to the CMS. To do their homework they click on a WeBWorK link which automatically signs them in to WeBWorK, creates a homework set instance for them.
  • Common grade book
    • When they have completed their homework their homework grades are transferred back to the gradebook in BB. (At first this was triggered by a cron job.)
  • Configuration of homework sets is done using WeBWorK tools, not from BlackBoard or Moodle.


History:

Creating a Blackboard Plugin to mimic the behavior of the Moodle "bridge1" plugin was begun in at the University of Rochester. The connection between the CMS and WeBWorK is minimal. Students sign in to the CMS. To do their homework they click on a WeBWorK link which automatically signs them in to WeBWorK, creates a homework set instance for them. When they have completed their homework their homework grades are transferred back to the gradebook in BB. (At first this was triggered by a cron job.)

  • Summer, 2008 -- Dan Arnold, supervised by Michael Gage. This was part of the UR summer intern program sponsored by the IT department of the University of Rochester.
  • Summer, 2009 -- Martin Georgiev , supervised by Michael Gage and Paula Yandow-Reilley(and others from the UR IT department)
  • November,2010 -- code base resurrected and cleaned up -- Paula Yandow-Reilley
  • February, 2011 -- Blackboard plugin code base shared with University of Missouri
  • Spring, Summer 2011 -- Further development by Srinivasan Devanathan, a student at University of Missouri in conjunction with (MU IT department) and supervised by Jason Aubrey. University of Oregon and University of Calgary are also beta testing and following results.


Installation

Construction.png This article is under construction. Use the information herein with caution until this message is removed.

Prepare WeBWorK

  • Enable the webwork webservice. To do so put the following lines in your webwork.apache2-config file. It is very likely that these lines are already in that file waiting to be uncommented.

<syntaxhighlight lang="apache">

 PerlModule WebworkSOAP
 <Location /webwork2_rpc>
        PerlHandler Apache2::SOAP
        SetHandler perl-script
        PerlSetVar dispatch_to "WebworkSOAP"
        PerlSetVar options "compress_threshold => 10000"
        Order Allow,Deny
        Allow from All
 </Location>
 <Location /webwork2_wsdl>
        PerlSetVar dispatch_to "WebworkSOAP::WSDL"
        PerlSetVar options "compress_threshold => 10000"
        PerlHandler WebworkSOAP::WSDL
        SetHandler perl-script
        Order Allow,Deny
        Allow from All
</Location>

</syntaxhighlight>

Note that there are likely other webservice configuration stanzas in your webwork.apache2-config file. The two above are the only ones that need to be active for communication with the Blackboard building block.

After adding or uncommenting these lines, you may check that things are working so far by restarting the webserver and navigating to http://[webwork@your_school].edu/webwork2_wsdl. You should see an XML file which begins something like

<syntaxhighlight lang="xml">

<?xml version="1.0" encoding="UTF-8"?>