创建报告容器

创建报告 API 对象来保存内容

每个报告 API 程序都必须创建一个 mlreportgen.report.Report 对象来保存报告内容。使用 mlreportgen.report.Report 构造函数创建 Report 对象。

如果使用没有参量的构造函数，报告 API 会在当前文件夹中创建一个名为 untitled.pdf 的 PDF 文档。要指定名称和位置，请使用报告的路径名作为构造函数的第一个参量。

您可以使用 type 参量指定要生成的报告类型。您可以将类型指定为 'html'、'docx'（用于 Microsoft^® Word）、'pdf'（用于 PDF 输出）或 'html-file'（用于单文件 HTML 输出）。

这个 Report 构造函数为 Word 输出创建一个名为 myReport 的文档对象。

d = Report('myReport','docx');

使用 templatePath 参量，您可以指定自定义模板的路径名，作为格式化报告的基础。如果您希望根据定义报告外观和结构体的自定义模板来创建报告，请指定模板路径。模板类型必须与文档类型匹配。例如，此报告构造函数使用模板 myWordTemplate.dotx 为 Word 输出创建报告对象。

d = Report('myReport','docx','myWordTemplate');

创建 DOM 文档对象来保存内容

如果您打算单独使用 DOM API（即不使用报告 API 对象）来生成报告，则必须创建一个 mlreportgen.dom.Document 对象来保存报告内容。使用 mlreportgen.dom.Document 构造函数创建 Document 对象。

如果使用不带参量的构造函数，DOM API 会在当前文件夹中创建一个名为 Untitled.htmx 的 HTML 文档。要指定名称和位置，请使用报告的路径名作为构造函数的第一个参量。

您可以使用 type 参量指定要生成的报告类型。您可以将类型指定为 'html'、'docx'（用于 Microsoft Word）、'pdf'（用于 PDF 输出）或 'html-file'（用于单文件 HTML 输出）。

这个 Document 构造函数为 Word 输出创建一个名为 myReport 的文档对象。

d = Document('myReport','docx');

使用 templatePath 参量，您可以指定要用作格式化报告基础的模板的路径名。如果您希望根据定义报告外观和结构体的自定义模板来创建报告，请指定模板路径。模板类型必须与文档类型匹配。例如，此 Document 构造函数使用模板 myWordTemplate.dotx 为 Word 输出创建一个文档对象。

d = Document('myReport','docx','myWordTemplate');