Birt and web.xml problems.

Mathematic

Hi , I am having a few problems understanding the web.xml tags for birt.

What I am trying to do is understand

BIRT_VIEWER_WORKING_FOLDER this is by default left blank in the web.xml and defaults to ${Birt Home}. But when I do a pageContext.getServletContext().getInitParameter("BIRT_VIEWER_WORKING_FOLDER")
in my jsp it display's nothing. Does that mean ${Birt Home} is nothing.

I am unsure if this context-param can be set so that birt is only running in a subfolder of my web application.

BIRT_VIEWER_DOCUMENT_FOLDER ( Is this where the output of what the report generates to either html or pdf etc ...)

WORKING_FOLDER_ACCESS_ONLY ( what is this for ? )
BIRT_VIEWER_IMAGE_DIR <- ( what images? Is this the directory it put the images for the pages generated by BIRT_VIEWER_DOCUMENT_FOLDER )

BIRT_RESOURCE_PATH ( what is this for ?)

BIRT_VIEWER_PRINT_SERVERSIDE ( Does this mean if they access my birt report thru a web page they can print to my server remotely ? )

Also in the viewer.properties file what is the jsp base href for I have never uncommented it yet I got birt to run in my jsp pages on localhost:8080/mywebapps/my.jsp
# configurable variable for JSP base href. Please uncomment the below line.
#base_url=http://127.0.0.1:8080

JasonW

BIRT_VIEWER_LOCALE This setting sets the default locale for the Web Viewer.

BIRT_VIEWER_WORKING_FOLDER This is the default location for report designs. If the report design specified in a URL parameter is relative, this path is pre-pended to the report name.

BIRT_VIEWER_DOCUMENT_FOLDER If a report document parameter (__document) is not used, this is the location that report documents will be generated in. If this setting is left blank, the default value ?webapp/documents? will be used. If the__document URL parameter is used and the value is relative the report document will be created in the working folder.

WORKING_FOLDER_ACCESS_ONLY If this value is set to true, reports will only be searched for, relative to the working folder. This prevents a user from entering a full path to a report. Relative paths below the working folder are accessible.

BIRT_VIEWER_IMAGE_DIR Specifies the default location to store temporary images generated by the report engine. If this setting is left blank, the default location of webapp/report/images is used.

BIRT_VIEWER_LOG_DIR Specifies the default location to store report engine log files. If this setting is left blank, the default location of webapp/logs is used.

BIRT_VIEWER_LOG_LEVEL Sets the report engine log level. Valid values are:
OFF
SEVERE
WARNING
INFO
CONFIG
FINE
FINER
FINEST

BIRT_VIEWER_SCRIPTLIB_DIR Specifies the default location to place Jar files used by the script engine. These can be Jars used by script engine or jars containing event handlers written in Java. These Jars are appended to the classpath. If this setting is left blank the default value of webapp/scriptlib will be used.

BIRT_RESOURCE_PATH This setting specifies the resource path used by report engine. The resource path is used to search for libraries, images, and properties files used by a report. If this setting is left blank, resources will be searched for in the same directory as the report.
BIRT_VIEWER_MAX_ROWS Specifies the maximum number of rows to retrieve from a dataset.

BIRT_OVERWRITE_DOCUMENT Specifies whether to overwrite the report document every time a report is executed. The default is set to true. Valid values are true and false.

BIRT_VIEWER_CONFIG_FILE Specifies the location of the viewer.properties file. This file contains various settings used by the viewer.

BIRT_VIEWER_PRINT_SERVERSIDE This setting specifies whether server side printing is supported. If set to OFF the toolbar icon used for server side printing will be removed automatically. Valid values are ON and OFF. With this setting on the servers printers should be displayed.

HTML_ENABLE_AGENTSTYLE_ENGINE This setting determines how BIRT styles are handled with the HTML emitter. If set to TRUE, the BIRT engine will output the styles directly to the report and depends on the browser to implement the style calculations. If set to FALSE the emitter will use the BIRT style engine to calculate the styles and will output the results directly to the report.

baseURL is used to set the location to viewer context. This setting is usefull when deploying the birt tag library in one context and the viewer in another. If not specified it builds the baseURL based on the current request.