自动刷新功能在Workshop中

Workshop的自动刷新功能使搭建者能够轻松创建在Foundry中随着数据变化自动更新的应用程序。为用户提供可靠的、最新的信息对于支持操作工作流程至关重要，而Workshop只需几次点击即可实现这一目标。

通过自动刷新，您可以在模块中注册对象集，以便在Foundry的任何地方监测更新。当发生更新时，当前模块中的所有数据将自动刷新，无需用户交互。更新来源的例子包括因其他用户采取的操作而导致的ontology数据更新、来自上游数据集成的编辑，或来自流数据源的新记录。在这些情况下，自动刷新将更新当前模块中的数据。

在数据新鲜度优先的情况下，自动刷新非常有价值，包括但不限于实时仪表盘和协作工作流程。

您可以在特定的Workshop模块中启用自动刷新。导航至Workshop编辑器中设置面板底部的自动刷新配置选项。

设置

要更新自动刷新设置，请在设置面板中选择自动刷新。然后展开面板底部的设置部分。

刷新间隔最小秒数

此设置允许模块搭建者配置数据刷新的最短时间间隔。此设置不会影响初始刷新延迟，而是确保模块不会不断重新加载。当前的最小或最频繁的刷新率为10秒，这确保了由于自动刷新的增加负载而导致的服务稳定性。

编辑模式下禁用

此设置允许模块搭建者在编辑模式下关闭自动刷新行为。如果在编辑模式下自动刷新数据会分散搭建体验或不需要，搭建者可能希望使用此功能。启用此设置时，自动刷新将在查看模式下保持配置和激活。

限制

Object Storage V2 (OSv2)

自动刷新仅限于OSv2支持的对象类型。这一限制包括对象集中使用OSv1支持的对象类型定义的链接对象。

了解更多关于从OSv1迁移到OSv2的信息。

链接对象类型的自动刷新

自动刷新不会自动监测链接对象类型的更新。这意味着已监测对象集的链接对象属性和链接对象聚合不会自动刷新，除非该链接对象类型也被明确监测。

筛选

某些对象集筛选类型当前不支持自动刷新，例如terms、phrase、multiMatch、prefixOnLastToken和objectSetLink。未来可能会添加对这些筛选类型的支持。作为替代方案，您可以监测同类型的未筛选对象集。这可能会导致刷新频率高于必要水平，但应确保对象类型在模块内保持最新状态。

模块内的可见性

当前，已启用自动刷新的对象集需要在模块内的可见微件中使用以触发自动刷新。这防止了对模块中显示的数据没有影响的自动刷新。例如，如果注册的对象集仅在隐藏的抽屉式导航中使用，自动刷新仅会在该抽屉式导航打开时发生。

嵌入模块不继承自动刷新配置

嵌入Workshop模块不会带入嵌入模块的自动刷新配置。必须为每个您打算使用自动刷新的模块明确配置自动刷新。

疑难解答

如果出现任何看似与自动刷新问题相关的错误，请考虑以下事项：

• 确保所有对象类型和链接类型都由Object Storage V2支持。特别注意两个由OSv2支持的对象类型，它们具有由OSv1支持的链接类型，因为这可能导致自动刷新出错。
• 确保在运行时不能设置无效对象集，例如向对象集中添加无效筛选类型。对象集可能最初与自动刷新兼容，但可能因用户与应用程序的交互而无法被监测更新。
• 提高网络连接的稳定性将直接改善自动刷新功能的稳定性。如果网络不断断开和重新连接，您可能会看到在自动刷新禁用时通知用户的错误。
• 如果未看到预期的刷新，您可能监测了过于具体的对象集。尝试监测更广泛的对象集，如给定类型的基础对象集，或更宽泛的筛选。然后，您可以在该更广泛的监测对象集下游定义具有更具体筛选的变量。
• 检查浏览器控制台以获取更详细的错误消息。以下是一些在使用自动刷新时可能发生的常见错误的详细信息：
  • InvalidObjectSetForPlanning: 被监测的对象集包含对Entity（对象类型或链接类型）的引用，该Entity在Object Storage V1中被索引。