Subscribe Bookmark RSS Feed
danielvalente

Joined:

Jul 26, 2013

HTML5 Auto-Publishing

Version 1.1 5-28-2014


Note: This Add-In Requires JMP 11.1.1 or Later. This Add-In is intended to support publishing from standard reports generated through JMP platforms. There may be situations where custom scripts, applications and/or journals may cause the Add-In to fail before generating a complete report. As such, we have to say that this Add-In does not support auto-publishing from these items. As this Add-In was intended to be a proof-of-concept, we are saying that development and maintenance for this Add-In is complete.


Changes in 1.1:

  • Fixed an error where the .css file selection was not writing correctly to the index.html page.
  • Path to the report is now automatically written to the Blast Queue JMP table. If the directory of the Web page is moved, you will need to run the first script to update the path.
  • Updated help file in Add-In.

This JMP Add-In constructs web pages and a folder structure to serve up an arbitrary number of interactive HTML reports from JMP. It does not require a user to script or leave the analysis flow to save reports and can be done at the end of an analysis session. You can choose reports to include in the final web page and build a stylized index page to aid with presentation. The final output is encapsulated in a folder that can be hosted on the server or shared with others.


Watch a demo:

   

Below is the web page structure that is written as the result of running this add-in:

Simply double-click the index page in the folder and the web page will be displayed in your browser (as shown in the Sample JMP report launcher image, above). Then click on the icons to view the interactive HTML JMP reports.

The index page is also built with standard HTML and the design is controlled by cascading style sheets (CSS). The details in the index page can be customized right in JMP, allowing you to change the report title and add descriptions or notes.

When you first start the Add-In, it will ask you for a directory where you’d like to store the built web page.

To get started generating your report click on the Refresh report list button to populate the list with all open JMP reports.If you want all the open reports to be part of the final output, you don’t need to select anything. If you want just a subset of the reports to be part of the final report, you can select them in the list.  If you want to close all open reports after running the application, select Close reports after running. When you are ready to generate the report, click the Build report with selections button.

This will generate a JMP table and populate the directory you specified previously with three folders and an index HTML file:

  • The _css folder includes .css files, which adjust how the index page looks and is organized.
  • The _html5 folder includes all of the generated interactive HTML reports with data saved by JMP.
  • The _images folder includes thumbnails of the JMP reports generated to populate the index page.
  • Finally there is an index page, which is the main file to browse and launch your JMP reports.

Below is a sample of the JMP table that is created, which is called Blast Queue. If you wish, you can save this file to the directory where the web page is created. This JMP table lets you adjust the layout of the web page and also lets you edit content of the index page directly. You don’t need to manually edit the HTML in order to make changes. Don’t change the data in the FileName or ImageName column. These are links to the interactive JMP reports and thumbnails in the generated file structure. If you move the folder on your desktop to another location on your computer, you need to run the first script in the data table: Set Current Directory, and navigate to the new folder where the web page is stored.

There are three scripts in this table that let you adjust the look of the index page:

  • Table Layout Report: Generates an index page in a grid with up to four analysis steps in a row.
  • Vertical Report (Lg. Icons): Generates an index page in a list with large thumbnail icons.
  • Vertical Report (Sm. Icons): Generates an index page in a list with small thumbnail icons.

In order for the timestamp to reflect the actual time when the report was run, navigate to JMP > Preferences > Reports and then turn on Date Title on Output. This will write the date/time to the JMP report, which will then be written to the Timestamp column.

You can change the Report Name and Description by editing the text in those columns. The order of the report will be the same as in the table, so to change the report order just change the order of the rows in the table. To delete any reports from the index page, delete them from the table.

Advanced Features

Thumbnails are generated automatically based on the first available graphic in the report. You can select the thumbnail manually by using the selection tool. Simply highlight the object on the JMP report you wish to use as the thumbnail before clicking the Build report with selections button.

You can also use the Journal to generate a report in the web page. This is useful if you have a PowerPoint slide or an image that you wish to include in your web page. Create a new Journal and then paste in the image:This will show up on the report list and the subsequent web page as a static image:

If you want to use your own CSS file, you can tell the data table where that is by executing the Set Custom .css file table script. Then to build the report using this custom .css file, run the Custom .css file Report script.

You can automatically add a description to your JMP reports during the analysis session by adding a text block right after the data/timestamp. Then, when the report is blasted, that text block will be pulled into the description field for that row.

Comments
leelaim

This is pretty slick! 

danielvalente

I'm glad you like it! Please let us know if you have any suggestions or comments.