The Blackboard Building Block is available with RefWorks Administrator Tool, Admin Central area, Customizing RefWorks section.

RefWorks Bridge Extension for Blackboard Installation and Usage Instructions

Release 1.0 and 1.0.1


This open source RefWorks Bridge Extension for Blackboard (a "Building Block" in Blackboard parlance) developed jointly by RefWorks-COS and Northwestern University provides one-click access to RefWorks databases.   

There are currently two versions of the RefWorks Bridge Extension:

Installation and usage for both versions is the same.

Access to RefWorks is provided in two ways:


This Blackboard extension can be installed using the standard Blackboard installation process as outlined below:

Configuration instructions

After completing the above steps you will need to configure the extension by clicking on the Properties button for the newly installed RefWorks Bridge Extension.

The Configure RefWorks Plug-in page contains entries for the location of the RefWorks server your institution uses; in most instances the default of is correct. These locations are used by Blackboard for user authentication purposes. To use a secure connection enter https:// instead of http://.

Note: using https:// requires that your Blackboard server has JDK 1.4 or above installed.

This page also contains entries for your institution's RefWorks Group Code and RefWorks Administrator password.  

Note:  if either your RefWorks Group Code or RefWorks administrator password get changed via the RefWorks Admin utility, the corresponding changes also need to be made here on this properties page.  Neglecting to do so will cause all RefWorks log-ins via this plug-in to fail.

Installation notes for sites that locally host RefWorks

If your institution is locally hosting RefWorks, you must first manually edit the bb-manifest.xml file in the extension zip package, adding a line that provides connection permissions to the local server. To do so:

After this modification, you are ready to install this plug-in.  Keep in mind that during configuration of the plug-in, you should specify your server's URL instead of the one provided by default in the web form.

RefWorks Account Maintenance

The RefWorks Bridge Extension is currently unable to automatically disable RefWorks accounts for deleted Blackboard users. The RefWorks Administrator will need to manually delete RefWorks accounts (for users no longer affiliated with the institution). We plan  on incorporating an automated removal  feature into the plugin when a robust event model is supported by Blackboard Building Blocks.

An institution that plans to re-use a Blackboard username (assigning it to a second individual once the first one is no longer affiliated with the institution) must first use the RefWorks Administrator Tool to delete the RefWorks account.  If this is not done, users will access incorrect accounts in RefWorks.

Getting Started – Instructions for Users

The Blackboard extension will allow you direct access to your RefWorks account by clicking on the RefWorks link in the Tools area of your course.

The first time you click on the Tools link, you will be asked if you wish to create a new RefWorks account or if you wish to link to an existing RefWorks account:

Creating a New RefWorks Account

If you choose to create a new RefWorks account, the Blackboard extension will open a new browser window and automatically create a new RefWorks account.  The next time you click on the RefWorks link from within Blackboard, you will be taken directly to your RefWorks account.  

Connecting to an Existing RefWorks Account

If you want to connect to an existing RefWorks account, you will be asked to enter your RefWorks login name and Password for your existing account.  If the login and password are entered correctly, the Blackboard extension will change the login name for that account to " BB-[Blackboardusername]" and open a new browser window which bring you into your existing RefWorks account. The next time you click on the RefWorks link within Blackboard, you will be taken directly to your RefWorks account.  

Regardless of whether you created a new account or linked to an existing account, RefWorks will send you an acknowledging email.  The email (depending on how it is customized by the RefWorks Administrator at the particular institution) will contain the RefWorks account login information, including the new username, the password, and the RefWorks Group Code.  You will need to this information if you want to access your RefWorks account outside Blackboard, so save this e-mail.

Getting Started – Instructions for Instructors

RefWorks accounts can be used to publish Instructor reading lists or to foster group collaboration on projects.  

Instructors can provide links to existing RefWorks accounts in any of the course Content areas (Course Information, Course Documents, Assignments, External Links, etc.).  Each content area can link to an entirely different RefWorks account.