Getting started with JasperReports JSF Plugin is very easy, just drop the jasperreports-jsf.jar file into your application classpath and you are ready to use it within your application view files.
Following are some indications you may need to use it depending of the JSF framework used by your web application.
If you are not using any JSF based framework, in other words, your application is JSP based you should configure your JSP's to enable the tag library this way:
<%@ taglib uri="http://jasperreportjsf.sf.net/tld/jasperreports-jsf-1_2.tld" prefix="jr" %>
After adding the taglib declaration you can add your report component to the JSF tree at any point you need:
<f:view> ... <jr:reportFrame value="..." /> ... </f:view>
When using Facelets, the JasperReports JSF Plugin tag library must be configured using a XML namespace this way:
<html xmlns=".." ... xmlns:jr="http://jasperreportjsf.sf.net/tld/jasperreports-jsf-1_2.tld" > ... </html>
After defining the XML namespace for the plugin you can add the report component like other HTML content:
<html xmlns="..." xmlns:jr="..."> ... <body> ... <span jsfc="jr:reportLink" value="..."> View Report </span> ... </body> <html>
Using JasperReports JSF Plugin with Shale-Clay depends on what kind of views are you implementing:
Using Shale-Clay is very similar to using JSF Facelets, the main difference is the special attribute needed to stablish which JSF component it's related to a HTML tag. Following is an example:
<html> ... <body> ... <span jsfid="jr:reportLink" value="..."> View Report </span> ... </body> <html>