| **Navigation:**  [[templates.htm|Templates]] > [[templates by topic.htm|Templates by Topic]] > Advanced Report Generation > Report to HTML Support Extension >====== Report to HTML Procedure Support ====== | [[tplextensionglobalreporttohtmlstringsettings.htm|{{btn_prev_n.gif|Previous page}}]][[templates by topic.htm|{{btn_home_n.gif|Return to chapter overview}}]][[tplextensionglobalreporttopdf.htm|{{btn_next_n.gif|Next page}}]] |
|  ||

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.

**Condition**

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.

**HTML Options**

The following prompts allow you to add additional HTML text to your generated output:

**Document Name**

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 [[tplextensionglobalreporttohtml.htm|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 [[tplextensionglobalreporttohtmlstringsettings.htm|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.

**Target Origin**

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.

**Hyperlink Type**

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**.

//Other Dynamic//

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**