关于 Doclets 和变量

报表包由称为 doclet引用 doclet引用文件补充 doclet 的子组件组成。此外,变量可以将引用 doclet 和引用文件作为来源。

  • doclet

    Doclet(有时称为常规 doclet)包含您要使用 Narrative Reporting 报表包创建的报表所需的内容。报表包可以包含一个或多个 doclet。基于 Word 的报表包中包含基于 Word 的 doclet;基于 PowerPoint 的报表包中包含基于 PowerPoint 的 doclet。基于 PDF 的报表包中包含基于 Word 和 Excel 的 doclet 以及 PDF 文件;但是,只能创作 Word 和 Excel doclet。

    存储在 Narrative Reporting 库中的文件夹中的 Word 和 PowerPoint 文档可以作为链接的常规 doclet 添加到报表包。链接常规 doclet 维护指向源库文档的持久链接。更新库文档时,Narrative Reporting 会自动更新链接到库文档的所有 doclet。Narrative Reporting 会持续更新 doclet 文件,直到 doclet 链接被禁用为止。

    doclet 参与整个报表包工作流,包括所有创作阶段、审核阶段、签署和报表发布。

  • 引用 doclet

    引用 doclet 可以用作容器来存储内容,例如 Excel 文件中的命名范围或者从报表创建的图表或图形,这些内容供报表包中的一个或多个 doclet 使用。

    基于 Excel 的引用 doclet 是 Excel 文件,用作内容的支持文件(例如,Oracle Smart View for Office 网格/表单或静态 Excel 内容),您可以先注册引用 doclet 再直接将其嵌入到基于 Word 的 doclet。您可以使用 Excel 的“名称管理器”来指定可嵌入内容,然后在 Smart View 中注册已命名范围。

    基于报表的引用 doclet 包含了在 Narrative Reporting Web 界面中创建并注册为可用内容的表和图表。

    然后,您可以将任一类型的引用 doclet 中的内容直接嵌入到基于 Word 的 doclet 中。借助嵌入过程,目标 doclet 中内容的布局和格式将与源引用 doclet 保持相同。

    基于 Excel 和基于报表的引用 doclet 都可以包含在基于 Word 的报表包中。嵌入的内容将合并到组合报表中,并且您可以在审核阶段向其添加注释。

    Smart View 中,基于 Excel 的引用 doclet 支持创作阶段的如下内容管理功能和工作流功能:

    • 可以签出、修改、上传、签入、提交以供审批、批准或驳回引用 doclet。

    • 可以签出、修改、上传、签入、提交以供审批、批准或驳回包含嵌入的内容的基于 Word 的 doclet。

    • 可以将嵌入的内容与引用 doclet 中命名范围的更新进行同步。

    • 可以刷新嵌入的内容。

    基于报表的引用 doclet 的工作流是在 Narrative Reporting Web 界面中维护的;不过,Smart View 中支持以下适用于创作阶段的内容管理功能和工作流功能:

    • 可以签出、修改、上传、签入、提交以供审批、批准或驳回包含嵌入的内容的基于 Word 的 doclet。

    • 可以将嵌入的内容与引用 doclet 中命名范围的更新进行同步。

    • 可以刷新嵌入的内容。

    请注意,在审核阶段或签署阶段不可以向引用 doclet 本身添加注释;但在 doclet 中,可以在来源为引用 doclet 的嵌入内容上添加注释,而该嵌入内容是最终发布的报表的一部分。

  • 引用文件

    引用文件是 Excel 工作簿,其中包含可嵌入到 Word doclet 中的报表内容。引用文件并不像 doclet、引用 doclet 和补充 doclet 一样列为报表包的一部分,而是在将引用文件中的内容嵌入到 Word doclet 中时,该引用文件成为 doclet 属性的一部分。签出目标 Word doclet 时,Narrative Reporting 会跟踪您对引用文件做出的任何更改。您随后可以刷新已嵌入到目标 Word doclet 中的内容。

    请注意,在审核阶段或签署阶段不可以向引用文件本身添加注释;但在 Word doclet 中,可以在来源为引用文件的嵌入内容上添加注释,而该嵌入内容是最终发布的报表的一部分。

  • 补充 doclet

    补充 doclet 是一些有助于开发整个报表的文档,例如源文件和支持文件。补充 doclet 可以属于 Office 文件类型(例如,Excel、Word 或 PowerPoint),也可以属于非 Office 文件类型(例如,PDF、TXT 或 ZIP)。来自补充 doclet 的内容不会合并到组合报表中。

    任何文件类型的补充 doclet 都可以包含在基于 Word 和 PowerPoint 的报表包中。例如,基于 Word 的补充 doclet 可以包含在基于 Word 或 PowerPoint 的报表包中。

    Smart View 中,补充 doclet 支持创作阶段的如下内容管理功能和工作流功能:

    • 可以签出、修改、上传、签入、提交以供审批、批准或驳回基于 Office 的补充 doclet。

    • 对于非 Office 类型的补充 doclet,已分配的作者可以轻松访问 Smart View 以下载和查看文件。但是,必须通过 Narrative Reporting Web 界面执行与这些文件的任何其他交互(例如,签出、上传和签入)。

    请注意,在审核阶段或签署阶段不可以向任何文件类型的补充 doclet 添加注释,而且它们不是最终发布的报表的一部分。

  • 变量

    通过报表包变量可以集中维护整个报表包的各个 doclet 中显示的通用文本、数字、日期和数据。变量也可用于在 doclet 之间引用内容,例如将引用 doclet 中的 Excel 数据插入到 Word doclet 中。

    提供了两种类型的变量:

    • 静态变量:此类变量使用用户定义的静态输入,例如日期标签或设定的值,它们可以在整个报表包中使用。这些静态变量可以轻松地更新,变量值的所有 doclet 实例都会反映更改。静态变量有助于集中维护报表包文档内容中的通用日期、数字和文本。

    • 引用变量:要创建此类变量,需要将报表包中的另一个 doclet 作为引用源,并选择变量的值,例如 Word 段落中的文本或 Excel 单元格值。如果源文档后来有所更新,这些更改会在报表包中插入的变量实例中自动更新。引用变量可用于将 Excel 单元格值插入到 Word doclet 中的段落,或者用于创建 Excel 公式来实施交叉总计规则以提高数据精确度,亦或用于为报表叙述创建方向性词,例如“增加”或“减少”。