全部文档
文档中心DeepModel快速入门

快速入门

介绍搭建对象结构与初始化数据的两种方式

在地图模式中逐步搭建对象结构,包括:新建对象、属性、链接,并在数据管理中批量编辑对象数据

使用需求模型作为示例:一个需求关联多个任务,任务通过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种使用场景:

  • 新建对象时:在新建对象弹窗中填写完对象信息后,点击底部的批量新建字段按钮(而非直接新建),进入字段编辑页面。系统会提示无需重复定义的字段(如业务主键),填写完成后点击确定,即可在创建对象的同时批量新建字段

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

字段编辑表格包含以下列:

列名

说明

是否必填

属性/链接编码

属性或链接的唯一标识,建议蛇形命名

属性/链接名称

属性或链接的显示名称,支持多语言

属性类型/链接对象

属性选择类型;链接选择目标对象

枚举值

仅枚举值属性需要填写,格式:编码1:名称1,编码2:名称2

枚举值必填

可通过添加行按钮批量添加空行;可通过选中表格的行头或列头来批量选择数据,并点击删除行按钮一次性删除这些行;表格支持复制粘贴

提供数据管理页面用于查看、批量编辑对象数据,包括以下2个入口:

  • 地图模式->新标签页打开对象详情->数据管理

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

数据管理页面分为数据管理、层级链接parent、自我链接等多个标签页。数据管理标签页展示当前对象所有字段;层级链接parent、自我链接标签页是每个自我链接(指向对象自身的链接)的单独标签页

  1. 通常先在数据管理标签页中维护好基础数据(除自我链接外)并点击保存

  2. 再在自我链接对应页中维护层级关系,一行是一条对象数据与一个对应父级,如果有多个父级,则分为多行;也支持在数据管理标签页中编辑自我链接数据

各标签页默认为查看态,点击编辑,进入当前标签页编辑态

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

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

通过地图模式批量新建快速创建对象结构,并通过数据管理导入全部逐个对象导入数据。使用Excel模板自带的示例数据进行演示

批量新建支持范围:

  • 新建通用对象

  • 新建对象的非计算属性/链接(不含系统属性/链接)

步骤一:下载模板

从工具栏拖出批量新建到画布,在弹窗底部点击下载模版,获取Excel模板文件

步骤二:查看并填写模板

下载后打开模板,包含3个sheet:

  • Sheet 1 模板说明:介绍该模板的使用方式

  • Sheet 2 对象:定义对象基本信息

列名

说明

是否必填

对象编码

对象的唯一标识,建议驼峰命名

对象名称(当前语言)

对象的显示名称

业务主键

指定一个文本属性作为业务主键

业务描述

指定一个文本/多语言文本属性作为业务描述,填<无>表示不设置

  • Sheet 3 属性与链接:定义每个对象的属性和链接

列名

说明

是否必填

对象编码

属性/链接所属的对象编码,需与Sheet 2中一致

属性/链接编码

属性或链接的唯一标识,建议蛇形命名

属性/链接名称(当前语言)

属性或链接的显示名称

属性类型/链接对象

属性填类型名称(包括:文本、多语言文本、布尔值、整数、小数、日期时间、日期时间TZ、枚举值、文件);链接填目标对象编码

属性/链接配置

目前仅枚举值属性需要填写枚举值定义,格式:编码1:名称1,编码2:名称2

枚举值必填

模板中已包含示例数据,可参照示例数据的格式进行填写,也可直接使用模板示例进行下一步操作体验完整流程

步骤三:上传并创建对象

批量新建弹框中上传填写好的Excel文件

  • 文件上传后,系统会自动校验,校验通过后展示待创建的对象列表;校验不通过则提示错误信息,需按提示修改Excel文件后重新上传

  • 确认无误后点击导入,即可批量创建对象结构

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

步骤一:下载模板并填写数据

在导入弹框中点击下载模板,获取当前对象的数据模板文件

模板列名对应对象的属性/链接,按模板格式填写数据后保存。模板格式说明:

  • 文件结构:第1行为字段编码行(用于字段映射),第2行为字段名称行(用于展示),从第3行开始填写数据

  • 样例数据:如果对象已有数据,模板会导出至多100条数据作为样例数据

  • 必填字段:标红的列为必填属性/链接,如果通过业务规则自动生成,则无需填写

  • 无需导入:id、计算属性/链接等字段值自动生成,无需通过导入赋值

  • 不同类型的属性/链接填写格式

属性/链接类型

支持的填写格式

示例

文本

直接填写文本值

测试

多语言文本

每种语言一列,分别填写该语言的文本值

中文列:测试;英文列:Test

布尔值

truefalse

true

整数

直接填写整数值

100

小数

直接填写小数值

3.14

日期时间

YYYY-MM-DD HH:mm:ss 格式填写,或使用Excel支持的日期类型

2025-01-01 10:00:00

日期时间TZ

填写带时区的日期时间,格式:YYYY-MM-DD HH:mm:ss±HH:mm

2025-01-01 10:00:00+08:00

枚举值

编码编码 - 名称

redred - 红

文件

不支持通过导入赋值,需在数据管理页面单独上传

-

单选链接

主键主键 - 描述

COMP_005COMP_005 - DeepModel

多选链接

多个值用英文逗号,隔开

COMP_005,COMP_008COMP_005 - DeepModel,COMP_008 - 数据流

步骤二:上传并映射字段

上传填写好的Excel文件,上传成功后点击下一步,系统会自动映射导入文件列名到当前对象的属性/链接,可手动调整映射关系

自动映射规则:以导入数据列名(即导入文件第1行)与当前对象的属性/链接进行匹配,使用模板文件上传都能自动匹配上

  • 属性:列名与属性编码一致;多语言文本属性按语言分别映射,列名为 属性编码(语言编码),例如:name(zh-cn)name(en)

  • 链接:列名为 链接编码.主键编码链接编码.主键编码-链接编码.描述编码,例如:component.codecomponent.code-component.name

列分类:除无需映射的列外,其他都是可映射的列

列分类

说明

无需映射的列

· id、计算属性/链接等无需导入的字段,导入数据列名显示 自动处理


· 文件属性等不支持导入的字段,导入数据列名显示 暂不支持

可映射的列

· 已映射的列:已匹配导入数据列名


· 未映射的列:导入数据列名选择不映射,即不导入该字段数据;可通过未映射的列检查是否有遗漏未映射

· 必需的列:标红的列为必填属性/链接,一般需映射,如果通过业务规则自动生成,可以选择不映射

步骤三:确认导入

  • 导入方式为增量导入:业务主键重复时更新现有数据,不重复时新增

  • 可选是否忽略所有业务规则,勾选即关闭所有业务规则,按导入文件导入数据

注意

  • 导入链接数据前,需确保目标对象数据已先导入(除自我链接外),避免链接值校验失败

  • 导入时自动生成属性id值,而非通过导入,所以与原有id值不同

回到顶部

咨询热线

400-821-9199

我们使用 ChatGPT,基于文档中心的内容以及对话上下文回答您的问题。

ctrl+Enter to send