BIRT查看器用户指南：配置与参数详解

"BIRT Viewer User’s Guide" 是一份针对BIRT（Business Intelligence and Reporting Tools）2.3版本的用户手册，由Jerry Cheng初稿，Zhiqiang Qian翻译更新，以及Vincent Petry审查和完善。该指南详细介绍了如何使用BIRT查看器，包括其配置、参数设置和功能特性。 在BIRT Viewer中，`web.xml`文件是关键配置文件，它定义了BIRT查看器的基本设置和行为。以下是其中几个重要的配置项： 1. **BIRT_VIEWER_LOCALE**：用于设置查看器的本地化设置，控制报告显示的语言和格式。 2. **BIRT_VIEWER_WORKING_FOLDER**：指定查看器的工作目录，用于存储临时文件和运行时数据。 3. **BIRT_VIEWER_DOCUMENT_FOLDER**：定义报告文档的存放位置。 4. **WORKING_FOLDER_ACCESS_ONLY**：如果设置为true，限制查看器只能访问工作目录内的文件。 5. **BIRT_VIEWER_IMAGE_DIR**：指定图片的存储路径。 6. **BIRT_VIEWER_SCRIPTLIB_DIR**：设置脚本库目录，存放JavaScript和其他脚本文件。 7. **BIRT_VIEWER_CONFIG_FILE**：配置文件的路径，用于自定义查看器的行为。 8. **BIRT_RESOURCE_PATH**：资源文件的路径，如样式表和图像。 此外，手册还涵盖了特定的特性与行为，例如： - **BIRT_OVERWRITE_DOCUMENT**：控制是否覆盖已存在的报告文档。 - **BIRT_VIEWER_PRINT_SERVERSIDE**：设置是否在服务器端进行打印。 - **HTML_ENABLE_AGENTSTYLE_ENGINE**：启用或禁用HTML渲染引擎的代理样式处理。 - **BIRT_FILENAME_GENERATOR_CLASS**：自定义文件名生成类，可以用来定制报告输出的文件名。 在日志方面，`BIRT_VIEWER_LOG_DIR`指定了日志文件的保存位置，而`BIRT_VIEWER_LOG_LEVEL`则设置了日志记录的详细程度，如DEBUG、INFO、WARN等。 手册还详细描述了`viewer.properties`文件的用途，例如基础URL设置、导出扩展设置和CSV分隔符设置。这些配置影响着查看器的外观和功能，以及报告的导出格式。 URL参数部分列出了影响报告输出和查看器布局的关键参数，如： - **__report** 和 **__document** 用于指定要显示的报告。 - **__locale** 设置报告的语言环境。 - **__resourceFolder** 指定资源文件夹。 - **__showtitle**、**__title** 控制报告标题的显示。 - **__toolbar** 和 **__navigationbar** 管理工具栏和导航栏的显示。 - **__page**、**__bookmark** 用于页面跳转和书签操作。 最后，手册还提到了报告页、书签和报告组件的管理，使得用户能够更灵活地控制报告的呈现方式和交互体验。 "BIRT Viewer User’s Guide" 提供了全面的指导，帮助用户理解和配置BIRT查看器，以便更好地创建、展示和管理基于BIRT的业务报告。