To help users navigate easily between the integrated application and the TeamForge
site, you can make the TeamForge button bar available from the integrated application user
interface.
CollabNet
provides a tag library for JSP-based applications to plug the TeamForge button bar into
their pages. The ButtonBar tag library is packaged in the SDK.
Note: Only JSP is
supported in this release. More helpers for other view technologies are on the way.
Tip: Reference the buttonbar tag in a default
layout page so that all pages can use the same tag library.
-
Copy the taglib definition to your WEB-INF folder.
-
The integratedapp-taglib.tld file is available in
the SDK Package.
-
The .jar file containing the
IntegratedApp taglib is available in the
integratedapps.jar (which also contains the
other helper classes).
-
Add the following to your web.xml file to define the tag
library:
<taglib>
<taglib-uri>/tags/iapp</taglib-uri>
<taglib-location>/WEB-INF/integratedapp-taglib.tld</taglib-location>
</taglib>
-
Set up the Layout JSP page.
-
Get an instance of IntegratedAppSupport and add it to the Request
attribute.
-
Set the “linkid” in the Request attribute.
Now you can draw the button bar on all integrated app pages so that the user can
navigate between TeamForge and the integrated application.
For example, this is how we integrated Pebble, our example blogging application,
with the TeamForge button bar. (For more detail, see
iapp.jsp in
the Pebble source.)
<%@ page import="com.collabnet.ce.soap50.integratedapps.util.IntegratedAppSupport" %>
<%@ taglib prefix="iapp" uri="http://jakarta.apache.org/tomcat/pluggableApp-taglib" %>
<%
IntegratedAppSupport support = (IntegratedAppSupport)
request.getSession().getAttribute("intAppSupport");
request.setAttribute("intAppSupport", support);
request.setAttribute("linkId", support.getIntegratedAppId());
%>
<iapp:viewbuttonbar />