# 数据实例概述 数据实例是数据模型实例化的数据。当数据实体和关系实体同时满足如下条件时，可以在应用运行态管理数据实例。 表1实例约束 | 实体类型 | 满足条件 | |:---|:---| | 数据实体 | - "模型类型"为"实体模型"的数据实体。 - 已在设计态中发布且部署至运行态。 - 基本信息中的"实例界面显示"选择为"是"。 | | 关系实体 | - "模型类型"为"实体模型"的关系实体。 - 已在设计态中发布且部署至运行态。 - 基本信息中的"实例界面显示"选择为"是"。 | - 如果您想对"扩展模型"的数据实体进行实例化，可在创建该父模型的数据实例时，将"实体"或"version.实体"指定为该扩展模型实体。 - 如果您想对未满足条件的数据实体/关系实体进行实例化，可参考如下文档进行操作。 - 参考[发布数据实体](https://support.huaweicloud.com/usermanual-idme/idme_usermanual_0010.html)/[发布关系实体](https://support.huaweicloud.com/usermanual-idme/idme_usermanual_0024.html)，发布数据实体/关系实体。 - 参考[发布应用](https://support.huaweicloud.com/usermanual-idme/idme_usermanual_0085.html)和[部署应用](https://support.huaweicloud.com/consog-idme/idme_consog_0022.html)，将数据实体/关系实体部署至运行态。 - 参考[修改数据实体](https://support.huaweicloud.com/usermanual-idme/idme_clientog_0011.html)/[修改关系实体](https://support.huaweicloud.com/usermanual-idme/idme_clientog_0015.html)，将数据实体/关系实体的"实例界面显示"选择为"是"。 #### 约束与限制 - 使用[全量数据服务API](https://support.huaweicloud.com/usermanual-idme/idme_clientog_0154.html)对数据实体/关系实体进行实例化时，会存在如下约束与限制： - 如果入参参数为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个结构化文档。 - 在对数据模型进行实例化操作时，默认启用跨站脚本攻击（XSS）防护机制。该机制会在数据入库（持久化）前，自动对文本及长文本类型的属性字段进行XSS风险检测。如检测到存在安全隐患的数据，系统将自动拦截，阻止该数据入库，从而有效保障数据存储的安全性与合规性。