介绍搭建对象结构与初始化数据的两种方式
在地图模式中逐步搭建对象结构,包括:新建对象、属性、链接,并在数据管理中批量编辑对象数据
使用需求模型作为示例:一个需求关联多个任务,任务通过requirement链接指向需求;需求通过component链接指向组件;组件通过parent链接指向自己
Requirement (需求):req_id, req_name, component->Component
Task (任务):task_id, requirement->Requirement
Component (组件):code, name, parent->Component

编码命名规则
对象编码:建议按驼峰命名法(如BusinessObject)
属性/链接编码:建议按蛇形命名法(如business_key)
从工具栏拖出通用对象到画布,基于数据类型模板创建对象。创建对象的同时,指定业务主键:新建一个文本属性,与id性质类似,即必填、只读、唯一,用于唯一标识一条对象数据,但具有业务含义
使用业务数据新建Requirement对象,该模板用于创建作为业务数据头表的对象。创建对象的同时,创建业务主键自动赋值规则


使用业务明细新建Task对象,该模板用于创建作为业务数据行表的对象。创建对象的同时,创建业务主键自动赋值规则;指定当前行表的头表,生成指向头表、关系基数为N:1、删除策略为级联删除的链接,该链接可用于领域模型添加头表的子对象


使用主数据新建Component对象,该模板用于创建作为主数据的对象。创建对象的同时,设置业务描述指定文本属性:新建一个多语言文本属性,用于对象数据对外展示时的补充描述


在画布中选中已有的标准对象,点击添加属性,选择属性类型,包括:文本、多语言文本、布尔值、整数、小数、日期时间、日期时间TZ、枚举值、文件

在画布中选中已有的标准对象,点击添加链接,选择目标对象,包括:当前应用、当前空间、当前空间其他应用的对象

在画布中选中已有的标准对象,对象属性栏开启层级结构并点击保存,新建parent链接,指向对象自身,用于维护层级关系

除了逐个添加属性/链接,还可以通过批量新建字段一次性添加多个非计算属性/链接(不含系统属性/链接)
包括以下2种使用场景:
新建对象时:在新建对象弹窗中填写完对象信息后,点击底部的批量新建字段按钮(而非直接新建),进入字段编辑页面。系统会提示无需重复定义的字段(如业务主键),填写完成后点击确定,即可在创建对象的同时批量新建字段

存量对象上:在画布中选中已有的标准对象,点击对象头部的更多菜单,选择批量新建字段,即可为已有对象添加多个属性/链接

字段编辑表格包含以下列:
|
列名 |
说明 |
是否必填 |
|---|---|---|
|
属性/链接编码 |
属性或链接的唯一标识,建议蛇形命名 |
是 |
|
属性/链接名称 |
属性或链接的显示名称,支持多语言 |
是 |
|
属性类型/链接对象 |
属性选择类型;链接选择目标对象 |
是 |
|
枚举值 |
仅枚举值属性需要填写,格式: |
枚举值必填 |
可通过添加行按钮批量添加空行;可通过选中表格的行头或列头来批量选择数据,并点击删除行按钮一次性删除这些行;表格支持复制粘贴

提供数据管理页面用于查看、批量编辑对象数据,包括以下2个入口:
地图模式->新标签页打开对象详情->数据管理

对象列表->选中对象展示对象详情->数据管理

数据管理页面分为数据管理、层级链接parent、自我链接等多个标签页。数据管理标签页展示当前对象所有字段;层级链接parent、自我链接标签页是每个自我链接(指向对象自身的链接)的单独标签页
通常先在数据管理标签页中维护好基础数据(除自我链接外)并点击保存
再在自我链接对应页中维护层级关系,一行是一条对象数据与一个对应父级,如果有多个父级,则分为多行;也支持在数据管理标签页中编辑自我链接数据
各标签页默认为查看态,点击编辑,进入当前标签页编辑态

可通过添加行按钮批量添加空行;可通过选中表格的行头或列头来批量选择数据,并点击删除行按钮一次性删除这些行;表格支持复制粘贴。编辑完成后需点击保存,默认忽略空行


编辑链接数据时,通过对象数据选择器选择目标对象数据,以业务主键为标识。可设置下拉的显示方式,默认显示业务主键 - 业务描述

通过地图模式批量新建快速创建对象结构,并通过数据管理导入全部逐个对象导入数据。使用Excel模板自带的示例数据进行演示
批量新建支持范围:
新建通用对象
新建对象的非计算属性/链接(不含系统属性/链接)
步骤一:下载模板
从工具栏拖出批量新建到画布,在弹窗底部点击下载模版,获取Excel模板文件

步骤二:查看并填写模板
下载后打开模板,包含3个sheet:
Sheet 1 模板说明:介绍该模板的使用方式

Sheet 2 对象:定义对象基本信息
|
列名 |
说明 |
是否必填 |
|---|---|---|
|
对象编码 |
对象的唯一标识,建议驼峰命名 |
是 |
|
对象名称(当前语言) |
对象的显示名称 |
是 |
|
业务主键 |
指定一个文本属性作为业务主键 |
是 |
|
业务描述 |
指定一个文本/多语言文本属性作为业务描述,填 |
是 |
Sheet 3 属性与链接:定义每个对象的属性和链接
|
列名 |
说明 |
是否必填 |
|---|---|---|
|
对象编码 |
属性/链接所属的对象编码,需与Sheet 2中一致 |
是 |
|
属性/链接编码 |
属性或链接的唯一标识,建议蛇形命名 |
是 |
|
属性/链接名称(当前语言) |
属性或链接的显示名称 |
是 |
|
属性类型/链接对象 |
属性填类型名称(包括:文本、多语言文本、布尔值、整数、小数、日期时间、日期时间TZ、枚举值、文件);链接填目标对象编码 |
是 |
|
属性/链接配置 |
目前仅枚举值属性需要填写枚举值定义,格式: |
枚举值必填 |
模板中已包含示例数据,可参照示例数据的格式进行填写,也可直接使用模板示例进行下一步操作体验完整流程


步骤三:上传并创建对象
在批量新建弹框中上传填写好的Excel文件
文件上传后,系统会自动校验,校验通过后展示待创建的对象列表;校验不通过则提示错误信息,需按提示修改Excel文件后重新上传
确认无误后点击导入,即可批量创建对象结构


目前按单个对象逐个导入数据。对象创建完成后,进入对象详情的数据管理页面,点击更多菜单,选择导入全部进入导入流程

步骤一:下载模板并填写数据
在导入弹框中点击下载模板,获取当前对象的数据模板文件

模板列名对应对象的属性/链接,按模板格式填写数据后保存。模板格式说明:
文件结构:第1行为字段编码行(用于字段映射),第2行为字段名称行(用于展示),从第3行开始填写数据
样例数据:如果对象已有数据,模板会导出至多100条数据作为样例数据
必填字段:标红的列为必填属性/链接,如果通过业务规则自动生成,则无需填写
无需导入:id、计算属性/链接等字段值自动生成,无需通过导入赋值
不同类型的属性/链接填写格式:
|
属性/链接类型 |
支持的填写格式 |
示例 |
|---|---|---|
|
文本 |
直接填写文本值 |
|
|
多语言文本 |
每种语言一列,分别填写该语言的文本值 |
中文列: |
|
布尔值 |
|
|
|
整数 |
直接填写整数值 |
|
|
小数 |
直接填写小数值 |
|
|
日期时间 |
按 |
|
|
日期时间TZ |
填写带时区的日期时间,格式: |
|
|
枚举值 |
|
|
|
文件 |
不支持通过导入赋值,需在数据管理页面单独上传 |
- |
|
单选链接 |
|
|
|
多选链接 |
多个值用英文逗号 |
|
步骤二:上传并映射字段
上传填写好的Excel文件,上传成功后点击下一步,系统会自动映射导入文件列名到当前对象的属性/链接,可手动调整映射关系


自动映射规则:以导入数据列名(即导入文件第1行)与当前对象的属性/链接进行匹配,使用模板文件上传都能自动匹配上
属性:列名与属性编码一致;多语言文本属性按语言分别映射,列名为 属性编码(语言编码),例如:name(zh-cn)、name(en)
链接:列名为 链接编码.主键编码 或 链接编码.主键编码-链接编码.描述编码,例如:component.code 或 component.code-component.name
列分类:除无需映射的列外,其他都是可映射的列
|
列分类 |
说明 |
|---|---|
|
无需映射的列 |
· id、计算属性/链接等无需导入的字段,导入数据列名显示 暂不支持
|
|
可映射的列 |
· 已映射的列:已匹配导入数据列名 不映射,即不导入该字段数据;可通过未映射的列检查是否有遗漏未映射不映射
|
步骤三:确认导入
导入方式为增量导入:业务主键重复时更新现有数据,不重复时新增
可选是否忽略所有业务规则,勾选即关闭所有业务规则,按导入文件导入数据
注意
导入链接数据前,需确保目标对象数据已先导入(除自我链接外),避免链接值校验失败
导入时自动生成属性id值,而非通过导入,所以与原有id值不同
回到顶部
咨询热线
