Configuring Table Sections

Overview

The Table section is an extremely performant display of work items (i.e., instances of a template) or associations. Tables can be configured to include editing of data or creation of new work items.

Tables will be paginated when they’re set to Fixed Height and will have virtual scrolling when they’re Fit to Window (default), more information on these settings can be found in the Height Settings article. Tables can also be configured to show a single line-height of data, or 2, 3, or 4 line-height for each row.

Adding a Table

1. On a layout in Configure mode, open the Add Section dialog.
2. Select the Table option from the left panel.
3. Click on the desired template or association to define the content to be displayed in the Table section. The Table will be added to the layout.

 

Configuring Table Settings

After successfully creating a new Table Section, follow the steps below to fully configure your new Table. These configuration options can be edited on an existing Table Section via the Settings dialog while in Configure mode on a Layout.

General Tab

1. Click on the Settings icon (gear) at the top right of the Table.
2. Select Settings.
3. Click on the Row Types drop down menu to see all available templates. Select one or more templates or associations to define row type.
4. Edit Form: This setting enables single-line editing via a Form dialog. Choose between the Default and Custom Form choices via the drop-down menu, or Disable the Edit Form. Selecting Custom Form will enable the Edit Forms tab of this dialog, allowing you to customize a Form for editing.
5. Create Form: (Optional) Enable Create from Table by selecting an option from the drop-down menu. This will display a plus button on the Table so users can add new work items. Choose between the Default and Custom Form choices. Selecting Custom Form will enable the Create Forms tab of this dialog, allowing you to customize a Form for editing.
6. Row Height: Define the Row Height for the Work Items being displayed in the Table, choose from 1-4 Lines. This will apply to all rows in the Table consistently.
7. Preview Pane: (Optional) Enable or disable the Preview Pane to allow users to preview work items in the Table.
8. Bulk Edit: (Optional) Enable or disable Bulk Editing for the Table. Ideally, Bulk Editing should only be enabled on Tables that have been optimized for bulk edit. For example, Calculated and Attachment Attributes cannot be bulk edited making their inclusion in Bulk Edit-enabled Tables unnecessary. Additionally, Table columns that are grouped will become individual columns in the Bulk Edit Dialog which could impact the size of flexible-width columns. It is recommended to use fixed-width columns to ensure there’s enough space for editing the content.

Filters Tab

Locked filters can be set when configuring a Table. These filters will apply to all content in the Table and cannot be seen or edited by end users viewing the Table.

Ex: {!toFilter(today())}, {!toFilter(Program__t.Start_Date__c)}

Additionally, Page filters can be set using the injected expression syntax: {!toFilter(API_Name__f)}. Refer to the Page Filtering article for more details on configuration.

1.  Navigate to the Filters tab in the Table settings dialog.
2. Choose the attribute on which to filter from the drop-down menu.
3. Enter a value into the Value field. Filtering syntax can be found here.
4. Add another filter by clicking Add Filter.
5. Remove a filter by clicking the trash icon next to the filter.

Edit Forms Tab

Table Sections support quick editing via the use of an Edit Form.

1. To enable the Edit Forms tab, select Custom Form from the Edit Form dropdown on the General tab.
2. Navigate to the Edit Forms tab to configure a custom edit form. Forms can be configured for each Row Type included in the Table. See Managing Forms for full configuration options. Once configured to your liking, click Save.
3. With an Edit Form configured, you can now edit each Row Type via the edit icon in the far left column of the Table Section.

Notes:

• Switching between Custom and Default Forms will erase any Custom Forms upon saving.
• Disabling Edit Forms will erase any Custom Forms upon saving.

Create Forms Tab

Tables support creation of new work items via Create Forms.

1. To enable the Create Forms tab, select Custom Form in the Create Form dropdown on the General Tab.
2. Navigate to the Create Forms tab to configure a custom edit form. Forms can be configured for each Row Type included in the Table. See Managing Forms for full configuration options. Once configured to your liking, click Save.
3. With a Create Form configured, you can now create new work items via the plus button in the top-right of the Table Section.

When Create Forms are enabled on a Table, App Admins can utilize this feature to seed descendant content on the Template. However, when seeding content on a template, you cannot define values in association attributes.

Notes:

• Metric columns cannot be included in Create Forms. Additionally, non-editable out-of-the-box attribute columns will not appear in the default Create Form.
• Switching between Custom and Default Forms will erase Custom Forms upon saving.
• Disabling Create Forms will erase Custom Forms upon saving.
• A warning will appear when enabling Create Forms on Association Tables if the association is calculated.

For information on Creating from Tables on an instance, please visit our Utilizing Table Sections article.

AI Actions Tab

The AI Actions tab supports the configuration of the AI: Recommend Work Items for the Table Section. Selecting the tab will provide a drop down to choose from a configured AI Action. For more information, please visit our AI Actions support article.

Note: The AI Actions tab will only be active if an action has been configured for the template type selected for the Table.