Compartir a través de

Migrar sitios de modelos de datos estándar a un modelo de datos mejorado (versión preliminar)

  • Artículo

[Este tema es documentación preliminar y está sujeto a modificaciones.]

En este artículo, aprenderá cómo migrar su sitio de modelo de datos estándar existente al modelo de datos mejorado.

Importante

  • Esta es una característica de vista previa.
  • Las características en vista previa no se han diseñado para un uso de producción y pueden tener una funcionalidad restringida. Estas características están disponibles antes del lanzamiento oficial para que los clientes puedan tener un acceso anticipado y proporcionar comentarios.

Requisitos previos

Paso 1. Descargar y verificar la personalización de los metadatos del sitio estándar existentes

  1. Abra un símbolo del sistema.

  2. Utilice el siguiente comando para autenticarse en la organización de Dataverse de su entorno de Power Platform para descargar el registro del sitio web para la migración.

    pac auth create -u [Dataverse URL]

    Ejemplo

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

    Más información: pac auth create

  3. Utilice el siguiente comando para generar una lista de sitios web en la organización actual.

    pac powerpages list

    Más información: pac powerpages list

  4. Utilice el siguiente comando para descargar el informe de personalización.

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

    Ejemplo

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

Si encuentra alguna personalización en el informe descargado, siga las instrucciones del informe para solucionarlo después de la migración al modelo de datos mejorado. Más información: Consideraciones para la personalización del sitio al migrar sitios del modelo de datos estándar al mejorado

Paso 2. Migrar los datos del sitio del modelo de datos estándar al mejorado

Utilice el siguiente comando para migrar los datos de su sitio al modelo de datos mejorado.

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

El Modo puede tener 3 valores:

Ejemplo

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

La herramienta de migración verifica las soluciones. Si hay una solución de modelo de datos estándar presente sin una solución de modelo de datos mejorada respectiva para la plantilla mencionada, se muestra una advertencia: Found template <template-name>. One of the prerequisite for migrate needs Enchanged data model template

Hay plantillas específicas, como el registro del programa y la programación y gestión de reuniones, que requieren la coincidencia de paquetes de modelos de datos mejorados para garantizar que el sitio web migrado funcione correctamente. Para obtener estos paquetes de modelos de datos mejorados, debe crear un nuevo sitio para la plantilla correspondiente (el entorno debe estar habilitado para el modelo de datos mejorado) para proporcionar soluciones compatibles con el modelo de datos mejorado para la migración.

Plantillas compatibles para la migración

Los sitios con las siguientes plantillas son compatibles con la migración:

  • Diseño de inicio 1-5
  • Procesamiento de la aplicación
  • Página en blanco
  • Registro en el programa
  • Programar y administrar reuniones

Paso 3. Verificar el estado de la migración

Utilice el siguiente comando para verificar el estado de migración de su sitio:

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

Ejemplo

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

Nota

Si la migración de su sitio está tardando más de lo previsto, puede deberse al volumen de datos. Si su símbolo del sistema se cierra, abra un nuevo símbolo del sistema y use el comando en este paso para verificar el estado de su sitio.

Paso 4. Actualizar la versión del modelo de datos del sitio después de una migración de datos correcta

Utilice el siguiente comando para actualizar la versión del modelo de datos del sitio:

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

Nota

  • Puede encontrar la identificación del portal navegando al sitio web con "/_services/about" agregado a la URL del sitio web. Para ver estas opciones, el usuario debe tener un rol web con todos los permisos de acceso al sitio web asignados.
  • Una vez actualizada la versión del modelo de datos del sitio, se desactivará el registro del sitio web vinculado al modelo de datos estándar. En cambio, el sitio ahora hará referencia al registro del sitio web asociado con el modelo de datos mejorado.
  • El usuario debe tener cualquiera de los siguientes roles para ejecutar el comando de migración con argumentos updateDatamodelVersion o revertToStandardDataModel. Ya que esto realizará una acción administrativa para cambiar su sitio para mejorar el modelo de datos o viceversa.

Ejemplo

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

Revertir el sitio migrado del modelo de datos mejorado al estándar

Utilice el siguiente comando para revertir un sitio de modelo de datos estándar a un modelo de datos mejorado después de la migración:

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

Nota

Cuando cambia un sitio migrado del modelo de datos mejorado al modelo de datos estándar, el registro del sitio web asociado con el modelo de datos mejorado se desactivará y el registro del sitio web para el modelo de datos estándar se reactivará.

Ejemplo

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

Migrar un sitio de producción del modelo de datos estándar al mejorado

Antes de migrar un sitio de producción, recomendamos crear una copia completa del sitio de producción. También recomendamos que la migración del sitio de producción se realice fuera del horario comercial.

Utilice estos pasos para migrar el sitio de producción al modelo de datos mejorado:

  1. Pruebe la migración en el sitio en el entorno copiado usando el comando migrate-datamodel de PAC CLI.
  2. Agregue datos de configuración del sitio a solución administrada e impórtelos al entorno de producción.
  3. Utilice los comandos de PAC CLI para migrar datos que no sean de configuración y finalizarlos actualizando la versión del modelo de datos para producción.

Nota

Para la migración, la identificación del sitio web de origen y de producción es la misma.

Consideraciones para la personalización del sitio al migrar sitios del modelo de datos estándar al mejorado

En esta sección se proporciona orientación para solucionar la personalización de la migración de un sitio del modelo de datos estándar al mejorado.

Hay cinco tipos de personalizaciones de sitios en tablas de metadatos de adx:

Nota

Todas las correcciones relacionadas con la personalización se realizarán después de la migración al modelo de datos mejorado.

Columnas personalizadas en tablas de metadatos adx

Para corregir esta personalización en el modelo de datos mejorado, cree una relación entre las tablas del sistema y la nueva tabla personalizada y migre los datos a la nueva tabla.

Modelo de datos estándar: la tabla adx_webpage contiene una columna personalizada como contoso_pagetype.

Modelo de datos mejorado: cree una nueva tabla llamada contoso_webpage. Esto incluirá una columna llamada contoso_pagetype y una columna de búsqueda contoso_webpage_id que está asociada con powerpagescomponent. Utilice el espacio de trabajo de datos para la creación de tablas.

Crear la tabla contoso_webpage en el modelo de datos mejorado para corregir el código

Relación entre tablas personalizadas y tablas adx

Para corregir esta personalización en el modelo de datos mejorado, cree una relación entre las tablas personalizadas y las tablas del sistema.

Modelo de datos estándar: la tabla adx_webpage tiene una relación denominada adx_webpage_contoso_pagelogs con la tabla contoso_pagelogs.

Modelo de datos mejorado: cree una nueva relación llamada powerpagecomponent_contoso_pagelogs con la tabla contoso_webpage. Utilice el espacio de trabajo de datos para la creación de tablas.

Referencias de tablas Adx en fragmentos de código de Liquid

Para corregir esta personalización en el modelo de datos mejorado, reemplace las referencias de la tabla adx en el código de Liquid con referencias de mspp de las tablas virtuales del modelo de datos mejorado. Como alternativa, puede usar la tabla Componente del sitio (nombre lógico powerpagecomponent) junto con el atributo Tipo de componente (nombre lógico powerpagecomponenttype) para recuperar las referencias correspondientes.

Modelo de datos estándar:entities la etiqueta de Liquid se utiliza para acceder a valores de enlaces web en código {% assign app_weblinks= entities['adx_weblinks'] %}.

Modelo de datos mejorado: en lugar de utilizar enlaces web a través de la etiqueta de Liquid entities, utilice los objetos de Liquid correspondientes. entities[adx_weblinks] directamente. En este caso entities['adx_weblinks'] se puede reemplazar por el objeto de Liquid weblinks.

Referencias de tablas Adx en buscar xml

Para corregir esta personalización en el modelo de datos mejorado, reemplace las referencias de FetchXML en el código de Liquid con referencias directas de las tablas virtuales del modelo de datos mejorado. Como alternativa, puede usar la tabla Componente del sitio (nombre lógico powerpagecomponent) junto con el atributo Tipo de componente (nombre lógico powerpagecomponenttype) para recuperar las referencias correspondientes.

Modelo de datos estándar: el nombre de la tabla adx_webrole se utiliza dentro de la consulta de FetchXML.

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

Modelo de datos mejorado: Utilice Componente de sitio (nombre lógico powerpagecomponent) junto con el atributo de Tipo de componente (nombre lógico powerpagecomponenttype) para recuperar las referencias correspondientes.

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

Tipos y valores de componentes del sitio

Tipo de componente valor
Estado de publicación 1
Página web 2
Archivo web 3
Conjunto de vínculos web 4
Vínculo web 5
Plantilla de página 6
Fragmento de contenido 7
Plantilla web 8
Configuración del sitio 9
Regla de control de acceso de página web 10
Rol web 11
Acceso al sitio web 12
Marcador de sitio 13
Formulario básico 15
Metadatos del formulario básico 16
List 17
Permiso de la tabla 18
Formulario avanzado 19
Paso de formulario avanzado 20
Metadatos de formulario avanzado 21
Ubicación de sondeo 24
Ubicación de anuncio 26
Consumidor de bot 27
Perfil de permiso de columna 28
Permiso de columna 29
Redirigir 30
Regla de transición de estado de publicación 31
Acceso directo 32
Flujo de nube 33
Componente de experiencia de usuario 34

Flujo de trabajo personalizado y complementos en tablas adx

Para corregir esta personalización en el modelo de datos mejorado, el flujo de trabajo y la lógica del complemento deben refactorizarse y volverse a registrar en la tabla respectiva del sitio.

Por ejemplo, si un usuario registró el flujo de trabajo/complemento en la Entidad principal como Página web (nombre lógico adx_webpage) en el modelo de datos estándar, entonces el código dentro del flujo de trabajo/complemento debe modificarse a Componente del sitio (nombre lógico powerpagecomponent) tabla y sus atributos para el modelo de datos mejorado.

Utilizar la tabla de componentes del sitio dentro del flujo de trabajo y sus atributos para el modelo de datos mejorado

Problemas conocidos

El comando de migración solo procesa un lote de registros de 5K desde el modelo de datos estándar al modelo de datos mejorado.