跳到主要内容

XML配置文件参考

XML配置参考

图11-10：XML配置文件参考

概述​

本节详细介绍电子表格报告XML配置文件的结构、主要标签、常用属性及示例，帮助用户高效定制和排查自定义报告。

文件结构​

<?xml version="1.0" encoding="utf-8"?>
<reports templatePath="templates/report.template.xls" traverseAssemblies="true">
  <CostModelWatchpoints sheetName="apOutput">
    <Node name="*" isLeaf="true" suppressZeros="false" tag="first">
      <CSL>
        <Formula>materialCost</Formula>
        <Formula>laborCost</Formula>
      </CSL>
    </Node>
  </CostModelWatchpoints>
</reports>

主要标签与属性​

  • <reports>：根节点
    • templatePath：Excel模板路径
    • traverseAssemblies：是否递归装配体
    • generateCsv/generateXml：输出格式
    • generateThumbnails：生成零件缩略图
    • generateUserOverrides：输出覆盖信息
  • <CostModelWatchpoints>：定义工作表
    • sheetName：工作表名称
    • generateOneRowPerAttribute：每属性一行
    • overridesSheetName：覆盖信息表名
  • <Node>：数据节点
    • name：节点名称
    • isLeaf：是否叶节点
    • suppressZeros：是否隐藏零值
  • <CSL>：公式集合
  • <Formula>：具体变量或公式

常见用法​

  • 多工作表、多节点、多级嵌套
  • 支持自定义属性、聚合、分组
  • 可结合模板实现复杂格式和图表

注意事项​

  • 标签、属性区分大小写，拼写需与系统一致
  • 路径需为相对或绝对，确保模板可访问
  • 结构错误会导致报告无法生成

快速导航​

本节为电子表格报告XML配置文件的详细参考