本文概述了发布应用包的流程,包括签入元数据、转换规则、编写SQL脚本、插件构建发布、配置应用包插件、应用包预发布及正式发布等步骤,并详细解释了各步骤的操作方法。此外,还提供了发布问题的排查方法和常见问题的解答,帮助客户在购买并启用应用包时顺利进行。
l 发布应用包前需要确保已在应用市场创建应用,应用包绑定的应用市场编码一定要从应用市场来的,否则客户购买应用将无法启用
应用包发布一般需要以下几个步骤(没有使用到则自行删减):
签入应用/页面元数据à签入转换规则à提交编写的SQL脚本文件到gità插件构建发布à配置应用包插件à应用包预发布à应用包发布à客户购买启用
1、签入应用/页面元数据
在开发平台应用管理界面点击签入图标,进入弹框
在弹框中选择需要签入到git的表单页面,填写注释信息,提交
2、签入转换规则
进入 系统配置>业务流程开发>转换规则,选中应用包需要的转换规则,点击“签入”按钮签入到git仓库,可根据应用和单据还有转换规则状态筛选后再批量签入。
进入 系统配置>业务流程开发>反写规则,选中应用包需要的反写规则,点击“签入”按钮签入到git仓库,可根据应用和单据还有反写规则状态筛选后再批量签入。
3、编写SQL脚本
SQL脚本的组成部分:
DDL
l 单据新增的表
l 新增的索引
l 在星辰原表上增加字段
DML
l 编码规则
l 菜单
l 系统参数
详细编写教程可以参考《星辰脚本制作》文档。
4、插件构建发布
在WebIDE发布jar
5、配置应用包插件
应用管理>我的应用,选中发布的应用包,点击插件项目配置,选中应用包需要的插件,多个插件点击【+】增加一行。
6、应用包发布
6.1、发布
应用发布前,先保证元数据(应用页面元数据、转换规则、反写规则、sql脚本)已迁入。
① 应用管理>我的应用,选中发布的应用包,点击“模块管理”,选中需要发布的应用,点击“添加”按钮将应用移到选中模块。
点击【下一步】,设置应用发布顺序,要求:基础资料需要排在前面。
②应用管理>我的应用,选中发布的应用包,点击“测试发布”按钮,完成预发布,此发布是将代码和元数据发布到集成测试环境。
发布结果可以点击‘账套升级管理’按钮查看,账套ID为‘meta_tenant’的账套发布失败,则说明页面元数据发布失败,其他账套发布失败,说明存在数据库脚本问题。
③发布灰度环境。在测试环境的代码和元数据都没有问题的情况下,可以根据自己的发布计划,将测试环境的代码和元数据发布到灰度环境。勾选应用,点击‘预发布’将测试环境的代码和元数据同步到灰度环境。
④发布生产环境。在灰度环境的代码和元数据都没有问题的情况下,可以根据自己的发布计划,将体验环境的代码和元数据发布到生产环境。勾选应用,点击‘发布’将灰度环境的代码和元数据同步到生产环境。
6.2、发布问题排查
在应用列表勾选应用,点击【账套升级管理】可以查看发布情况。
如下图所示,
账套环境:集成测试-集成测试环境 灰度-体验环境 生产-生产环境。
元数据版本:账套的元数据版本。
是否最新:最新说明账套和改环境下的应用最新版本是一致的,否则说明此账套的元数据没有更新。
升级状态:正常-说明发布成功,失败-说明发布失败,可以勾选该行,点击【升级日志】查看失败原因。
若是要保证发布成功,首先要保证账套ID为 【meta_tenant】的升级状态正常,此账套正常,则查看其它客户账套的升级情况。
6.3、发布常见问题
1、 问:发布之后,元数据版本更新了,但是账套里没有看到相关的页面改动。
答:请检查①应用/页面元数据是否签入git,可登陆git查看,元数据在metadatabase/apps目录下。②模块管理是否选中该应用。
2、 问:为什么git提交元数据提示元数据没有变化,实际上是有改动的
答:检查一下元数据是否提交成功,检查一下.ignore文件是否忽略元数据文件(后缀为 .dym/.dymx/.app/.appx/.cr/.crx/.wb/.wbx)。
3、 问:sql脚本已提交到git,元数据也发布成功了,但是还是提示缺少表或者字段。
答:①元数据metadatabase/apps/{应用编码} 目录下是否存在 {应用编码}.xml文件(xml命名必须和上级目录一致)② 检查xml文件中是否包含该sql文件目录。③ sql文件中的sql语句每句sql结束是否以【;】分隔。
4、 问:体验环境编码规则没有生效、开发环境是好的。
答:请确认是否增加编码规则sql脚本到元数据,详情可以参考《星辰脚本制作》文档。
5、 问:体验环境转换规则或者反写规则没有生效,开发账套正常。
答:转换规则或者反写规则是否已经签入,没有请执行签入操作,若是执行仍未生效,请登录git master 分支查看metadatabase/app/元数据中是否有转换规则或者反写规则元数据文件(文件是.cr、.wb后缀)。
7、客户购买启用
客户在应用市场购买应用,登录星辰账套,在应用授权绑定应用包到对应账套即可使用该应用包
推荐阅读