Skip to main content

列表跨对象关联字段展示Lookup

业务场景​

我们想在学员请假管理列表中，展示当前数据对应的学员的额外信息，比如学员的直接上级（辅导员）是谁，学员所在部门（班级/院系）是哪个，甚至学员的性别、邮箱、手机号、出生年月、家庭信息等。

如果我们直接在请假管理对象中添加相关字段，又难以保证学员信息更新时，数据保持最新状态，而且也不利于业务系统维护。

别担心，Chameleon平台提供了Lookup的功能，可以帮你轻松实现这一点。

字段配置​

打开请假管理对象的字段配置，编辑申请人字段，打开Lookup开关。

视图列表配置​

打开我们的休假管理视图列表，对列表进行编辑，我们可以看到，列表多出了员工信息对象（该对象是系统内置对象，可在Chameleon系统应用中找到进行设置）的字段。

我们可以勾选电子邮箱、性别、直线经理字段，并且顺便修改显示名称，让名称显示更加自然一些。

查看列表​

可以看到，我们的列表已经额外展示了申请人的部分个人信息。

扩展说明​

除员工单选类型字段外，我们的数据源类型字段也支持打开lookup开关，一旦打开lookup开关，则无法关闭（因为有可能业务已经使用了lookup字段进行配置，一旦关闭会对配置好的业务造成影响）。

数据源字段Lookup要求​

数据源字段lookup只能支持以数据id为value的数据源（接口类型的数据源或实体数据源），因此，我们可以选择lookup的目标对象，以该对象的数据_id进行lookup。

注意事项：

  • 如果数据源字段所选的数据源并非以数据_id为value的数据源（如审批状态为枚举类型数据源），则无法成功lookup
  • 正确情况下，应该在数据源下拉列表中选择自定义的接口数据源
  • 接口需要正确配置以lookup目标对象为数据对象的数据源组件，即可正常渲染lookup

使用场景​

  • 展示关联人员的详细信息（如部门、职位、联系方式等）
  • 展示关联部门的信息（如部门负责人、部门人数等）
  • 展示关联对象的自定义字段信息
  • 避免数据冗余，保持数据一致性

注意事项​

  • Lookup开关一旦打开无法关闭
  • 数据源字段lookup需要使用以数据_id为value的数据源
  • Lookup字段展示的是关联对象的实时数据
  • 确保关联对象有访问权限
  • 合理使用Lookup，避免过多关联影响列表查询性能