|Navigation: Templates > Templates by Topic > Advanced Report Generation > Report to HTML Support Extension >====== Report to HTML Procedure Support ======|
The Report to HTML Procedure template provides exact control as to when to use the output document format, global overrides of selected string settings, and report controls that need to be hidden or skipped when this output format is enabled.
The following options are provided (and only available if the associated Global Extension is active):
Populate on Report
The Report to HTML Global Extension populates this template in all reports by default. Select Never if you do not want this report to be directed to an HTML document. Select Always if you want to have this capability available always for this report at runtime. Select Conditional if you need to make this output available based on a certain condition, specified in the next prompt.
This prompt is available if you have specified Conditional in the Populate on Report prompt above. A condition can be a simple variable or an expression. If the variable or expression evaluates to non-zero, the HTML document output capability will be active for this report at runtime.
Press the “E” button to call the Expression Editor. This dialog is used to help you construct syntactically correct expressions to use in the Condition prompt.
General Tab Options
Output Name Type
If you have directed that the report print to an HTML document file, specify a Fixed, Variable or Runtime name here. Fixed will use a default name, and add page numbers and other extensions as discussed on the tab control. Variable can be used to designate a fixed name based on a variable condition at runtime, like a date, user name, order number, etc. Use the Fixed or Variable option if you do not plan to have a print preview, and wish to generate the reports directly to HTML.
Runtime allows the end user to specify a custom name and optional folder to direct the HTML document to.
When a report is generated, HTML pages are generated based on the number of pages generated by the report. Hyperlinks to first page, next page, last page, etc. are automatically included. By added a deployment module to your program (i.e., FTP transfer), you now have a way to display all of your Clarion reports as dynamic web pages to your users.
The following prompts allow you to add additional HTML text to your generated output:
Enter string text or variable here that will appear on the title bar of your HTML pages. The default text is 'Clarion Report'.
Override Global String Settings
A series of HTML text values are available in the HTML to Report Global Extension for all of your reports. If you need to change specific values for a single report, check this box to enable the HTML String Settings button. Press this button to modify the global settings.
Local HTML String Settings
This dialog duplicates the settings available in the HTML Global String Settings dialog. Enter new text if needed here to override the global settings.
Controls Tab Options
The Controls tab displays a list box of every report control's Field equate label that is populated on the report structure. A Field equate label (FEQ) can represent text displayed on the generated report output, but can also identify report logic for Headers, Footers, Detail Bands, Form Bands, and Break structures. Select a control in the list box, and press the Properties button to modify a report's target FEQ.
Report Control's HTML Properties
HIDE (Omit printing)
If a report's FEQ targets a field used specifically for special documents generation (i.e., Hyperlinks, Bookmarks, etc.), check this box to hide (omit) this FEQ from the report's printed output.
SKIP (Omit processing)
A report's contents can be redirected to multiple types of output documents when using the new Advanced Report Generation templates. Check this box to designate that the selected FEQ will not be used for this type of generated document output (e.g., HTML). For example, you would want to skip a control used to generate a special XML tag when generating to HTML.
This prompt is only active if you are not SKIPing the control. For each of the report's FEQs that are active, select None from the drop list to designate that the HTML output is plain text information (e.g., the HTML generator will not generate special tag information for this control).
Select Control Text to allow the HTML generator to create a hyperlink for this control into the output document. For example, you may have a control in your data table that stores hyperlinks to customer's websites. As the control is generated to HTML, the column's text (i.e. 'http://www.softvelocity.com') will be hypertext.
Select HardCoded from the drop list, and press the ellipsis button to select a variable that holds HTML specific information that will be assigned to a report's FEQ that is static (always generated). By contrast, select Dynamic from the drop list, and press the ellipsis button to select a variable that holds HTML specific information that will be assigned to a report's FEQ that is conditionally generated. A example of this could be a Detail band that is conditionally generated based on a table column's value. The target variable may hold special HTML tag information that displays color, text, formatting, etc.
This prompt is used to seed the proper hyperlink syntax to the Target Origin.
HTTP Adds “HTTP:” text in front of the selected Target Origin. MAIL Adds “mailto:” text in front of the selected Target Origin. FTP Adds “FTP:” text in front of the selected Target Origin.
NEWS Adds “news:” text in front of the selected Target Origin.
Other An additional prompt, Other Type appears with this choice. Enter anything into the Other Type prompt. This choice is used if you need to add any custom hyperlink that's not included above to your Target Origin.
An additional prompt, Other Type, appears with this choice. Press the ellipsis button to select a variable that will hold the custom hyperlink type information. This choice is used if you need to add any dynamically changing or conditional hyperlink that's not included above to your Target Origin.
None ' Adds no additional text to the Target Origin