Tip:
Highlight text to annotate it
X
Welcome to this presentation,
Adding widgets to the widget catalog of IBM Rational DOORS Next Generation.
This video demonstrates how to include OpenSocial gadgets
and Rational DOORS Next Generation extensions
in the widget catalog, and make them available in Jazz Team Server
alongside the widgets supplied by the Jazz™ Team Server and Jazz Team Server applications.
Adding widgets from the catalog is easier than its alternative
of adding an OpenSocial gadget by using a URL.
OpenSocial gadgets are widgets developed by using Open social standards,
including the JavaScript Client API for Rational DOORS Next Generation.
Gadgets written by using the JavaScript Client API are one way to extend the capabilities of Rational DOORS Next Generation.
Accordingly, those gadgets are often called extensions.
In this example, the team has a number of OpenSocial gadgets and extensions that they would like to use.
Currently, each individual has to know about the gadget,
its url and add it to the dashboard by telling the Add Gadget dialog how to access the gadget.
The team would like to add these gadgets on their widget catalog, so they are easier to find and use.
The jazz.net pages provide sample extensions, instructions on how to create your own extensions,
instructions on creating a catalog of extensions and a template to get you started.
Start by downloading the template.
Let’s have a quick look at the template
The first line talks about the version of XML being used.
Leave this line as is
The first part of the RDF section points to standard representations of resources needed. Leave this section.
The catalog entry section is a block of fields that need to be provided for every gadget.
Every gadget needs its own catalog entry block.
As you see, some fields are optional and some are required.
You need a description of the gadget, a title, and a URL to the gadget XML implemention of the extension.
The rest of the information is optional referring to images and organizational categories.
The categories are interesting because if the category exists, the gadget will be added to that category.
If the category does not exist, it will create a new category and add the gadget to it.
This section is optional because by default, All gadgets will exist in the all category.
All this information is information we already have.
The template file gets updated with the information needed
and for this demo the file is saved as WidgetsCatalog.XML.
Now you need to host the catalog on the server.
In our example, Apache Tomcat is the server.
Following the instructions on Jazz.net, we placed the WidgetCatalog.xml file in the "extensions" directory.
Finally, notify the Jazz Team Server about the catalog
From the Jazz Team Server administration page, scroll to the Requirements Management section, and click Manage Server Administration
On the left side, click Advanced Properties.
Find the property called com.ibm.rdm.fronting.server.UserExtensionCatal ogUrl.
Enter the URL for the WidgetCatalog.xml file, and click Update Property.
The gadgets should now be available in the widget catalog.
Let’s confirm.
Go in a requirements management project dashboard.
Click Add Widget.
In category All, flip through the pages to find the widgets FMEA and Wikipedia.
In the Our RM Extensions category, FMEA is listed.
Click on Add Widget to add the widget to the dashboard.
In the Sample Extensions category, the Wikipedia gadget is listed.
Click on Add Widget to add the widget to the dashboard.
The gadgets were successfully added to the dashboard.
For additional details, examples, and restrictions,
on how to extend the widget catalog visit Jazz.net.
This concludes our demo.
Thanks for watching.