Partilhar via

Migrar sites de modelo de dados padrão para o modelo de dados avançado (pré-visualização)

  • Artigo

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

Neste artigo, vai aprender a migrar o seu site de modelo de dados padrão existente para o modelo de dados avançado.

Importante

  • Esta é uma funcionalidade de pré-visualização.
  • As caraterísticas de pré-visualização não se destinam à produção e poderão ter caraterísticas restritas. Estas caraterísticas estão disponíveis antes do lançamento oficial, para que os clientes possam ter acesso antecipado e enviar comentários.

Pré-requisitos

Passo 1. Transferir e verificar a personalização de metadados de site padrão existentes

  1. Abra uma linha de comandos.

  2. Utilize o comando que se segue para autenticar a organização do Dataverse para o seu ambiente do Power Platform para transferir o registo 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: criação de autenticação do pac

  3. Utilize o comando que se segue para gerar uma lista de sites na organização atual.

    pac powerpages list

    Mais informações: lista do powerpages pac

  4. Utilize o comando seguinte para transferir 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 encontrar alguma personalização no relatório transferido, siga as orientações no relatório para corrigi-las após a migração para o modelo de dados avançado. Mais informações: Considerações para personalização de sites ao migrar sites do modelo de dados padrão para avançado

Passo 2. Migrar os dados do site de modelo padrão para o modelo de dados avançado

Utilize o comando seguinte para migrar os dados do site para o modelo de dados avançado.

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 respetiva solução de modelo de dados avançado para o modelo mencionado, é apresentado um aviso: Found template <template-name>. One of the prerequisite for migrate needs Enchanged data model template

Existem modelos específicos, como o registo no Programa e Agendar e Gerir reuniões, que necessitam de pacotes de modelos de dados melhorados correspondentes para assegurar que o site migrado funciona corretamente. Para obter estes pacotes de modelos de dados avançados, tem de criar um novo site para o modelo correspondente (o ambiente deve estar ativado para o modelo de dados avançado) para fornecer soluções compatíveis com o modelo de dados avançado para migração.

Modelos suportados para migração

Os sites com os seguintes modelos são suportados para migração:

  • Esquema de iniciação 1-5
  • Processamento da aplicação
  • Página em branco
  • Registo no programa
  • Agendar e gerir reuniões

Passo 3. Verificar o estado da migração

Use o seguinte comando para verificar o estado da 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

Nota

Se a migração do site está a demorar mais do que o previsto, pode ser devido ao volume de dados. Se o pedido de comando fechar, abra um novo pedido de comando e use o comando neste passo para verificar o estado do seu site.

Passo 4. Atualizar a versão do modelo de dados do site após a migração de dados com êxito

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]

Nota

  • Pode encontrar o ID do Portal navegando para o site com '/_services/about' anexado ao URL do site. Para ver estas opções, o utilizador deve ter uma função da Web com todas as permissões de acesso ao site atribuídas.
  • Após a versão do modelo de dados do site ser atualizada, o registo do site associado ao modelo de dados padrão será desativado. Em vez disso, o site irá agora fazer referência ao registo do site associado ao modelo de dados avançado.
  • O utilizador deve ter qualquer uma das seguintes funções para executar o comando de migração com argumentos updateDatamodelVersion ou revertToStandardDataModel. Isto irá executar a ação de administrador para mudar o seu site para o modelo de dados avançado ou vice-versa.

Exemplo

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

Reverter o site migrado de modelo de dados avançado para padrão

Utilize o comando seguinte para reverter um site de modelo de dados padrão para um modelo de dados avançado após a migração:

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

Nota

Quando alternar um site migrado do modelo de dados avançado de volta para o modelo de dados padrão, o registo de site associado ao modelo de dados avançado será desativado e o registo 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 avançado

Antes de migrar um site de produção, recomendamos a criação de cópia completa do site de produção. Recomendamos também que a migração do site de produção seja realizada fora do horário de funcionamento.

Utilize estes passos para migrar o seu site de produção para o modelo de dados avançado:

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

Nota

No caso da migração, o ID do site de origem e de produção são os mesmos.

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

Esta secção fornece orientações para corrigir a personalização de uma migração de site do modelo de dados padrão para avançado.

Existem cinco tipos de personalizações de sites em tabelas de metadados adx:

Nota

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

Colunas personalizadas em tabelas de metadados adx

Para corrigir esta personalização no modelo de dados avançado, crie uma relação entre tabelas de sistema e 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 avançado: crie uma nova tabela com o nome contoso_webpage. Isto inclui uma coluna chamada contoso_pagetype e uma coluna de procura contoso_webpage_id associada a powerpagescomponent. Utilize a Área de trabalho de dados para a criação de tabelas.

Criar a tabela contoso_webpage no modelo de dados avançado para corrigir código

Relação entre tabelas personalizadas e tabelas adx

Para corrigir esta personalização no modelo de dados avançado, crie uma relação entre tabelas personalizadas e tabelas de sistema.

Modelo de dados padrão: a tabela adx_webpage tem uma relação com o nome adx_webpage_contoso_pagelogs com a tabela contoso_pagelogs.

Modelo de dados avançado: crie uma nova relação com o nome powerpagecomponent_contoso_pagelogs com a tabela contoso_webpage. Utilize a Área de trabalho de dados para a criação de tabelas.

Referências de tabela adx no fragmento de código Liquid

Para corrigir esta personalização no modelo de dados avançado, substitua as referências da tabela adx em código Liquid por referências mspp das tabelas virtuais do modelo de dados avançado. Em alternativa, pode utilizar a tabela Componente do Site (nome lógico powerpagecomponent) juntamente com o atributo Tipo de Componente (nome lógico powerpagecomponenttype) para obter as referências correspondentes.

Modelo de dados padrão:entities a etiqueta do Liquid é usada para aceder a valores de ligações Web no código {% assign app_weblinks= entities['adx_weblinks'] %}.

Modelo de dados avançado: em vez de utilizar ligações Web através da etiqueta entities do Liquid, utilize os respetivos objetos do Liquid. entities[adx_weblinks] diretamente. Neste caso, entities['adx_weblinks'] pode ser substituído pelo objeto do Liquid weblinks.

Referências de tabela adx em fetch xml

Para corrigir esta personalização no modelo de dados avançado, substitua as referências da tabela adx em fetch xml por referências diretas das tabelas virtuais do modelo de dados avançado. Em alternativa, pode utilizar a tabela Componente do Site (nome lógico powerpagecomponent) juntamente com o atributo Tipo de Componente (nome lógico powerpagecomponenttype) para obter as referências correspondentes.

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

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

Modelo de dados avançado: use Componente do Site (nome lógico powerpagecomponent) juntamente com o atributo Tipo de Componente (nome lógico powerpagecomponenttype) para obter 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 5
Página Web 2
Ficheiro Web 3
Conjunto de Ligações Web 4
Ligação Web 5
Modelo de Página 6
Fragmento de Conteúdo 7
Modelo Web 8
Definição do Site 9
Regra de Controlo de Acesso à Página Web 10
Função Web 11
Acesso ao Site 12
Marcador do Site 13
Formulário Básico 15
Metadados de Formulário Básico 17
Listar 17
Permissão de Tabela 18
Formulário Avançado 19
Passo de Formulário Avançado 20
Metadados de Formulário Avançado 21
Colocação de Inquéritos 24
Colocação de Anúncios 26
Consumidor do Bot 27
Perfil de Permissão de Coluna 28
Permissão de Coluna 29
Redirecionamento 30
Regra de Transição da Condição de Publicação 31
Atalho 32
Fluxo de Cloud 33
Componente da UX 34

Fluxo de trabalho personalizado e plug-ins em tabelas adx

Para corrigir esta personalização no modelo de dados avançado, a lógica do fluxo de trabalho e do plug-in tem de ser refatorizada e registada novamente na respetiva tabela do site.

Por exemplo, se um utilizador registou o fluxo de trabalho/plug-in na Entidade Primária como tabela Página Web (nome lógico adx_webpage) no modelo de dados padrão, o código no fluxo de trabalho/plug-in tem de ser modificado para a tabela Componente do Site (nome lógico powerpagecomponent) e respetivos atributos para o modelo de dados avançado.

Utilizar a tabela Componente do Site no fluxo de trabalho e os respetivos atributos para o modelo de dados avançado

Problemas conhecidos

O comando de migração está apenas a processar um lote de 5.000 registos do modelo de dados padrão para o modelo de dados avançado.