Migrar configuración do portal

Nota

A partir do 12 de outubro de 2022, Portais de Power Apps é Power Pages. Máis información: Microsoft Power Pages xa está dispoñible de forma xeral (blog)
Proximamente migraremos e uniremos a documentación de Portais de Power Apps coa documentación de Power Pages.

O desenvolvemento do portal implica varias configuracións e personalizacións para lograr unha experiencia desexada para os usuarios finais del portal.

Despois de completar o desenvolvemento ou a configuración da súa instancia de Portal, é posible que desexe migrar os datos máis recentes de configuración de Portal do contorno de desenvolvemento ao de proba ou ao de produción.

A migración implica a exportación dos datos de configuración existentes desde o ambiente de Microsoft Dataverse de orixe e, a seguir, importalos no ambiente de Dataverse de destino.

Preparar o ambiente obxectivo

Nota

• A preparación do ambiente de destino é un proceso único. Deberá proporcionar un novo portal para instalar as solucións do portal xestionadas en Dataverse así como configurar a aplicación web do portal. O proceso tamén instala metadatos do portal predeterminados que se substituirán por metadatos do portal do seu contorno de orixe.
• Asegúrese de que o tamaño máximo dos anexos do contorno de destino estea configurado no mesmo ou maior tamaño que o seu contorno de orixe.
• O tamaño máximo dos ficheiros vén determinado polo axuste Tamaño máximo do ficheiro na pestana de correo electrónico de configuración do sistema no cadro de diálogo de configuración do sistema do contorno.

1. Proporcione un novo portal no seu ambiente de destino. Use o mesmo modelo de portal tal e como aprovisionou no seu contorno de orixe. Por exemplo, se aprovisionou o portal de autoservizo de clientes de Dynamics 365 no seu contorno de orixe, proporcione o portal de autoservizo de clientes de Dynamics 365 no seu contorno de destino.

2. No contorno de destino, utilizando a Aplicación de xestión de portais, elimine o rexistro do sitio web recentemente creado. Isto eliminará os datos de configuración do portal predeterminados do contorno de destino.

   

3. No ambiente obxectivo, elimine a aplicación do portal. Isto eliminará a aplicación do portal actualmente configurada para renderizar o portal predeterminado.

   Nota

   Non eliminar a aplicación de xestión do portal.

   

4. Transfira os metadatos do portal do contorno de orixe mediante a CLI de Power Platform ou a Configuration Migration Tool.

5. No contorno de destino, proporcione un novo portal mediante a opción de sitio web do portal existente. Este proceso configurará un portal mediante a configuración do portal que transferiu desde o contorno de orixe.

   

6. As actualizacións do portal do contorno de orixe deberían reflectirse neste novo contorno de destino. No futuro, debería poder transferir a configuración da súa orixe aos ambientes de destino transferindo os datos de configuración do portal.

Transferir metadatos do portal

CLI de Power Platform

Nota

A partir do 12 de outubro de 2022, Portais de Power Apps é Power Pages. Máis información: Microsoft Power Pages xa está dispoñible de forma xeral (blog)
Proximamente migraremos e uniremos a documentación de Portais de Power Apps coa documentación de Power Pages.

Transferir a configuración do portal usando a CLI de Power Platform

A CLI de Microsoft Power Platform ofrece moitas funcións especificamente para portais. Estes comandos permítenlle descargar a configuración do portal desde un ambiente de orixe e transferilo a un ambiente de destino. Estes comandos tamén se poden incorporar aos seus procesos de ALM.

1. Cree perfís de autenticación da CLI de Power Platform para conectarse aos seus contornos de orixe e destino. Pode darlles un nome para identificar facilmente os ambientes de destino e orixe.

   pac auth create --name [name] --url [environment url]
   

   Exemplo

   pac auth create --name PORTALDEV --url https://contoso-org.crm.dynamics.com
   

2. Cando se creen os perfís de autenticación, terán un índice asociado que se pode determinar mediante a lista de comandos.

   pac auth list
   

   

3. Seleccione o perfil de autenticación da CLI de Power Platform conectado ao contorno de orixe.

   pac auth select --index [source environment index]
   

   Exemplo

   pac auth select --index 1
   

4. Determine o ID do sitio web para o portal de orixe.

   pac paportal list
   

   

5. Descargue os datos de configuración do portal na súa estación de traballo local. Use o conxunto de opcións --sobrescribir establecido en verdadeiro se xa descargou a configuración do portal no mesmo camiño.

   pac paportal download --path [path] --webSiteId [website id]
   

   Exemplo

   pac paportal download --path c:\paportals\ --webSiteId db9db518-ea5c-ec11-8f8f-00224804e6cd
   

6. Seleccione o perfil de autenticación da CLI de Power Platform conectado ao contorno de destino.

   pac auth select --index [target environment index]
   

   Exemplo

   pac auth select --index 2
   

7. Cargue os datos de configuración do portal no contorno de destino.

   pac paportal upload --path [path]
   

   Exemplo

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

Nota

A ferramenta CLI da Power Platform non migra táboas nin esquemas de táboas. A migración pode fallar con elementos que faltan como táboas e campos cando os datos de configuración non coinciden co esquema seleccionado. Durante a importación, asegúrese de que o contorno de destino conteña o mesmo tipo de portal xa instalado con calquera personalización adicional como táboas, campos, formularios ou vistas importadas por separado como solucións.

Ferramenta de migración da configuración

Nota

A partir do 12 de outubro de 2022, Portais de Power Apps é Power Pages. Máis información: Microsoft Power Pages xa está dispoñible de forma xeral (blog)
Proximamente migraremos e uniremos a documentación de Portais de Power Apps coa documentación de Power Pages.

Configuración do portal de transferencia mediante a Configuration Migration Tool

Nota

O método preferido é utilizar a CLI de Power Platform para transferir metadatos do portal.

Para exportar datos de instalación, deberá usar a ferramenta Migración da configuración e un ficheiro de esquema de configuración específico do portal. Para obter máis información acerca desta ferramenta, consulte Administrar datos de configuración.

Nota

• Recoméndase usar a versión máis recente da ferramenta Migración da configuración. A ferramenta Migración da configuración pódese descargar de NuGet. Máis información para descargar a ferramenta: Descargar ferramentas de NuGet.
• A versión mínima da solución de Portals que admiten os ficheiros de esquema para a migración da configuración é 8.4.0.275. Non obstante, recomendamos utilizar a versión máis recente da solución.
• As organizacións de orixe e destino deben ter o mesmo idioma predeterminado para que a migración funcione correctamente.

Os ficheiros de esquema están dispoñibles para os tipos de portal seguintes:

• Portais creados nun contorno con Dataverse

  • Portal personalizado (portal en branco)
  • Portal personalizado (portal en branco) (para a versión 9.2.2103.x)
  • Portal personalizado (portal en branco) (para a versión 9.3.2201.x ou superior)

• Portais creados nun contorno que contén aplicacións de participación de clientes (como Dynamics 365 Sales e Dynamics 365 Customer Service)

  • Portal personalizado (portal en branco)
  • Portal personalizado (portal en branco) (para a versión 9.2.2103.x)
  • Portal personalizado (portal en branco) (para a versión 9.3.2201.x ou superior)
  • Portal da comunidade
  • Portal de autoservizo de clientes
  • Portal de asociados
  • Portal de autoservizo de empregados

Os ficheiros de esquema predefinidos conteñen información sobre as táboas, relacións e definicións da exclusividade do portal para cada entidade. Máis información: Exportar datos de configuración do portal

Despois de exportar os datos de configuración, debe importalos ao ambiente de destino. Máis información: Importar datos de configuración do portal

Nota

A ferramenta Migración de configuración utiliza un esquema para exportar e importar datos de configuración. A ferramenta non migra táboas nin esquemas de táboas. A migración pode fallar con elementos que faltan como táboas e campos cando os datos de configuración non coinciden co esquema seleccionado.

Durante a exportación, asegúrese de que o contorno de orixe conteña táboas de portal como se especifica no ficheiro de esquema da ferramenta de migración de configuración. Pode alterar os ficheiros do esquema para engadir, quitar e modificar táboas, atributos etc. para mirar un subconxunto de datos de configuración.

Durante a importación, asegúrese de que o contorno de destino conteña o mesmo tipo de portal xa instalado con calquera personalización adicional como táboas, campos, formularios ou vistas importadas por separado como solucións.

Exportar datos de configuración do portal

Pode exportar os datos de configuración do portal desde un sistema de orixe utilizando ficheiros predeterminados de esquema de configuración específicos do portal.

1. Descargue a ferramenta Migración da configuración e extráiala no cartafol desexado.

2. Descargue un ficheiro de esquema de configuración do portal coas ligazóns fornecidas anteriormente para o tipo de portal.

3. Prema dúas veces no ficheiro DataMigrationUtility.exe no cartafol <your_folder>\Tools\ConfigurationMigration para executar a ferramenta Migración da configuración, escolla Exportar datos na pantalla principal e, a seguir, seleccione Continuar.

   

4. Na pantalla Inicio de sesión, forneza detalles de autenticación para conectar co ambiente de Dataverse desde o que quere exportar os datos. Se ten varias organizacións no ambiente de Dataverse e quere exportar os datos, seleccione a caixa de verificación Mostrar a lista de organizacións e seleccione Iniciar sesión.

   

5. Se ten varias organizacións e activou a caixa de verificación Mostrar a lista de organizacións dispoñibles no paso anterior, a próxima pantalla permitiralle escoller a organización coa que desexe conectarse. Seleccione un ambiente de Dataverse ao que quere conectarse.

   Nota

   Se non ten varias organizacións, non se mostra esta pantalla.

6. En Ficheiro de esquema, busque e seleccione o ficheiro de esquema de configuración específico do portal que se utilizará para exportación de datos.

7. En Gardar en ficheiro de datos, especifique o nome e a localización do ficheiro de datos que desexe exportar.

   

8. Seleccione Exportar datos. A pantalla mostra o estado do progreso da exportación e a localización do ficheiro exportado na parte inferior da pantalla unha vez que conclúe a exportación.

   

9. Seleccione Saír para pechar a ferramenta.

Importar datos de configuración do portal

1. Execute a ferramenta Migración da configuración e seleccione Importar datos na pantalla principal e, a seguir, seleccione Continuar.

   

2. Na pantalla Inicio de sesión, forneza detalles de autenticación para conectar co ambiente de Dataverse desde o que quere exportar os datos. Se ten varias organizacións no ambiente de Dataverse e quere exportar os datos, seleccione a caixa de verificación Mostrar a lista de organizacións e seleccione Iniciar sesión.

3. Se ten varias organizacións e activou a caixa de verificación Mostrar a lista de organizacións dispoñibles no paso anterior, a próxima pantalla permitiralle escoller a organización coa que desexe conectarse. Seleccione un ambiente de Dataverse ao que quere conectarse.

   Nota

   • Se non ten varias organizacións, non se mostra esta pantalla.
   • Asegúrese de que a solución para o portal xa está instalada para a organización onde teña previsto importar as configuracións.

4. A seguinte pantalla solicitaralle que forneza o ficheiro de datos (.zip) que se vai importar. Busque o ficheiro de datos, seleccióneo e, a seguir, seleccione Importar datos.

   

5. A pantalla seguinte mostra o estado de importación dos rexistros. A importación de datos realízase en varias fases para importar primeiro os datos base mentres os datos dependentes fan cola e, a seguir, importar os datos dependentes nas fases seguintes para xestionar as ligazóns e dependencias de datos. Esta acción asegura unha importación de datos limpa e coherente.

6. Seleccione Saír para pechar a ferramenta.

Crear un novo portal utilizando datos migrados

Se o proceso de migración está a actualizar un portal existente, as actualizacións deberían estar agora visibles no contorno de destino. Se a migración é para un portal novo, agora pode crear o novo portal para o rexistro do sitio web importado mediante a opción Usar os datos do rexistro do sitio web existente. Máis información: Crear un portal

Migración de arrendatario a arrendatario

Os portais de Power Apps non admiten a migración de arrendatario a arrendatario. Para migrar un portal dun arrendatario a outro, ten que seguir estes pasos:

1. Restablecer o seu portal no arrendatario de orixe.

2. Forneza un novo portal nun ambiente con Dataverse ou que conteña aplicacións de compromiso dos clientes.

3. Migre configuracións e personalizacións do portal usando os pasos explicados neste artigo anteriormente.

Consulte tamén

• Faga un seguimento dos cambios na configuración de portais de Power Apps.
• Asistencia técnica de portais para a CLI de Microsoft Power Platform.
• Migración de arrendatario a arrendatario dun ambiente de Power Platform.
• Migración de arrendatario a arrendatario de aplicacións xeradas por modelos de Dynamics 365, como Sales, Customer Service, Marketing, Field Service e Project Service Automation.

Nota

Pode indicarnos as súas preferencias para o idioma da documentación? Realice unha enquisa breve. (teña en conta que esa enquisa está en inglés)

Esta enquisa durará sete minutos aproximadamente. Non se recompilarán datos persoais (declaración de privacidade).