盘古3.0-多环境多版本 操作手册
1. 环境
系统在开发环境、测试环境、预发环境、生产环境之间进行切换,实现在不同环境中进行系统操作。
在系统主界面中,通过点击右上角环境切换按钮进行系统环境切换
2. 应用
确定创建位置
在盘古公共开发平台中,所有的「应用」都存在于某一个「应用组」中,因此,在创建应用前,我们需要确定好要在哪个「应用组」下创建「应用」,或者创建一个新的「应用组」。
创建一个应用组
环境选中开发环境,导航栏选中应用开发,应用抽屉中找到应用管理,点击应用列表右侧“+”后选择“新建应用组”按钮新建应用组。
创建应用组需要填写的内容:
名称:应用组的中文名称,必填。
排序:应用组在应用列表中的显示顺序。
领域:应用组所属领域类型。
描述:应用组信息描述。
主题图片:应用抽屉中展示的背景图片。
编辑:对应用组名称,排序,领域,描述,主体图片进行更改;
删除:若该应用组下已包含应用,则无法删除该应用组,需先删除应用。
创建应用
在「开发平台」中,「应用」以树形列表的形式呈现在选中应用组的应用列表中,选择某一个应用组,展开会展示当前应用组下的所有应用列表。
开发环境下,在应用管理页面点击新建应用或点击应用组右侧图标在新建应用,进行应用的创建。
点击「创建应用」,选择想要创建的应用终端(PC或移动端),需要填写的内容如下:
基础信息
名称:应用的中文名称,必填。
编码:应用的英文编码,需要保证唯一性(注意:应用编码中不能包含-),必填。
应用组:应用所属的应用组。
水印:开启水印后,该应用下的所有页面将会显示水印。
描述:应用的功能补充描述,会展示在应用抽屉中。
应用图标:从预置的图标库中选择适合应用功能的图标,也可以从本地上传,必填。
高级信息
排序:应用在所属应用组中的排列顺序。
首页类型:应用首页的渲染类型。
默认首页:该应用首页显示系统默认欢迎页
页面:选择已创建的页面作为应用的首页
外链:设置一个url地址作为应用的跳转目标
菜单:todo
打开方式:应用列表中点击应用时的打开方式。
新页签:在系统顶部导航栏打开新的应用页签进行展示
新窗口:在浏览器打开新的浏览器页签进行展示
菜单宽度:可配置应用内左侧菜单的宽度,默认为208px;自定义:自己填入宽度;移动端没有此配置项。
轻应用配置(仅移动端有)
首先须完成信鸿轻应用的申请,申请完成后将轻应用的AppID、APPSecret、团队EID以下信息填入完成配置。
其他操作
删除:应用新增后,将鼠标移动至应用右侧...图标上,可对应用进行删除,删除应用会将该应用下「页面」全部删除,如果应用下页面同时被绑定到了其他应用下的「菜单」,需要先将「其他应用」下的「菜单」与该页面解绑后才可删除应用。应用下菜单绑定了其他应用下的页面,需要先将菜单删除或和与页面解绑(更换关联页面为应用下页面),才可删除应用。
编辑:在应用编辑TAB页面可对应用下基本信息进行编辑。
2.1 应用版本管理
在应用版本管理页面可对应用版本进行增删改查等操操作
新增版本:创建一个新的应用版本
页面:跳转到应用-页面管理。
菜单:跳转到应用-菜单管理。
复制(仅限开发环境):复制当前应用版本。
编辑(仅限开发环境):修改此版本的基本信息。
删除(仅限开发和测试环境):删除应用会将该应用版本下「页面」全部删除。
迁移:将该应用版本由当前环境迁移至下一环境,迁移路径为开发→测试→预发→生产。
终止(测试和预发环境):将该应用版本终止掉,不能再进行迁移操作
详情:查看该应用版本的基本信息。
运行管理
对应用的运行版本进行管理。
预览:查看应用的运行效果。
应用迁移记录
应用的历史迁移记录,点击明细可查看每次迁移的内容。
3. 多语言
3.1 项目词条管理
项目词条管理提供了词条新增,支持GPT在线翻译,词条展示、筛选,在线编辑,进入引用页面,查看词条引用数量,词条删除、批量翻译、导入、导出等功能操作。
操作指南
入口
顶部导航条——应用开发——多语言——词条管理
在项目词条管理页面,词条数量过多时,此时可以在页面右上角根据文案/国际化key进行快速搜索定位。
注:文案支持模糊查询,国际化key则必须精确匹配。
新增词条
点击新建词条,在对应弹出框输入想要新增的词条:
平台也提供GPT在线翻译助手帮助我们快速生成,只需点击-->选择基准语言(默认自动检测)和翻译目标语言-->输入词条-->点击翻译-->一键插入-->确定,即可:
批量翻译
盘古平台也支持批量翻译(至少勾选一项词条后方可使用该功能),选定词条后,在批量翻译弹窗选择基础语言(表格中该词条已存在的语言)要翻译的目标语言即可:
在翻译完成也可点击查看详情,如果觉得翻译结果不太精准,也可双击对应单元格进行编辑修改,确认无误点击确定后即可填充到首页表格。
批量迁移
点击批量迁移,选择需要迁移的词条,将选中的词条由当前环境迁移至下一环境,迁移路径:开发→测试→预发→生产。
注意:批量迁移时只对发生修改或者新增的词条执行迁移。
全部迁移
点击全部迁移,将所有词条迁移至下一环境。
注意:由开发→测试环境,测试→预发环境全量迁移时,会将下一环境的全部词条替换掉,保持两个环境间词条完全一样。由预发→生产环境全部迁移时词条不会被替换掉。
迁移记录
词条历史迁移记录,可查看每次迁移的明细。
批量发布(生产环境)
选泽未发布的词条,点击批量发布,使其在生产环境中生效。
版本记录(生产环境)
在词条列表中点击版本记录,可查看该词条历史生效本版。
回滚(生产环境)
在版本记录中点击回滚,可切换词条生效版本。
导入/导出
词条管理中选择相应的词条后,支持execl形式的导入/导出功能,以方便使用。在词条导入时,可以选择更新规则,提供使用导入模版:
模板说明:
1.模版keyType字段仅支持web(前端)与backend(后端)类型,字段不能为空。
2.如需添加web类型文案,languageKey格式为intl_{8}-{4}-{4}-{4}-{12}(intl_UUID32位)。
3.如需添加backend类型文案,languageKey格式为intl_backend_{8}-{4}-{4}-{4}-{12}(intl_backend_UUID32位)。
4.如需添加公共类型文案,模版keyType字段仅支持web(前端)。
5.模板中内容请勿修改,以防止导入出现问题。
编辑
若对于引用的词条信息有变动,可以点击对应词条的右侧编辑图标,对当前词条进行相应的修改,修改操作步骤和新增类似:
此时在编辑词条的右侧会显示该词条引用详情(引用数量和引用位置),修改词条后,被引用的地方的词条信息也会对应变动。
删除
页面中表格上方的删除图标支持批量删除(仅在至少选择一条词条的情况下才能使用),对应词条右侧的删除图标仅能对该词条进行删除。
注意:已经被引用的词条暂时无法删除!
3.2 公共词条管理
公共词条管理提供了词条新增,支持GPT在线翻译,词条展示、筛选,在线编辑,查看词条引用数量、引用位置,进入引用页面,词条删除、批量翻译、导入、导出等功能操作。
操作指南
入口
顶部导航条——配置中心——公共词条管理
在词条管理页面,词条数量过多时,此时可以在页面右上角根据文案/国际化key进行快速搜索定位。
注:文案支持模糊查询,国际化key则必须精确匹配。
新增词条
点击新建词条,在对应弹出框输入想要新增的词条:
平台也提供GPT在线翻译助手帮助我们快速生成,只需点击-->选择基准语言(默认自动检测)和翻译目标语言-->输入词条-->点击翻译-->一键插入-->确定,即可:
批量翻译
盘古平台也支持批量翻译(至少勾选一项词条后方可使用该功能),选定词条后,在批量翻译弹窗选择基础语言(表格中该词条已存在的语言)要翻译的目标语言即可:
在翻译完成也可点击查看详情,如果对觉得翻译结果不太精准,也可双击单元进行编辑修改。
批量迁移
点击批量迁移,选择需要迁移的词条,将选中的词条由当前环境迁移至下一环境,迁移路径:开发→测试→预发→生产。
注意:批量迁移时只对发生修改或者新增的词条执行迁移。
全部迁移
点击全部迁移,将所有词条迁移至下一环境。
注意:由开发→测试环境,测试→预发环境全量迁移时,会将下一环境的全部词条替换掉,保持两个环境间词条完全一样。由预发→生产环境全部迁移时词条不会被替换掉。
迁移记录
词条历史迁移记录,可查看每次迁移的明细。
批量发布(生产环境)
选泽未发布的词条,点击批量发布,使其在生产环境中生效。
版本记录(生产环境)
在词条列表中点击版本记录,可查看该词条历史生效本版。
回滚(生产环境)
在版本记录中点击回滚,可切换词条生效版本。
导入/导出
词条管理中选择相应的词条后,支持execl形式的导入/导出功能,以方便使用。在词条导入时,提供使用导入模版:
xml
模板说明:
1.模版keyType字段仅支持web(前端)与backend(后端)类型,字段不能为空。
2.如需添加web类型文案,languageKey格式为intl_{8}-{4}-{4}-{4}-{12}(intl_UUID32位)。
3.如需添加backend类型文案,languageKey格式为intl_backend_{8}-{4}-{4}-{4}-{12}(intl_backend_UUID32位)。
4.如需添加公共类型文案,模版keyType字段仅支持web(前端)。
5.模板中内容请勿修改,以防止导入出现问题。
编辑
若对于引用的词条信息有变动,可以点击对应词条的右侧编辑图标,对当前词条进行相应的修改,修改操作步骤和新增类似:
此时在编辑词条的右侧会显示该词条引用详情(引用数量和引用位置),修改词条后,被引用的地方的词条信息也会对应变动。
位置详情
点击词条对应右侧的位置详情图标,可查看该词条具体被引用信息。
删除
页面中表格上方的删除图标支持批量删除(默认不生效,仅在至少选择一条词条的情况下才能使用),对应词条右侧的删除图标仅能对该词条进行单量删除。
注意:已经被引用的词条暂时无法删除!
4. 数据建模
盘古公共开发平台引入了数据建模模块,使用数据建模,生成建模信息,一键发布,在盘古平台数据中心建立相关表,提高开发效率。
入口
你可以参考以下步骤从导航栏中,进入数据建模菜单。
1.登录盘古公共开发平台工作。
2.查看上方导航栏,到并进入「流程中心」。
3.在左侧菜单栏选择数据建模,点击即可进入数据建模菜单页。
分类管理
盘古提供的分类管理主要功能是新建[模型分组],对后边新增的数据模型进行管理,这样有便于方便对数据模型查找与引用。
进入页面展示所有的模型组的信息,也可以根据分类名称,单独过滤对应的分组信息,分组信息包括有:分组名称、详情和修改日期。
新建分类
在创建模型前,需要确定好要在哪个「分组」下创建「模型」,或者创建一个新的「分组」,这样有便于使用者可以更好的管理数据模型。
选择指定数据模型分组
可以选择列表中存在的模型组
新建数据模型分组
1.在开发环境下,点击下方图片红色选择框内的[新建分类]
2.编辑数据模型分组信息
• 分类名称:分组的名称,最好能见名知意,必填。
• 图标选择:从预置的图标库中选择适合该分组的图标标识。
• 图标背景:分组标识的背景颜色,可选择纯色和渐变色进行填充。
• 描述:分组的简洁文字性描述。
删除&修改
在开发环境下可对模型进行修改、删除
1.修改时,点击修改可以分组属性进行修改。
2.删除时,若模型分组下存在模型,则无法被删除。
模型管理
盘古提供的模型就是在数据库中创建相应的表格,对模型的管理就是对数据库中的表格进行管理。我们可以对分组下已经存在的模型进行管理,也可以新建所需的新模型。
点击红色框进入模型管理页面。
1.点击红色框①可以更换其他已经创建的模型分组。
2.点击红色框②可以创建新的数据模型。
添加模型设置
模型设置主要是对模型的公共字段进行操作,用户可以根据自己的需要将除现有公共字段外的字段进行添加、删除、以方便数据库的操作。
字段信息:
• 字段信息:模型的名称,必填。
• 编码:模型对应的字母、数字组合的编码,大写开头,全局唯一,必填。
• 字段类型:字段展示类型,必填。
注意:设置默认字段后,新创建的数据模型将自动创建以下字段,之前已经创建的模型将不受影响。
新增数据模型
点击红色框①新建数据模型。
红色框②内,用户可以根据自己的业务需要,填写基本信息、字段信息、索引信息。
1.填写基本信息
• 模型名称:模型的名称,必填。
• 编码:模型对应的字母、数字组合的编码,大写开头,全局唯一,必填。
• 描述:模型的简洁文字性介绍。
2.填写模型字段信息
除去模型设置所添加的字段,无法操作,用户可以根据自己的业务需要,点击新增一行添加字段。
在字段详情页面需要填写相应内容。
• 字段名称:字段的名称,必填。
• 编码:字段的唯一标识,必填。
• 字段类型:字段的类别,必填。
• 字段默认值:未赋值时字段对应的值。
注意:
1.模型创建时必须要有业务字段。
2.主键为空时,模型无法创建。
3.主键只能是长整型,和字符串。
4.添加新字段时,编码属性不能是关键字。
3.填写模型索引信息
用户可以根据自己的业务需要,点击新增索引也可以删除索引。
• 索引名称:索引的名字,必填。
• 编码:索引的唯一编码,字母、数字组合,小写开头,必填。
• 索引列:选择索引所对应的数据库列。可根据情况选择是否为唯一索引。
• 描述:对索引的文字性描述。
模型发布
新建的数据模型状态为未发布,这时候数据模型并没有创建数据表,只有点击发布后才会在数据库里,生成对应数据模型的表。
注意:发布后的数据模型进行编辑保存,状态会被变更为未发布。
Diff功能
可查看当前模型最新版本与下一环境最新版本的区别,开发与测试环境对比,测试与预发环境对比,预发与生产环境对比。
模型迁移
点击模型迁移按钮,选择模型进行迁移。
注意:当模型存在多个版本时,迁移只会迁移其最新已发布的版本。
迁移记录
点击迁移记录按钮,查看模型历史的迁移记录。
在迁移记录页面点击明细,可查看每次迁移的模型明细。
查看设计视图
盘古平台还提供了数据模型设计视图,用户可以点击进入设计视图,以图解方式更加清晰直观的了解此模型中数据表之间的关联关系,并支持导出图片。