架构导出和导入

在 Data Fabric / Data Service 中导出和导入实体和选项集架构，以支持整个开发、测试和生产过程中的应用程序生命周期管理。

概述

架构表示每个实体和选项集的元数据，其中包含实体字段数据类型或实体字段之间的关系等信息。

By exporting and importing schema, you are able to implement the best practices of an application lifecycle management—development, testing, deployment—considering capabilities such as copying schema between tenants and folders, or tracking schema changes through a source control tool of your choice.

Exporting schema downloads a JSON file containing the entity metadata on your local machine. You may share the file to be imported by different developers into their tenants or folders, and you yourself can import schemas developed by the community.

Cloning entities across scopes

You can use export and import to clone a native entity schema from one scope to another. For example, export a tenant-level entity and import it into a folder to create a folder-scoped copy with the same schema. Only the schema is cloned — no data is copied. The imported entity is independent of the original and can be modified separately.

This is useful when you want to reuse an existing entity design in a folder for use with Solutions, without recreating the schema manually.

权限

必须为用户设置以下管理权限，才能导出和导入架构：

操作	权限
导出架构	查看架构
导入架构	自定义架构 查看架构

要了解如何设置所需权限，请查看管理访问权限页面。

导出架构

备注：

• 只有拥有足够权限的用户才能导出架构。
• All native entities present in the tenant are exported.
• 系统构建的实体和相应的系统字段不会导出。

To export schema:

1. 导航到 Data Fabric/Data Service 中的所需租户。
2. 选择“导入/导出” 。
3. 选择“导出架构”。弹出消息提示您确认导出。
4. 选择“确认”以触发导出。此时包含架构的.JSON文件下载到您的计算机。

导入架构

备注：

• 只有拥有足够权限的用户才能导入架构。
• 导入的架构文件必须：
  • 有效
  • 为 JSON 格式
  • 小于 30MB
• 导入架构的“创建人”和“修改人”字段将填充执行导入的用户。
• 创建和上次修改时间字段将填充导入的时间戳。
• 导入流程一旦启动，便无法停止。

To import a schema:

1. Navigate to the desired tenant or folder in Data Fabric / Data Service.
2. 选择“导入/导出” 。
3. Select Import Schema.
4. Select the destination location (tenant or folder) for the import.
5. Browse for the schema file and select it.
   备注：

   The schema file must be in JSON format and valid. If you are generating schema files through coding agents, verify that the field types match the expected Data Fabric types, as incorrect types can cause unexpected behavior.

6. Select the entities and choice sets you want to import.
7. If no duplicate is detected, the selected entities are imported in the selected destination. In case of duplicates, the Entities Import window is displayed, allowing you to either append duplicate fields to existing entities or to not import the duplicates.

处理重复项

The process of importing a schema compares the existing entities, fields, or choice sets in the selected destination to those in the imported schema.

对于导入的架构中每个已识别的重复项，系统将显示以下选项：

附加到现有（默认选项）

• Entity fields and choice sets that do not exist in the selected destination are imported.
• 导入时会跳过包含不同属性（例如名称或数据类型）的字段和选项集的实体。

不导入

• The entity does not get imported to the selected destination.