Reporting API Tag Library

The following appendices describe various JSP tags for using InetSoft's Dashboard Reporting API to integrate dashboards and reports in your Web application.

Cache Tag

The cache tag caches the content of the report page. This tag must be the first report tag in the page. The cache tag is required.

Attribute Name	Description	Required	Allowed Values
jspId	Unique ID of the cache	Yes	Any globally unique string

Create Tag

The create tag generates the report and serves any resources required to display the report. This tag must be inserted after the cache tag, but before any other report tags. If there is any HTML content or JSP tags that write HTML content before the create tag, the resourceUri attribute must be set to the URL of the Servlet Repository. The create tag is required. The create tag can contain parameter tags.

Attribute Name	Description	Required	Allowed Values
reportId	Unique ID of the report	Yes	Any string that is unique within the JSP
name	The name of the report	Yes	The name of any report in the replet registry
processPage	Specifies if the JSP will be processed when the report is not available	No	true/false
resourceUri	The URI of the servlet or JSP that should be used to load report resources	No	Any valid URL
linkUri	The URI that should be used as the base of all links inside the report	No	Any valid URL

Parameter Tag

The parameter tag defines parameters that are passed to the report. This tag must be enclosed within a create tag. The parameter tag is optional.

Attribute Name	Description	Required	Allowed Values
name	The name of the parameter	Yes	The name of any parameter defined in the report
value	The value of the parameter	Yes	Any valid value
type	The data type of the parameter	Yes	string, number, date, boolean
format	The format of the value, if it is a date parameter	Only for dates	A format string as specified by java. text.SimpleDateFormat

Header Tag

The header tag includes the CSS style information, JavaScript and any imports required by the report. This tag must be placed within the HTML head tag.

Attribute Name	Description	Required	Allowed Values
reportId	Unique ID of the report	Yes	The report ID specified in the create tag

Body Tag

The body tag writes the report page in the JSP. This tag may be placed anywhere in the HTML body. The body tag is required. The body tag may contain valid HTML or JSP content. This content will be written if the report is not available and the processPage attribute of the create tag is true.

Attribute Name	Description	Required	Allowed Values
reportId	Unique ID of the report	Yes	The report ID specified in the create tag

Toolbar Tag

The toolbar tag inserts the report toolbar as displayed by the Servlet Repository. This tag may be placed anywhere in the HTML body. The toolbar tag is optional. The toolbar tag may contain valid HTML or JSP content. This content will be written if the report is not available and the processPage attribute of the create tag is true.

Attribute Name	Description	Required	Allowed Values
reportId	Unique ID of the report	Yes	The report ID specified in the create tag

Button Tag

The button tag inserts an individual toolbar button into the JSP. This tag may be placed anywhere in the HTML body. Any attributes that are not set will use the default value and all attributes that are specified will override the default settings in the SREE properties file. The button tag is optional. The button tag may contain valid HTML or JSP content. This content will be written if the report is not available and the processPage attribute of the create tag is true.

Attribute Name	Description	Required	Allowed Values
reportId	Unique ID of the report	Yes	The report ID specified in the create tag
type	Specifies which button to insert	Yes	first-page, previous-page, page-box, next-page, last-page, find, find-next, PDF, refresh, archive, export, mail, print, customize, toc, menu, user
image	The URL of the image to use as the button's icon	No	Any valid URL. URLs beginning with resource:// will be loaded from the classpath of the web application. file:// URLs will be loaded from the file system of the server. URLs with the JAR: protocol will be loaded from a JAR file in the file system of the server. Any other URLs will be interpreted as HTTP URLs and will be used exactly as specified.
text	The text to use for a text-type button	No	Any string
useImage	Determines if the button will be a text or image type	No	true/false
actionClass	The fully qualified class name of the action that will be invoked when the button is clicked	Only for user-defined buttons	The name of any Java class that is on the web application's classpath

More Articles About Reporting

Advantages of IFrame Integration - IFrame integration is the recommended alternative to JSP-based integration, and there are several advantages that make IFrames the preferred approach in most cases: IFrames are easier to use, and Style Intelligence's report design architecture is geared toward IFrame integration. JSPs can be time-consuming to build and require knowledge of the JSP Tag Library. Reports that are integrated using JSP technology do not offer the end user Ad Hoc reporting functionality or portal utilities. These features are fully retained in IFrame-integrated reports. Certain application servers (WebLogic) require specific configurations and settings when using the JSP Tag Library. This complexity is avoided in the IFrame approach...

Alternative to Pentaho - Users find the Style Intelligence GUI very reliable, from the end-user perspective it's also very intuitive, easy to understand and to implement the creation of reports and dashboards with its ability to integrate and join data from various sources, all that leads Style Intelligence to beat Pentaho in building reports, Data Visualization, Big Data services, Data Modeling, Data trasnformation, Data API's, WYSIWYG Report Design. Pentaho as a competitor on the other side is not an intuitive platform that allows quick and great progress according to users, new users need to learn a lot to be able to perform specific analysis and reporting tasks, and that makes users feel more comfortable with Style Intelligence capabilities...

Analytic Tools for Government - It's driving a lot of decisions that the government has to make, hard decisions. And we want to make sure they are the right decisions because they are going to impact our future. We are also working with a lot of states who are working on tax compliance solutions. For instance, I read where over the past fifteen years a combination of five states were able to collect $1.5B more because of good analytics. With modern analytic tools, they were able to identify non-compliant tax filers. I know that as a taxpayer, myself, I am happy that they are going after those non-compliant filers because that way everybody pays their fair share and it keeps the tax burden on the rest of us lower...

Hospice Management Dashboards - Providing patients and their families with compassionate end-of-life care is the delicate and complex work of hospice administration. Key Performance Indicators (KPIs) and charts are essential tools for tracking, assessing, and improving care quality in this setting. Hospice care managers may make well-informed choices and maximize their services by using the visual depiction of vital data that hospice management dashboards provide. Now let's examine the key KPIs and charts included in dashboards for hospice management. A key performance indicator (KPI) in hospice management dashboards is the number of patient admissions and duration of stay. This measure sheds light on how quickly patients are admitted to hospice care and how long they stay there on average. Administrators can spot trends, evaluate how resources...

Qlik Sense Alternative - InetSoft has done extremely well in general usage ratings - Meeting Requirements, Ease of Use, Ease of Setup, Ease of Admin, Quality of Support, Ease of Doing Business With, and Product Direction. The speed with which dashboards and reports can be churned out has been a great reason for reviewers to recommend Style Intelligence. InetSoft also scored big under Quality of Support with its very responsive support staff and quick resolution of customer queries. The Product Direction parameter was also ranked favorably with the extensive "how to" reference videos on numerous topics and the mentoring service from InetSoft to kick-start an organization's efforts in the BI space. Dashboards and Scorecards were the categories where Style Intelligence was lauded for its robustness and described as a complete and powerful go-to tool for visual data analysis...

Previous: Displaying the Dashboard Page in a Dashboard Portal

Next: JavaScript Chart Scripting Techniques