Table bot response control
Use the Table bot response control in a Virtual Agent topic to display a bot response as a table.
Table bot responses enable users to see information in a more organized way.
For example, you can organize and display information such as the following:
- Planned service changes
- Company holidays
- Contact information
- Testing sites
Output tables can have between one and four columns and may include optional column headers. You can populate tables using the conditioner builder or scripts.
Table bot response properties
| Property | Description |
|---|---|
| Node name | Name that identifies this Table bot response control node in the topic flow. |
| Populate this table by | Options for populating the table. Select one of the following:- Table: Select the ServiceNow table that contains the data to be displayed. - Script: Enter code in the Define rows dialog box. |
| Table | The name of the table that contains the data.This field is available only when the Table option is selected. |
| Filter rows | Options for filtering the contents of the table. Choose one of the following:- Condition: Specify a no-code condition statement using the condition builder. For more information, see Condition builder. - Script: Enter a low-code script that specifies a condition. This field is available only when the Table option is selected. |
| No records response message | Message displayed if no records are found. |
| Show links for each record | Slide this toggle to activate links for each record in the output in your Virtual Agent conversation.The Show links for each record toggle is not available by default. It can be enabled by changing the value of the system property sn_cs_builder.table_show_links_enabled to true. |
| Columns and rows | |
| Columns \(left to right\) | Table columns that you want to display in the conversation. You can have up to 4 columns.- Field: Select a field from the ServiceNow table to be displayed in the column. - Display name: Reflects the selected column name. Use the default name or change the name. This field is available only when the Table option is selected. |
| Sort rows by | Option for sorting returned rows by column. You can sort by one of the selected columns, or by a column not shown in the response to the user. Choose Ascending or Descending order for the sort.If you don't specify a sort order, rows are sorted by creation date in descending order. If you specify a different sort order, creation date is used as a secondary sort order. This field is available only when the Table option is selected. |
| Advanced | |
| Headers | |
| Header | Header or title for the table when the table is displayed in the response output. The header can be a text string, variables, or a script. |
| Display Column Headers | Toggle switch that enables the display of column headings. |
| Hide this node | |
| Conditionally show this node if | No-code condition statement or low-code script that specifies a condition for presenting this node in the conversation. The condition must evaluate to true. |
Channel support
| Channel | Support | Constraints |
|---|---|---|
| Web UI | Supported | None |
| Mobile UI | Supported | None |
| Now Assist panel | Not supported | Not applicable |
| Microsoft Teams | Supported | None |
| Slack | Supported | None |
| Workplace | Supported | None |
| Facebook Messenger | Not supported | Not applicable |
| SMS Twilio | Not supported | Not applicable |
| LINE | Supported | None |
| Not supported | Not applicable | |
| Apple Messages for Business | Supported | None |
| Alexa (Voice) | Partial support | Supported on devices with screens. For nonscreen devices, the table will be read, if possible. For details, see Fine-tune Virtual Agent settings and topics for the best Alexa voice chat experience. |
Example Table bot response output
Note: Virtual Agent Designer controls may display and function differently in other channels.
| Response properties | Table bot response output |
|---|---|
Image omitted: table-bot-response.png Basic properties include the node name, the method of populating the table, the filter, and the columns to be returned. | Image omitted: table-bot-response-web-ui.png Table in a chat window that displays the 2020 Company Holidays by Holiday and Date. |
Image omitted: table-bot-response-mobile.png Table in a chat window that displays the first six 2021 Company Holidays by Holiday and Date. The user can choose an option to view all 11 rows. |
Parent Topic:Assistant Designer bot responses