首页新版主页二开自定义卡片实例之简单实例
背景:
新版卡片式首页已发布很久,并且也已经同时支持到了客户端上,相信有很多小伙伴对其中卡片二开的开发流程和卡片的具体实现会有一些疑惑,本篇将会从卡片的创建实现到添加到布局的整个流程进行讲解,根据主页卡片的标准设计框架与运用,大致分为2种场景应用(根据主页类型单据上的自定义卡片对象和关联业务对象区分运用场景):
1、自定义卡片对象无关联业务对象:是指自定义一个卡片对象,直接展示到首页卡片当中,经过新增主页卡片类型->新增主页卡片(多张主页卡片可共用一个卡片类型),用户主控编辑可添加此卡片到自己个性主页中
2、自定义卡片对象有关联业务对象:是在上面(第1点)的基础上,设置了关联对象,关联对象是指此卡片具有设置功能的含义,参考:数据汇总卡片,卡片列表卡片,星空live卡片等等系统预置卡片功能,具体操作可以呈现为,主页显示了此类卡片,点击主页编辑方案(主页右上角)时,该卡片上方会出现“编辑”,“删除”按钮功能,该编辑功能是否显示,是根据是否有无关联对象来进行判断的,如果点击”编辑“,打开的是关联对象对应的单据,此单据可对应二开
本文将介绍上面场景的第1点无关联对象的简单场景实例二开:
一、BOS设计器中新增卡片元数据。
首先要在bos设计器里面创建一个卡片表单。登陆bos设计器
具体步骤:选择业务领域BOS=>主控台(可以根据需要选择领域)。然后新建,选择继承,选择bos,主控台下面的单据,选择html5智能卡片基类这个单据。输入名称和编号,完成保存。
保存后的表单
注意:
1、由于继承的”html5智能卡片基类”是一个单据,那么保存后的卡片也是单据,单据平台会自动关联一个表名,根据实际业务场景判断,如果此卡片二开上使用就是一个动态表单和没有用到单据相关特性,则需要删除掉该卡片的关联表名属性,以免平台创建无意义的数据表
2、由于卡片最终会显示到主页,主页布局是列式布局,主页卡片默认机制是卡片最大宽度是430宽度,所以设计表单卡片的宽度应按照430的宽度进行设计,如超过430宽度,拖拽的控件显示时有可能会被截取
3、卡片的高度不限制
4、卡片最终会显示主页上,主页相关内容是登录到系统时会自动加载,为不影响主控加载性能和速度,其插件开发应保持以下部分原则:
1)、插件中不允许直接访问第三方API接口,如一定要用到,需要使用异步方式(借用Kingdee.BOS.KDThread.MainWorker.QuequeTask)访问接口取数
2)、AfterBindData等加载触发的事件中不允许直接做数据统计类的代码,可使用异步加FireCustomer方式进行加载统计性的数据,可参考列表卡片的插件写法(.net懂得反编译^_^)
二、创建一个卡片类型。
用Administrator登陆系统,在全功能菜单下【门户管理】=>【卡片类型】打开单据,创建一个卡片类型,输入名称和编码,自定义卡片对象字段选择上面步骤创建的卡片。保存卡片类型后提交、审核该卡片。
三、创建一个主页卡片。
在【门户管理】=>【主页卡片】下面新增,输入编码和名称,
说明:
1、卡片类型字段选择上面步骤创建的卡片类型,其他字段可根据需要修改。
2、允许重复字段控制主页上是否能添加多次此卡片,
3、自动拓展高度控制此卡片高度(由于卡片的宽度是固定的,卡片高度会根据这个属性是自适应还是固定高度)。
保存后将卡片提交并审核,审核完成之后可以将卡片分配给用户和角色。
如果将此卡片分配给其他人时,其他人将不允许更改卡片,分配等操作,只有卡片的创建者才允许操作
四、完成卡片创建,进行卡片权限分配。
此时卡片的创建步骤已经完成,可以在【门户管理】=>【主页方案】下面创建或者修改主页方案,添加上方创建好的卡片进入,也可以直接在主页编辑(主页右上角编辑方案功能)时,进行编辑添加卡片操作中选择添加。
总结:
主页卡片创建的流程,确定卡片的类型,根据这个类型创建一个对应的卡片元数据,一个卡片类型可以衍生多张卡片。卡片审核后可以应用于卡片主页中。
首页新版主页二开自定义卡片实例之简单实例
本文2024-09-23 03:47:30发表“云星空知识”栏目。
本文链接:https://wenku.my7c.com/article/kingdee-k3cloud-161120.html