Exportação e importação de esquemas

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 esquema, você pode implementar as melhores práticas de um gerenciamento de ciclo de vida de aplicativos: desenvolvimento, testes, implantação, considerando recursos como copiar esquema entre tenants ou acompanhar alterações de esquema por meio de uma ferramenta de controle de origem da sua escolha.

Exportação de esquema baixa um arquivo JSON contendo os metadados da entidade na sua máquina local. Você pode compartilhar o arquivo a ser importado por desenvolvedores diferentes para seus tenants e você mesmo pode importar esquemas desenvolvidos pela comunidade.

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 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 atual:

1. Navegue até o tenant desejado no Data Service.
2. Clique em Importar/Exportar.
3. Selecione Exportar esquema. Uma mensagem de pop-up solicita que você confirme a exportação.
4. Clique em Confirmar para disparar a exportação. Um arquivo .JSON que contém o esquema é baixado na 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 em seu tenant:

1. Navegue até o tenant desejado no Data Service.
2. Clique em Importar/Exportar.

3. Selecione Importar esquema. Uma janela é exibida, permitindo que você procure o arquivo de esquema e selecione-o.

   Observação: O arquivo de esquema deve estar no formato JSON e válido.
4. Se nenhuma duplicata for detectada, as entidades são importadas no tenant de destino. No caso de duplicatas, a janela Importação de entidades é exibida, permitindo que você anexe os 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 tenant com aqueles no esquema importado.

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

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

• Os campos e conjuntos de escolhas de entidades que não existem no tenant de destino 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 tenant de destino.