报告表单

该组件根据 Word、HTML 或 PDF 模板指定的格式生成报告。要创建此组件的实例，请在报告资源管理器中选择文件 > 新建表单。

使用此组件的报告输出类型和模板选项为其分配表单模板。表单模板指定了此组件生成的报告的固定内容，以及用生成的内容填充的固定内容中的空位。分配表单模板会使用代表表单模板的空位和页面布局的空位和页面布局组件填充此组件。

您可以设置布局组件的属性来覆盖模板布局。您还可以将内容生成和控制流组件追加到代表报告表单空位的空位组件中。

要执行此组件，请在报告资源管理器中选择文件 > 报告。执行此组件会将关联表单模板的固定内容复制到输出报告中，并使用空位组件的子组件生成的内容填充固定内容中的空位。

要设置这些选项的默认值，请使用报告生成器预设项。有关详细信息，请参阅报告生成设置。

报告文件位置选项

文件夹

使用目录选项指定存储生成的报告文件的文件夹。指定您有写入权限的文件夹。

文件夹	选项
与报告设置文件相同的文件夹	与设置文件相同
当前工作文件夹	当前工作目录
临时文件夹	临时目录
另一个文件夹	自定义。使用浏览按钮从目录列表中选择。

您可以使用 %<VariableName> 符号在自定义文本框中指定一个文件夹。

报告文件名

使用文件名选项指定报告文件的文件名。

文件名	选项
与报告设置文件相同的文件名	与设置文件相同（默认）
文件名与报告设置文件名不同	自定义。输入报告的名称。

文件名

选项

与报告设置文件相同的文件名

与设置文件相同（默认）

文件名与报告设置文件名不同

自定义。

输入报告的名称。

您可以使用 %<VariableName> 符号在自定义文本框中指定文件名。

增加以防止覆盖

若要在保存设置文件更新时保留设置文件的先前版本，请选择“如果报告已存在，则递增报告编号以防止覆盖”。

包类型

对于 HTML 输出，您可以指定以压缩、解压或压缩和解压的形式生成报告包。

报告输出格式

在报告输出类型和模板下，从文件格式列表中选择报告输出格式。对于基于表单的报告，您可以使用模板以指定的格式生成报告。

文件格式

选择以下选项之一：

直接 PDF - 使用 PDF 模板
直接 PDFA - 使用 PDF 模板 (自 R2025a 起)
HTML - 使用 HTML 模板生成压缩或未压缩的报告包
多页 HTML - 使用 HTML 模板并生成压缩或解压的报告包。 (自 R2024a 起)
单文件 HTML (来自模板) - 使用 HTML 模板并生成单个文件
Word - 使用 Word 模板
PDF (来自 Word 模板) - 根据 Word 模板创建 Word 文档，然后将 Word 文档转换为 PDF 文档。

模板

要将模板应用到此报告表单组件，请从文件格式列表旁边的列表中选择一个模板。模板列表显示您第一次打开报告资源管理器时 MATLAB^® 路径上的所有模板。如果您在第一次打开报告资源管理器后将模板添加到 MATLAB 路径，则必须更新列表。要更新列表，请执行以下命令：

 rptgen.db2dom.TemplateCache.getTheCache(true);

当您选择一个模板时，模板的结构体将填充报告设置。

模板中定义的节和空位（可用内容填充的占位符）会出现在报告设置中。
如果您的模板包含子表单模板库，则可以使用 Subform 组件插入这些子表单模板。有关详细信息，请参阅创建基于多表单的报告设置。

有关在基于表单的报告中使用模板的示例，请参阅创建一个简单的基于表单的设置。有关自定义模板的信息，请参阅创建报告模板。

报告生成处理

选项	用途
生成后查看报告	报告生成完成后，与报告输出格式关联的查看器将显示该报告。在 Linux^® 或 Macintosh 平台上打开 Microsoft^® Word 文档会调用 `soffice` 命令。要在 Linux 计算机上使用 `soffice` 命令，必须安装 Apache^® OpenOffice^® 或 LibreOffice^®。在 Macintosh 上，您必须在 `/Applications` 文件夹中安装 Apache OpenOffice。要手动查看报告，请从报告的报告选项中指定的位置（报告文件位置下）打开文件。
生成前自动保存	在生成报告之前保存报告设置文件。
编译模型以报告编译的信息	确保报告反映编译的值。默认情况下，Simulink^® Report Generator™ 报告 Simulink 参数的未编译值。某些参数的未编译值（例如信号数据类型）可能与仿真期间使用的编译值不同。此选项使报告生成器在报告模型参数之前编译模型。生成报告后，报告生成器将模型返回到未编译状态。注意当您选择此选项时，每当报告生成需要仿真模型时（例如，报告包含模型仿真 (Simulink Report Generator)组件），报告生成器都会反编译该模型，然后重新编译该模型（如有必要），以报告模型内容。如果一份报告需要多次编译，处理过程可能会非常耗时。为了尽量减少编译，请考虑使用单独的报告来报告模型的内容和对该模型进行仿真的结果。
仅生成 DocBook	生成 DocBook XML 文件，但不生成 Word、PDF 或 HTML 报告。
生成后计算此字符串	指定 MATLAB 代码以便在报告生成后进行处理。例如，您可以指定关闭一个模型。

报告描述

要记录有关报告设置的注释和评论，请使用报告描述框。

另请参阅