变量支持的设计

变量支持的设计包括两个高级设计功能，使模块构建者能够构建具有更响应式用户界面的应用程序。

1. 部分：基于变量的折叠状态提供控制部分何时展开（显示）或折叠（隐藏）。
2. 页面：基于变量的页面选择提供对多页面模块中当前显示页面的控制。

这些选项共同为构建动态应用程序提供了相当大的灵活性，下面将详细描述。

部分：基于变量的折叠状态

此功能为构建者提供了控制部分何时展开（显示）或折叠（隐藏）的能力。

要使用此功能，构建者将选择一个布尔变量（由true或false值组成）作为部分的基于变量的折叠状态变量。此选定布尔变量的值将有效地决定该部分是折叠（true）还是展开（false）。该功能使构建者能够动态控制部分的折叠状态；例如，可以通过函数中定义的自定义业务逻辑，选定对象的属性值，或URL中或从父模块传递的模块接口布尔变量来实现。

如下图所示，基于变量的折叠状态可以配置为部分的可折叠设置的一部分。

了解更多关于具有完整教程的基于变量的折叠状态。

页面：基于变量的页面选择

此功能允许构建者动态控制在多页面模块中当前显示的页面。要启用此功能，模块构建者需要配置以下两个组件：

1. 页面ID： 唯一标识每个模块页面的参数（在每个页面的配置中设置）。
2. 基于变量的页面选择： 决定显示哪个页面的字符串变量（在模块头部的配置中设置）。

每当基于变量的页面选择的值等于模块中给定页面的ID时，该页面将在模块中显示。此功能允许构建者动态控制模块当前可见的页面；例如，可以通过函数中定义的自定义业务逻辑，选定对象的属性值，从父模块传递的模块接口字符串变量，或URL中决定最初显示页面的模块接口字符串变量来实现。

如下图所示，基于变量的页面选择在模块设置的配置面板下的页面中配置。

应用案例示例

Workshop有许多功能可以帮助构建者使其模块更具响应性和动态性。此示例使用指南演示了如何使用这些功能之一，即基于变量的折叠状态，以提高模块的可用性。

下面的截图展示了一个用于监控野火事件的示例模块。对于该模块的用户来说，最重要的操作是为每个野火事件指派一个员工团队。由于指派团队的重要性，当前模块在页面顶部显著显示了一个团队指派窗口用于每个事件。

此初始模块设计适用于尚未指派团队的野火，但不适合查看已指派团队的火灾事件。在事件已指派团队后，用户可能不太需要占用页面顶部空间的团队指派窗口，这使得快速查看事件详情变得更加困难。在这种情况下，用户可能更希望团队指派部分为一个折叠部分，减少模块中所占的空间，但可以在需要时访问。

在下图中，您可以看到左侧展开的团队指派窗口和右侧折叠的窗口：

为了使我们的模块根据选定的事件显示最佳设计，我们可以使用Workshop的基于变量的折叠状态功能，仅在查看其Team Assigned属性设置为False的事件对象时展开团队指派部分。

要为类似此示例的情况设置基于变量的折叠状态，请按照以下步骤操作：

1. 打开您的模块并点击编辑按钮以编辑模式打开模块。
2. 找到并选择您希望使用基于变量的折叠状态展开或折叠的部分。在本例中，我们选择名为团队指派的部分，其中包含指派团队的微件。
3. 在选择部分时，使用右侧的配置面板将部分设置为“可折叠”。
   • 在基于变量的折叠状态下，您现在应该会看到一个布尔变量的选择器，该变量将决定您的部分是否折叠。
4. 接下来，创建决定您的部分是否折叠的变量。对于本例，我们将新建一个变量Should Section Be Collapsed?，并将其设置为我们的活动野火对象的Team Assigned?属性。
5. 将新创建的变量指派给步骤3中提到的“基于变量的折叠状态”选择器。

您已配置模块根据您指派的变量折叠部分！如下面的截图所示，这创建了一个更直观的用户界面，当查看当前正在审查的野火事件时，会根据需要展开或折叠团队指派部分。

您可以在模块中以多种方式使用此功能，以便在用户和他们的工作流程最直观的时候显示或隐藏部分。您还可以使用此功能捕获某些错误并显示自定义错误消息。例如，如果由于搜索限制发生错误，您可以创建一个自定义消息，要求用户进一步筛选输入对象集以解决问题。