Share via

Migrar sites de modelo de dados padrão para modelo de dados aprimorado (versão preliminar)

  • Artigo

[Este tópico faz parte da documentação de pré-lançamento e está sujeito a alterações.]

Neste artigo, aprenda como migrar seu site de modelo de dados padrão existente para o modelo de dados aprimorado.

Importante

  • Essa é uma versão prévia do recurso.
  • Os recursos de versão preliminar não foram criados para uso em ambientes de produção e podem ter funcionalidade restrita. Esses recursos são disponibilizados antes de um lançamento oficial para que os clientes possam ter acesso antecipado e forneçam comentários.

Pré-requisitos

Etapa 1. Baixar e verificar personalização de metadados de site padrão existentes

  1. Abrir um prompt de comando.

  2. Use o comando a seguir para se autenticar na organização do Dataverse do seu ambiente do Power Platform para fazer download do registro do site para migração.

    pac auth create -u [Dataverse URL]

    Exemplo

    pac auth create -u https://contoso-org.crm.dynamics.com

    Mais informações: pac auth create

  3. Use o comando a seguir para gerar uma lista de sites na organização atual.

    pac powerpages list

    Mais informações: pac powerpages list

  4. Use o comando a seguir para baixar o relatório de personalização.

    pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] --siteCustomizationReportPath [PATH]

    Exemplo

    pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --siteCustomizationReportPath "c:\\pac-powerpages\\downloads"

Se você encontrar alguma personalização no relatório baixado, siga as orientações no relatório para corrigi-la após a migração para o modelo de dados aprimorado. Mais informações: Considerações para personalização do site ao migrar sites do modelo de dados padrão para o aprimorado

Etapa 2. Migrar os dados do site do modelo de dados padrão para o aprimorado

Use o comando a seguir para migrar os dados do seu site para o modelo de dados aprimorado.

pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] –-mode [type-of-data]

O Modo pode ter 3 valores:

Exemplo

pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e –-mode all

A ferramenta de migração verifica as soluções. Se houver uma solução de modelo de dados padrão presente sem uma solução de modelo de dados aprimorada respectiva para o modelo mencionado, um aviso será exibido: Found template <template-name>. One of the prerequisite for migrate needs Enchanged data model template

Existem modelos específicos, como Registro do programa e Agendar e Gerenciar reuniões, que exigem a correspondência de pacotes de modelo de dados aprimorados para garantir que o site migrado funcione corretamente. Para obter esses pacotes de modelo de dados aprimorado, você deve criar um novo site para o modelo correspondente (o ambiente deve ser habilitado para o modelo de dados aprimorado) para fornecer soluções compatíveis com modelo de dados aprimorado para migração.

Modelos com suporte para migração

Os sites com os seguintes modelos são compatíveis com migração:

  • Layout de Início 1-5
  • Processamento de aplicativos
  • Página em branco
  • Registro no programa
  • Agendar e gerenciar reuniões

Etapa 3. Verificar o status da migração

Use o seguinte comando para verificar o status de migração do seu site:

pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] --checkMigrationStatus

Exemplo

pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --checkMigrationStatus

Observação

Se a migração do seu site estiver demorando mais do que o previsto, pode ser devido ao volume de dados. Se o prompt de comando for fechado, abra um novo prompt de comando e use o comando nesta etapa para verificar o status do site.

Etapa 4. Atualizar a versão do modelo de dados do site após uma migração de dados bem-sucedida

Use o seguinte comando para atualizar a versão do modelo de dados do site:

pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] --updateDatamodelVersion --portalId [Portal-GUID]

Observação

  • Você pode encontrar o ID do portal navegando até o site com '/_services/about' anexado à URL do site. Para visualizar essas opções, o usuário deve ter uma função Web com todas as permissões de acesso ao site atribuídas.
  • Depois que a versão do modelo de dados do site for atualizada, o registro do site vinculado ao modelo de dados padrão será desativado. Em vez disso, o site agora fará referência ao registro do site associado ao modelo de dados aprimorado.
  • O usuário deve ter qualquer uma das funções a seguir para executar o comando de migração com argumentos de updateDatamodelVersion ou de revertToStandardDataModel. Como isso executará uma ação do administrador para mudar seu site para o modelo de dados aprimorado ou vice-versa.

Exemplo

pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --updateDatamodelVersion --portalId 04435d71-c45a-4a05-9702-8f127559e48e

Reverter site migrado do modelo de dados aprimorado para o padrão

Use o seguinte comando para reverter um site de modelo de dados padrão para o modelo de dados aprimorado após a migração:

pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] --revertToStandardDataModel --portalId [Portal-GUID]

Observação

Ao alternar um site migrado do modelo de dados aprimorado de volta para o modelo de dados padrão, o registro do site associado ao modelo de dados aprimorado será desativado e o registro do site para o modelo de dados padrão será reativado.

Exemplo

pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --revertToStandardDataModel --portalId 07f35d71-c45a-4a05-9702-8f127559e48e

Migrar um site de produção do modelo de dados padrão para o aprimorado

Antes de migrar um site de produção, recomendamos criar uma cópia completa do site de produção. Também recomendamos que a migração do site de produção seja realizada fora do horário comercial.

Use estas etapas para migrar seu site de produção para o modelo de dados aprimorado:

  1. Teste a migração no site no ambiente copiado usando o comando PAC CLI migrate-datamodel.
  2. Adicione dados de configuração do site para solução gerenciada e importe-os para o ambiente de produção.
  3. Use os comandos da PAC CLI para migrar dados não configurados e conclua-os atualizando a versão do modelo de dados para produção.

Observação

Para migração, as IDs do site de origem e produção são as mesmas.

Considerações para personalização do site ao migrar sites do modelo de dados padrão para o aprimorado

Esta seção fornece orientações sobre a personalização de correção para uma migração de site de modelo de dados padrão para o aprimorado.

Existem cinco tipos de personalizações de site nas tabelas de metadados do adx:

Observação

Todas as correções relacionadas à personalização serão feitas após a migração para o modelo de dados aprimorado.

Colunas personalizadas em tabelas de metadados do adx

Para corrigir essa personalização no modelo de dados aprimorado, crie um relacionamento entre as tabelas do sistema e a nova tabela personalizada e migre os dados para a nova tabela.

Modelo de dados padrão: A tabela adx_webpage contém uma coluna personalizada como contoso_pagetype.

Modelo de dados aprimorado: crie uma nova tabela chamada contoso_webpage Isso incluirá uma coluna chamada contoso_pagetype e uma coluna de pesquisa contoso_webpage_id associada a powerpagescomponent. Utilize o Espaço de trabalho de dados para criação da tabela.

Crie a tabela contoso_webpage no modelo de dados aprimorado para corrigir o código

Relacionamento entre tabelas personalizadas e tabelas adx

Para corrigir essa personalização no modelo de dados aprimorado, crie um relacionamento entre tabelas do sistema e tabelas personalizadas.

Modelo de dados padrão: a tabela adx_webpage tem um relacionamento nomeado adx_webpage_contoso_pagelogs com a tabela contoso_pagelogs.

Modelo de dados aprimorado: cria um novo relacionamento chamado powerpagecomponent_contoso_pagelogs com a tabela contoso_webpage. Utilize o Espaço de trabalho de dados para criação da tabela.

Referências de tabela Adx em trecho de código líquido

Para corrigir essa personalização no modelo de dados aprimorado, substitua as referências de tabela adx no código líquido por referências mspp de tabelas virtuais de modelo de dados aprimorado. Como alternativa, você pode usar a tabela Componente do Site (nome lógico powerpagecomponent) junto com o atributo Tipo de Componente (nome lógico powerpagecomponenttype) para recuperar as referências correspondentes.

Modelo de dados padrão:entities a marca líquida é usada para acessar valores de weblinks no código {% assign app_weblinks= entities['adx_weblinks'] %}.

Modelo de dados aprimorado: em vez de usar links da Web por meio da marca líquida entities, use os respectivos objetos líquidos. entities[adx_weblinks] diretamente. Neste caso entities['adx_weblinks'] pode ser substituído pelo objeto líquido weblinks.

Referências de tabela Adx no xml de fetch

Para corrigir essa personalização no modelo de dados aprimorado, substitua as referências de tabela adx no xml de fetch por referências diretas de tabelas virtuais de modelo de dados aprimorado. Como alternativa, você pode usar a tabela Componente do Site (nome lógico powerpagecomponent) junto com o atributo Tipo de Componente (nome lógico powerpagecomponenttype) para recuperar as referências correspondentes.

Modelo de dados padrão: o nome da tabela adx_webrole é usado na consulta xml de fetch.

{% fetchxml app_webroles %}
<fetch>
 <entity name='adx_webrole'>
  <attribute name='adx_name'/>
 <entity>
</fetch>
{% endfetchxml %}

Modelo de dados aprimorado: use Componente do Site (nome lógico powerpagecomponent) junto com o Tipo de Componente (nome lógico powerpagecomponenttype) para recuperar as referências correspondentes.

{% fetchxml app_webroles %}
<fetch>
 <entity name='powerpagecomponent'>
  <attribute name='adx_name'/>
  <filter type='and'>
   <condition attribute ='powerpagecomponenttype' operator ='eq' value ='11'/>
  <entity>
</fetch>
{% endfetchxml %}

Tipo e valores do componente do site

Tipo de Componente Valor
Estado de Publicação 0
Página da Web 2
Arquivo da Web 3
Conjunto de Links da Web 4
Link da Web 5
Modelo de Página 6
Trecho de Conteúdo 7
Modelo da Web 8
Configuração de Site 9
Regra de Controle de Acesso à Página da Web 10
Função da Web 11
Acesso ao Site 12
Marcador de Site 13
Formulário Básico 15
Metadados do Formulário Básico 16
Lista 17
Permissão de Tabela 18
Formulário Avançado 19
Etapa do Formulário Avançado 20
Metadados do Formulário Avançado 21
Posicionamento de Enquete 24
Posicionamento do Anúncio 26
Consumidor de Bots 27
Perfil de Permissão da Coluna 28
Permissão de Coluna 29
Redirecionar 30
Regra de Transição de Estado de Publicação 31
Atalho 32
Fluxo da Nuvem 33
Componente da Experiência do Usuário 34

Fluxo de trabalho e plug-ins personalizados em tabelas do adx

Para corrigir essa personalização no modelo de dados aprimorado, o fluxo de trabalho e a lógica do plug-in precisam ser refatorados e registrados novamente na respectiva tabela do site.

Por exemplo, se um usuário registrou o fluxo de trabalho/plug-in para a Entidade Principal como Página da Web (nome lógico adx_webpage) no modelo de dados padrão, o código dentro do fluxo de trabalho/plug-in deve ser modificado para a tabela Componente do Site (nome lógico powerpagecomponent) e seus atributos para o modelo de dados aprimorado.

Usar a tabela Componente do Site no fluxo de trabalho e seus atributos para o modelo de dados aprimorado

Problemas conhecidos

O comando de migração está processando apenas um lote de registros 5K do modelo de dados padrão para o modelo de dados aprimorado.