列表联动模型

1 使用场景

列表联动模型适用于某些需要同时展示两个具备关联关系的列表的业务场景，例如“项目-合同”管理等业务，前端界面支持对通过选中项目联动显示出关联的合同列表，并针对当前项目对合同进行增删改。

如下图所示：页面上半部分是项目列表，需支持条件查询；页面下半部分需要展示上方高亮单选选中的项目相关的合同数据，实现上下联动展示，且在此页面主要业务是要对项目合同指标进行查询和维护。

2 配置说明

2.1 引用模板准备

根据业务需要提前准备两个数据具备关联关系的模板（目前上下仅支持配置为跨设备表单列表页面，故需准备具备列表页面的跨设备表单模板，例如：单表模型、主从模型、多对多模型、视图模型、文档编辑模型）

例如前文“项目-合同”管理业务中，就可以准备一个项目数据列表和合同数据列表，合同在维护时绑定的项目id就可以作为两者的联动关系使用。

2.2 列表联动模型配置

新建跨设备表单后，首先在【表单模型】配置项中需要选择“列表模型”，总体配置界面如下图所示。页面标题设置和数据连接作为表单基础设置在此不再赘述。

（1）列表模板设置
用于配置模型上半部分页面引用的列表模板。

• 【表单文件】必选，仅支持选择跨设备表单：单表模型、视图模型、主从模型、多对多模型、文档编辑模型。
• 【页面类型】默认自动选中列表页面。
• 【参数列表】显示引用模板的参数列表，用于设置列表参数是否启用、默认值以及参数栏显示。

（2）联动模板设置
用于配置模型下半部分页面引用的联动模版。

• 【表单文件】必选，目前仅支持选择跨设备表单：单表模型、视图模型、主从模型、多对多模型。
• 【页面类型】目前仅支持列表页面，默认自动选中列表页面。
• 【关联关系】必填，用于配置“列表模板”和“关联模板”的联动关系（执行时默认以两边模板字段值相同作为关联关系进行联动），支持设置多个字段关联关系。
• 【参数列表】显示引用模板的参数列表，需要注意：“关联模板”列表页面参数字段若已在【关联关系】中设置了关联关系，则在参数列表中则不再允许启用该字段。

（3）PC页面显示布局
该模型仅支持PC端使用，在此可以对PC页面显示布局进行配置。

• 【显示表头】默认不开启，用于配置是否显示当前模板标题栏；
• 【列表模板显示占比】控制前端页面列表模板（上半区）在整体页面的占比，默认50%，允许输入范围[20,80]之间的整数。

（4）参数设置
针对这类模型支持自定义参数列表用于超链接至此类型模板时接收外部传入参数。

3 执行效果

该模型上下半区模板显示和功能均依赖于引用的原模板配置，相应的界面或功能调整需要去对应的原模板中进行设置。