Using Web Publish

You can use Web Publish for individual graphs, graph pages, projects, and their annotations. Web Publish does not require that you set database focus to use it.

However, if you don't focus on a specific graph or graph page, Web Publish publishes everything in the project.

1. Select a data source and data detail (see Selecting-data for more information).
2. Draw one or more graphs.

3. Select an individual graph, graph pages, or an entire project to publish as follows:    

   To publish	You need to
   Selected graphs	Make each graph open or current by clicking each graph you want to export.
   Graph pages	Open the page you want to export and then do one of the following: Make sure that the graph on the page is not selected. If the page contains multiple graphs, make sure that none is selected.
   Projects	Close all graphs.

4. Select File > Web Publish.
   A window displays one or more graphs being converted. These converted graphs are put in a temporary directory and then published to the Web server. 
5. Use your Web browser to display the page. The published page contains the company logo, title of the graph, page or project, and an index below it on the left side of the Web page.
   Each time you select File > Web Publish, the most recently published page becomes the default for the target location. You must rename projects on the Web server to prevent them from being over written. To rename projects, turn to Renaming projects on the web.
6. Select File > New Project > From Template and select the appropriate template for Web publishing.
7. Once you draw all the graphs you want, select Window > Close Windows.
8. Select File > Web Publish.
   A window displays the graph conversion. Web Publish converts each graph in the project into a *.PNG version and a *.JPG version. The converted graphs are stored in a temporary directory and then published to the Web server.
9. Use your Web browser to display the graph, page, or project. The published page contains the company logo, project title, project notes, page captions, and an index of page numbers on the left side of the Web page. When you click a page number, the page is displayed on the right side. When you click a graph on the right side, the entire right side of the page displays the selected graph. 

Renaming projects on the web

To maintain multiple projects on the Web, you must rename each project. If you don't do so, each project you publish overwrites the last. When you rename the project, you simultaneously set the caption name as it's displayed on your web browser.

1. Create the template you want to use in Visualizer.
2. Select Windows > Close Windows.
3. Select Edit > Title/Subtitle/Colors.
   When the Title/Subtitle/Colors dialog box is displayed, enter the Title name and click OK.
4. Select Window > Page Select > All Pages.
5. Select File > Save Project As.
6. Enter a unique name for the project and click OK.

Renaming pages on the web

By default, pages published to the Web are called Page n through Page nn. To specify unique names for individual pages and to set the page caption, use the following procedure.

1. Create the template you want to use in Visualizer.
2. Select Window > Page Select > All Pages.
3. Select the first page.
4. Select Edit > Title/Subtitle/Colors.
   When the Title/Subtitle /Colors dialog box is displayed, enter the Title name and click OK.
5. Repeat Step 3 through Step 5 for each page.
6. Select Window > Close Windows.
7. Select Window > Page Select > All Pages.
8. Select File > Save Template As.
9. Enter a unique name for the template and click OK.

Publishing data tables to the web

You can publish data tables (derived from a graph) to the Web. You can derive a data table from any graph associated with the Graphics Options dialog box or Hierarchy dialog box. These graphs include bar, line, pie, area, and checkerboard.

To successfully publish a data table to the Web, satisfy the following criteria:

The graph must support the Show Table command from the Edit menu. If the option is dimmed, you cannot publish a data table to the Web.

You must attach a note to the graph or project that includes the following explicit statement, exactly as it's shown below.

1. Draw the graph that you want to use as a base for generating the table data.

2. Select Edit > View/Edit Note.
   Within the note itself, type the following, exactly as shown:

   (show table)
3. Select Windows > Close Note.
4. Select Windows > Close Windows.
5. Select File > Export (as .htm) and click OK.

When you export or publish a graph or project to the Web, you'll see a Table button above each graph that can display data tables.

Accessing the published web pages

There are two ways to access published Web pages.

• Double-click the <filename>.htm page from Windows Explorer.
• Specify the http address in your Web browser. 

Navigating published web pages

The converted, published Web pages are generated from HTML templates you can modify (see Editing-HTML-templates). The right side of the page is blank (not counting the watermark company logo on the background) when it's displayed. The left column contains a company color logo at the top, the title of the page or project, an index, and copyright information. The following figure shows a sample page.

To display the graphs, select pages from the index on the left. In the window on the right, you see PNG thumbnails of the graph. Double-click a graph to see it full-size. 

Once the graphs are published, you can manipulate them in the same way as you manipulate other HTML-formatted files.

Controlling how graphs are displayed on the web

Pages, by default, are published in a 1024 by 768 format. There are two ways to control the display of graphs on the Web.

• By customizing your page layout
• By overriding the .htt file

To alter the display size of graphs through custom page layout,

1. Put the graph on a custom page (see Selecting graph page layouts), position and size the graph.
2. Select a page layout other than One Per Page (which defaults to 1024 by 768).
   For example, saving graphs to a 2 by 4 page layout produces eight 345 by 198 files (<graphname>01, <graphname>02... <graphname>08).

To alter the display size of graphs by overriding the .htt file, use the following procedure:

1. Open the pergraph.htt file from the Visualizer directory.

2. Specify the size you want. For example, to specify a 6 by 8 inch graph, you would enter the following code before the second line of the file:

   <Visual/XinY=6.00><Visual/XinX=8.00>

   The first few lines of the file would look like the following:

   <Visual /Cols=?>
   <Visual /XinY=6.00><Visual /XinX=8.00>
   <td>
   <SCRIPT LANGUAGE=JavaScript>
   fname='<Visual / GREF>'
3. Save the pergraph.htt file.

Web publishing error detection

Visualizer uses a Windows API call to get error messages returned from Web Publishing. The error messages are written to the Automator running log file. The error messages do not stop or hang an Automator script run.

Messages for WMFPost may include extended information describing why the WebPost process failed. For example:

• No connection could be established to the Web server
• An invalid password was supplied to the Web server
• An invalid user name was passed to the Web server

Extended information may not be available depending on where the error occurred in the process. In these cases, the error message will be less descriptive. For example:

• No extended information - An error occurred during Web Publishing but there is no additional information available about the error
• Lost extended information - An error occurred during Web Publishing but the additional information has been lost
• No WebPost Wizard entry for tagname - An error occurred during Web Publishing for the specific tagname

The error detection information is available when added to the Automator running log when using -g or /g in the command line. Trace is off by default in Visualizer. It is on by default for TrueSight Capacity Optimization Manager effective with version 7.1.01.

If errors are logged to the keystroke trace file while converting or publishing graphs to the web, the projectname_err.log file is deleted and the keystroke trace file describes the location of the retained files. Go to the retained files for more information.