Chapter 17 17 Avizo XReporting Extension

Avizo允许创建报告。这是通过报告工作室（Reporting Workroom）完成的（见图17.1）。从这个工作室中可以加载报告模板。报告模板是一个带有框架（frame）的HTML页面。报告工作室允许用户把快照和统计结果关联到该HTML模板上。这既可以自动完成——通过把运行某个配方（recipe）时生成的某个特定快照或表格指派到某个特定框架；也可以通过拖放的方式完成——把由Avizo快照工具生成的某个快照、或某次分析所产生的某个表格拖放进去。

图 17.1：报告工作室。

任何HTML编辑器都可以用来创建一个适用于Avizo报告工作室的模板。该页面应当由框架和静态元素（例如文本或图像）构成。每一个带有 class="reportContentContainer" 的框架都将能够接收来自某个Avizo会话的快照或表格。报告工作室并非设计成一个HTML查看器，它是设计用来加载模板、在会话期间填充模板、并保存报告的。保存下来的HTML报告可以用任何浏览器查看，或者以PDF形式用任何PDF阅读器查看。切换到报告工作室时，会加载Avizo所提供的默认报告模板。从那里，既可以使用这个默认报告，也可以加载一个新的报告（见图17.2）。

图 17.2：加载一个新模板。

报告工作室的 Content（内容）面板分为两个子面板。上面那个列出可以导入到模板中的可用快照，下面那个列出各个表格。有两种方式来填充这些子面板。当某次分析（例如一个 Label Analysis 模块）产生出一张电子表格时，表格子面板会被自动填充。至于快照面板，快照可以从Avizo快照工具交互式地生成，在那里可以把报告工作室选作快照的目标（见图17.3）。

图 17.3：Avizo快照工具。

加载 AVIZO_ROOT/data/tutorials/spring_loaded_cam.am，并给它附加任意可视化模块。
选择快照工具，把一张快照发送到报告工作室。
切换到报告工作室。该快照出现在上面的子面板中。
把该快照从子面板拖放到报告模板的某个框架中。

图 17.4：快照的拖放。

同样地，分析所产生的表格也会被发送到报告工作室，在那里它们可以被拖放到模板的某个框架中。第二种方式是使用配方。一个配方可以自动产生快照以及分析所得的表格。由某个配方产生的每一张快照和每一个表格都会被顺序标识，并在播放时以同样的顺序填充这些子面板。重新播放一个配方将按同样的顺序替换这两个子面板中的快照和表格。

加载 AVIZO_ROOT/data/tutorials/spring_loaded_cam.am。
切换到 Recipes 工作室。
加载 AVIZO_ROOT/data/tutorials/recipes/porosity.hxrecipe。
在每个步骤之间添加一个快照步骤。
播放该配方。
切换到报告工作室。快照和表格出现在各个子面板中。请注意，在加载一个配方时，Avizo会自动检测该配方所生成的快照，并且快照子面板会自动被空的快照占位符填充。对表格而言并非如此，因为配方必须被播放一次，Avizo才能确定生成了哪些表格（见图17.5）。

图 17.5：来自配方的快照与表格。

随后，快照和表格可以被拖放到模板的各个框架中。一旦这种关联建立完毕，每次播放该配方时，模板中的快照和表格都会被自动更新。一旦关联被设定好，该模板就可以被保存为一个新的模板。这个新模板可以在Avizo中重新加载，并且每次播放相关联的配方时它都会被自动填充（见图17.6）。

图 17.6：报告示例。

要从报告中移除某张快照或某张电子表格，单击它并按 Delete。

随后，该报告可以被保存为一个HTML页面，或导出为PDF（见图17.7）。

图 17.7：保存或导出报告。

报告的日期格式可以自定义。要更改日期的格式，在date span中添加属性 “format”：

1	<span class="reportingDate" format="dd/MM/yy hh:mm:ss"><CurrentDateAndTime></span>

默认格式是 “yyyy/MM/dd hh:mm:ss”，可以使用下面这套形式体系来更改它：

对于日：d，1到31；dd，01到31；ddd，本地日名的缩写（例如 ‘Mon’），或 dddd，完整的本地日名（例如 ‘Monday’）
对于月：M，1到12；MM，01到12；MMM，本地月名的缩写（例如 ‘Jan’），或 MMMM，完整的本地月名（例如 ‘January’）
对于年：yy，年份表示为两位数字（00到99），或 yyyy，年份表示为四位数字（例如2017）
对于小时：h，0到23（若使用AP显示则为1到12），或 hh，00到23（若使用AP显示则为01到12）
对于分：m，0到59，或 mm，00到59
对于秒：s，0到59，或 ss，00到59
对于毫秒：z，0到59，或 zz，00到59
对于AP显示：AP，将显示 “AM” 或 “PM”；ap，将显示 “am” 或 “pm”

一份报告可以使用Avizo脚本来填充。要创建这样一份报告，在每个框架中设置一个唯一的HTML标签（推荐使用：accesskey="key"）。

要在某个给定框架中设置一张快照，使用下面的命令行：

1	theReportingWorkroom insertSnapshot "Snapshot-#" "td\[accesskey=\"key\"\]"

要在某个给定框架中设置一张电子表格，使用下面的命令行：

1	theReportingWorkroom insertSpreadsheet "sheet_name" "td\[accesskey=\"key\"\]"

要保存一份报告，使用下面的命令行：

1	theReportingWorkroom saveReport "C:/Path_to_your_file"

要清空该报告，使用![清空按钮]图标。

要把该报告导出为PDF，使用![导出按钮]图标。