跳到主要内容

XML文件编辑

XML编辑

图11-3：XML文件编辑界面

概述​

电子表格报告的核心在于XML配置文件，决定了数据提取、结构和输出内容。正确编辑XML文件是实现自定义报告的关键。

编辑工具​

  • 推荐使用支持高亮和结构校验的文本编辑器（如Notepad++、VS Code）
  • 保持UTF-8编码，避免中文乱码
  • 建议使用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>
        <Formula>directOverheadCost</Formula>
      </CSL>
    </Node>
  </CostModelWatchpoints>
</reports>

常用标签​

  • <reports>：根节点，定义模板路径、遍历选项等
  • <CostModelWatchpoints>：定义每个工作表的数据范围和名称
  • <Node>：数据节点，支持多级嵌套
  • <CSL>：包含公式、变量等
  • <Formula>：指定提取的字段或计算公式

编辑注意事项​

  • 文件名需以.watchpoints.xml结尾
  • 路径、标签、属性区分大小写
  • 变量、公式拼写需与系统一致
  • 结构错误会导致报告无法生成

快速导航​

本节介绍了XML配置文件的结构、编辑方法和常用标签