外部报表功能允许使用用户创建的报表处理程序导出 EPLAN Harness proD 报表。这是通过将报表中包含的数据导出到临时 XML 数据文件并自动启动报表处理程序来实现的，然后报表处理程序将使用这些数据来创建所需的输出。请参阅开发人员须知部分，了解有关如何创建这种程序的更多信息。

EPLAN Harness proD 安装目录包含这样一个名为 HReportExternally.exe 的程序的演示：该程序使用 .xlsx 文件模板输出格式为 Microsoft Excel 电子表格的报表。每种类型的报表模板包含在安装目录中。每种类型的报表关键词可参见：

• 附件报表关键词
• 装配体 / 设备报表关键词
• 物料清单汇总关键词
• 物料清单单行关键词
• 电缆报表关键词
• 电缆单位报表关键词
• 连接物报表关键词
• 特殊组件报表关键词
• 表面保护材料报表关键词
• 线束报表关键词
• 导线列表报表关键词

所有类型的报表都可以包含用户定义的属性。用户定义的属性的名称必须带有前缀 userdef_，且空格替换为 _x0020_ 字符串。

使用外部报表所需的设置

必须满足两个先决条件，才能使用外部报表：

• 在本机或本地网络上必须可以访问合适的报表处理 .exe 程序
• 其文件路径和参数必须添加到 Studio 设置中

使用 HReportExternally.exe 演示作为示例：

1. 在 Studio 中，转到工具 > 设置 > 报表 > 外部报表
   
   您将看到一个报表类型列表，每个类型都有两个字段。一个用于报表处理程序的文件路径，另一个用于参数。
   
2. 在相应报表类型中插入外部程序的路径
   
   选择汇总物料清单报表作为示例，并使用 <Harness ProD installation directory>\HReportExternally.exe 演示程序。
   
3. 单击相邻字段并输入程序可能需要的任何其他参数。
   
   对于演示程序，这将是相应报表模板的路径。模板路径必须按以下形式输入：-template "<Harness proD installation directory>\Demo\Demo_ReportExternally\<template name>.xlsx"。对于汇总物料清单报表，您需要使用 bom_aggregated_template.xlsx 模板。
4. 单击 [确定]。
   

使用 "外部报表" 导出报表

为外部报表设置了 Studio 设置后，就可以继续使用它导出报表：

1. 打开要使用此程序导出的报表。
2. 选择文件 > 外部报表菜单项。
   
   选择保存最终报表的目录，定义其名称并分配相应的文件扩展名。对于演示程序，扩展名必须为 *.xlsx。
3. 单击 [保存]。

开发人员须知

HReportExternally.exe 的未汇编源代码存储在 <Harness ProD installation directory>\Demo\Demo_ReportExternally\Demo_ReportExternally.zip 中。

当使用外部报表功能保存报表时，Harness proD 将执行以下步骤：

• Harness proD 创建包含报表数据的 *.xml 文件。
• Harness proD 通过以下参数调用程序：
  
  
  • -源 "<xml 数据文件的文件路径>"
  • -输出 "<用户指定的输出文件的文件路径>"
  • 任何其他用户定义的参数，如 HReportExternally.exe 演示程序的 -模板 "<模板文件路径>"。

该程序随后使用此信息创建最终报表。

HReportExternally.exe 模板的特定变量

HReportExternally.exe 演示程序在其模板中使用几个变量：

关键词	描述
PROJECT_NAME	项目的名称
DATE	导出报表的日期
TIME	导出报表的时间
START	强制性指示要填充数据的表第一列位置
END	强制性指示要填充数据的表最后一列位置