Object View（对象视图(Object View)）

The Object View widget provides detailed information about a single object by displaying an embedded object view within a Workshop module. A builder configuring an Object View widget can:

• Choose the input object set, which determines the object that will be displayed.
• Choose between the full or panel object view.
• Hide or display the object view header.
• Define a mapping of variables for the interface of the object view.
• Customize the tab behavior of the full object view.

This is an example of a configured Object View widget displaying a single Airport object:

Configuration options

This is the initial state of an Object View widget and its configuration panel:

Core configuration options

• Input data
• Object to display: The input variable that determines the object(s) that will be displayed. For the full object view form factor, only the first object will be shown if the object set contains multiple objects. For the panel object view form factor, the display behavior depends on the configured panel behavior.

• Display & formatting

• Form factor: Controls whether the full or panel object view is displayed. See form factor configuration options below for additional configuration available for each form factor.

• Hide header: If toggled on, the object view header will be hidden.

• Empty state: Configures the appearance when the widget's input variable is empty. Builders can select an icon and configure a custom message to display.

  

Form factor configuration options

• Full object view

• Hide tabs: Hides the tabs of the object view. Tabs are always hidden for object views with a single tab, so this is only applicable to object views with multiple tabs. Users will be unable to navigate to different tabs of the object view when this option is selected.

• Go to initial tab on object switch: Automatically navigates back to the initial tab when the displayed object changes. The initial tab is the first tab in the object view by default, but can be configured to a different tab using the parameter below.

• Initial object view tab ID: This controls the tab that will initially display when the object view is first opened. If not configured, the first tab will show by default.

• Interface configuration: Defines a mapping from the current module's variables to an object view tab's module interface. Start by adding an object type to the mapping, then select a tab that has a module interface defined and populate the interface. For more details, visit the interface configuration section for embedded modules. Legacy object view tabs are not supported.

• Revert to legacy widget: This downgrades the object view widget to the legacy version. The legacy widget loads legacy object view tabs faster, but does not support interface configuration.

• Panel object view

• Panel behavior: Controls how the panel displays objects based on the input object set. Three modes are available:

  • Object instance: Always displays the first object of the input object set as a single object view, regardless of the object count.
  • Adaptive: Automatically switches between object instance view and object set view based on the input. When the object set contains exactly one object, it displays the object instance view. When the object set contains zero or multiple objects, it displays the object set view.
  • Object set: Always displays the object set view, regardless of the object count.

  

• Interface configuration: Defines a mapping from the current module's variables to an object view panel's module interface. Configure this by adding an object type to the mapping and populating the panel's module interface. For more details, visit the interface configuration section for embedded modules.

  

---

中文翻译

对象视图(Object View)

对象视图小部件通过在 Workshop 模块中显示嵌入的对象视图来提供有关单个对象的详细信息。配置对象视图小部件的构建者可以：

• 选择输入对象集(Object set)，这将决定要显示的对象。
• 在完整或面板对象视图之间进行选择。
• 隐藏或显示对象视图页眉。
• 为对象视图的接口定义变量映射。
• 自定义完整对象视图的选项卡行为。

以下是配置好的对象视图小部件显示单个 Airport 对象的示例：

配置选项

以下是对象视图小部件及其配置面板的初始状态：

核心配置选项

• 输入数据
• 要显示的对象： 决定将显示哪些对象的输入变量。对于完整对象视图形态(Form factor)，如果对象集包含多个对象，则仅显示第一个对象。对于面板对象视图形态，显示行为取决于配置的面板行为。

• 显示与格式

• 形态： 控制显示完整对象视图还是面板对象视图。请参阅下方的形态配置选项，了解每种形态可用的其他配置。

• 隐藏页眉： 开启后，将隐藏对象视图页眉。

• 空状态： 配置小部件输入变量为空时的外观。构建者可以选择图标并配置要显示的自定义消息。

  

形态配置选项

• 完整对象视图

• 隐藏选项卡： 隐藏对象视图的选项卡。对于只有一个选项卡的对象视图，选项卡始终处于隐藏状态，因此此选项仅适用于具有多个选项卡的对象视图。选择此选项后，用户将无法导航到对象视图的不同选项卡。

• 切换对象时返回初始选项卡： 当显示的对象发生变化时，自动导航回初始选项卡。默认情况下，初始选项卡是对象视图中的第一个选项卡，但可以使用以下参数将其配置为其他选项卡。

• 初始对象视图选项卡 ID： 控制首次打开对象视图时初始显示的选项卡。如果未配置，则默认显示第一个选项卡。

• 接口配置： 定义从当前模块变量到对象视图选项卡的模块接口(Module interface)的映射。首先向映射中添加对象类型，然后选择已定义模块接口的选项卡并填充该接口。有关更多详细信息，请访问嵌入式模块的接口配置部分。不支持旧版对象视图(Legacy object view)选项卡。

• 恢复为旧版小部件： 将对象视图小部件降级为旧版。旧版小部件加载旧版对象视图选项卡的速度更快，但不支持接口配置。

• 面板对象视图

• 面板行为： 控制面板如何根据输入对象集显示对象。提供三种模式：

  • 对象实例： 无论对象数量多少，始终将输入对象集的第一个对象显示为单个对象视图。
  • 自适应： 根据输入自动在对象实例视图和对象集视图之间切换。当对象集恰好包含一个对象时，显示对象实例视图。当对象集包含零个或多个对象时，显示对象集视图。
  • 对象集： 无论对象数量多少，始终显示对象集视图。

  

• 接口配置： 定义从当前模块变量到对象视图面板的模块接口的映射。通过向映射中添加对象类型并填充面板的模块接口来进行配置。有关更多详细信息，请访问嵌入式模块的接口配置部分。