Table Components

Layout components that are part of a document format, with the exception of Logo and Remittance Line components, are essentially tables consisting of a number of cells. Each cell may contain the following:

a text label such as a column header or any other literal text
a data item (database field) or a group of data items that display values stored in the database.

The example below shows invoice items that have been formatted into a table format. In this example the table has been formatted to display column headers, where the text displayed inside each column header is literal text. The values within each subsequent row of the table are populated with data items.

Table / Field properties are available for each component of a layout that is based on a table. The properties define attributes such as the following:

the contents of each cell (e.g. literal text or data items)
formatting of the cell contents (e.g. font face, font size, font colours, background colours, text wrapping)
display of grid lines.

Table / Field properties are viewed and modified via the Document Format Properties screen. When you click an invoice component, in the far right panel the related Properties screen displays. In the example below the user has clicked on the Billing Details - Header Component, and on the right the Properties for this item are available for editing (the Rows/Columns section is expanded in this example).

To manage the Field Properties, click on the view button next to the item, in the example below the user has selected the ‘Site Contact’ item.

The table below lists and describes the options available on the Document Format Table Properties screen for managing the table properties of a layout component.

Field	Description

Field	Description
Item List	Lists the literal text labels and data items that appear in the table.
Name	Name of the text label or data item.
Format
Order By	If the item selected in the item list represents a column header (column header text), this field allows the sort order of the column to be defined. For example, if set to Order By 1 the values displayed within the corresponding column will form the primary sorting criteria for items listed in the table. This option is available only for the Invoice Items component for invoice formats only and lists the following options: None Order By 1 Order By 2 Order By 3 Order By 4
Supress When Duplicated	If ticked, the item is displayed once the first time it occurs within the table and is not repeated against each row to which it corresponds.
Visible	If ticked, the selected item is visible when a document based on this format is generated.
Height	Specifies the height, in millimetres, of the table cell within which the item is displayed.
Wrap Text	If ticked, the text within the cell in which the item is displayed wraps onto the next line if it does not fit within the width of the cell. Otherwise, text may extend passed the boundary of the cell.
Grid
Grid Line Colour	Determines the colour of the grid lines that define the boundaries of the cell in which the item appears.
Grid Line Style	Determines the type of lines used for the grid lines that define the boundaries of the cell in which the item appears. Lists the following options: None Dash DashDot Dash Dot Dot Dot Solid (default)
Grid Line Thickness	Determines the thickness of the grid lines that define the boundaries of the cell in which the item appears. Lists the following options: Thinnest (default) Thinner Thin Thick Thicker Thickest
Show Grid Lines Bottom	If ticked, a grid line is displayed along the bottom edge of the cell in which the item appears.
Show Grid Lines Left	If ticked, a grid line is displayed along the left edge of the cell in which the item appears.
Show Grid Lines Right	If ticked, a grid line is displayed along the right edge of the cell in which the item appears.
Show Grid Lines Top	If ticked, a grid line is displayed along the top edge of the cell in which the item appears.
Show Header Grid Line	If ticked, a grid line is displayed between the cell in which the item appears and the header of the table.
Header – options in this section allow an item to be displayed as a label within the header of the table
Header Text	Defines the literal text that appears in the column header. Can be blank if the item is a field value that is to be displayed within the component instead of a label that is to appear within the header of a table.
Text Colour	Determines the colour in which the header text is to be displayed.
Font	Determines the font face and font size in which the header text is to be displayed.
Horizontal Text Alignment	Determines the horizontal alignment of the header text within the cell. Lists the following options: None Right Centre Left
Vertical Text Alignment	Determines how the vertical alignment of the header text within the cell. Lists the following system-defined options: None Top Centre Bottom
Background Colour	Determines the background colour of the cell.
Padding Bottom	Defines the amount of whitespace, in millimetres, between the header text and the bottom edge of the cell in which it appears.
Padding Left	Defines the amount of whitespace, in millimetres between the header text and the left edge of the cell in which it appears.
Padding Right	Defines the amount of whitespace, in millimetres, between the header text and the right edge of the cell in which it appears.
Padding Top	Defines the amount of whitespace, in millimetres, between the header text and the top edge of the cell in which it appears.
Item – options in this section determine the data item(s) (data base fields) that display inside a table cell
Database Field	Displays the database field name of the data item that is displayed inside the cell. You can click a button to launch the Document Designer Data Items screen, which allows you to select a database field or a group of database fields that are to be displayed for the selected item within the layout component. Within this pop up the Text Before and Text After fields can be used to insert text before the inserted database field, and/or after the inserted database field.
Text Colour	Defines the colour of the text in which the data item is displayed within the cell.
Font	Defines the font face and font size used to display the data item within the cell.
Horizontal Text Alignment	Defines the horizontal alignment of the data item text within the cell. Lists the following options: None Right Centre Left
Vertical Text Alignment	Defines the vertical alignment of the data item text within the cell. Lists the following options: None Top Centre Bottom
Background Colour	Defines the background colour of the data item within the cell.
Padding Bottom	Defines the amount of whitespace, in millimetres, between the data item text and the bottom edge of the cell in which it appears.
Padding Left	Defines the amount of whitespace, in millimetres, between the data item text and the left edge of the cell in which it appears.
Padding Right	Defines the amount of whitespace, in millimetres, between the data item text and the right edge of the cell in which it appears.
Padding Top	Defines the amount of whitespace, in millimetres, between the data item text and the top edge of the cell in which it appears.

FastTrack360 Online Help

Table Components

Related pages