Report Designer/Form

Form is a built-in type of report part that allows WYSIWYG editting in HTML. User can:

  • Interactively design the form using icons on the toolbar, with muli-level Undo and Redo.

  • Add dynamic content using smart tags.

  • Add recurring content using innovative repeater tags, see Repeater Smart Tag.

  • Leverage existing report parts by embedding them into the form.

  • Edit the form in HTML format (for experienced users).

../_images/Form_Properties_Sections.png

Fig. 227 Form - Properties Sections

Form properties are grouped into several sections:

  • Form

  • Edit

  • Insert

  • Format

  • Table

  • Tool

  • View

  • Printing

Configure General Form Properties

General Form properties can be configured in Form section:

  • ../_images/Form_Border_Settings.png

    Fig. 228 Form - Border Settings

    Form border

    1. Click the gear icon (⚙) to open Form Border Settings pop-up.

    2. Choose the border to be visible or not.

    3. Select a border color.

    4. Select the border thickness (in pixels).

    5. Click OK to close the Form Border Settings pop-up.

    Note

    The Preview section will not be shown (as image below) if the Show Preview section in Configuration Mode checkbox is unticked in Others tab in Advanced Settings.

    ../_images/Form_Border_Settings_No_Review.PNG

    Report Designer - Gauge Border Settings without Preview section

    Please see Update Others Settings for more details.

  • Form background color

    1. Click the color icon to open the color palete.

    2. Choose a color from the color palete.

    3. Click OK to close the pop-up and apply the selected color.

Edit Section

Click inside the text area in Visual mode to see all the toolbar icons.

  • Copy, Cut and Paste:

    Highlight one or multiple items then click Copy or Cut, then Paste into another place. Paste as Text will remove all formatting from the items. (This feature is still in progress.)

  • Find and Replace text values while preserving the formatting.

  • Muli-level Undo and Redo.

Insert Items in Visual mode

Many items can be quickly and interactively inserted using the icons in visual mode:

  • ../_images/Form_Insert_Link_Pop-up.png

    Fig. 229 Form - Insert Link

    Link

    The link is displayed as Form Link Display.png.

  • ../_images/Form_Insert_Image_Pop-up.png

    Fig. 230 Form - Insert Image

    Image

  • Anchor

  • Special character

  • Current date value

  • Horizontal line

  • Page break

  • Template break

  • ../_images/Form_Insert_Field.png

    Fig. 231 Form - Insert Data Source Field

    Data Source Field

  • Smart Tag. This is a dynamic content that will be updated on display:

    • Date Time - it will show the date value at the time of display (compared with “Insert date/time value” button that populates the fixed date value at the time of editing).

    • Subtotal - it will show the sub total value for a field being used in the form.

    • Grand Total - it will show the grand total value for a field being used in the form.

  • Embedded Report Settings - To be updated.

Format Items in Visual mode

Formatting can also be quickly applied using the icons in visual mode:

  • Heading styles

  • Grouping HTML tags <p>, <blockquote>, <div> and <pre>.

    • <p> is used for a paragraph;

    • <blockquote> is used to quote content from another source, usually with a <cite> tag containing the reference.

    • <pre> is used for preformatted content, which would be displayed differently without the tag.

    • <div> is used to group items together for easy organization and formatting.

  • Font face and font size.

  • Text effects bold, italic, underlined and struck through.

  • Text effects superscript, subscript, and computer code style <code> (displayed in a monospaced font by default).

  • Font color and background color.

  • Text alignment.

  • Bulleted and numbered list styles.

  • Indent space.

  • Clear Formatting

Design a Table in Visual mode

  1. ../_images/Form_Table_Insert.png

    Fig. 232 Form - Insert Table

    Click the Insert Table icon in Table section, then interactively select the number of columns and rows.

  2. ../_images/Form_Table_Properties_Icons.png

    Fig. 233 Form - Table Properties

    Click inside the table in Visual mode to see more icons in Table section, divided into Table, Cell, Row and Column groups.

  3. Configure table-wide settings in Table Properties pop-up.

    ../_images/Form_Table_General_Properties.png

    Fig. 234 Form - Table General Properties

    ../_images/Form_Table_Advanced_Properties.png

    Fig. 235 Form - Table Advanced Properties

  4. ../_images/Form_Table_Cell_General_Properties.png

    Fig. 236 Form - Table Cell General Properties

    ../_images/Form_Table_Cell_Advanced_Properties.png

    Fig. 237 Form - Table Cell Advanced Properties

    Configure each cell in Cell Properties pop-up.

  5. ../_images/Form_Table_Row_Properties.png

    Fig. 238 Form - Table Row Properties

    Configure each row in Row Properties pop-up.

Note

../_images/Form_Table_Floating_Toolbar.png

Fig. 239 Form - Table Floating Toolbar

The floating toolbar contains quick access icons for table properties and quickly adding and removing columns and rows.

Tool Section

  • Directionality supports formatting right-to-left languages with the Right to Left icon.

Editing Preferences in View Section

Editing preferences can be configured in View section:

  • Show invisible characters.

  • Show Visual Aids.

  • Show the form in fullscreen mode.

  • Edit Data Refresh Interval settings.

  • Use Pagination

Printing Section

  • Tick “Page Break After Each Entry” checkbox to print each data object in a separate page.

Right-click Menu

../_images/Report_Form_Spell_Checker.png

Fig. 240 Form - Spell Checker

Most-commonly-used actions are already incorporated into the right-click menu:

  • Link

  • Image

  • Table, cell, row and column actions

  • Spell Checker for selected text - this is only available on a selected block of text.

Edit in HTML format

In HTML tab:

  • User can edit the raw HTML code and see the changes reflected in Visual mode or Preview mode.

  • User can use the now visible HTML group in Properties box.

    • Tick the Wrap Text checkbox to make long lines of code span multiple lines.

    • Tick the Highlight Code checkbox to enable syntax highlighting for HTML tags.

    • Click the Reformat button to beautify the code.

    ../_images/Report_Form_HTML_tab.png

    Fig. 241 Form - HTML Properties

Repeater Smart Tag

The Repeater smart tag allows repeating form content to dynamically display data. That content will be repeated for each unique set of values of the data.

For example, the Repeater smart tag can be used to display Freight amount for each ShipCity in each ShipCountry, in a format totally customizable by the report designer.

../_images/Form_ShipCountry_Repeater_ShipCity_SumFreight_Preview.png

Fig. 242 Form - Sample Repeater Result

To repeat a specific form content:

    • Either select the content then click Repeater > Add in Insert group in Report Part Properties panel

    • Or wrap the content by <repeater> and </repeater> tags in HTML view

  1. Make sure that the field values outside of Repeater tags are either unique or grouped.
    (In this example ShipCountry field has “Group” as Function in Data Formatting)

The selected content will be highlighted in Visual view.

../_images/Form_ShipCountry_Repeater_ShipCity_SumFreight_Visual.png

Fig. 243 Form - Repeater Indicator in Visual view

Steps for this specific sample:

  1. Type “In country ” then add field ShipCountry, select “Group” as Function in Data Formatting then enter.

  2. Type “In city ” then add field ShipCity then select “Group” as Function in Data Formatting.

  3. Select both lines then choose Bullet List in Format group in Report Part Properties panel.

  4. Click anywhere in the second line and choose Increase Indent in Format group in Report Part Properties panel.

  5. Switch to HTML view to easily enter <repeater> and </repeater> tags in correct position.

    Also add one more <br /> tag to make the view prettier.

    ../_images/Form_ShipCountry_Repeater_ShipCity_SumFreight_HTML.png

    Fig. 244 Form - Repeater tags in HTML view

Analytics Center supports the form report part containing subtotal inside repeater(s).

For example:

../_images/Form_Subtotal_Inside_Repeater_Designer.png

Fig. 245 Form - Subtotal inside repeaters - Configuration

../_images/Form_Subtotal_Inside_Repeater_View.png

Fig. 246 Form - Subtotal inside repeaters - Preview

Notes: Subtotals are not supported for parallel repeaters, only nested repeater structures.