重复控件屏幕显示组件

备注 为了获得最佳性能，我们建议将流和运行时设置为 API 版本 58.0 或更高版本。

以下是重复控件组件在运行时的外观。当用户单击添加以添加另一个人时，此重复控件包含在屏幕上重复显示的五个子组件。子组件是两个名为名字和姓氏的文本组件、一个名为出生日期的日期组件、一个名为接收有关更新的电子邮件的切换组件和一个名为电子邮件的复选框组组件。复选框组组件设置为隐藏，直到切换组件设置为启用。用户可以继续单击添加，屏幕上每次重复相同的五个组件。

配置重复控件组件

配置数据源

选择在运行时预填充重复控件组件的项目集合。重复控件的子组件可以引用此集合中的值。

配置显示选项

设置组件可见性

指定逻辑，确定流何时显示组件。

使用情况

配置重复控件组件后，在重复控件中添加并配置一个或多个子组件。该流在组件的AllItems属性中存储重复控件组件的用户输入。您可以循环遍历该集合中的项目，以创建集合变量，供以后在流中使用。

AllItems 属性注意事项

• AllItems 属性在以下情况下为空：
  • 重复控件组件仅包含不接受用户输入的子组件，例如显示文本组件。
  • 用户不会将重复控件实例添加到屏幕。
• 当条件字段可见性隐藏所有子组件时，AllItems 属性为空。
• AllItems 属性及其值为只读。
• 分配元素不支持 AllItems 属性。

一般注意事项

• 您不能在重复控件中包含操作按钮组件或记录字段。
• 转换、集合筛选器或集合排序元素不支持重复控件组件的输出。
• 您不能在重复控件子组件中引用不同重复控件组件的输出。
• 在选择字段中引用集合选择集资源的选择组件在重复控件组件中不具反应性。
• 创建或更新屏幕时，可以将同一屏幕上的组件拖放到重复控件组件中。您也可以将组件从重复控件组件内部移动到屏幕上的不同位置。但是，对移动的组件的任何引用都会中断。
• 如果您将选中了“手动分配变量”复选框的组件移动到重复控件组件中，则任何手动分配都会被删除，复选框也会被取消选中。但变量仍存在于流中。我们建议在移动后检查组件，以确保它不包含损坏的引用。
• 用户可在运行时将重复控件组件的最多 30 个实例添加到屏幕。
• 组件本身中对重复控件组件的引用格式是 {!repeaterAPIName.fieldName}。在验证消息和流元数据软件包中，相同引用的格式是 {!repeaterAPIName.AllItems[$Items].fieldName}。