工业数字模型驱动引擎-数据实例概述:使用说明

时间:2024-12-23 10:44:02

使用说明

  • 使用全量数据服务API对数据实体/关系实体进行实例化时,会存在如下约束与限制:
    • 如果入参参数为Collection、map或Array类型,单次最多传入1000个对应类型的参数值。
    • 枚举、分类、JSON、参考对象、浮点型(自定义精度)和文件类型属性的入参值不允许为空字符串;文本、长文本、URL和人员类型属性的入参值允许为空字符串,返回结果会返回该空字符串。
    • 如果输入的浮点型(自定义精度)类型属性值超过自定义标度,会先四舍五入到指定标度后再校验。
    • 如果存在“多值”“是”的枚举类型扩展属性,入参不允许输入[""]
    • 如果您想将 数据实例 中自定义的属性(包括基本属性和扩展属性)设置为空值,可在调用数据实体/关系实体的update、batchUpdate、save、saveAs和saveAll接口时,在“needSetNullAttrs”参数中对非必填属性进行设置。
    • 调用数据实体/关系实体的创建类接口(如create、batchCreate、save、saveAs和saveAll)时,
      • 已设置默认值的属性未输入入参值,返回结果会返回该默认值。
      • 未设置默认值的整型、长整型、浮点型、日期和布尔值类型属性,如果入参值为空字符串,返回结果会返回空值(即NULL)。
    • 调用数据实体/关系实体的更新类接口(如updateByAdmin、update、reviseAndUpdate、checkoutAndUpdate、updateAndCheckin、updateByCondition、save、saveAll、batchUpdateByAdmin、batchReviseAndUpdate、batchCheckoutAndUpdate和batchUpdateAndCheckin)时,
      • 如果存在“值可变”“否”的属性,其返回结果会返回原值。
      • 整型、长整型、浮点型、日期和布尔值类型属性,如果入参值为空字符串,返回结果会返回原值。
    • 调用save和saveAs接口时,如果入参值为NULL或未输入入参值,其返回结果会返回原值。
    • 调用saveAll接口时,基本属性的入参值会强覆盖,扩展属性的入参值不会强覆盖。即:如果基本属性未输入入参值,其返回结果会返回NULL;如果扩展属性未输入入参值,其返回结果会返回原值。
    • 调用find接口查询“入库”“否”的属性时,如果对应属性未设置默认值,其返回结果会返回NULL。
  • 支持调用数据实体/关系实体的saveAs接口另存该实体的数据实例。
  • 如果实体具有生命周期管理功能,在为该实体创建数据实例时,不能绑定“状态”“工作中”的生命周期模板。
  • 如果实体具有结构化文档管理功能,该实体下的每个数据实例最多只能创建200个结构化文档。
support.huaweicloud.com/usermanual-idme/idme_clientog_0017.html