Exportação e importação de esquemas

Exporte e importe esquemas de entidade e de conjunto de escolhas no Data Fabric/Data Service para oferecer suporte ao gerenciamento do ciclo de vida do aplicativo em desenvolvimento, testes e produção.

Visão geral

Um esquema representa os metadados de todas as entidades e conjuntos de escolhas, mantendo informações como o tipo de dados de campos de entidade ou os relacionamentos entre os campos de entidade.

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.

Permissões

As seguintes permissões administrativas devem ser definidas para os usuários exportarem e importarem esquema:

Operação	Permission
Exportar Esquema	Exibir Esquema
Importar Esquema	Personalizar esquema exibir esquema

Para saber como definir as permissões necessárias, verifique a página Gerenciando acesso .

Exportação de esquema

Observação:

• Somente os usuários com permissões adequadas podem exportar o esquema.
• All native entities present in the tenant are exported.
• As entidades integradas do sistema e os campos do sistema correspondentes são excluídos da exportação.

To export schema:

1. Navegue até o tenant desejado no Data Fabric / Data Service.
2. Selecione Importação/Exportação.
3. Selecione Exportar esquema. Uma mensagem de pop-up solicita que você confirme a exportação.
4. Selecione Confirmar para disparar a exportação. Um arquivo .JSON contendo o esquema é baixado para sua máquina.

Importação de esquema

Observação:

• Somente usuários com permissões adequadas podem importar o esquema.
• O arquivo de esquema importado deve ser:
  • válido
  • no formato JSON
  • menos de 30 MB
• Os campos Criado por e Modificado por do esquema importado são preenchidos com o usuário que executou a importação.
• Os campos de hora de criação e última modificação são preenchidos com o carimbo de data/hora da importação.
• Depois de iniciado, o processo de importação não pode ser interrompido.

To import a schema:

1. Navigate to the desired tenant or folder in Data Fabric / Data Service.
2. Selecione Importação/Exportação.
3. Select Import Schema.
4. Select the destination location (tenant or folder) for the import.
5. Browse for the schema file and select it.
   Observação:

   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.

Tratamento de duplicatas

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

Para cada duplicata identificada no esquema importado, as seguintes opções são exibidas:

Acrescentar à existente (opção padrão)

• Entity fields and choice sets that do not exist in the selected destination are imported.
• Entidades que contêm campos e conjuntos de escolhas com propriedades diferentes (como nome ou tipo de dados) são ignoradas na importação.

Não importar

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