跳转至

实体详细信息#

entityDetails

概述#

实体详细信息小组件显示给定实体实例的一组选定属性和特性。 例如,它可用于显示给定物料资源的属性。下面显示了一个示例,其中实体详细信息小组件用于显示生产工单的详细信息。

entityDetailsExample

要在UI页面中使用实体详细信息小组件,请执行以下步骤。

  1. 在处于构建模式的任何UI页面中,从页面右侧的“小组件”列表中选择实体详细信息小组件,然后将其拖放到UI页面中的正确位置。
  2. 进入小组件的“设置”部分。
  3. 在“常规”选项卡中,提供小组件的名称、说明,并指定是否应显示标题以及用户是否可以激活全屏模式。 entityDetailsGeneral
  4. 在“设置”选项卡中提供可视化效果和数据相关属性。 entityDetailsSetup 对于可视化,可以选择小组件是否显示图标以及是否允许导航至实体的实例。 对于数据,可以配置参考类型:
  5. 非版本化实体的类型
  6. 版本化实体的定义或版本 以及实体名称,其将用于筛选要显示的可能实例。
  7. 选择性地定义将显示的属性。 entityDetailsProperties

必须提供一个名称,该名称将显示以识别属性;如果该属性不是用户定义的,则从提供的属性列表中选择一个值;如果该属性是用户定义的,则输入一个值。

  1. (可选)定义此小组件和UI页面的其他元素之间的链接。 entityDetailsLinks 在本部分中,必须定义小组件要显示的实例输入。
  2. 通过保存并关闭设置,小组件将相应地进行更改。

实施示例:显示所选实体的信息#

在UI页面上显示所选实体的详细信息通常是有意义的,这样可以避免打开实体本身。为此,可以将实体详细信息小组件链接到提供实体的实体列表小组件或实体表单字段。

根据应该显示的属性,必须使用loadEntity转换器来加载所选实体的(更多)数据。

Info

需要转换器的一个示例是访问资源区域的名称。由于此信息不直接存储在与资源相同的数据库表中,而是作为外键链接到同一表中。这意味着为了使信息显示在实体详细信息小组件中,必须加载资源实体以获得更多级别。此上下文中的每个级别代表所需属性与初始实体的距离。即车间名称,由于车间直接链接到资源,因此距离车间1个级别。

  1. 向页面添加整数属性(稍后需要定义要加载的级别数):

image-20210518165600900

  1. 为实体配置实体详细信息小组件:

entityDetailsSetup

  1. 根据需要添加属性:

entitydetails_usecase_2

Note

添加不在提供列表中的属性(即车间描述),选择选项用户定义,并以如下图所示的语法提供属性的路径:

entitydetails_usecase_3

  1. 将资源实体表单字段链接到实体详细信息小组件,然后使用转换器loadEntity并将上面创建的属性作为转换器参数:

    entityDetailsLinks

    entitydetails_usecase_4

  2. 最终结果应该如下所示:

image-20210518171144717