Skip to content

盘古3.0-多环境多版本 操作手册

1. 环境

系统在开发环境、测试环境、预发环境、生产环境之间进行切换,实现在不同环境中进行系统操作。

在系统主界面中,通过点击右上角环境切换按钮进行系统环境切换 多环境多版本-1环境

2. 应用

确定创建位置

在盘古公共开发平台中,所有的「应用」都存在于某一个「应用组」中,因此,在创建应用前,我们需要确定好要在哪个「应用组」下创建「应用」,或者创建一个新的「应用组」。

创建一个应用组

环境选中开发环境,导航栏选中应用开发,应用抽屉中找到应用管理,点击应用列表右侧“+”后选择“新建应用组”按钮新建应用组。

多环境多版本-2应用1

创建应用组需要填写的内容:

多环境多版本-2应用2

  • 名称:应用组的中文名称,必填。

  • 排序:应用组在应用列表中的显示顺序。

  • 领域:应用组所属领域类型。

  • 描述:应用组信息描述。

  • 主题图片:应用抽屉中展示的背景图片。

编辑:对应用组名称,排序,领域,描述,主体图片进行更改;

删除:若该应用组下已包含应用,则无法删除该应用组,需先删除应用。

创建应用

在「开发平台」中,「应用」以树形列表的形式呈现在选中应用组的应用列表中,选择某一个应用组,展开会展示当前应用组下的所有应用列表。

开发环境下,在应用管理页面点击新建应用或点击应用组右侧图标在新建应用,进行应用的创建。

多环境多版本-2应用2.1

点击「创建应用」,选择想要创建的应用终端(PC或移动端),需要填写的内容如下:

多环境多版本-2应用3

基础信息

  • 名称:应用的中文名称,必填。

  • 编码:应用的英文编码,需要保证唯一性(注意:应用编码中不能包含-),必填。

  • 应用组:应用所属的应用组。

  • 水印:开启水印后,该应用下的所有页面将会显示水印。

  • 描述:应用的功能补充描述,会展示在应用抽屉中。

  • 应用图标:从预置的图标库中选择适合应用功能的图标,也可以从本地上传,必填。

高级信息

多环境多版本-2应用4

  • 排序:应用在所属应用组中的排列顺序。

  • 首页类型:应用首页的渲染类型。

    • 默认首页:该应用首页显示系统默认欢迎页

    • 页面:选择已创建的页面作为应用的首页

    • 外链:设置一个url地址作为应用的跳转目标

    • 菜单:todo

  • 打开方式:应用列表中点击应用时的打开方式。

    • 新页签:在系统顶部导航栏打开新的应用页签进行展示

    • 新窗口:在浏览器打开新的浏览器页签进行展示

  • 菜单宽度:可配置应用内左侧菜单的宽度,默认为208px;自定义:自己填入宽度;移动端没有此配置项。

轻应用配置(仅移动端有)

多环境多版本-2应用5

首先须完成信鸿轻应用的申请,申请完成后将轻应用的AppID、APPSecret、团队EID以下信息填入完成配置。

其他操作

多环境多版本-2应用6

删除:应用新增后,将鼠标移动至应用右侧...图标上,可对应用进行删除,删除应用会将该应用下「页面」全部删除,如果应用下页面同时被绑定到了其他应用下的「菜单」,需要先将「其他应用」下的「菜单」与该页面解绑后才可删除应用。应用下菜单绑定了其他应用下的页面,需要先将菜单删除或和与页面解绑(更换关联页面为应用下页面),才可删除应用。

编辑:在应用编辑TAB页面可对应用下基本信息进行编辑。

多环境多版本-2应用7

2.1 应用版本管理

多环境多版本-2应用8

在应用版本管理页面可对应用版本进行增删改查等操操作

新增版本:创建一个新的应用版本

页面:跳转到应用-页面管理。

菜单:跳转到应用-菜单管理。

复制(仅限开发环境):复制当前应用版本。

编辑(仅限开发环境):修改此版本的基本信息。

删除(仅限开发和测试环境):删除应用会将该应用版本下「页面」全部删除。

迁移:将该应用版本由当前环境迁移至下一环境,迁移路径为开发→测试→预发→生产。

终止(测试和预发环境):将该应用版本终止掉,不能再进行迁移操作

详情:查看该应用版本的基本信息。

运行管理

多环境多版本-2应用9

对应用的运行版本进行管理。

预览:查看应用的运行效果。

应用迁移记录

多环境多版本-2应用10

应用的历史迁移记录,点击明细可查看每次迁移的内容。

3. 多语言

3.1 项目词条管理

项目词条管理提供了词条新增,支持GPT在线翻译,词条展示、筛选,在线编辑,进入引用页面,查看词条引用数量,词条删除、批量翻译、导入、导出等功能操作。

操作指南

入口

顶部导航条——应用开发——多语言——词条管理

在项目词条管理页面,词条数量过多时,此时可以在页面右上角根据文案/国际化key进行快速搜索定位。

注:文案支持模糊查询,国际化key则必须精确匹配。

多环境多版本-3多语言1

新增词条

点击新建词条,在对应弹出框输入想要新增的词条:

多环境多版本-3多语言2

平台也提供GPT在线翻译助手帮助我们快速生成,只需点击-->选择基准语言(默认自动检测)和翻译目标语言-->输入词条-->点击翻译-->一键插入-->确定,即可:

多环境多版本-3多语言2-3

多环境多版本-3多语言2-4

批量翻译

盘古平台也支持批量翻译(至少勾选一项词条后方可使用该功能),选定词条后,在批量翻译弹窗选择基础语言(表格中该词条已存在的语言)要翻译的目标语言即可:

多环境多版本-3多语言2-6

在翻译完成也可点击查看详情,如果觉得翻译结果不太精准,也可双击对应单元格进行编辑修改,确认无误点击确定后即可填充到首页表格。

多环境多版本-3多语言2-7

多环境多版本-3多语言2-8

批量迁移

点击批量迁移,选择需要迁移的词条,将选中的词条由当前环境迁移至下一环境,迁移路径:开发→测试→预发→生产。

多环境多版本-3多语言2-9

多环境多版本-3多语言2-10

注意:批量迁移时只对发生修改或者新增的词条执行迁移。

全部迁移

点击全部迁移,将所有词条迁移至下一环境。

注意:由开发→测试环境,测试→预发环境全量迁移时,会将下一环境的全部词条替换掉,保持两个环境间词条完全一样。由预发→生产环境全部迁移时词条不会被替换掉。

迁移记录

词条历史迁移记录,可查看每次迁移的明细。

多环境多版本-3多语言2-11

批量发布(生产环境)

选泽未发布的词条,点击批量发布,使其在生产环境中生效。

多环境多版本-3多语言2-12

版本记录(生产环境)

在词条列表中点击版本记录,可查看该词条历史生效本版。

多环境多版本-3多语言2-13

回滚(生产环境)

在版本记录中点击回滚,可切换词条生效版本。

多环境多版本-3多语言2-14

导入/导出

词条管理中选择相应的词条后,支持execl形式的导入/导出功能,以方便使用。在词条导入时,可以选择更新规则,提供使用导入模版:

多环境多版本-3多语言2-15

多环境多版本-3多语言2-15

模板说明:

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-17

删除

页面中表格上方的删除图标支持批量删除(仅在至少选择一条词条的情况下才能使用),对应词条右侧的删除图标仅能对该词条进行删除。

多环境多版本-3多语言2-19

注意:已经被引用的词条暂时无法删除!

3.2 公共词条管理

公共词条管理提供了词条新增,支持GPT在线翻译,词条展示、筛选,在线编辑,查看词条引用数量、引用位置,进入引用页面,词条删除、批量翻译、导入、导出等功能操作。

操作指南

入口

顶部导航条——配置中心——公共词条管理

在词条管理页面,词条数量过多时,此时可以在页面右上角根据文案/国际化key进行快速搜索定位。

注:文案支持模糊查询,国际化key则必须精确匹配。

多环境多版本-3多语言2-1

新增词条

点击新建词条,在对应弹出框输入想要新增的词条:

多环境多版本-3多语言2-2

平台也提供GPT在线翻译助手帮助我们快速生成,只需点击-->选择基准语言(默认自动检测)和翻译目标语言-->输入词条-->点击翻译-->一键插入-->确定,即可:

多环境多版本-3多语言2-3

多环境多版本-3多语言2-4

多环境多版本-3多语言2-5

批量翻译

盘古平台也支持批量翻译(至少勾选一项词条后方可使用该功能),选定词条后,在批量翻译弹窗选择基础语言(表格中该词条已存在的语言)要翻译的目标语言即可:

多环境多版本-3多语言2-6

在翻译完成也可点击查看详情,如果对觉得翻译结果不太精准,也可双击单元进行编辑修改。

多环境多版本-3多语言2-7

多环境多版本-3多语言2-8

批量迁移

点击批量迁移,选择需要迁移的词条,将选中的词条由当前环境迁移至下一环境,迁移路径:开发→测试→预发→生产。

多环境多版本-3多语言2-9

多环境多版本-3多语言2-10

注意:批量迁移时只对发生修改或者新增的词条执行迁移。

全部迁移

点击全部迁移,将所有词条迁移至下一环境。

注意:由开发→测试环境,测试→预发环境全量迁移时,会将下一环境的全部词条替换掉,保持两个环境间词条完全一样。由预发→生产环境全部迁移时词条不会被替换掉。

迁移记录

词条历史迁移记录,可查看每次迁移的明细。

多环境多版本-3多语言2-11

批量发布(生产环境)

选泽未发布的词条,点击批量发布,使其在生产环境中生效。

多环境多版本-3多语言2-12

版本记录(生产环境)

在词条列表中点击版本记录,可查看该词条历史生效本版。

多环境多版本-3多语言2-13

回滚(生产环境)

在版本记录中点击回滚,可切换词条生效版本。

多环境多版本-3多语言2-14

导入/导出

词条管理中选择相应的词条后,支持execl形式的导入/导出功能,以方便使用。在词条导入时,提供使用导入模版:

多环境多版本-3多语言2-15

多环境多版本-3多语言2-16

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.模板中内容请勿修改,以防止导入出现问题。

编辑

若对于引用的词条信息有变动,可以点击对应词条的右侧编辑图标,对当前词条进行相应的修改,修改操作步骤和新增类似:

此时在编辑词条的右侧会显示该词条引用详情(引用数量和引用位置),修改词条后,被引用的地方的词条信息也会对应变动。

多环境多版本-3多语言2-17

位置详情

点击词条对应右侧的位置详情图标,可查看该词条具体被引用信息。

多环境多版本-3多语言2-18

删除

页面中表格上方的删除图标支持批量删除(默认不生效,仅在至少选择一条词条的情况下才能使用),对应词条右侧的删除图标仅能对该词条进行单量删除。

多环境多版本-3多语言2-19

多环境多版本-3多语言2-20

注意:已经被引用的词条暂时无法删除!

4. 数据建模

盘古公共开发平台引入了数据建模模块,使用数据建模,生成建模信息,一键发布,在盘古平台数据中心建立相关表,提高开发效率。

入口

你可以参考以下步骤从导航栏中,进入数据建模菜单。

1.登录盘古公共开发平台工作。

2.查看上方导航栏,到并进入「流程中心」。

3.在左侧菜单栏选择数据建模,点击即可进入数据建模菜单页。

多环境多版本-4数据建模1

分类管理

盘古提供的分类管理主要功能是新建[模型分组],对后边新增的数据模型进行管理,这样有便于方便对数据模型查找与引用。

多环境多版本-4数据建模2

进入页面展示所有的模型组的信息,也可以根据分类名称,单独过滤对应的分组信息,分组信息包括有:分组名称、详情和修改日期。

新建分类

在创建模型前,需要确定好要在哪个「分组」下创建「模型」,或者创建一个新的「分组」,这样有便于使用者可以更好的管理数据模型。

选择指定数据模型分组

可以选择列表中存在的模型组

多环境多版本-4数据建模3

新建数据模型分组

1.在开发环境下,点击下方图片红色选择框内的[新建分类]

多环境多版本-4数据建模4

2.编辑数据模型分组信息

多环境多版本-4数据建模5

• 分类名称:分组的名称,最好能见名知意,必填。

• 图标选择:从预置的图标库中选择适合该分组的图标标识。

• 图标背景:分组标识的背景颜色,可选择纯色和渐变色进行填充。

• 描述:分组的简洁文字性描述。

删除&修改

在开发环境下可对模型进行修改、删除

多环境多版本-4数据建模6

1.修改时,点击修改可以分组属性进行修改。

多环境多版本-4数据建模7

2.删除时,若模型分组下存在模型,则无法被删除。

多环境多版本-4数据建模8

模型管理

盘古提供的模型就是在数据库中创建相应的表格,对模型的管理就是对数据库中的表格进行管理。我们可以对分组下已经存在的模型进行管理,也可以新建所需的新模型。

点击红色框进入模型管理页面。

多环境多版本-4数据建模9

多环境多版本-4数据建模10

1.点击红色框①可以更换其他已经创建的模型分组。

2.点击红色框②可以创建新的数据模型。

添加模型设置

模型设置主要是对模型的公共字段进行操作,用户可以根据自己的需要将除现有公共字段外的字段进行添加、删除、以方便数据库的操作。

多环境多版本-4数据建模11

字段信息:

• 字段信息:模型的名称,必填。

• 编码:模型对应的字母、数字组合的编码,大写开头,全局唯一,必填。

• 字段类型:字段展示类型,必填。

注意:设置默认字段后,新创建的数据模型将自动创建以下字段,之前已经创建的模型将不受影响。

新增数据模型

点击红色框①新建数据模型。

红色框②内,用户可以根据自己的业务需要,填写基本信息、字段信息、索引信息。

1.填写基本信息

多环境多版本-4数据建模12

• 模型名称:模型的名称,必填。

• 编码:模型对应的字母、数字组合的编码,大写开头,全局唯一,必填。

• 描述:模型的简洁文字性介绍。

2.填写模型字段信息

除去模型设置所添加的字段,无法操作,用户可以根据自己的业务需要,点击新增一行添加字段。

在字段详情页面需要填写相应内容。

多环境多版本-4数据建模13

• 字段名称:字段的名称,必填。

• 编码:字段的唯一标识,必填。

• 字段类型:字段的类别,必填。

• 字段默认值:未赋值时字段对应的值。

注意:

1.模型创建时必须要有业务字段。

2.主键为空时,模型无法创建。

3.主键只能是长整型,和字符串。

4.添加新字段时,编码属性不能是关键字。

3.填写模型索引信息

用户可以根据自己的业务需要,点击新增索引也可以删除索引。

多环境多版本-4数据建模15

• 索引名称:索引的名字,必填。

• 编码:索引的唯一编码,字母、数字组合,小写开头,必填。

• 索引列:选择索引所对应的数据库列。可根据情况选择是否为唯一索引。

• 描述:对索引的文字性描述。

模型发布

新建的数据模型状态为未发布,这时候数据模型并没有创建数据表,只有点击发布后才会在数据库里,生成对应数据模型的表。

多环境多版本-4数据建模15

多环境多版本-4数据建模17

注意:发布后的数据模型进行编辑保存,状态会被变更为未发布。

Diff功能

多环境多版本-4数据建模18

可查看当前模型最新版本与下一环境最新版本的区别,开发与测试环境对比,测试与预发环境对比,预发与生产环境对比。

模型迁移

点击模型迁移按钮,选择模型进行迁移。

多环境多版本-4数据建模19

多环境多版本-4数据建模20

多环境多版本-4数据建模21

注意:当模型存在多个版本时,迁移只会迁移其最新已发布的版本。

迁移记录

多环境多版本-4数据建模22

点击迁移记录按钮,查看模型历史的迁移记录。

多环境多版本-4数据建模23

在迁移记录页面点击明细,可查看每次迁移的模型明细。

查看设计视图

盘古平台还提供了数据模型设计视图,用户可以点击进入设计视图,以图解方式更加清晰直观的了解此模型中数据表之间的关联关系,并支持导出图片。

多环境多版本-4数据建模24

多环境多版本-4数据建模24