Migrar configuración de portal

Nota

A partir del 12 de octubre de 2022, los portales de Power Apps son Power Pages. Más información: Microsoft Power Pages ya está disponible para el público en general (blog)
Pronto migraremos y fusionaremos la documentación de los portales de Power Apps con la documentación de Power Pages.

El desarrollo del portal implica varias configuraciones y personalizaciones para lograr una experiencia deseada para los usuarios finales del portal.

Después de completar el desarrollo o la configuración de su instancia del portal es posible que desee migrar los datos más recientes de configuración del portal del entorno de desarrollo al de prueba o al de producción.

La migración implica la exportación de los datos de configuración existentes desde el entorno de Microsoft Dataverse de origen y, a continuación, importarlos en el entorno de Dataverse de destino.

Preparar el entorno de destino

Nota

• La preparación del entorno de destino es un proceso único. Deberá aprovisionar un nuevo portal para instalar las soluciones de portal administrado en Dataverse, así como configurar la aplicación web del portal. El proceso también instala metadatos del portal predeterminados que se reemplazarán con metadatos del portal de su entorno de origen.
• Asegúrese de que el tamaño máximo de archivo adjunto del entorno de destino esté establecido en el mismo tamaño o en un tamaño superior al de su entorno de origen.
• El tamaño máximo de los archivos está determinado por el valor de configuración tamaño máximo de archivo en el cuatro de diálogo de configuración del sistema de entorno pestaña de correo electrónico de configuración del sistema.

1. Aprovisione un nuevo portal en su entorno de destino. Use la misma plantilla de portal como lo aprovisionó en su entorno de origen. Por ejemplo, si aprovisionó el portal de Autoservicio de clientes de Dynamics 365 en su entorno de origen, aprovisione el portal Autoservicio de clientes de Dynamics 365 en su entorno de destino.

2. En el entorno de destino, mediante la Aplicación de Administración de portales, elimine el registro del sitio web recién creado. Esto eliminará los datos de configuración del portal predeterminados del entorno de destino.

   

3. En el entorno de destino, elimine la aplicación del portal. Esto eliminará la aplicación del portal configurada actualmente para representar el portal predeterminado.

   Nota

   ¡No elimine la aplicación Administración de portales!

   

4. Transfiera los metadatos del portal desde el entorno de origen mediante Power Platform CLI o la Herramienta de migración de la configuración.

5. En el entorno de destino, aprovisione un nuevo portal utilizando la opción de sitio web del portal existente. Este proceso configurará un portal utilizando la configuración del portal que transfirió desde el entorno de origen.

   

6. Las actualizaciones del portal desde el entorno de origen deben reflejarse en este nuevo entorno de destino. En el futuro, debería poder transferir la configuración de su origen a los entornos de destino mediante la transferencia de los datos de configuración del portal.

Transferir metadatos del portal

Power Platform CLI

Nota

A partir del 12 de octubre de 2022, los portales de Power Apps son Power Pages. Más información: Microsoft Power Pages ya está disponible para el público en general (blog)
Pronto migraremos y fusionaremos la documentación de los portales de Power Apps con la documentación de Power Pages.

Transferir la configuración del portal usando Power Platform CLI

Microsoft Power Platform CLI proporciona muchas características específicas para portales. Estos comandos le permiten descargar la configuración del portal desde un entorno de origen y transferirla a un entorno de destino. Estos comandos también se pueden incorporar a sus procesos de ALM.

1. Cree perfiles de autenticación de Power Platform CLI para conectarse a sus entornos de origen y destino. Puede asignarles un nombre para identificar fácilmente los entornos de destino y de origen.

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

   Ejemplo

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

2. Cuando se crean los perfiles de autenticación, tendrán un índice asociado que se puede determinar mediante el comando list.

   pac auth list
   

   

3. Seleccione el perfil de autenticación Power Platform CLI conectado al entorno de origen.

   pac auth select --index [source environment index]
   

   Ejemplo

   pac auth select --index 1
   

4. Determine el id. del sitio web para el portal de origen.

   pac paportal list
   

   

5. Descargue los datos de configuración del portal a su estación de trabajo local. Use la opción --overwrite establecida en cierto si ha descargado previamente la configuración del portal a la misma ruta.

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

   Ejemplo

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

6. Seleccione el perfil de autenticación Power Platform CLI conectado al entorno de destino.

   pac auth select --index [target environment index]
   

   Ejemplo

   pac auth select --index 2
   

7. Cargue los datos de configuración del portal en el entorno de destino.

   pac paportal upload --path [path]
   

   Ejemplo

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

Nota

La Power Platform CLI herramienta no migra tablas ni esquemas de tablas. La migración puede fallar con elementos que falten, como tablas y campos, cuando los datos de configuración no coinciden con el esquema seleccionado. Durante la importación, asegúrese de que el entorno de destino contenga el mismo tipo de portal ya instalado con cualquier personalización adicional como tablas, campos, formularios o vistas importados por separado como soluciones.

Herramienta de migración de la configuración

Nota

A partir del 12 de octubre de 2022, los portales de Power Apps son Power Pages. Más información: Microsoft Power Pages ya está disponible para el público en general (blog)
Pronto migraremos y fusionaremos la documentación de los portales de Power Apps con la documentación de Power Pages.

Transferir configuración de portal con la herramienta Migración de la configuración

Nota

El método preferido es utilizar Power Platform CLI para transferir metadatos del portal.

Para exportar datos de configuración, debe usar la herramienta de migración de configuración y un archivo de esquema de configuración específico del portal. Para obtener más información acerca de esta herramienta, consulte Administrar datos de configuración.

Nota

• Se recomienda usar la versión más reciente de la herramienta Migración de la configuración. La herramienta Migración de la configuración se puede descargar de NuGet. Más información para descargar la herramienta: Descargar herramientas de NuGet.
• La versión mínima de la solución de portales que admiten los archivos de esquema para la migración de la configuración es 8.4.0.275. Sin embargo, se recomienda que use la versión más reciente de la solución.
• Las organizaciones de origen y destino deben tener el mismo idioma predeterminado para que la migración funcione correctamente.

Los archivos de esquema están disponibles para los tipos de portal siguientes:

• Portales creados en un entorno con Dataverse

  • Portal personalizado (portal vacío)
  • Portal personalizado (portal en blanco) (para la versión 9.2.2103.x)
  • Portal personalizado (portal en blanco) (para versión 9.3.2201.x o superior)

• Solo los entornos que contienen aplicaciones de interacción con clientes (como Dynamics 365 Sales y Dynamics 365 Customer Service)

  • Portal personalizado (portal vacío)
  • Portal personalizado (portal en blanco) (para la versión 9.2.2103.x)
  • Portal personalizado (portal en blanco) (para versión 9.3.2201.x o superior)
  • Portal de la comunidad
  • Portal de autoservicio de clientes
  • Portal de asociados
  • Portal de autoservicio de empleados

El archivo de esquema predeterminado contiene información sobre las tablas, relaciones y definiciones de la exclusividad del portal para cada entidad. Más información: Exportar datos de configuración del portal

Después de exportar los datos de configuración, debe importarlos en el entorno de destino. Más información: Importar datos de configuración del portal

Nota

La herramienta Migración de configuración utiliza un esquema para exportar e importar datos de configuración. La herramienta no migra tablas ni esquemas de tablas. La migración puede fallar con elementos faltantes, como tablas y campos, cuando los datos de configuración no coinciden con el esquema seleccionado.

Durante la exportación, asegúrese de que el entorno de origen contenga tablas del portal como se especifica en el archivo de esquema de la herramienta de migración de configuración. Todavía puede alterar los archivos de esquema para agregar, quitar y modificar tablas, atributos, etc. para migrar un subconjunto de datos de configuración.

Durante la importación, asegúrese de que el entorno de destino contenga el mismo tipo de portal ya instalado con cualquier personalización adicional como tablas, campos, formularios o vistas importados por separado como soluciones.

Exportar datos de configuración del portal

Puede exportar los datos de configuración del portal desde un sistema de origen utilizando archivos predeterminados de esquema de configuración específicos del portal.

1. Descargue la herramienta Migración de la configuración y extráigala en la carpeta deseada.

2. Descargue un archivo de esquema de configuración del portal con los vínculos proporcionados anteriormente para el tipo de portal.

3. Haga doble clic en el archivo de DataMigrationUtility.exe en la carpeta <your_folder>\Tools\ConfigurationMigration para ejecutar la herramienta Migración de la configuración, elija Exportar datos en la pantalla principal y luego seleccione Continuar.

   

4. En la pantalla Iniciar sesión, proporcione los detalles de autenticación para conectarse al entorno de Dataverse desde donde desea exportar los datos. Si tiene varias organizaciones en el entorno de Dataverse desde donde exportar los datos, active la casilla Mostrar la lista de organizaciones disponibles y después seleccione Iniciar sesión.

   

5. Si tiene varias organizaciones y había activado la casilla Mostrar la lista de organizaciones disponibles en el paso anterior, la próxima pantalla le permitirá elegir la organización con la que desea conectarse. Seleccione un entorno de Dataverse para conectarse.

   Nota

   Si no tiene varias organizaciones, no se muestra esta pantalla.

6. En Archivo de esquema, busque y seleccione el archivo de esquema de configuración específico del portal que se usará para exportación de datos.

7. En Guardar en archivo de datos, especifique el nombre y la ubicación de archivo de datos que desea exportar.

   

8. Seleccione Exportar datos. La pantalla muestra el estado de progreso de la exportación y la ubicación del archivo exportado en la parte inferior de la pantalla una vez terminada la exportación.

   

9. Seleccione Salir para cerrar la herramienta.

Importar datos de configuración del portal

1. Ejecute la herramienta Migración de la configuración y seleccione Importar datos en la pantalla principal y, a continuación seleccione Continuar.

   

2. En la pantalla Iniciar sesión, proporcione los detalles de autenticación para conectarse al entorno de Dataverse desde donde desea exportar los datos. Si tiene varias organizaciones en el entorno de Dataverse desde donde exportar los datos, active la casilla Mostrar la lista de organizaciones disponibles y después seleccione Iniciar sesión.

3. Si tiene varias organizaciones y había activado la casilla Mostrar la lista de organizaciones disponibles en el paso anterior, la próxima pantalla le permitirá elegir la organización con la que desea conectarse. Seleccione un entorno de Dataverse para conectarse.

   Nota

   • Si no tiene varias organizaciones, no se muestra esta pantalla.
   • Asegúrese de que la solución de portal ya está instalada para la organización donde tenga previsto importar las configuraciones.

4. La siguiente pantalla le pide que facilite el archivo de datos (.zip) que se importa. Busque el archivo de datos, selecciónelo y, a continuación, seleccione Importar datos.

   

5. La pantalla siguiente muestra el estado de importación de sus registros. La importación de datos se realiza en múltiples pasos para importar primero los datos de base mientras se sitúan en cola los datos dependientes, y después se importan los datos dependientes en las pasadas posteriores para administrar las vinculaciones o dependencias de datos. Esta acción una importación limpia y coherente de los datos.

6. Seleccione Salir para cerrar la herramienta.

Crear un nuevo portal utilizando datos migrados

Si el proceso de migración está actualizando un portal existente, las actualizaciones ahora deberían estar visibles en el entorno de destino. Si la migración es para un portal nuevo, ahora puede crearlo para el registro del sitio web importado usando la opción Usar datos del registro del sitio web existente. Más información: Crear portal

Migración de inquilino a inquilino

Los portales de Power Apps no admiten la migración de inquilino a inquilino. Para migrar un portal de un inquilino a otro, debe seguir estos pasos:

1. Reinicie su portal en el inquilino de origen.

2. Suministro de un nuevo portal en un entorno con Dataverse o que contiene aplicaciones de participación del cliente.

3. Migre las configuraciones y personalizaciones del portal mediante los pasos explicados en este artículo anterior.

Consulte también

• Seguimiento de cambios en la configuración de portales de Power Apps.
• Compatibilidad de portales para Microsoft Power Platform CLI.
• Migración de inquilino a inquilino de un entorno Power Platform.
• Migración inquilino a inquilino de aplicaciones basadas en modelos en Dynamics 365 como Sales, Customer Service, Marketing, Field Service y Project Service Automation.

Nota

¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)

La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).