Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

A number of component settings are available for each layout component of an invoice/credit note or payslip format to allow the size, position, formatting and other characteristic of the component to be defined and edited.
The component settings can be viewed and modified by clicking on a component within the components list in the Component List and Property Grid pane or by clicking on the component on the layout, as highlighted in the example below.
Image Removed
Once the relevant component is selected, click Component Settings within the Component List and Property Grid pane to display the component settings for the component you have selected, as shown in the example below.
Image Removed
The table below lists and describes the settings that are available for each type of component.

...

Setting

...

Applies to which Component Types?

...

Sub Setting

...

Description

...

Options Available

...

Display

...

All

...

Location X

...

Defines the X coordinate that specifies the position of the component.

...

A numeric value can be keyed in.

...

 

...

 

...

Location Y

...

Defines the Y coordinate that specifies the position of the component.

...

A numeric value can be keyed in.

...

 

...

 

...

Width

...

Defines the width of the component, in millimetres.

...

A numeric value can be keyed in.

...

 

...

 

...

Height

...

Defines the width of the component, in millimetres.

...

A numeric value can be keyed in.

...

 

...

 

...

Display Option

...

Where a payslip is printed over multiple pages, this setting determines if the component appears on each page, on the last page only or on all pages except the last page.

Picklist containing the following options:

...

Border

...

All except the following:
Logo Remittance Line

...

Border Line Colour

...

Colour of the border that displays around the component.

...

List of system-defined colours.

...

 

...

 

...

Border Line Style

...

Style of the line used to render the border around the component.

...

List of the following system-defined options:
None Dash DashDot
DashDotDot Dot
Solid

...

 

...

 

...

Border Line Thickness

...

Thickness of the lined used to render the border around the component.

...

List of the following system-defined options:
Thinnest Thinner Thin Thick Thicker Thickest

...

 

...

 

...

Show Border

...

Determines if a border is displayed around the component.

...

Checkbox

...

Header

...

All except the following:
Logo Remittance Line

...

Header Size

...

Defines the height of the header on the component, in millimetres. For example, where a component is a table of items, the header contains the column headings.

...

A numeric value can be keyed in.

...

 

...

 

...

Show Header

...

Determines if the component displays a header.

...

Checkbox

...

Labels

...

Heading

...

Tax Invoice/Payslip Label

...

Text that is to be displayed at the top of an invoice/credit note (for example: Tax Invoice).

...

A string of text can be keyed in.

...

Rows/Columns

...

All except the following:
Logo Remittance Line

...

Edit Columns

...

Displays the Document Designer Table Properties screen, thereby allowing a list of items to be added to the component.
For more information, see Table Properties.

...

Button

...

 

...

Invoice Items

...

Display Rounding Line

...

This option is available in v11.22 onwards.
If selected, a rounding difference line is displayed at the bottom of the Invoice Items table. If a column in the table is configured to display a total within the Invoice Totals component, the rounding line shows the rounding differenc e between the sum of the values in the column and the corresponding total shown within the Invoice Totals component.

...

 

...

 

...

 

...

Rounding Line Label

...

Literal text that is to appear as a label against the rounding line.
This field is available only if the Display Rounding Line op tion is enabled.

...

A string of text can be keyed in.

...

 

...

Sub-group Totals

...

Invoice Items

...

Include a Sub Totals Row

...

If selected, sub-totals will be displayed within the following columns of Invoice Items table, if they are included in the document format:
Quantity Pay Total Margin Oncosts Tax
Total Charge

...

Checkbox - defaults
to the deselected state.

...

 

...

 

...

 

...

Group Sub Totals By

...

Determines how invoice/credit items are to be sub-totalled.
For example, if the Item Date option is selected, a sub-total will be displayed for all invoice/credit items that have the same item date.

...

Picklist

...

 

...

Image

...

Logo

...

Image

...

Displays the filename of the image displayed within the component.

...

Displayed by the system.

...

 

...

 

...

 

...

Add

...

Allows the user to browse to a file location where the required image file is located.

...

Button

...

 

...

 

...

 

...

Use Pay Company Logo

...

If selected, sets the image file stored against the Payslip Logo field on Pay Company record as the image displayed with in the component.

...

Checkbox – defaults to deselected state.

...

 

...

Line

...

Remittance Line

...

Line Colour

...

Sets the colour of the line component.

...

List of system-defined colours.

...

 

...

 

...

 

...

Line Style

...

Sets the type of line for the selected component

...

Picklist displays the options of:
None Dash DashDot
Dash Dot Dot Dot
Solid (default)

...

 

...

 

...

 

...

Line Thickness

...

Sets the thickness of the line component.

...

List that displays the options of:
Thinnest (default) Thinner
Thin Thick Thicker Thickest

...

 

...

 

...

 

...

Orientation

...

Sets the orientation of the line.

...

List that displays the options of:
Vertical
Horizontal (default)

...

 

...

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.
Image Removed
Table properties are available for each component of a layout that is based on a table. The table 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 properties are viewed and modified via the Document Format Table Properties screen. To display the Document Format Table Properties screen, in the Component List and Property Grid pane, select Component Settings > Rows/Columns and click I as shown in the example below.
Image Removed
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

...

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.

...

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

...

A number of component settings are available for each layout component of an invoice/credit note or payslip format to allow the size, position, formatting and other characteristic of the component to be defined and edited.

The component settings can be viewed and modified by clicking on a component within the components list in the Component List and Property Grid pane or by clicking on the component on the layout, as highlighted in the example below. Note: the right hand Property panel is collapsed in this screen shot.

...

Once the relevant component is selected, the Property panel on the right displays the component settings for the component you have selected, as shown in the example below.

...

The table below lists and describes the settings that are available for each type of component.

Setting

Applies to which Component Types?

Sub Setting

Description

Options Available

Display





All





Location X

Defines the X coordinate that specifies the position of the component.

A numeric value can be keyed in.

Location Y

Defines the Y coordinate that specifies the position of the component.

A numeric value can be keyed in.

Width

Defines the width of the component, in millimetres.

A numeric value can be keyed in.

Height

Defines the width of the component, in millimetres.

A numeric value can be keyed in.

Display Option

Where a payslip is printed over multiple pages, this setting determines if the component appears on each page, on the last page only or on all pages except the last page.

Picklist containing the following options:

  • Show On All Pages (default)

  • Show On Last Page Only

  • Don't Show On Last Page

Is unavailable for the following layout components:

  • Payslip Items/Allowances

  • Deductions

  • Payslip Leave Balance

  • Payslip Super

Border




All except the following:

  • Logo

  • Remittance Line




Border Line Colour

Colour of the border that displays around the component.

List of system-defined colours.

Border Line Style

Style of the line used to render the border around the component.

List of the following system-defined options:

  • None

  • Dash

  • DashDot

  • DashDotDot

  • Dot

  • Solid

Border Line Thickness

Thickness of the lined used to render the border around the component.

List of the following system-defined options:

  • Thinnest

  • Thinner

  • Thin Thick

  • Thicker

  • Thickest

Show Border

Determines if a border is displayed around the component.

Checkbox

Header


All except the following:

  • Logo

  • Remittance Line


Header Size

Defines the height of the header on the component, in millimetres. For example, where a component is a table of items, the header contains the column headings.

A numeric value can be keyed in.

Show Header

Determines if the component displays a header.

Checkbox

Labels

Heading

Tax Invoice/Payslip Label

Text that is to be displayed at the top of an invoice/credit note (for example: Tax Invoice).

A string of text can be keyed in.

Rows/Columns

All except the following:

  • Logo

  • Remittance Line

Edit Columns

Displays the Document Designer Table Properties screen, thereby allowing a list of items to be added to the component.
For more information, see Table Properties.

Button


Invoice Items

Display Rounding Line

If selected, a rounding difference line is displayed at the bottom of the Invoice Items table. If a column in the table is configured to display a total within the Invoice Totals component, the rounding line shows the rounding differenc e between the sum of the values in the column and the corresponding total shown within the Invoice Totals component.


Checkbox - defaults
to the deselected state.



Rounding Line Label

Literal text that is to appear as a label against the rounding line.
This field is available only if the Display Rounding Line op tion is enabled.

A string of text can be keyed in.

Sub-group Totals


Invoice Items


Include a Sub Totals Row

If selected, sub-totals will be displayed within the following columns of Invoice Items table, if they are included in the document format:
Quantity Pay Total Margin Oncosts Tax
Total Charge

Checkbox - defaults
to the deselected state.

Group Sub Totals By

Determines how invoice/credit items are to be sub-totalled.
For example, if the Item Date option is selected, a sub-total will be displayed for all invoice/credit items that have the same item date.

Picklist

Image



Logo



Image

Displays the filename of the image displayed within the component.

Displayed by the system.

Add

Allows the user to browse to a file location where the required image file is located.

Button

Use Pay Company Logo

If selected, sets the image file stored against the Payslip Logo field on Pay Company record as the image displayed with in the component.

Checkbox – defaults to deselected state.

Line




Remittance Line




Line Colour

Sets the colour of the line component.

List of system-defined colours.

Line Style

Sets the type of line for the selected component

Picklist displays the options of:

  • None

  • Dash

  • DashDot

  • Dash Dot Dot

  • Dot

  • Solid (default)

Line Thickness

Sets the thickness of the line component.

List that displays the options of:

  • Thinnest (default)

  • Thinner

  • Thin

  • Thick

  • Thicker

  • Thickest

Orientation

Sets the orientation of the line.

List that displays the options of:

  • Vertical

  • Horizontal (default)