Daniel Valente,博士,JMP 产品经理,SAS
Brady Brady,JMP 技术支持工程师,SAS
Aaron Kennedy,JMP SAS 高级数字设计师
抽象的
直接在 JMP 中显示来自 JMP 的数据分析结果总是很不错。 但在某些情况下,您可能需要与无法访问该软件的人共享结果。 保存交互式 HTML 报告甚至可以让那些没有 JMP 的人使用动态图表和报告探索数据。 虽然这些报告可以在大多数现代浏览器中查看,但它们可能缺乏演示工作流或分析过程所需的上下文。 在本文中,介绍了一种新的 JMP 插件,该插件构建网页和文件夹结构以组织来自 JMP 的任意数量的交互式 HTML 报告。 这无需在分析会话结束时编写脚本即可完成,因此用户不会被迫离开分析流程来保存报告。 用户可以选择要包含在最终网页中的报告,并构建一个程式化的索引页面来帮助演示。 最终输出被封装在一个文件夹中,该文件夹可以托管在服务器上或与其他人共享。

这个 JMP ®插件构建网页和文件夹结构,以提供来自 JMP 的任意数量的交互式 HTML 报告。 它不需要用户编写脚本或离开分析流程来保存报告,并且可以在分析会话结束时完成。 您可以选择要包含在最终网页中的报告,并构建一个程式化的索引页面来帮助演示。 最终输出被封装在一个文件夹中,该文件夹可以托管在服务器上或与其他人共享。
下面是作为运行此加载项的结果编写的网页结构:

您可以观看此演示视频,了解使用此加载项创建交互式 HTML5 报告摘要报告的过程。
https://www.youtube.com/watch?v=E6C7GZd2x6A
只需双击文件夹中的索引页,网页就会显示在您的浏览器中(如上面的示例 JMP 报表启动器图像所示)。 然后点击图标查看交互式 HTML JMP 报告。
索引页面也是用标准的 HTML 构建的,设计由级联样式表 (CSS) 控制。 索引页面中的详细信息可以直接在 JMP 中定制,允许您更改报告标题并向图标添加描述或注释以帮助展示您的发现。
当您第一次启动加载项时,它会询问您要存储构建网页的目录。
要开始生成报告,请单击刷新报告列表按钮以使用所有打开的 JMP 报表填充列表。
如果您希望所有打开的报表成为最终输出的一部分,则无需选择任何内容。
如果您只希望报告的子集成为最终报告的一部分,您可以在列表中选择它们。 如果您想在运行应用程序后关闭所有打开的报告,请选择运行后关闭报告. 当您准备好生成报告时,单击使用选择构建报告按钮。
这将生成一个 JMP 表并使用三个文件夹和一个索引 HTML 文件填充您之前指定的目录:
- 这_css文件夹包含 .css 文件,这些文件调整索引页面的外观和组织方式。
- 这_html5文件夹包含所有生成的交互式 HTML 报告以及 JMP 保存的数据。
- 这_图片文件夹包含为填充索引页而生成的 JMP 报告的缩略图。
- 最后还有一个索引页面,这是浏览和启动 JMP 报告的主要文件。
下面是创建的 JMP 表的示例,称为 Blast 队列。 如果您愿意,可以将此文件保存到创建网页的目录中。 这个 JMP 表可以让您调整网页的布局,还可以让您直接编辑索引页面的内容。 您无需手动编辑 HTML 即可进行更改。
不要更改 FileName 或 ImageName 列中的数据。 这些是生成的文件结构中交互式 JMP 报告和缩略图的链接。 为了在生成的网页中反映任何更改,您需要运行数据表中的第一个脚本:设置当前目录,然后导航到您第一次运行加载项时在其中创建报表的同一文件夹。
此表中有三个脚本可让您调整索引页面的外观:
- 表格布局报告:在网格中生成一个索引页面,最多连续四个分析步骤。
- 垂直报告(LG. 图标):在带有大缩略图图标的列表中生成索引页。
- 垂直报告 (Sm. 图标):在带有小缩略图图标的列表中生成索引页。
为了让时间戳反映报表运行的实际时间,请导航至JMP > 首选项 > 报告然后选择输出日期标题. 这会将日期/时间写入 JMP 报告,而 JMP 报告又将写入时间戳列。
您可以通过编辑这些列中的文本来更改报告名称和说明。 报告的顺序将与表中的顺序相同,因此要更改报告顺序,只需更改表中行的顺序即可。 要从索引页中删除任何报告,请将它们从表中删除。
高级功能
缩略图是根据报告中的第一个可用图形自动生成的。 您可以使用选择工具手动选择缩略图;在单击使用选择构建报告按钮。
您还可以使用日志在网页中生成报告。 如果您有 PPT 幻灯片或希望包含在网页中的图像,这将很有用。 创建一个新的日志,然后粘贴图像:

这将以静态图像的形式显示在报告列表和随后的网页上:

如果你想使用你自己的 CSS 文件,你可以通过执行设置自定义 .css 文件表脚本。 然后使用这个自定义 .css 文件构建报告,运行自定义 .css 文件报告脚本。
您可以在分析会话期间通过在数据/时间戳之后添加一个文本块来自动向您的 JMP 报告添加描述。 然后,当报告被爆破时,该文本块将被拉入该行的描述字段。

伪代码/程序流程
- 设置目录。
- 根 HTML 报告目录:用户将在运行时选择它。
- 基目录:与此自动报告关联的带时间戳的目录。
- css 子目录:包含.css 文件。
- html 子目录:包含 JMP 生成的 .html5 报告。
- images 子目录:包含缩略图的图像文件。
- 将 .css 文件(包含在“defineCssTxt.jsl”中)保存到 _css 文件夹中。
- 为索引文件定义 HTML 基本文本。 包括用于插入每个报告的 HTML 文本的占位符。
- 向用户呈现控制窗口:
- 获取打开的窗口列表。
- 从此列表中删除不包含报告的窗口。
- 更改窗口名称以使其唯一并将它们列在控制窗口中。
- 当用户点击确定按钮时:
- 创建队列表,其中包含文件名、图像名称、报告名称、描述和时间戳列。
- 对于窗口列表中的每个窗口:
- 在队列表中添加一行。
- 将窗口名称添加到表格的当前行。
- 获取当前窗口的树结构,隐藏它并从中获取文本。
- 获取报表中第一个被选中元素的图片,如果没有元素被选中,则获取报表中的第一张图片。
- 将此图像的名称写入队列。
- 获取当前报告的日志文本。
- 解析它以获得平台名称。
- 将此名称保存为当前报告的默认报告名称。
- 获取当前报告的时间戳和描述信息:
- 获取当前报告的日志文本。
- 获取时间戳和描述信息(如果可用)。
- 请注意,必须在运行报告之前为这些设置首选项。
- 为当前报告保存交互式 HTML。
- 按时间戳对队列排序。
- 对于队列中的每一行:
- 为通用报告定义 HTML 文本,并使用队列中列信息的占位符。
- 用当前行中的列信息替换这些占位符。
- 将生成的字符串替换为基本 HTML 文本。
- F。保存生成的索引文件。
- G。如果需要,关闭所有报告。
- H。将控制和显示脚本写入队列表。
我从哪里得到它?
JMP 文件交换中提供了 HTML5 自动发布插件。 在这里下载: https://community.jmp.com/docs/DOC-6118
CSS 信息资源
如果您想编辑 .css 文件并自定义索引页面的外观,可以从以下资源开始。 第一个是 HTML Dog,它特别适合初学者,也是一个很好的参考资料。 它会定期更新以保持最新状态。 第二个链接是 Chris Coyier 的 CSS-tricks,它更适合中级/高级用户。
HTML 狗: http://www.htmldog.com/guides/css/beginner /
CSS 技巧: http://css-tricks.com /
意见及建议
请将意见、问题和建议发送至Daniel.Valente@jmp.com或者Brady.Brady@jmp.com .