一、产品介绍
U创平台已经根据多年来在电力防误、智慧餐饮和智能家居等领域的软件开发经验,沉淀出多个领域的模型数据,分别通过领域函数管理工具、领域数据库工具、领域语言工具来管理。每种工具面向平台管理员以及应用开发者开放,其中平台管理员定义的数据为公共数据,提供给所有应用开发者使用;应用开发者定义的数据为私有数据,仅供所在的用户组或个人空间使用。
二、操作权限
上文也提到领域函数数据分为公共和私有两种类型,配合领域函数使用的函数插件也是如此,目前公共函数和插件由平台管理员定义和维护;私有函数和插件由应用开发者创建和维护,但同时平台管理员享有查看和删除的权利。具体操作权限矩阵如下,后文不做赘述。
2.1函数操作
2.2插件操作
本文以平台管理员的角色介绍领域函数管理工具的使用方法,分为两个模块函数管理和插件管理。
三、函数管理
3.1领域服务管理
领域服务作为领域函数的载体,用于存放同一领域或相关服务的函数。用户在录入函数之前可以选择现有的服务,或者新建服务,操作如下。
3.2新建领域函数
在函数管理首页,通过右上角的icon可以切换卡片视图或列表视图,找到对应的服务名称,点击“打开”进入对应服务的领域函数列表。
- 卡片视图
- 列表视图
在领域服务页,点击”新建服务”,添加领域服务。
创建好服务后,“打开”服务进入函数列表页,点击”新建”,添加领域函数。
打开”新增”,录入函数信息,函数类型包括:本地全局函数、云端服务函数、JS脚本转换函数、Lua脚本函数。
选择图片
编辑完成后,点击“确定”,需要决定当前函数是否马上发布,函数在发布后正式生效。选择“保存数据”,函数默认为“未发布”状态,可以稍后发布。
3.3调试领域函数
在函数检查的弹窗里,输入函数入参,点击“检查”,即可查看函数的返参。
注:函数检查将产生真实有效的函数执行结果,请谨慎使用。
3.4查看领域函数
在领域函数列表,点击”查看”,打开新页面,包含两个功能,默认“函数编辑”功能。
在此页可以修改函数信息,支持“保存”、“发布”和“复制”。
点击“版本管理”,可以查看当前函数的历史版本,并且切换“已发布环境”的版本。
3.5批量导入领域函数
点击“批量导入”函数按钮,可以通过上传导入文件批量定义领域函数。导入格式支持txt和swagger两种,其中txt文本需要符合平台定义的JSON数据规范。
唯一性标识:用户组+函数名称+函数Key+入参列表 (用于区分两个不同的领域函数)
导入模板:提供导入文件模板《functions.txt》和《functions.json》。如文件格式不正确提示错误信息。
导入模式:有两种:
普通模式:递增+同名不覆盖,即不导入已存在的数据,只导入增量数据
覆盖模式:递增+同名覆盖,即如存在同名不保留旧数据,同时导入增量数据
以swagger文件为例,平台会呈现出导入文件中所有的函数,请用户二次确认需要导入的函数。
若导入时,提示中文名不符合规范,点击右边的编辑按钮,进行编辑。
修改名称至符合规范,即可导入
点击“确定”后即可导入成功
3.6批量导出领域函数
在函数列表页,通过复选框选择多个需要导出的领域函数,点击“批量导出”,则可以将对应的函数保存为本地文件,导出文本格式符合平台定义的json数据规范,默认文件名为functions.txt。
导出文本示例。
3.7批量发布领域函数
勾选多条需要发布的函数点击“批量发布”,录入发布备注后“马上发布”可以批量发布多个函数。
已经发布函数支持二次发布,发布后线上生效版本更新至最新。
3.8批量删除领域函数
勾选需要删除的函数,点击”批量删除”,弹出确认提示,”确定”后生效。
3.9查询领域函数
在输入框输入函数中文名或英文名,点击” 放大镜”或“enter”返回查询结果,支持模糊查询。
四、插件管理
4.1新建插件
在领域模型管理页,找到“插件管理”,进入插件列表。
点击“新建插件”,录入插件信息,插件类型分为“鉴权插件”和“格式插件”两种,插件内容为JS代码,需要开发者录入。
4.2查看已绑定
在函数列表中,操作“已绑定”可以查看当前插件已经绑定哪些领域函数。
点击函数列表“查看”函数版本详情。
4.3编辑插件
点击“编辑”对插件进行编辑,“更新”后生效。
4.4删除插件
点击“删除”,弹出提示框。
当插件“已绑定”函数列表为空时,支持删除当前插件,否则不允许删除。
4.5查询插件
在输入框输入插件名称,点击” 放大镜”或“enter”返回查询结果,支持模糊查询。
-------------------------------------------------------------------------------------------------------------THE END------------------------------------------------------------------------------------------------------------------------------