Export HTML
The HTML Export command tells the Frontline software to invoke the Frame Display. It then automatically selects the HTML Export menu option. Using the Export HTML command parameters, the user can choose whether to include the summary pane information, data bytes, and frame range. Also, the user only has to specify a name for the saved HTML file. The saved html file is always written to the default directory which is: \\documents and settings\all users\documents\frontline test equipment\my log files.
If you enter a file name with an invalid character “\/:*?<>”, then the system automatically generates a file name using:
$(FrameDisplayPrint-<process id>-<counter>).htm
The following is an example of the command string for this command. If no frame range is specified, all frames will be exported.
HTML Export;Summary=<1 | 0>;Data Bytes=<1 | 0>;Decode=<1|0>;Frame Range Upper=30000;Frame Range Lower=1;File=htmlexport1.htm
There are several important ideas to remember about HTML Export.
- Be aware that this can cause the Frontline software to spend considerable time generating the html file.
- The Frame Display window remains open once the export is complete.
- The frame range is a positive number followed by a hyphen, followed by another positive number greater or equal to the first positive number.
- If no html file is specified, a default one will be generated and saved in the log file directory created during installation of the Frontline software.
- If an html file is specified, then this file is created and saved in the log file directory created during installation of the Frontline software.
- If no summary is specified, summary information will not be included by default.
- If no data bytes are specified, data bytes will be included by default. Decode will always be included if Data Bytes are included.
- All layers for each frame will be exported. The user cannot select the layers.
- If the capture file is empty, no html is generated and an error is reported.
- If the range selected is outside the current range of processed frames, no html is generated and the last process frame is included in the reason.
- If all frames need to be exported, then select some unknown large number for the upper range.
Parameter | Default Values |
---|---|
Summary |
0 |
Data Bytes |
1 |
Decode |
Data Bytes Value |
An error can occur if there are no frames to export. If a failure occurs, a failure notification response is sent. The form for the failure notification response is the following.
HTML Export;FAILED;Timestamp=10:43:00,10/05/2006;Reason=Some Reason
A successful attempt to export returns a successful notification response. The form for the successful notification response is the following.
HTML Export;SUCCEEDED;Timestamp=5/18/2007 10:44:00 AM