##### Define > Fields > Field Properties

# Table Tab

The Table tab can only be accessed if the Table field type is selected. When you select the Table tab, the Field Properties dialog box opens. The Field Properties dialog box provides the following options:

## Maximum Number of Rows to Display at One Time

This setting indicates the maximum number of rows that Genesys Agent Scripting should display on the script page in the browser. If the number of rows in the table exceeds this number, Genesys Agent Scripting will automatically add First, Previous x, Next x, and Last buttons to the script page where x is equal to the display rows.

### Display Table as Drop-Down List

When this option is selected, the table is displayed as a drop-down list containing the column headings. When the user selects, that column will be displayed on the page.

### Allow Multiple Table Rows to be Selected at One Time

You can use this option to indicate that multiple rows in a table can be selected at one time. By default, Genesys Agent Scripting tables are displayed with a radio type button in the first column of each row so a user can select that row. When this option is selected, the radio buttons are replaced with check boxes so the user can select more than one row at a time.

#### Only If This Field Is True

This field becomes active if the Allow Multiple Table Rows to be Selected at One Time field is selected. This item allows you to set a condition on whether or not multiple rows in a table can be selected. Only check box fields will appear in this list.

### Filter Field

Select a Filter field to be used to evaluate each row in the table. If the field’s filter column’s value matches the filter field’s value, the row will be displayed; otherwise the row will be hidden.

### Filter Column

Selects the column within the table whose value will be matched against the filter field’s value to determine if the row will be displayed.

#### Automatically Update Rows

The Automatically Update Rows check box is used to indicate if table values should automatically be updated. A table is a collection of Genesys Agent Scripting fields. If auto update is activated, values in fields are automatically copied to rows in a Genesys Agent Scripting table. If auto update is not activated, you must press a button to have changes copied into a row in a table.

#### Branch on Row Change

When this option is checked, Genesys Agent Scripting will automatically generate a branch when a row in the table is selected.

#### Retain Deleted Rows

If this option is selected, when a delete row command is issued, the row will be marked for deletion and hidden from the user. The row will not actually be removed from the table. If this option is not selected, a delete row command will cause the row to be removed from the table.

#### Hide Table Heading

If this box is selected, the heading for the table will not appear on the window at runtime.

#### Hide Column Heading

If this box is selected, the heading for all columns in the table will not appear on the screen at runtime.

## Associate Fields

Clicking this button opens the Associate Fields dialog box. Use this dialog box to associate previously-defined fields with this table.

This screen displays the table in a tree structure and allows you to maintain the current table as well as any sub-tables. Fields can be dragged and dropped onto the table, and reordered. The available field list is managed to ensure that the same field is not added to the structure twice. Changes to the attributes are automatically saved.

Each of the options on the table is described below.

## Table Tree

This window displays the fields that belong to the table. The fields are displayed in a tree structure and can be reordered by dragging and dropping. The columns appear in the table from left to right in the same order that the fields appear in the tree, from top to bottom.

## Add Field

Click this button to add the selected field to the table.

## Remove Field

Click this button to remove the selected field from the table.

## Available Field List

This list contains all of the fields that can be added to the table. Once a field has been added to the table, it will be removed from this list since fields cannot appear twice in the same table.

The Available Field List can be filtered to show all fields or only those that belong to a specific group. In order to filter the fields, select a group from the drop-down list.

### Heading

The heading is a text field to be displayed as a column heading in the table.

### Hidden

Selecting this check box hides the values of the field so that the user cannot see them when this table is displayed. This option is helpful if you need to include a field in a table but do not wish to display its values on the window.

## Child Table Display Column

If the field you have selected to add to the current table (table 1) is another table (table 2), you can select a column from table 2 to display in a column for table 1.