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.

Ao exportar e importar o esquema, você pode implementar as melhores práticas de gerenciamento do ciclo de vida de um aplicativo — desenvolvimento, teste, implantação — considerando recursos como copiar o esquema entre tenants e pastas ou rastrear alterações de esquema por meio de uma ferramenta de controle de origem de sua escolha.

A exportação do esquema baixa um arquivo JSON contendo os metadados da entidade em sua máquina local. Você pode compartilhar o arquivo a ser importado por diferentes desenvolvedores em seus tenants ou pastas, e você mesmo pode importar esquemas desenvolvidos pela comunidade.

Clonagem de entidades entre escopos

É possível exportar e importar para clonar um esquema de entidade nativo de um escopo para outro. Por exemplo, exporte uma entidade no nível do tenant e importe-a para uma pasta para criar uma cópia com escopo de pasta com o mesmo esquema. Apenas o esquema é clonado — nenhum dado é copiado. A entidade importada é independente da original e pode ser modificada separadamente.

Isso é útil quando você quer reutilizar um design de entidade existente em uma pasta para uso com Soluções, sem recriar o esquema manualmente.

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.
• Todas as entidades nativas presentes no tenant são exportadas.
• As entidades integradas do sistema e os campos do sistema correspondentes são excluídos da exportação.

Para exportar o esquema:

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.

Para importar um esquema:

1. Navegue até o tenant ou pasta desejado em Data Fabric / Data Service.
2. Selecione Importação/Exportação.
3. Selecione Importar esquema.
4. Selecione o local de destino (tenant ou pasta) para a importação.
5. Procure o arquivo de esquema e selecione-o.
   Observação:

   O arquivo de esquema deve estar no formato JSON e válido. Se você estiver gerando arquivos de esquema por meio de agentes de codificação, verifique se os tipos de campo correspondem aos tipos esperados do Data Fabric, pois tipos incorretos podem causar comportamento inesperado.

6. Selecione as entidades e conjuntos de escolhas que você deseja importar.
7. Se nenhuma duplicata for detectada, as entidades selecionadas serão importadas no destino selecionado. No caso de duplicatas, a janela Importar entidades é exibida, permitindo que você anexe campos duplicados a entidades existentes ou não importe as duplicatas.

Tratamento de duplicatas

O processo de importação de um esquema compara as entidades, campos ou conjuntos de escolhas existentes no destino selecionado com aqueles do esquema importado.

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

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

• Campos de entidade e conjuntos de escolhas que não existem no destino selecionado são importados.
• 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

• A entidade não é importada para o destino selecionado.