数据传输
功能概述
数据传输,为开发、实施人员提供开发、测试、生产多环境之间应用构建类和实施配置类数据的自动化传输工具。
关键应用
为用户提供传输包管理、传输包上载、传输包部署三个菜单入口,支持开发配置数据打包、上载、部署的传输流程。
主要字段说明
传输包管理入口:通过菜单【应用构建服务】→【构建平台】→【传输包管理】,进入功能。
字段名称 | 说明 |
---|---|
包编码 | 新建传输包时自动生成的传输包唯一标识 |
状态 | 状态值包括:无数据、未上载、已上载。“无数据”标识当前传输包内还未添加任何数据;“未上载”标识当前传输包还未上载到任何其他环境;“已上载”标识当前传输包已经存在上载到其他环境的情况,已上载后将不可对当前传输包内容再进行调整。 |
数据类型 | 可通过传输包传输的数据类型名称,比如应用构建的应用、数据建模的元数据实体、页面建模的单据页面、实施配置的编码规则等,可选择具体数据类型下的数据添加到传输包内,进行传输。 |
包含方式 | 描述添加到传输包中的方式,分为两类,一类是用户在添加数据页面上选择的,一类是通过选择的数据关联导出的。 |
传输包上载入口:通过菜单【应用构建服务】→【构建平台】→【传输包上载】,进入功能。
字段名称 | 说明 |
---|---|
包编码 | 新建传输包时自动生成的传输包唯一标识 |
目标租户 | 传输包上载的目标租户 |
目标环境 | 传输包上载到的目标租户所属的基础设施环境 |
状态 | 状态值包括:上载中、成功、失败。“上载中”标识当前传输包在向目标租户传输中;“成功”标识当前传输包已经成功上载到目标租户;“失败”标识当前传输包未成功上载到目标租户,需要重试。 |
传输包部署入口:通过菜单【应用构建服务】→【构建平台】→【传输包部署】,进入功能。
字段名称 | 说明 |
---|---|
包编码 | 传输包的唯一标识 |
来源租户 | 将传输包上载到当前租户的来源租户 |
来源环境 | 来源租户所属的基础设施环境 |
状态 | 状态值包括: 待部署、部署中、成功、失败。“待部署”状态标识当前租户接收到且还未部署的传输包,仅在待部署页签中存在;“部署中”状态标识当前传输包正在部署导入过程中;“成功”状态标识当前传输包已经成功部署导入到当前租户;“失败”状态标识当前传输包部署导入的过程中出现错误,需要检查重试。 |
主要操作说明
传输包管理
新建传输包
点击“新建传输包”按钮进行新建。新建时,仅需填写包名称和描述;确认保存时,会为这个包生成一个唯一标识的包编码,在后续传输包在各个环境间流转时作为唯一依据。
添加数据
传输包列表上点击“查看”按钮进入传输包详情后,点击“添加数据”按钮,选择需要添加到当前传输包进行一同传输的数据。
选择数据时,可选择当前选定数据类型下的数据加入到已选数据中。当前版本支持应用构建下的应用选择。
选择数据后点击确认,将会根据当前数据业务逻辑导出本身及相关联的数据到传输包内,可在传输包详情内查看导出的数据内容。
传输方向设置
管理员账户才能进行设置,看到对应按钮 可选择的来源环境范围为当前用户有权限的多环境下的租户传输包上载
上载传输包
进入“传输包上载”功能,根据具体开发或者实施打包人员等输出的传输包编码查找,且进行选择目标环境进行上载的操作。
上载时,可选择的目标环境范围为设置了允许该租户作为来源租户的租户。 即上步操作【传输方向设置】
传输包部署
部署模式配置
进入“传输包部署”功能,点击右上角“部署模式配置”按钮,可操作配置上载到当前租户的传输包的部署导入时机。默认为“手动部署”,即需要部署人员进入功能节点内在待部署页签仅手动点击部署按钮进行部署;用户也可根据需要将部署模式调整为“自动部署”,自动部署包括迁入时立即部署和每日定时部署两种配置。
部署
作为传输包接收方,会根据部署模式配置的进行传输包数据部署导入仅当前租户。
手动部署。进入“待部署”页签,查找到需要部署的传输包,点击“部署”按钮执行操作,开始执行后会自动跳转进入已部署页签,可查看和跟进当前传输包的部署状态。
自动部署。配置为“迁入时立即部署”时,当前租户接收到其他环境上载上来的传输包时,系统将自动执行部署操作;配置为“每日定时部署”时,系统将在每天对应的时间点自动将待部署的传输包部署导入到当前租户。
导入传输包
专属化环境下,点击右上角的“导入传输包”按钮,会弹出导入传输包的窗口,可选择本地传输包压缩文件包进行导入。
选择文件后,导入传输包窗口内即显示出当前传输包信息,确认无误后,即可点击导入按钮进行导入操作。
导入后,即可在“待部署”列表查看到该传输包,可对该传输包进行查看包详情、部署、删除的操作。
生产/沙箱环境——>灰度环境
目前传输包不支持从生产/沙箱环境界面化操作迁移至灰度环境,暂提供如下两个接口
- 获取来源环境的传输包:url中的域名要与来源环境一致;packId为传输包的主键,可在传输包管理界面F12获取。
https://yonbip.diwork.com/iuap-yonbuilder-transdata/packEvent/getPackUrl?packId=XXX&serviceCode=apppkgtransfer
获取上述接口获取的返回值,将返回值中的路径粘贴至浏览器请求即可下载下来传输包
使用postman请求接口上载传输包至目标环境:url域名与目标环境一致
https://yonbip-core1.diwork.com/iuap-yonbuilder-transdata/packEvent/uploadZip/upload?serviceCode=apppkgdeploy
header中必须携带目标环境的cookie,body中file="上面步骤下载的压缩包"