Migrar configuração do portal

Artigo
04/25/2023

Observação

Desde o dia 12 de outubro de 2022, os portais do Power Apps passaram a ser Power Pages. Mais Informações: O Microsoft Power Pages já está disponível para todos (blog)
Em breve, migraremos e mesclaremos a documentação dos portais do Power Apps com a documentação do Power Pages.

O desenvolvimento em várias personalizações e configurações para obter a experiência desejada para portais usuários finais.

Depois de concluir o desenvolvimento ou a configuração de sua instância do portal, pode ser útil migrar a configuração mais recente do portal do ambiente de desenvolvimento para o de teste ou de produção.

A migração envolve exportar a configuração existente do ambiente de origem do Microsoft Dataverse e, em seguida, importá-la para o ambiente de destino do Dataverse.

Preparar o ambiente de destino

Observação

A preparação do ambiente de destino é um processo único. Você precisará provisionar um novo portal para instalar as soluções do portal gerenciado no Dataverse bem como configurar o aplicativo Web do portal. O processo também instala metadados do portal padrão que serão substituídos por metadados do portal do seu ambiente de origem.
Certifique-se de que o tamanho máximo de anexo do ambiente de destino esteja definido para o mesmo tamanho ou maior do seu ambiente de origem.
O tamanho máximo dos arquivos é determinado pela configuração Tamanho máximo do arquivo na guia email de configurações do sistema na caixa de diálogo configurações do sistema do ambiente.

Provisione um novo portal no seu ambiente de destino. Use o mesmo modelo de portal que você provisionou no seu ambiente de origem. Por exemplo, se você provisionou o portal Autoatendimento para Clientes do Dynamics 365 no seu ambiente de origem, provisione o portal Autoatendimento para Clientes do Dynamics 365 no seu ambiente de destino.
No ambiente de destino, usando o aplicativo Gerenciamento do Portal, exclua o registro do site recém-criado. Isso removerá os dados de configuração do portal padrão do ambiente de destino.
No ambiente de destino, exclua o aplicativo do portal. Isso removerá o aplicativo do portal atualmente configurado para renderizar o portal padrão.

Observação

Não exclua o aplicativo Gerenciamento do Portal!
Transfira os metadados do portal do ambiente de origem usando a CLI do Power Platform ou a Ferramenta de Migração de Configuração.
No ambiente de destino, provisione um novo portal usando a opção de site do portal existente. Esse processo configurará um portal usando a configuração do portal que você transferiu do ambiente de origem.
As atualizações do portal do ambiente de origem devem ser refletidas nesse novo ambiente de destino. De agora em diante, você deve ser capaz de transferir a configuração do ambiente de origem para os de destino, transferindo os dados de configuração do portal.

Observação

Transferir a configuração do portal usando a CLI do Power Platform

A CLI do Microsoft Power Platform fornece muitos recursos especificamente para portais. Esses comandos permitem baixar a configuração do portal de um ambiente de origem e transferi-la para um ambiente de destino. Esses comandos também podem ser incorporados aos seus processos de ALM.

Crie perfis de autenticação da CLI do Power Platform para se conectar aos ambientes de origem e destino. Você pode nomeá-los para identificar facilmente os ambientes de destino e origem.
```
pac auth create --name [name] --url [environment url]
```
Exemplo
```
pac auth create --name PORTALDEV --url https://contoso-org.crm.dynamics.com
```
Quando os perfis de autenticação forem criados, eles terão um índice associado que poderá ser determinado usando o comando de lista.
```
pac auth list
```
Selecione o perfil de autenticação da CLI do Power Platform conectado ao ambiente de origem.
```
pac auth select --index [source environment index]
```
Exemplo
```
pac auth select --index 1
```
Determine a ID do site para o portal de origem.
```
pac paportal list
```
Baixe os dados de configuração do portal na sua estação de trabalho local. Use o conjunto de opções --overwrite como verdadeiro se você tiver baixado a configuração de portal anterior no mesmo caminho.
```
pac paportal download --path [path] --webSiteId [website id]
```
Exemplo
```
pac paportal download --path c:\paportals\ --webSiteId db9db518-ea5c-ec11-8f8f-00224804e6cd
```
Selecione o perfil de autenticação da CLI do Power Platform conectado ao ambiente de destino.
```
pac auth select --index [target environment index]
```
Exemplo
```
pac auth select --index 2
```

Carregue os dados de configuração do portal no ambiente de destino.

pac paportal upload --path [path]

Exemplo

pac paportal upload --path "C:\paportals\portaldev"

Observação

A ferramenta de CLI do Power Platform não migra tabelas ou esquema de tabela. A migração pode falhar com elementos ausentes, como tabelas e campos, quando os dados de configuração não correspondem ao esquema selecionado. Durante a importação, verifique se o ambiente de destino contém o mesmo tipo de portal já instalado com quaisquer personalizações adicionais, como tabelas, campos, formulários ou exibições, importadas separadamente como soluções.

Observação

Transferir a configuração do portal usando a Ferramenta de Migração de Configuração

Observação

O método preferencial é usar a CLI do Power Platform para transferir metadados do portal.

Para exportar dados de configuração, você precisaria usar a Ferramenta de Migração de Configuração e um arquivo de esquema de configuração específico do portal. Para obter mais informações sobre a ferramenta, consulte Gerencie os dados configuração.

Observação

Recomendamos que usar a versão mais recente a ferramenta de configuração de migração. A ferramenta Migração de Configuração pode ser baixada do NuGet. Para obter mais informações sobre o download da ferramenta: Baixar ferramentas do NuGet.
A versão de solução mínima dos portais com suporte dos arquivos de esquema para migração de configuração é 8.4.0.275. Entretanto, é recomendável usar a versão mais recente da solução.
As organizações de origem e destino devem ter o mesmo idioma padrão para que a migração funcione com êxito.

Os arquivos de esquema estão disponíveis nos tipos de portal a seguir:

Portais criados em um ambiente com o Dataverse
- Portal personalizado (Portal em branco)
- Portal personalizado (portal em branco) (para a versão 9.2.2103.x)
- Portal personalizado (portal em branco) (para a versão 9.3.2201.x ou superior)
Portais criados em um ambiente contendo aplicativos do Customer Engagement (como Dynamics 365 Sales e Dynamics 365 Customer Service)
- Portal personalizado (Portal em branco)
- Portal personalizado (portal em branco) (para a versão 9.2.2103.x)
- Portal personalizado (portal em branco) (para a versão 9.3.2201.x ou superior)
- Portal da comunidade
- Portal de Autoatendimento para Clientes
- Portal do parceiro
- Portal de Autoatendimento para Funcionários

O arquivo de esquema padrão contém informações sobre todas as tabelas, relacionamento e definições únicas de cada entidade. Para obter mais informações, consulte Exportar dados de configuração do portal

Após a exportação dos dados, você deve configurar o ambiente importá-las de destino. Para obter mais informações, consulte Importar dados de configuração do portal

Observação

A ferramenta de migração de configuração usa o esquema para exportar e importar dados de configuração. A ferramenta não migra tabelas ou esquema de tabela. A migração pode falhar com elementos ausentes, como tabelas e campos, quando os dados de configuração não correspondem ao esquema selecionado.

Durante a exportação, certifique-se de que o ambiente de origem contenha tabelas do portal conforme especificado no arquivo de esquema da ferramenta de migração de configuração. Você ainda pode alterar os arquivos de esquema para adicionar, remover e modificar tabelas, atributos e assim por diante para migrar o subconjunto de dados de configuração.

Durante a importação, certifique-se de que o ambiente de destino contenha o mesmo tipo de portal já instalado com quaisquer personalizações adicionais, como tabelas, campos, formulários ou exibições importadas separadamente como soluções.

Portal de dados de exportação de configuração

Você pode exportar os dados de configuração do sistema de origem usando o arquivo padrão do esquema de dados de configuração.

Baixe a ferramenta de migração de configuração e extraia a pasta desejada.
Baixar um arquivo de configuração do esquema acessando-se os links fornecidos no portal para tipo.
Dê duplo clique no arquivo DataMigrationUtility.exe na pasta <your_folder>\Tools\ConfigurationMigration para executar a ferramenta de migração de configuração, escolha Exportar dados na tela principal, e depois selecione Continuar.
Na tela Logon, forneça os detalhes de autenticação para se conectar ao seu ambiente do Dataverse de onde você deseja exportar dados. Se houver várias organizações no ambiente do Dataverse do qual você deseja exportar os dados, marque a caixa de seleção Exibir lista de organizações disponíveis e selecione Logon.
Se houver várias organizações, e você marcou a caixa de seleção Exibir lista de organizações disponíveis, a próxima tela permite selecionar a organização que você deseja se conectar. Selecione um ambiente do Dataverse para estabelecer conexão.

Observação

Se você não tiver essas várias organizações, essa tela não é exibida.
Em Esquema de arquivo, selecione a consulta e o portal no arquivo de configuração de esquema a ser usado para exportar os dados.
Em Salvar para arquivo de dados, especifique o nome e a localização dos arquivos de dados a ser exportado.
Selecione Exportar dados. As tela exibe o status do progresso da exportação e a localização do arquivo exportado na parte inferior de tela quando a exportação for concluída.
Selecione Sair para fechar a ferramenta.

Portal de dados de importação de configuração

Execute a ferramenta de migração de configuração e escolha Importar dados na tela principal, e selecione Continuar.
Na tela Logon, forneça os detalhes de autenticação para se conectar ao seu ambiente do Dataverse de onde você deseja exportar dados. Se houver várias organizações no ambiente do Dataverse do qual você deseja exportar os dados, marque a caixa de seleção Exibir lista de organizações disponíveis e selecione Logon.
Se houver várias organizações, e você marcou a caixa de seleção Exibir lista de organizações disponíveis, a próxima tela permite selecionar a organização que você deseja se conectar. Selecione um ambiente do Dataverse para estabelecer conexão.
Observação
- Se você não tiver essas várias organizações, essa tela não é exibida.
- Assegure a solução que o ainda está instalada para a organização em que planeja importar as configurações.
A tela seguinte solicitará você forneça o arquivo de dados (.zip) a ser importado. Procure o arquivo de dados, selecione-o e clique Importar Dados.
As próximas telas mostram o status da importação dos seus registros. A importação de dados é feita em várias etapas para importar primeiro os dados da fundação enquanto coloca em fila os dados dependentes e importa os dados dependentes nas etapas subsequentes para lidar com qualquer dependência ou vínculo de dados. Esta ação garante uma importação de dados limpa e consistente.
Selecione Sair para fechar a ferramenta.

Criar um portal usando dados migrados

Se o processo de migração estiver atualizando um portal existente, as atualizações agora devem estar visíveis no ambiente de destino. Se a migração for para um novo portal, agora você pode criar o novo portal para o registro do site importado usando a opção Usar dados de registro do site existente. Mais informações: Criar portal

Migração de locatário para locatário

Os portais do Power Apps não oferecem suporte à migração de locatário para locatário. Para migrar um portal de um locatário para outro, você deverá seguir estas etapas:

Redefina seu portal no locatário de origem.
Provisione um novo portal em um ambiente com o Dataverse ou contendo aplicativos do Customer Engagement.
Migre configurações e personalizações do portal usando as etapas explicadas neste artigo anteriormente.

Consulte também

Controlar alterações na configuração de portais do Power Apps.
Suporte dos portais para a CLI do Microsoft Power Platform.
Migração de locatário para locatário de um ambiente do Power Platform.
Migração de locatário para locatário de aplicativos baseados em modelo no Dynamics 365, como Sales, Customer Service, Marketing, Field Service e Project Service Automation.

Observação

Você pode nos falar mais sobre suas preferências de idioma para documentação? Faça uma pesquisa rápida. (Observe que esta pesquisa está em inglês)

A pesquisa levará cerca de sete minutos. Nenhum dado pessoal é coletado (política de privacidade).

Compartilhar via

Migrar configuração do portal

Preparar o ambiente de destino

Transferir metadados do portal

Transferir a configuração do portal usando a CLI do Power Platform

Transferir a configuração do portal usando a Ferramenta de Migração de Configuração

Portal de dados de exportação de configuração

Portal de dados de importação de configuração

Criar um portal usando dados migrados

Migração de locatário para locatário

Consulte também

Recursos adicionais