数据表屏幕输入组件
在表中显示记录集合，以便运行流的用户可以选择记录。流将选定记录存储为流的其余对象可以操作的流变量。
所需的 Edition
配置数据表名称
| 字段 | 描述 |
|---|---|
| API 名称 | 组件的 API 名称。 API 名称可以包含下划线和字母数字字符，但不得有空格。必须以字母开头，且不得以下划线结尾。也不得包含两个连续下划线。 |
| 标签 | 如果您选择使用标签作为表格标题，则组件前会显示标题文本。 |
| 使用标签作为表格标题 | 表示是否在运行流时在表前显示标签值。 |
配置数据表源
| 字段 | 描述 |
|---|---|
| 源集合 | 对于 API 版本 65 和更高版本，用于填充表的记录集合或 Apex 定义的数据类型集合。 对于 API 版本 64 和早期版本，用于填充表的记录集合。 |
| 显示搜索栏 | 使用户能够搜索和筛选他们的记录结果。 |
配置数据表行
| 字段 | 描述 |
|---|---|
| 行选择模式 | 指示用户可以在表中选择多少行。您可以将该值设置为：
|
| 最小行选择 | 指定用户选择的最小行数。 |
| 最大行选择 | 指定用户可以选择的最大行数。 |
| 默认选择 | 集合，该集合指定要在表中预选哪些记录。 |
| 唯一标识符 | 必需。用于标识每个记录的字段。该字段需要每个记录的唯一值，例如 ID 或 API 名称。 为确保数据表组件正常工作，请提供唯一标识符。如果您选择可能有重复值的字段，可能会导致不正确和不可预测的选择行为，例如选择多个意外行。 |
配置数据表列
要将第一列添加到表，请配置这些字段。要添加后续列，请单击添加列。拖动列以重新排序。
| 字段 | 描述 |
|---|---|
| 源字段 | 要在列中显示的源集合对象中的字段。 不支持具有 anyType 数据类型的字段，例如 AccountHistory 对象的 NewValue 字段。 |
| 显示选项 | 仅在源字段是查找字段时可用。
如果您选择显示记录名称并取消选择链接到记录，相关记录名称将在运行时显示为纯文本。取消选择显示相关记录和链接到记录会在运行时显示 Salesforce ID。 |
| 自定义列标签 | 表示是否显示您指定为列标题的列标签值。 |
| 标签 | 如果您选择自定义列标签，请输入要显示为列标题的文本。屏幕阅读器也会阅读此文本。 |
| 默认文本溢出模式 | 指定长度超过列宽的文本的显示方式。您可以将该值设置为：
|
| 允许用户修改数据表 | 允许用户在运行时修改数据表中的字段。
|
设置组件可见性
指定逻辑，确定流何时显示组件。
| 选项 | 说明 |
|---|---|
| 何时显示组件 | 使用条件逻辑配置组件的显示时间。 您可以将组件设置为：
|
将数据表组件的值存储在流中
流会自动存储这些值。如果手动存储值，请将属性的输出值存储在变量中。
要手动存储值，请选择手动分配变量(高级)。
您可以在流变量中存储所有属性，但我们建议存储这些属性。
| 字段 | 描述 |
|---|---|
| 首个选定行 | 流用户选择的表中的第一个记录。如果用户选择了两条记录，则这条记录是从上到下第一条选择的记录。 |
| 选定行 | 用户选择的记录列表。记录按照它们在表中的位置从上到下的顺序显示。 |
验证输入
提供评估用户输入的内容是否有效和显示错误消息（如果无效）的公式。
| 选项 | 描述 |
|---|---|
| 错误消息 | 指定当用户输入无效值时出现在组件下方的错误消息。 |
| 公式 | 提供返回布尔值的公式表达式。 如果公式表达式评估为 true，输入有效。如果公式表达式评估为 false，则错误消息将显示在组件下方。 如果用户将该字段留空，并且该字段不是必填的，则流不会执行验证。如果用户将字段留空并且该字段是必填项，流会显示默认错误消息，而非自定义错误消息。 |
指定重新访问的屏幕上的值的行为
指定当用户输入值、导航到上一个屏幕，然后返回带有此组件的屏幕时，此组件的作用。
| 选项 | 描述 |
|---|---|
| 使用用户上次访问此屏幕时的值 | 该组件保留用户指定的值，并且不更新这些值以反映在先前屏幕上所做的更改。 |
| 刷新输入以合并流中其他地方的更改 | 该组件更新用户指定的值，以反映在先前屏幕上所做的更改。 如果暂停然后恢复流，则流仅在复选框、复选框组、货币、长文本区域、多选选项列表、数字、密码、选项列表、单选按钮和文本组件中保留用户指定的值。 |
注意事项
- 数据表流屏幕组件与移动设备不兼容。
- 如果您使用“获取记录”流元素检索要在数据表中显示的记录，请选择选择字段并让 Salesforce 执行剩余操作以获得最佳性能。
- 数据表的最大高度为 400 像素。
- 如果您选择在数据表中换行，请确保文本在测试流时不会溢出。当数据表在屏幕上压缩时，换行文本可能会溢出，例如，当它位于多列中的一列时。
- 数据表最多可以显示 1500 条记录。但是，您的搜索是在整个数据集上执行的。
- 在数据表中最多可以选择 200 条记录。
- 如果在加载初始记录后应用筛选器，则只会显示新的结果。初始记录不再显示。
- 如果数据表包含尚未提交到数据库的公式字段和记录或记录更新，则该表无法正确计算公式。
对于数据库中不存在的记录，使用静态值或“公式”资源，通过分配更新公式字段的值。执行此操作不会影响流中的任何后续“创建”或“更新”操作。
对于已经更新的现有记录，使用可调用操作重新计算公式，或使用 IN 运算符刷新记录和公式字段值。
- 您无法搜索“时间”字段。
- 不支持任务和事件记录中的主题字段。
- 日期和时间以 Unicode 国际化组件 (ICU) 日期和时间格式显示。
- 在多币种组织中，如果记录使用的币种不同于用户的个人币种，则数据表不支持该记录。
- 要在数据表组件中显示多语言列标题标签，请使用
$Label全局变量指定自定义标签。有关创建和翻译自定义标签的更多信息，请查看自定义标签。 - 运行时的数据表选择受 Lightning Aura 组件开发人员指南 中描述的客户端有效载荷数据限制的制约。如果您超过此限制，流会返回通用错误消息。例如，如果您包含超过限制的文件数据，流会生成错误。我们建议避免源集合中 ContentVersion 记录的 VersionData 字段等字段。
- 如果您有一个包含数据表组件的打开流，并且您在另一个页面上更新了您的用户设置时区，请刷新流页面，以在数据表组件中显示更新的日期和时间字段。
- 在设置行选择时，如果您想要使用其他数据表组件的行选择，请谨慎小心。Salesforce 不支持使用具有重复记录变量而没有记录 ID 的行选择。
- 如果您将行选择模式设置为单行并使其成为必填项，或者如果您将最小和最大行选择设置为 1，Salesforce 会在运行时使用单选按钮。否则，我们会在运行时使用复选框。
- 如果您封装包含数据表组件的流，数据表中使用的字段不会自动添加到软件包中。如果您在数据表组件中使用字段，您必须手动将其添加到软件包中。
- 从 API 版本 65.0 开始，字段名称更改会在数据表组件中自动更新。对于在 65.0 之前的 API 版本中运行的流，如果您在对象管理器中重命名映射到数据表中列的字段，Salesforce 不会更新列名。要在数据表中查看新名称，请删除列并重新添加。
- 从 API 版本 65.0 开始，您不能再删除数据表组件中引用的字段。对于在 65.0 之前的 API 版本中运行的流，您可以删除数据表组件使用的自定义字段。因此，您还必须从数据表组件中删除该字段。
- 从 API 版本 65.0 开始，命名空间会在数据表组件中自动更新。对于在 65.0 之前的 API 版本中运行的流，如果数据表组件在没有命名空间的组织中使用自定义对象或自定义字段，然后向组织添加命名空间，您还必须手动将该命名空间添加到数据表中的关联列字段。
- 通过列排序，排序不会影响第一个选定行和选定行。
- 当您选择显示记录名称时，排序和搜索选项不可用。
- 仅当用户有权访问相关记录对象时，选择显示记录名称会在运行时显示相关记录名称。
