更新时间:2024-12-23 GMT+08:00
分享

创建数据实体

操作场景

数据实体是工业数字模型驱动引擎-数据建模引擎(xDM Foundation,简称xDM-F)原子接口的承载体之一。在应用设计态中,分为实体模型和抽象模型。实体模型是实际存在的一个对象模型,抽象模型是根据多个实体模型公共的部分抽象出来的模型。如果实体模型继承这个抽象模型,就包含了该抽象模型的属性。本文指导您在应用设计态创建数据实体。

图1 创建数据实体流程图

前提条件

登录应用设计态

步骤1:填写基本信息

  1. 在左侧导航栏中,选择数据模型管理 > 数据实体,进入数据实体页面。
  2. 单击“创建”

    图2 创建数据实体

  3. 根据页面提示,配置如下信息。

    图3 基本信息
    表1 基本信息

    类型

    参数

    参数说明

    基本信息

    英文名称

    数据实体的英文名称。

    需以大写字母开头,只能包含字母、数字和“_”,不能以History、Query、VersionView、LifecycleManagedReviseAnd、LifecycleManagedCheckoutAnd、Version、VersionCheckoutAnd和VersionReviseAnd结尾(不区分大小写),长度不能超过60个字符。

    中文名称

    数据实体的中文名称。

    只能包含中文、英文字母、数字、“_”和“-”,长度不能超过128个字符。

    英文描述

    数据实体的英文描述。

    不能包含中文字符,长度不能超过1024个字符。

    中文描述

    数据实体的中文描述。

    支持各种字符,长度不能超过1024个字符。

    模型类型

    xDM-F提供如下两种类型,请根据实际需求进行选择。

    • 实体模型:生成物理表,可用于扩展子模型。
    • 抽象模型:不生成物理表,可继承或被实体模型继承。

    父模型

    应用设计态下的父模型均为抽象模型,xDM-F提供如下父模型:
    • BusinessObject:基本业务对象,具有13个系统属性(Name、Description、ID、Creator、CreateTime、Modifier、LastUpdateTime、 RdmVersion、RdmExtensionType、KIAGUID、SecurityLevel、Tenant、ClassName)。
    • BasicObject:基础对象,具有9个系统属性(ID、Creator、CreateTime、Modifier、LastUpdateTime、RdmVersion、RdmExtensionType、 Tenant、ClassName)。
    • AbstractCategory:抽象分类对象,是xDM-F在XDM应用预置的内置模型。如果您希望数据实体可以使用数据分类管理功能,您可以选择此抽象模型,用于后续在应用运行态通过此数据实体进行数据分类。
    • VersionObject:版本对象,用于创建有大小版本的业务对象,即Master-Version(M-V)模型的对象。关于M-V模型的介绍可参见什么是M-V模型?

    模型分类

    xDM-F提供如下两种模型分类,请根据实际需求进行选择。

    • 系统配置模型:用于承载为实现业务逻辑而增加的模型,该模型不会与上下游集成。
    • 业务数据模型:用于承载业务数据的模型。

    责任人

    数据实体的责任人。

    表名称

    数据实体存储至数据库的表名称,默认格式为“应用名称_数据实体英文名称”,可修改。

    • 如果应用的数据库类型为mysql,且实体是单实体,表名称总长度不能超过64个字符。
    • 如果应用数据库类型是mysql,且实体是M-V模型,表名称总长度不能超过58个字符。
    • 如果应用的数据库类型为postgresql,且实体是单实体,表名称总长度不能超过63个字符。
    • 如果应用数据库类型是postgresql,且实体是M-V模型,表名称总长度不能超过57个字符。

    二级缓存

    针对读多写少的业务场景,xDM-F提供了作用于实体级的级缓存功能。开启此配置项后,系统会自动缓存实体的实例信息,从而提高系统整体的性能。

    如果实体有参考对象类型的属性,该属性的参考对象建议同步开启二级缓存功能。

    更多信息请参见数据建模引擎相关问题

    标签

    • 如果您没有可使用的标签,可选择“自定义”
    • 如果您已有可使用的标签,可选择“添加标签”

    更多关于标签的操作请参见主服务标签

    图标

    数据实体的图标,自定义。

    同步至LinkX-F

    如果您希望当前元模型及其实例数据可以继续在LinkX-F进行数据入图、数据探索、编排数据服务等操作时,您可以开启此配置项。

    说明:

    此配置项需要已开通LinkX-F,否则配置后不生效。如果您未开通LinkX-F,请开通数字主线引擎

    • 是:针对您选择的“模型类型”系统会自动将对应模型类型的元模型及其实例数据自动同步至LinkX-F
      • 如果当前元模型的“模型类型”选择为“实体模型”,当前元模型及其实例数据会自动同步至LinkX-F
      • 如果当前元模型的“模型类型”选择为“抽象模型”,后续可通过被实体模型的元模型继承的方式,将当前元模型下“入图”“是”的属性及其相关数据自动同步至LinkX-F并入图。

      开启后,即可通过LinkX-F来实现汇聚企业全场景数据,构建企业级数据图谱去进行数据索引、分析、追溯等。具体操作请参见xDM-F应用同步

      自动同步时,当前元模型继承的所有内置模型属性不会同步至LinkX-F。如果您希望当前元模型继承的内置模型属性可以同步至LinkX-F,请将对应内置模型的“同步至LinkX-F”修改为“是”,并允许对应内置模型属性入图,具体操作请参见XDM应用

    • 否:当前元模型及其实例数据不同步至LinkX-F。默认为“否”

    入图标识

    “同步至LinkX-F“是”时,必填项。

    表示此元数据在入图时的别名或标识。

    入图标识需以字母开头,只能包含字母、数字和“_”。例如a0_01。

    功能列表

    基础功能

    xDM-F提供的标准能力,随父模型自动带出,不可修改。

    • 如果父模型选择为“BusinessObject”,基础功能自动勾选“基础数据服务”“文件服务”“安全受控”
    • 如果父模型选择为“BasicObject”,基础功能自动勾选“基础数据服务”“文件服务”
    • 如果父模型选择为“VersionObject”,version模型(版本对象)上自动勾选“基础数据服务”“文件服务”“安全受控”“版本服务”,master模型(主对象)上自动勾选“主版本服务”“文件服务”,branch模型(分支对象)上自动勾选“文件服务”
    • 如果父模型选择为其他抽象模型,基础功能会根据父模型的配置自动选中,且不可删除。

    可选功能

    提供多种可选功能(如系统版本、权限管理、业务编码生成器、分类管理、数据分类管理、扩展属性、扩展类型、文件夹管理、生命周期管理、树形结构、失效管理、多维视图&多维分支、所有者管理、结构化文档管理、标签管理等)。随父模型选择不同,支持可选的功能不同。

    更多功能详情请参见数据建模引擎功能

    自定义功能

    • 如果您没有可勾选的自定义功能,请参阅创建接口模型进行创建。
    • 如果您已有可勾选的自定义功能,请根据实际需求进行勾选。勾选后,数据实体会继承该接口模型中的属性和关系。

  4. 单击“保存”

步骤2:新增属性(可选)

属性是数据实体所具有的特征或性质,用于描述数据实体的特征。完成基本信息的填写后,该数据实体会继承父模型的属性,例如唯一编码、创建者、租户、实体类型等属性。如果从父模型继承的属性已满足您实际的业务场景,可跳过此步骤,后续可参见管理数据实体属性管理该实体的属性。如果从父模型继承的属性满足不了您实际的业务场景,可通过如下操作添加属性。

  1. 选择“属性”页签,进入属性页面。
  2. “基本属性”栏中,单击“新增”

    图4 新增属性

  3. 在弹出的窗口中,填写如下主要信息。

    图5 属性基本信息
    表2 数据实体属性-参数说明

    类型

    参数

    参数说明

    基本信息

    英文名称

    用户自定义,表示当前创建的基本属性的英文名称。

    需以字母开头,只能包含字母、数字和“_”,长度不能超过58个字符。

    不能以数据库的关键词作为属性的英文名称,例如where、select等。

    xDM-F会自动以类小驼峰方式转换属性的英文名称,以作为key值存储至系统中。后续您在调用API时,请避免使用实际定义的属性英文名称作为参数名。例如,您定义的属性英文名称为“Part_model_mumber”,调用API时需使用“part_Model_Mumber”作为参数名。

    中文名称

    用户自定义,表示当前创建的基本属性的中文名称。

    只能包含中文、英文字母、数字、“_”和“-”,长度不能超过58个字符。

    英文描述

    用户自定义,表示当前创建的基本属性的英文描述。

    不能包含中文字符,长度不能超过1024个字符。

    中文描述

    用户自定义,用于说明当前创建的基本属性的用途、特征等,以便于其他用户可以快速了解和使用该属性。

    支持各种字符,长度不能超过1024个字符。

    类型

    xDM-F提供如下属性类型,请根据实际需求进行选择。

    • 文本:可存储较短的字符串数据,文本长度不能超过4000个字符。
    • 长文本:可存储较长的字符串数据,例如大型文章。文本长度最大支持524288个字符。如果您需要存储超长的字符串数据,建议使用“文件”类型的属性进行存储。
      • 如果应用的数据库类型为mysql,对应数据库的字段类型为LongText。
      • 如果应用的数据库类型为postgresql,对应数据库的字段类型为TEXT。
    • 整型:对应数据库的字段类型为int。
    • 长整型:对应数据库的字段类型为long。
    • 浮点型:对应数据库的字段类型为float。
    • 浮点型(自定义精度):浮点型数据并且可以自定义精度。
    • 参考对象:为对象建立1:N或主外键关系,例如部门和员工。
      • 参考对象值可以选择该应用下“正在工作”“已发布”的数据模型以及默认应用(XDM)下发布的所有数据模型(不包括扩展类型子数据模型)。
      • 如果参考非默认应用(XDM)对象,则当前属性作为外键生成一条虚拟的N:1的关系。
    • 文件:支持“BLOB”“对象存储”两种文件存储方式,默认为“对象存储”
    • 布尔值:true/flase。
    • 日期:展示为年/月/日/时/分/秒。
    • 枚举:为几乎没有变化的对象列举值,例如性别(男/女)。
    • 人员:企业/部门人员的名称。
    • URL:长度不能超过4000个字符,匹配正确格式。
    • JSON:JSON数据类型。

    属性分类

    用户自定义,可根据各维度自定义分类,便于管理属性。

    EOS日期

    EOS(End of Service,停止服务)日期主要用于标识属性的生效/失效时间。您可以通过EOS日期预设置某个属性字段的截止日期,以便于后续在业务开发时通过该参数控制相应的业务逻辑。

    约束信息

    文本长度

    “类型”选择为“文本”“长文本”时,必填项。

    其中,“文本”类型属性的最长文本长度为4000个字符,“长文本”类型属性的最长文本长度为524288个字符。

    为保障部署在数据建模引擎的应用运行态性能最优,建议您合理控制“长文本”类型属性的文本长度设置。

    有效范围

    “类型”选择为“整型”“长整型”“浮点型”“浮点型(自定义精度)”时,可根据实际业务需求进行设置。

    • 左开右开():表示不包括区间边界的两个值。例如(a,b),即a<x<b,取值不包括a和b。
    • 左闭右闭[]:表示包括区间边界的两个值。例如[a,b],即a≤x≤b,取值包括a和b。
    • 左开右闭(]:表示不包括开区间一边的边界值,包括闭区间一边的边界值。例如(a,b],即a<x≤b,取值不包括a,包括b。
    • 左闭右开[):表示不包括开区间一边的边界值,包括闭区间一边的边界值。例如[a,b),即a≤x<b,取值包括a,不包括b。

    指定合法值类型

    “类型”选择为“文本”“整型”“长整型”“浮点型”“浮点型(自定义精度)”“人员”时,可根据实际业务需求进行设置。

    仅支持输入英文名称。

    指定枚举类型

    “类型”选择为“枚举”时,必填项。

    • 如果您没有可指定的枚举类型,可选择
    • 如果您已有可指定的枚举类型,可选择已有枚举类型。
    • 在下拉选项列表中,单击枚举右侧的,可查看该枚举的详细信息。

    单位类型

    “类型”选择为“整型”“长整型”“浮点型”“浮点型(自定义精度)”时,可根据实际业务需求进行设置。

    如果您设置了单位类型,完成属性创建后,数据实体会自动创建一个英文名称格式为属性英文名称_unit“参考对象”类型属性,不可编辑。当您在运行态创建数据实例时,其“参考对象”类型的属性用于表示对应数值型属性的计量单位。

    仅支持选择xDM-F内置的国标单位,如果内置的国标单位满足不了您实际业务需求,后续您可以在应用运行态中自定义单位类型,然后在数据实体的扩展属性中选择该单位类型。具体操作请参见创建单位类型

    设计默认单位

    “单位类型”设置单位时,必填项。

    如果用户在应用运行态中设置了“运行默认单位”,创建数据实例时优先选择应用运行态设置的默认单位,否则创建的数据实例默认选择“设计默认单位”

    标度

    “类型”选择为“浮点型”“浮点型(自定义精度)”时,必填项。

    小数位范围1-30,如果实例值超过标度范围,采用四舍五入方式处理。

    默认值

    “类型”选择为“文本”“长文本”“整型”“长整型”“浮点型”“浮点型(自定义精度)”“布尔值”“日期”“枚举”“人员”“URL”时,可根据实际业务需求进行设置。

    • 如果“唯一键”选择为“是”,默认值为空且不能修改。
    • 如果“指定合法值类型”设置了合法值类型,默认值只能设置为该配置项对应合法值类型中的合法值。

    参考对象

    “类型”选择为“参考对象”时,必填项,支持选择数据实体、关系实体和接口模型。

    根据业务需求,在参考对象下拉列表中选择需要参考的数据模型类型和对应模型的具体模型,使当前数据模型和选择的参考对象形成一种参考关系。

    组合关系

    “类型”选择为“参考对象”(数据实体)时,必填项。

    • 是:组合关系,定义为组合关系的目标数据实体支持级联查询和删除关联对象。
      说明:

      仅支持“模型类型”“实体模型”的单实体将“参考对象”类型属性设置为组合关系。

    • 否:非组合关系,默认为否。

    存储方式

    “类型”选择为“文件”时,必填项。

    支持BLOB和对象存储两种。

    • BLOB:数据库存储,最大支持1M。
    • 对象存储:使用对象存储服务存储文件,文件≤100M使用普通上传,文件>100M使用分块上传,最大支持10G。

    文件格式

    “类型”选择为“文件”时,可根据实际业务需求进行设置。

    以英文逗号分隔输入文件类型,例如“pdf,docx”。如果没有设置文件格式,则不对上传的文件进行格式限制。

    文件最大值

    “类型”选择为“文件”,且“存储方式”“对象存储”时,可根据实际业务需求进行设置。

    支持输入大于100MB且小于等于10GB的值。

    分块大小

    “类型”选择为“文件”,且“存储方式”“对象存储”时,可根据实际业务需求进行设置。

    支持5MB~200MB的分块大小,默认为5MB。

    密级

    支持内部公开、机密、秘密和绝密四种。

    • 内部公开:指可在公司内部公开发布的信息,不属于保密信息。
    • 秘密:是公司比较重要或敏感的信息,其泄露会使公司利益受到一定损害,但影响范围有限;适合在体系、部门或特定组织范围公开的信息。
    • 机密:对公司运营管理非常重要或内容非常敏感,其泄露会使公司利益遭受巨大损害,且影响范围广泛;只适合在极少数人员或指定岗位范围公开的信息。如:重要产品的路标规划、营销策略、经营分析报告、销售项目一览表、商务授权及价格信息。
    • 绝密:对公司市场竞争、领先对手起决定性作用,其泄露会使公司利益遭受巨大损害,且影响范围广泛;只适合在极少数人员或指定岗位范围公开的信息。如:核心算法、定价策略、战略意图。

    唯一键

    默认为“否”

    • 如果数据实体为M-V模型,只支持在master模型中为属性设置此参数项。
    • 如果“值加密”选择为“是”,唯一键只能选择为“否”
    • URL、JSON、参考对象和文件类型只能选择为“否”

    唯一键区间

    “唯一键”“是”时,必填项。

    支持全局唯一和租户内唯一,默认为“全局唯一”

    唯一键及其区间变化时,如果历史数据与该约束有冲突,则需手动处理,发布后请谨慎更改。

    必填

    如果您希望在应用运行态对当前元模型进行实例化时用户必须提供此属性值,可设置此配置项。

    “类型”“参考对象”的属性默认为“是”,其他类型属性默认为“否”

    如果“类型”选择为“文件”,只能选择为“否”

    列表属性

    用于查询接口,作为查询条件和返回值。

    • JSON和文件类型只能选择为“否”
    • 如果“值加密”选择为“是”,列表属性只能选择为“否”

    多值

    “类型”选择为“枚举”“人员”时,必填项。

    值可变

    “类型”选择为“文本”“长文本”“整型”“长整型”“浮点型”“浮点型(自定义精度)”“参考对象”“布尔值”“日期”“枚举”“人员”“URL”时,必填项。

    默认为“是”。如果选择为“否”,则该实例的值保存后不支持修改。

    值存储方式

    “类型”选择为“文本”“长文本”时,必填项。

    支持原值、大写和小写三种,默认为“原值”

    • 原值:实例值按照实际输入的字符串存储。
    • 大写:将实例值中小写字符串转换为大写字符串存储。
    • 小写:将实例值中大写字符串转换为小写字符串存储。

    值加密

    “类型”选择为“文本”时,必填项。

    默认为“否”。如果选择为“是”,发布后该数据将以密文方式存储在数据库中,且为longtext类型。

    • 设置值加密后,用户通过API(如get,batchGet,find,query等)获取属性时,可通过“decrypt”来解密该实体的属性。
    • 如果“唯一键”选择为“是”,值加密只能选择为“否”
    • 如果“密级”“内部公开”时,不支持值加密。
    • 如果当前属性绑定了业务编码生成器规则,值加密只能选择为“否”
    • 如果当前属性是树形结构指定的全路径字段,值加密只能选择为“否”

    索引

    “类型”选择为“文本”“整型”“长整型”“浮点型”“浮点型(自定义精度)”“日期”“人员”时,可根据实际业务需求进行设置。

    “类型”选择为“人员”时,默认为“是”;其他类型默认为“否”

    “类型”选择为“文本”时,如果应用的数据库类型为mysql,且“文本长度”的设置大于768个字符,则该配置无效,无需配置。

    入库

    默认为“是”。如果选择为“否”,发布后在数据库不会生成字段。模型发布后不能修改。

    加密

    “类型”选择为“文件”,且“密级”“机密/秘密/绝密”时,必填项。

    如果“密级”“内部公开”时,不支持加密。

    加密方式

    “加密”“是”时,必填项。

    支持对称加密和非对称加密。

    • 对称加密:即私钥加密,需使用同一个密钥进行加密或解密。
    • 非对称加密:即公钥加密,需使用一对密钥(公钥和私钥)进行加密或解密。

    入图

    需在填写基本信息时将“同步至LinkX-F设置为“是”,才展示该配置项。

    用于将当前属性与LinkX-F图数据库中的图数据属性进行对应,进而对数据实例实现从多类型数据源到图数据库的转换。

    说明:

    此配置项需要已开通LinkX-F,否则配置后不生效。如果您未开通LinkX-F,请开通数字主线引擎

    • 是:当前属性将在LinkX-F中入图。
    • 否:当前属性不在LinkX-F中入图。默认为“否”

    入图标识

    “入图”“是”时,必填项。

    此元数据在入图时的别名或标识。

    入图标识需以字母开头,只能包含字母、数字和“_”。

    引用类型

    “类型”选择为“参考对象”时,可根据实际业务需求进行设置。

    • 强引用:假设实体A参考实体B,组合关系下,实体B的数据实例被删除时,实体A的数据实例也被删除;非组合关系下,实体B的数据实例被删除时,会返回引用信息,不允许被删除,我们称这两种引用依赖为强引用。
      说明:

      如果“组合关系”选择为“是”,则引用类型只能为强引用。

    • 弱引用:假设实体A参考实体B,实体B的数据实例被删除时,实体A的数据实例仍然存在,我们称这种引用依赖为弱引用。

  4. 单击“保存”

    如需创建多个属性,可单击“保存继续创建”

步骤3:功能配置(可选)

不同类型的数据实体支持的基础功能和可选功能不同,您可根据实际的业务场景,在“功能配置”中设置相应功能的规则。如果系统提供的默认功能配置已满足您实际的业务需求,可跳过此步骤。

  1. 选择“功能配置”页签,进入功能配置页面。
  2. 根据实际需求,设置如下主要信息。

    图6 功能配置
    表3 功能配置-参数说明

    类型

    参数

    参数说明

    设置规则

    版本服务

    M-V模型实体中Version模型实体(版本对象)的默认功能,用于自定义版本号生成规则。如果在填写基本信息时,“父模型”选择为“VersionObject”,可在“功能配置”中设置“版本服务”的规则。关于M-V模型的内容请参见什么是M-V模型?

    • 流水码:默认为“字母(不包含I、O、Z)”
    • 前缀:可以选择当前实体提供的属性,可以手动输入版本号的前缀,也可以选择分隔符“-”和“_”。
    • 后缀:可以选择分隔符“-”和“_”,可以选择当前实体提供的属性,也可以手动输入版本号的后缀。

    多维版本

    M-V模型实体中Version模型实体(版本对象)的可选功能,用于以不同视角差异化管理同一个数据对象。如果在填写基本信息时,“父模型”选择为“VersionObject”,且“功能列表”添加了“多维视图&多维分支”功能,可在“功能配置”中设置“多维版本”。一个M-V模型实体至多可添加3个多维版本。

    单击“新增”,设置如下信息,定义多维版本。

    • 属性英文名称:填写多维版本的英文名称。
    • 属性中文名称:填写多维版本的中文名称。
    • 参考对象:选择参考对象的目标端(数据实体)。
    • 必填:设置该多维版本是否必填,默认为“是”

    当您发布数据实体时,该实体会根据新增的多维版本自动在基本属性中生成对应的多维版本属性。

    将具有“多维视图&多维分支”功能的M-V模型实体部署至运行态后,您可以通过调用API的方式创建多维版本实例,具体操作请参见创建多维版本的数据实例

    业务编码生成器

    如果在填写基本信息时,“功能列表”添加了“业务编码生成器”,可在“功能配置”中设置“业务编码生成器”的生成规则。

    生成的业务编码由自定义字段1自定义字段2...自定义字段10生成,初始业务编码值可在业务编码生成器的说明中查看。

    说明:
    • 当数据实体的“父模型”为自定义的抽象模型且配置了业务编码生成器功能,数据实体如需使用父模型的业务编码生成规则,可保持默认配置(即“选择绑定属性”为空),即可继承父模型的业务编码生成规则。
    • 如果数据实体更新了父模型,该数据实体支持的业务编码生成器功能会被删除,需重新配置业务编码生成器功能。
    • 选择绑定属性:
      • 如果您没有可使用的属性,请新增一个“类型”“文本”“唯一键”“是”的属性,具体操作可参见管理数据实体属性
      • 如果您已有可使用的属性,请选择需要绑定的属性。
    • 自定义字段:支持如下字段,请根据实际业务需求进行选择。如需设置多个自定义字段,可单击“添加编码段”进行添加,至多只能添加10个自定义字段。如需调整自定义字段排序,将需要调整的自定义字段拖动至所需位置后松开鼠标即可。
      • 常量:输入自定义常量,例如下划线(_)、中横线(-)。
      • 流水码:支持“字母”“数字”“数字+字母”,请根据实际业务进行选择。

        如果“流水码”“字母”:需设置流水码位数和初始流水码,还支持设置需要排除的字母。

        如果“流水码”“数字”:需设置流水码位数和初始流水码。

        如果“流水码”“数字+字母”:需设置流水码位数和初始流水码,还支持设置需要排除的字母。

        其中,“流水码位数”只能为1~9的正整数,“初始流水码”只能为≥0的整数,且初始流水码的长度不能超过流水码位数。

      • 属性:选择当前实体可使用的属性。

        如果当前实体是单实体,不可使用的属性包括:ID属性,“类型”“参考对象”“URL”“文件”“JSON”“枚举”(约束信息的“多值”“是”)、“人员”(约束信息的“多值”“是”)和“文本”(约束信息的“值加密”“是”)的属性。

        如果当前实体是M-V模型,不可使用的属性包括:ID属性,Iteration属性,Master属性,Version属性,Branch属性,“类型”“参考对象”“URL”“文件”“JSON”“枚举”(约束信息的“多值”“是”)、“人员”(约束信息的“多值”“是”)和“文本”(约束信息的“值加密”“是”)的属性。

      • 日期:日期格式,支持“YYYY”“YYMM”“YYMMDD”“YYYYMMDD”。其中,Y表示年,M表示月,D表示日。

    树形结构

    如果在填写基本信息时,“功能列表”添加了“树形结构”,可在“功能配置”中设置“树形结构”的规则。

    指定全路径字段:仅支持选择文本类型或数值类型的属性,为树形节点全路径绑定属性。建议选择ID字段的属性,如将全路径字段选择为非ID字段属性,可能会影响后续对树形结构相关接口的调用。

    配置完成后,在应用运行态创建实体的数据实例时,会根据您填写的父节点信息,自动填充其全路径字段(fullPath,以指定属性构建的从根到叶子节点全路径)、原始全路径字段(rawFullPath,以ID属性构建的从根到叶子节点全路径);更新实体的数据实例时,会根据您填写的父节点信息,自动更新其全路径信息、原始全路径信息,更新方式为非实时性的异步任务(待异步任务执行完成后,刷新路径信息)。

    生命周期管理

    如果在填写基本信息时,“功能列表”添加了“生命周期管理”,可在“功能配置”中设置“生命周期管理”的规则。

    单击“新增”,设置如下信息,用于约束运行态应用下的生命周期管理。如未新增,默认使用“LifecycleTemplate”生命周期模板。

    • 模板属性定义:自定义模板属性的英文名称、中文名称、英文描述和中文描述,选择出厂默认生命周期模板。如果您没有可选择的生命周期模板,可先输入出厂默认生命周期模板名称,待数据实体部署至运行态后,再在运行态创建同名的生命周期模板。具体操作请参见创建生命周期模板
    • 状态属性定义:自定义状态属性的英文名称、中文名称、英文描述和中文描述。

    扩展属性

    如果在填写基本信息时,“模型类型”选择为“实体模型”“功能列表”添加了“扩展属性”,可在“功能配置”中设置“扩展属性”的规则,用于约束应用运行态下该实体可添加的扩展属性类型数量、文本长度等配置。

    单击“新增”,参考如下说明进行设置。

    • 属性类型:用于约束应用运行态下该实体可添加的扩展属性类型。当前支持选择文本、长文本、整型、长整型、浮点型、浮点型(自定义精度)、布尔值、日期、枚举、分类、URL、文件和参考对象类型。
    • 数量:用于约束应用运行态下该实体可添加对应扩展属性类型的数量。
      • 如果应用的数据库类型为mysql,文本、长文本、布尔、日期、分类类型的属性数量不可超过200个,整型、长整型、浮点型、浮点型(自定义精度)类型的属性数量不可超过100个,枚举类型的属性数量不可超过55个,URL类型的属性数量不可超过4个,文件类型的属性数量不可超过183个,参考对象类型的属性数量不可超过45个。
      • 如果应用的数据库类型为postgresql,每种类型的属性数量不可超过200个。
    • 文本长度:表示存储至数据库的文本总长度。如果应用的数据库类型为mysql,其文本总长度不可超过14234字节(Byte)。
    • 是否索引:选择为“是”,系统会在对应实体扩展表中创建普通索引,后续您在应用运行态为该实体添加“索引”“是”的扩展属性时,将自动匹配至有索引的列。同时存在如下约束:
      • 长文本、文件、布尔值、URL不支持选择“索引”“是”
      • 文本、日期、分类和参考对象类型的属性数量不可超过60个,整型、长整型、浮点型和浮点型(自定义精度)类型的总属性数量不可超过60个。
      • 如果应用的数据库类型为postgresql,枚举类型的属性数量不可超过60个。
      • 如果应用的数据库类型为mysql,且“文本长度”的设置大于768个字符,则该配置无效,无需配置。
    • 扩展表名称:默认为“应用英文名称_数据实体英文名称+属性类型+EXAValue”,可自定义。

      例如应用名为DMEApp,数据实体为Parts,属性类型为整型,扩展表名称默认为“DMEApp_PartsNumberEXAValue”

    将具有“扩展属性”功能的实体部署至运行态后,运行态会基于设计态的扩展属性约束规则,自动生成对应的扩展属性值宽表。例如,您在设计态对A实体设置扩展属性类型为数值类型,数量为10个,则在运行态中会自动创建一个“A数值扩展属性值宽表”的实体。

    联合索引管理

    如果在填写基本信息时,“模型类型”选择为“实体模型”,且需要对该实体进行多属性查询时,可在“功能配置”中定义联合索引,提高查询效率。更多关于联合索引的介绍请参见联合索引管理

    API列表

    -

    应用发布后,API列表中的API会注册到APIG,提供调用。

  3. 单击“保存”

相关操作

完成数据实体的创建后,您还需发布数据实体、发布应用生成相应代码包、部署应用生成运行态,才可在运行态应用中调用数据实体API、创建数据实体实例等操作。相关操作请参见:

相关文档