Davisor Chart Tag Library (4.2)

JSP version: 1.2 or higher


Tags


<cache>


Defines cache settings for all content generated from the enclosed chart definition tag. Cache tag must enclose def tag to have any effect. Note that the chart definition is not cached only the resulting content from out tags.

Attributes

shared
When shared value is set to false (default) the cached content is available only for particular user. If value is true cached content is shared with all users. This mode is usefull in a situation where a chart result is same for all users for a fixed time.
required: false
rtexprvalue: true
timeout
Timeout in seconds (s), minutes (m), hours (h) or days (d) from current time. Timeout value contains a number and a unit abbreviation, where unit is s, m, h or d. If unit is not given seconds (s) will be used.
required: false
rtexprvalue: true

<def>


Defines a Chart XML. Tag is referenced from out tags, so it must be introduced before any out tag. If source attribute is not given the Chart XML is read from tag body, otherwise tag body is ignored and Chart XML is loaded from the source URL.

Attributes

id
Tag identification. If page has only one def tag the id attribute is not required.
required: false
rtexprvalue: true
urlContext
URL context for data and attributes. If not given current page URL context is used.
required: false
rtexprvalue: true
source
URL for an external Chart XML document. If this attribute is set the Chart XML is read from the defined sorce and the body content is ignored.
required: false
rtexprvalue: true

<out>


Writes embedding code and possible content to the JSP page. The result is written just to that position where the out tag was. The result depens on a chart content type. Common results are a table tag (with full content) or a img tag with a src attribute pointing to a chart servlet or to a image file.

Attributes

source
URL of the external Chart XML document. If source is given the Chart XML is loaded directly from given URL and the def attribute is ignored.
required: false
rtexprvalue: true
def
Id of the def tag. If not given (and source attr is undefined) default def id is used.
required: false
rtexprvalue: true
attributes
ID off the attributes block within the Chart XML. If not given first attributes block is used.
required: false
rtexprvalue: true
file
If this attribute has a value the chart image is saved to specified file, otherwise the chart image is streamed from servlet. Value can be an optional path with a asterisk (*) character or an path with given file name. If the asterisk character is used, a temporary file is created with unique name. Files can be relative to the current JSP page (dir/myfile.png) or to the web application (/dir/myfile.png). All referenced directories must exist. The file feature can not be used if the web application is served directly from the WAR.
required: false
rtexprvalue: true
width
Chart width. Overrides the Chart XML value.
required: false
rtexprvalue: true
height
Chart height. Overrides the Chart XML value.
required: false
rtexprvalue: true
resolution
Chart resolution. Overrides the Chart XML value.
required: false
rtexprvalue: true
contentType
Chart content type. Overrides the Chart XML value.
required: false
rtexprvalue: true
chartType
Chart type. Overrides the Chart XML value.
required: false
rtexprvalue: true
markupType
Mime type for object inclusion markup. Regoniced values: text/html (default) or image/xsl+xml (XSL-FO).
required: false
rtexprvalue: true
id
Identification string that is used to cache or transfer the resulting chart.
required: false
rtexprvalue: true
servlet
Explicit servlet URL.
required: false
rtexprvalue: true
ignoreError
If this attribute is set to true exceptions are logged to log file but not thrown to the JSP page (default value is false).
required: false
rtexprvalue: true

<attr>


Defines an out tag attribute. Attr tag can be used to add extra atributes to the out tag. Every attribute introduced with the attr tag is displayed in the resulting markup. These attributes does not affect the chart generation and are just pass by attributes for the implementation. Attr tags must be placed in the out tags body.

Attributes

name
Attribute name.
required: true
rtexprvalue: true
value
Attribute value.
required: false
rtexprvalue: true

<importData>


Imports an attibute with given name from specified context so that is can be used in chart data sources. ImportData tags must be placed in the def tags body. There can be several importData tags inside one def tag.

Attributes

id
Attribute name.
required: true
rtexprvalue: true
scope
Scope wherefrom to get the attribute.
required: false
rtexprvalue: true

<exportData>


Exports the chart data defined by def tag into the specified context with the given name (id). ExportData tags must be placed in the def tags body. There may be only one exportData tag inside one def tag.

Attributes

id
Attribute name.
required: true
rtexprvalue: true
scope
Scope to store the chart data to.
required: false
rtexprvalue: true