循环设计

本页面讨论循环设计。有关 Workshop 嵌入功能的概述，请参见嵌入概述页面。

循环设计允许您循环遍历一个对象集，使用该对象作为输入为集合中的每个对象显示一个嵌入模块。循环设计中的每个嵌入模块实例独立于循环设计中的其他嵌入模块实例运行，具有自己的变量作用域和设计状态。您可以使用循环设计以获得比其他对象集显示微件（如对象表或对象列表）提供的更高控制权。虽然其他对象集显示微件带有一组固定功能，但循环设计允许使用 Workshop 中提供的任何功能组合来显示对象集中的每个对象。

下面是一个循环设计的示例，用于为三个对象集中的每个对象创建交互式票据卡片（每列一个），以创建一个看板风格的应用程序。每张票据卡片是一个嵌入模块实例，其中填充了提供给列的循环设计的对象集中的一个对象。在这个嵌入模块中，提供了完整的设计控制，构建者可以配置具体显示内容和每个对象的可用操作，提供了比其他对象集显示微件更大的灵活性。

配置

循环设计配置允许构建者选择一个对象集进行循环，并为所选对象集中的每个对象嵌入一个模块，以及排序和分页样式的控制。

要循环的对象集

循环设计中的第一个配置是“要循环的对象集”变量输入。这个对象集将在循环设计中被循环，每个对象用于显示在“模块选择”步骤中配置的子嵌入模块的一个实例。

排序

可以对被循环的对象集应用属性排序，以确定在循环设计中显示对象的顺序。

可以通过在函数支持的对象集变量的对象集定义中返回一个具有所需排序顺序的静态对象集来实现自定义排序。

对于单一对象类型的非静态对象集，在任何用户配置的排序后将应用主键排序，以确保对象的顺序一致。如果主键不可排序，这可能导致循环设计无法显示。

分页样式

• 限制： 此分页样式将仅显示一个页面，其中显示最多前 X 个对象，X 是在“最大显示项目数”配置中配置的值。
• 分页： 此分页样式将显示大小为 X 的对象页，X 是在“每页最大项目数”配置中配置的值。循环设计目前限制为分页前一万个对象。

显示

• 列表： 此显示选项将以列表形式显示对象。没有额外的配置选项。
• 网格： 此显示选项将以网格形式显示对象。此外，可以配置最大列数和最小卡片宽度（以像素为单位）。

使用任一选项，可以通过在选定子模块的顶级部分配置绝对或最大高度来实现每行的一致高度。

模块选择

循环设计模块选择类似于嵌入模块微件模块选择，需要通过 Compass 资源选择器选择一个子模块；然而，循环设计中选择的模块必须具有模块接口对象集变量。

用于循环对象集中的对象的接口变量

在此配置中，构建者必须选择哪个子模块的模块接口对象集变量将映射到“要循环的对象集”变量中的对象。

如果此变量值在子模块中更改，例如通过“设置变量值”事件，可能会发生意外行为。

接口配置

除上述的模块接口变量输入外，循环设计变量映射与嵌入模块接口配置中所有其他模块接口变量的工作方式相同。

设计设置

填充

这是在其他 Workshop 设计中提供的相同填充配置。配置的填充将应用于循环设计中每个嵌入模块实例的周围。

内边框样式

如果对循环设计应用填充，可以选择一种边框样式，该样式将应用于循环设计中每个嵌入模块实例。

共享变量

循环设计中的接口配置允许变量值在循环设计嵌入模块之间共享。这可能有助于共享诸如已选对象的状态之类的内容。在这种应用案例中，每个嵌入模块都可以通过事件设置共享的“已选对象”变量的值，然后在父模块中使用。

限制

循环设计分页限制

循环设计目前限制为分页前一万个对象；此限制将来可能会更改。

动态值

每个模块实例的动态变量值必须从传入对象中派生。传入对象是区分每个模块实例的唯一方法。可以将其他变量传递给循环设计中的每个模块实例，并且这些变量将在实例之间共享。