This page
Other pages
Account
Tutorial recording
This recording and sample code will help you get up and running with your first Building Blocks project using Eclipse. It covers how to use the built-in Eclipse wizards to create, edit, build, and manually deploy a Building Block to a development server. It also shows how to add the Blackboard supporting Java jar libraries and UI tag libraries to your project. (Tip: As a best practice, obtain the Blackboard jar libraries by downloading the installer jar file from Behind the Blackboard, unzipping it, and selecting the /payload/systemlib directory. Alternatively, you can select the /blackboard/systemlib or /apps/tomcat/lib directory from your development instance of Blackboard.) Finally, it covers how to automate the build process using supporting developer tools and scripts supplied by Blackboard.
Video recording
bb-manifest documentation
The bb-manifest XML schema attached to this page can be used to verify your bb-manifest.xml file that tells Blackboard how your Building Block plugin will hook into the system.
Configuring Eclipse
1. Window > Preferences
2. XML > XML Catalog > Add
- Location: /path/to/bb-manifest-plugin.xsd
- Key type: Namespace name
- Key: http://www.blackboard.com/bb-manifest-plugin.xsd
What you get out of this
- Syntax errors will show up as you edit
- Smart completion is enabled
- Inline documentation for the elements that have it
Comments (5)
17 May 2011
Calvin Bishop says:
Hi, I followed the tutorial, but when I go to access the ne...Hi,
I followed the tutorial, but when I go to access the new link in the admin panel, this is the error that I get:
The specified resource was not found, or you do not have permission to access it.
Can you tell me what I have done wrong? I tried this using 9.1 SP1 and 9.1 SP5 with the same results. I can download the hello-world.war file and the page that is created there loads just fine. Thanks in advance for the help, ~Calvin.
18 May 2011
Calvin Bishop says:
As it turns out, I created the admin.jsp file in the wrong directory. It i...As it turns out, I created the admin.jsp file in the wrong directory. It is supposed to be in the WebContent directory.
20 May 2011
Peter Hanley says:
I was able to find bb-cms-admin.jar bb-platform.jar bb-taglibs.jar in b...I was able to find
in blackboard/systemlib/ on our 9.1 SP5 server , but there isn't a servlet.api.jar file. Was it removed from SP5?
22 Jun 2011
Robert Rienzi says:
I found the servlet.api.jar file in $BB_HOME/apps/tomcat/lib/ on my installation...I found the servlet.api.jar file in $BB_HOME/apps/tomcat/lib/ on my installation.
06 Feb 2012
Guy Heatley says:
I found the instructions for configuring the XML catalog in Eclipse didn't work:...I found the instructions for configuring the XML catalog in Eclipse didn't work: I still got an error saying "No grammar constraints (DTD or XML schema) detected for the document."
To use the "bb-manifest-plugin.xsd" schema for validating your building block bb-manifest (e.g. having added it to the catalog in the Eclipse IDE), you need to do this:
<manifest xmlns="http://www.blackboard.com/bb-manifest-plugin">