金蝶云星辰扩展应用包发布指引原创
金蝶云社区-小微生态何惠珍
小微生态何惠珍
1人赞赏了该文章 1,226次浏览 未经作者许可,禁止转载编辑于2022年11月01日 17:07:44

发布应用包前需要确保已在应用市场创建应用,应用包绑定的应用市场编码一定要从应用市场来的,否则客户购买应用将无法启用

应用包发布一般需要以下几个步骤(没有使用到则自行删减):

签入应用/页面元数据à签入转换规则à提交编写的SQL脚本文件到gità插件构建发布à配置应用包插件à应用包预发布à应用包发布à客户购买启用

1、签入应用/页面元数据

在开发平台应用管理界面点击签入图标,进入弹框

image.png

在弹框中选择需要签入到git的表单页面,填写注释信息,提交

image.png

2、签入转换规则

进入 系统配置>业务流程开发>转换规则,选中应用包需要的转换规则,点击“签入”按钮签入到git仓库,可根据应用和单据还有转换规则状态筛选后再批量签入。

image.png

进入 系统配置>业务流程开发>反写规则,选中应用包需要的反写规则,点击“签入”按钮签入到git仓库,可根据应用和单据还有反写规则状态筛选后再批量签入。

image.png

3、编写SQL脚本

SQL脚本的组成部分:

DDL

l  单据新增的表

l  新增的索引

l  在星辰原表上增加字段

DML

l  编码规则

l  菜单

l  系统参数

 

详细编写教程可以参考《星辰脚本制作》文档。

4、插件构建发布

在WebIDE发布jar

image.png

5、配置应用包插件

应用管理>我的应用,选中发布的应用包,点击插件项目配置,选中应用包需要的插件,多个插件点击【+】增加一行。

image.png

6、应用包发布

6.1、发布

应用发布前,先保证元数据(应用页面元数据、转换规则、反写规则、sql脚本)已迁入

① 应用管理>我的应用,选中发布的应用包,点击“模块管理”,选中需要发布的应用,点击“添加”按钮将应用移到选中模块。

image.png

点击【下一步】,设置应用发布顺序,要求:基础资料需要排在前面。

image.png


②应用管理>我的应用,选中发布的应用包,点击“测试发布”按钮,完成预发布,此发布是将代码和元数据发布到集成测试环境。

image.png

发布结果可以点击‘账套升级管理’按钮查看,账套ID为‘meta_tenant’的账套发布失败,则说明页面元数据发布失败,其他账套发布失败,说明存在数据库脚本问题。

image.png

 

③发布灰度环境。在测试环境的代码和元数据都没有问题的情况下,可以根据自己的发布计划,将测试环境的代码和元数据发布到灰度环境。勾选应用,点击‘预发布’将测试环境的代码和元数据同步到灰度环境。

image.png

④发布生产环境。在灰度环境的代码和元数据都没有问题的情况下,可以根据自己的发布计划,将体验环境的代码和元数据发布到生产环境。勾选应用,点击‘发布’将灰度环境的代码和元数据同步到生产环境。

image.png


6.2、发布问题排查

在应用列表勾选应用,点击【账套升级管理】可以查看发布情况。

image.png


如下图所示,

账套环境:集成测试-集成测试环境  灰度-体验环境  生产-生产环境。

元数据版本:账套的元数据版本。

是否最新:最新说明账套和改环境下的应用最新版本是一致的,否则说明此账套的元数据没有更新。

升级状态:正常-说明发布成功,失败-说明发布失败,可以勾选该行,点击【升级日志】查看失败原因。

若是要保证发布成功,首先要保证账套ID为 【meta_tenant】的升级状态正常,此账套正常,则查看其它客户账套的升级情况。

image.png


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、客户购买启用

客户在应用市场购买应用,登录星辰账套,在应用授权绑定应用包到对应账套即可使用该应用包

image.png

















赞 1