getReportlet

Used to display a Reportlet. This tag is similar to the getReportletData tag but is used to get the Reportlet as a page. This tag sends the request to Actuate BIRT iServer to retrieve the page, then parses the response and writes the DHTML Reportlet to the JSP output stream. You access the height and width of the Reportlet by calling the getHeight( ) and getWidth( ) methods respectively.

Library

reportlet

Tag class

com.actuate.reportcast.tags.reportlet.GetReportletTag

Attributes

Table 8-14 lists and describes the attributes for getReportlet.

**Table 8-14** Attributes for getReportlet
Attribute	Required	Description
authID	Yes	The unique authentication identifier returned by Actuate BIRT iServer on successful login.
componentID	No	The identifier of the report component from which to retrieve Reportlet data. Specify either componentID, or componentName and componentValue.
componentName	No	The name of the report component from which to retrieve Reportlet data. The componentName is the name of the component assigned in the ROD file, such as NewReport::Frame1. If componentName is not specified, the componentID is used. Use in conjunction with componentValue. Specify either componentName and optionally componentValue, or componentID.
componentValue	No	A value identifying the specific instance of the report component from which to retrieve Reportlet data. The value is the result of evaluating a search expression. Use componentValue in conjunction with componentName. Specify either componentName and componentValue, or componentID. If unspecified, componentValue defaults to the first report component specified by componentName that the user has access to.
connectionHandle	No	The connection handle from the Actuate BIRT iServer.
customInputPara	No	Parameters to a custom converter for a new output type.
embeddedObjPath	No	The path name of the servlet which retrieves embedded objects such as images for the Reportlet.
fileId	No	The report file’s unique identifier.
id	No	The object’s unique identifier.
locale	No	The Reportlet locale, such as en_US, as in <context root>\Web-inf\localemap.xml.
name	No	The Reportlet source’s full Encyclopedia volume path name.
operation	No	Operation to perform, view or print.
page	No	The single page to display as a Reportlet.
range	No	A range of pages to include. Separate pages and page ranges with commas, such as:1-3, 15, 21-25.
reportletMaxheight	No	The Reportlet’s maximum height in points.
scalingFactor	No	Less than 100 reduces and more than 100 enlarges the Reportlet.
searchCriteria	No	Search criteria to use.
serverURL	Yes	The URL of the server on which the Reportlet’s source resides.
timeZone	Yes	The Reportlet server’s time zone as in <context root>\Web-inf\TimeZone.xml.
useragent	No	The user’s browser, such as IE/5.5.
version	No	The version number for the Reportlet source.
viewMode	No	Additional viewing parameters.
volume	Yes	The Encyclopedia volume on which the Reportlet’s source resides.