Technology Preview

Table control

This control creates a table in which you can organize the presentation of content to the user. Each element that you add to the table creates a column. The column label is taken from the label for the element in that column.

Data binding

Set the data binding for the control in the General properties tab.
Table 1. Table control data binding
Binding description Data type
Contains a list of business objects of any type ANY (List)

Configuration properties

Set or modify control configuration in the Configuration properties tab.

Configuration properties that have the screen sizes icon can have different values for each screen size. If you do not set a value, the screen size inherits the value of the next larger screen size as its default value. If you are using the Process Designer desktop editor, you are setting the value for the large screen size. The other screen sizes inherit this value.

Table 2. Table control configuration properties
Configuration property Description Data type
Columns that are always editable List columns that are always editable regardless of Edit mode settings. Separate column numbers with a comma. For example, 1,3 makes the cells in the first and third columns always editable. String
Edit mode
Specify the table-wide editing behavior. Settings include:
  • Click cell to edit - Users click in a cell to edit contents. This is the default setting.
  • Show edit mode toggle - Users click a button to turn editing on and off for the table.
  • Always editable - All cells in the table are always editable.
String
Hide columns screen sizes icon List the columns to hide. Separate column numbers with a comma. For example, 1,3 hides the first and third columns. String
Hide columns selectorscreen sizes icon Select this option to hide the link that allows users to show or hide specific columns.

By default, this option is not selected (False).

Boolean
Column widthsscreen sizes icon Set the width of each column using a comma-separated list of integers. By default, all columns are the same width. String
Column width unit Specify the unit of measure for the Column widths values. Supported units include:
  • % - percentage of viewport (Default)
  • in - inches
  • cm - centimeters
  • mm - millimeters
  • em - width of letter 'm' in current font.
  • ex - the x-height of the font, which is approximately the height of lowercase letters a, c, m, or o in that font
  • pc- pica (12 points)
  • pt - point (1/72 inch)
  • px - CSS pixels
String
Override column label visibility By default, field labels within a column are hidden, except for in the column header. To override this default, list the columns whose labels you want to show in each row. For example, 1,3 shows the label for the coach view instance in each row of the first and third columns.

This setting is useful for coach views that contain a label within the view, such as button controls.

String
Row selection type Specify how many rows the user can select in the table.
  • Single Selection The user can select only a single row. This is the default value.
  • Multiple Selection The user can select one or more rows.
  • No Selection The user cannot select any rows.
TableSelectionType
Show Add button Include a button that a user can click to add a row to the table.

By default, this option is not selected (False).

Boolean
Add button hover text Provide hover text for the Add button. The default text is "Add". String
Show Delete buttons Display a button in each row for users to delete the row from the table.

By default, this option is not selected (False).

Boolean
Delete button hover text Provide hover text for the Delete buttons. The default text is "Delete". String
Disable sorting by columns List the columns by which the table cannot be sorted. Separate column numbers with a comma. For example, 1,3 prevents users from sorting the table data by the first or third columns. String
Disable sorting Select this option to prevent users from sorting the table data. Boolean
Enable pagination Select this option to display table content over multiple pages when the number of rows exceeds either the value of the Number of rows per page configuration option, if it is specified, or 8 if Number of rows per page is not specified.

When table pagination is enabled, users can use page controls to navigate to other pages in the table instead of scrolling.

By default, this option is not selected (False).

Boolean
Number of rows per page screen sizes icon Set this option to specify the maximum number of table rows to be displayed at one time when table pagination is enabled.

The default value is 8.

Integer