数据实例概述

使用说明

• 使用全量数据服务API对数据实体/关系实体进行实例化时，会存在如下约束与限制：
  • 如果入参参数为Collection、map或Array类型，单次最多传入1000个对应类型的参数值。
  • 枚举、分类、JSON、参考对象、浮点型（自定义精度）和文件类型属性的入参值不允许为空字符串；文本、长文本、URL和人员类型属性的入参值允许为空字符串，返回结果会返回该空字符串。
  • 如果输入的浮点型（自定义精度）类型属性值超过自定义标度，会先四舍五入到指定标度后再校验。
  • 如果存在“多值”为“是”的枚举类型扩展属性，入参不允许输入[""]。
  • 如果您想将数据实例中自定义的属性（包括基本属性和扩展属性）设置为空值，可在调用数据实体/关系实体的update、batchUpdate、save、saveAs和saveAll接口时，在“needSetNullAttrs”参数中对非必填属性进行设置。其中，saveAs接口仅支持对单数据实体和关系实体的自定义属性设置为空值。
  • 调用数据实体/关系实体的创建类接口（如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接口另存该实体的数据实例。
• 如果实体具有生命周期管理功能，在为该实体创建数据实例时，不能绑定“状态”为“工作中”的生命周期模板。