Introducción a la migración del modelo de datos estándar a mejorado

La utilidad de migración de la CLI de Microsoft Power Platform mueve una configuración admitida del sitio Power Pages existente y los registros relacionados del modelo de datos estándar al modelo de datos mejorado y, a continuación, cambia el sitio para usar la configuración migrada.

El modelo de datos estándar almacena la configuración del sitio de Power Pages en tablas que usan el prefijo adx_. El modelo de datos mejorado almacena la configuración del sitio en la tabla Componente de sitio (powerpagecomponent) e identifica cada componente por su tipo de componente. Comprender cómo funciona la utilidad de migración, qué plantillas admite y qué personalizaciones no actualiza automáticamente le ayuda a decidir cuándo y cómo mover un sitio.

La revisión de las ventajas del modelo de datos mejorado explica por qué podría considerar la posibilidad de migrar un sitio.

Es importante tener en cuenta que no todas las tablas adx_* se mueven a powerpagecomponent. Solo las tablas de metadatos adx_*, las que describen la estructura y la superficie de creación del sitio, como adx_webpage, adx_webtemplate, adx_contentsnippet, adx_sitesetting, adx_pagetemplate, adx_weblink, adx_entityformy adx_entitylist , se consolidan en powerpagecomponent (con sus propiedades por fila movidas a la columna JSON de contenido).

Las tablas transaccionales o en tiempo de ejecución adx_* —las que capturan la actividad del usuario final en tiempo de ejecución, como adx_invitation, adx_inviteredemption, adx_portalcomment, adx_externalidentity y las tablas de envío y registro de formularios de entidad o formularios avanzados— no se migran a powerpagecomponent; permanecen en sus esquemas existentes y siguen almacenando datos en tiempo de ejecución como antes. Lo que cambia para esas tablas transaccionales es que sus consultas a los registros de metadatos se redirigen durante la migración de referencias para que apunten a las nuevas filas powerpagecomponent en lugar de a las filas heredadas de metadatos adx_*.

Los sitios existentes creados en el modelo de datos estándar siguen ejecutándose en tablas adx_*, por lo que cada sitio debe migrarse para beneficiarse del modelo de datos mejorado. La migración traslada los metadatos de configuración del sitio al formato del modelo de datos mejorado powerpagecomponent, redirige las referencias transaccionales a esos nuevos registros de metadatos y cambia el registro del sitio para que use el modelo de datos mejorado. También es donde se identifican y corrigen las personalizaciones —columnas adx_* personalizadas, código Liquid que lee atributos adx_*, consultas FetchXML sobre tablas adx_*, complementos y flujos de trabajo—, ya que esas personalizaciones no se transfieren automáticamente y deben reescribirse o reestructurarse para funcionar con el modelo de datos mejorado.

Prerequisites

Funcionalidades de la utilidad de migración

La utilidad de migración copia la configuración compatible del sitio y los registros relacionados al modelo de datos mejorado. Una vez finalizada la migración, el sitio activo cambia al modelo de datos mejorado y se valida antes de volver al uso normal.

La utilidad de migración:

  • Genera un informe de personalizaciones que podrían requerir cambios manuales.
  • Migra la configuración del sitio compatible y los registros relacionados.
  • Permite comprobar el estado de la migración antes de cambiar el modelo de datos activo.
  • Permite revertir el sitio al modelo de datos estándar si la validación identifica un problema crítico.

Importante

La utilidad de migración no actualiza automáticamente todas las personalizaciones que dependen directamente de las tablas del modelo de datos estándar. Revise el informe de personalización, corrija el código personalizado afectado y pruebe el sitio migrado antes de su uso en producción.

Plantillas soportadas

Puede migrar los sitios de modelo de datos estándar existentes que se crearon a partir de las plantillas siguientes:

  • Diseño de inicio 1-5
  • Procesamiento de la aplicación
  • Página en blanco
  • Registro en el programa
  • Programar y administrar reuniones
  • FAQ
  • Portal de la comunidad (Dynamics 365)
  • Portal de Self-Service de clientes (Dynamics 365)
  • Portal de autoservicio del empleado (Dynamics 365)
  • Portal de partners (Dynamics 365)

Nota:

La creación de nuevos sitios con el modelo de datos mejorado y la migración de sitios existentes son funcionalidades independientes. Si la plantilla original de un sitio no aparece aquí, no ejecute la utilidad de migración para ese sitio.

Antes de empezar

Consideraciones de planeación adicionales:

  • La opción Cambiar al entorno del modelo de datos mejorado controla el modelo de datos usado para los nuevos sitios. Al activar la configuración, no se migran los sitios existentes.
  • Ejecute primero la migración en una copia completa del entorno de producción. Complete la corrección y validación de la personalización antes de migrar.
  • Use el proceso estándar de copia de seguridad y restauración de la organización para realizar copias de seguridad del entorno de producción.
  • Planificar una ventana de mantenimiento para el cambio final a producción y su validación.
  • Registre el identificador del sitio web, el identificador del portal, la dirección URL del entorno, la versión de la CLI, las versiones del paquete, la hora de inicio de la migración y la salida del comando como parte del registro de migración.

Planificar la secuencia del entorno

La migración admite entornos diferentes, con un modo diferente para cada entorno.

Medio ambiente Modo recomendado Qué haces
Desarrollo configurationData Migre la configuración, revise el informe de personalización, corrija las personalizaciones, valide y capture la configuración en una solución.
Prueba o UAT configurationDataReferences Importe la solución probada desde el desarrollo, migre los registros relacionados admitidos, active el modelo de datos mejorado y valide.
Producción configurationDataReferences Importe la solución administrada validada, migre los registros relacionados admitidos, active durante la ventana de mantenimiento y complete la validación de producción.
Entorno único o sitio simple all Migre la configuración y los registros relacionados en una sola operación solo si comprende el impacto de las personalizaciones y no utiliza el enfoque de solución multientorno.

Creación de una carpeta de trabajo

Use una carpeta de trabajo vacía para contener informes, el origen del sitio descargado y los archivos de comparación. En los ejemplos siguientes se usa \<OUTPUT\> para esta ubicación.

mkdir C:\PowerPagesMigration\<site-name>
cd C:\PowerPagesMigration\<site-name>

Fases de migración

El proceso de migración consta de cuatro fases:

  1. Comprobaciones previas: compruebe el sitio, los identificadores, la CLI, los paquetes, la solución de plantilla y el estado de migración.
  2. Configuración — Migrar la configuración del entorno de desarrollo o importar la configuración probada en entornos posteriores.
  3. Migración y activación: migre registros relacionados, confirme la finalización, cambie los modelos y reinicie.
  4. Validar — probar el comportamiento, los permisos, el código personalizado y los recorridos de las plantillas.

Captura de pantalla de un diagrama de flujo que muestra el proceso de migración del modelo de datos estándar a mejorado.

La fase 1 (detección de sitios y comprobaciones previas) y la fase 4 (validación posterior a la migración) se ejecutan de la misma manera para cada sitio.

La Fase 2 y la Fase 3 están ramificadas por canal; su estructura depende del modo de migración, que determina el canal a partir del tipo de entorno.

La Pista de creación (modo configurationData o all) se usa para las configuraciones de desarrollo y entorno único. Los metadatos en sí se migran localmente y las personalizaciones se examinan y se fijan en el origen del modelo de datos estándar antes de que se muevan las referencias transaccionales.

La canalización descendente (modo configurationDataReferences) se usa para entornos de prueba, UAT y producción, en los que se supone que los metadatos de configuración se han recibido mediante la importación de la solución de ALM desde Dev. Solo se migran las referencias transaccionales en este flujo. Cualquier hallazgo de personalización indica una carencia en el ALM de origen, no trabajo que deba realizar localmente.

Fase 1: Comprobaciones previas

  1. Compruebe la versión de la CLI de Power Platform con pac --version. Si la versión es anterior a la versión necesaria, instale o actualice la CLI de Microsoft Power Platform antes de continuar.

  2. Autentíquese en el entorno de destino.

    1. Ejecute pac auth list.
    2. Ejecute pac auth who.

  3. Confirme que el perfil de autenticación activo apunta al entorno que contiene el sitio. Para seleccionar otro perfil o crear un perfil, use pac auth select o pac auth create -u "https://contoso.crm.dynamics.com".

  4. Instale las soluciones del modelo de datos mejorados para la plantilla mediante uno de los métodos siguientes:

    1. Aprovisione un sitio de la plantilla con la marca de modelo de datos mejorado (EDM) habilitada en el centro de administración.
    2. Uso de la CLI para instalar con el comando pac application install --application-name "PowerPages_PartnerPortal_V2"

  5. Busque el sitio y registre sus identificadores con pac pages list -v.

  6. Registre los valores que se muestran en la tabla siguiente.

    Valor Se usa para
    Id. de sitio web Todos los comandos migrate-datamodel.
    Id. del portal Cambio al modelo de datos mejorado y reversión al modelo de datos estándar.
    Nombre descriptivo y dirección URL Confirmar que ha seleccionado el sitio correcto en el Centro de administración.
    Versión del modelo de datos Debe ser Estándar. Si ya está mejorado, no se requiere la migración.

    Importante

    El identificador del portal no es el identificador de la aplicación de Power Pages. Si la CLI no muestra el identificador del portal, se puede consultar en el Centro de administración de Power Platform, en Recursos>Sitios de Power Pages>, o agregar /_services/about a la URL del sitio si ha iniciado sesión con los permisos necesarios para acceder al sitio web.

  7. Compruebe si hay una migración anterior o en curso con el comando siguiente:

    pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --checkMigrationStatus
    Status Significado Action
    No iniciado o sin rastreador No se ha iniciado ninguna migración. Continúe con las comprobaciones del paquete.
    Volvió Se revirtió una migración anterior. Revise por qué se revierte y continúe cuando esté listo.
    Completado La migración finalizó, pero es posible que el sitio no se haya cambiado. Confirme el modelo de datos activo. Si sigue siendo Estándar, continúe con la activación.
    Running La migración todavía se está procesando. Continúe comprobando el estado. No inicie otra migración para el mismo sitio.
    Fallido Se produjo un error durante la migración. Recopile la salida del comando y los detalles del entorno, corrija la causa y vuelva a intentarlo solo después de que se comprenda el error.

    Nota:

    Si una migración permanece en ejecución más tiempo del esperado, necesitará el identificador del sitio web, el identificador del entorno, la versión de la CLI, las versiones de los paquetes, la salida del comando y la hora de inicio de la migración antes de contactar con el soporte técnico de Microsoft. No se debe restablecer una migración activa a menos que el soporte técnico o un runbook aprobado lo indique.

  8. Compruebe los paquetes de primera entidad necesarios con pac solution list --includeSystemSolutions.

    1. Confirme que CDSBasePortal, PowerPages_Core y las soluciones de EDM para la plantilla del sitio estén instaladas en las versiones requeridas.

  9. Si falta un paquete o está obsoleto, actualícelo desde el Centro de administración de Power Platform:

    1. Abra el entorno de destino.
    2. Vaya a Resources>Dynamics 365 aplicaciones.
    3. Busque el paquete necesario.
    4. Seleccione Instalar o actualizar.
    5. Espere a que finalice la operación y vuelva a ejecutarse pac solution list --includeSystemSolutions .

    Nota:

    Si la solución EDM de plantilla no está disponible para la instalación directa, la creación de un sitio de modelo de datos mejorado temporal en el mismo entorno con la misma plantilla instala la solución EDM coincidente. Puede eliminar el sitio temporal después de confirmar la solución.

  10. Genere el informe de personalización con pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --siteCustomizationReportPath "<OUTPUT>". La generación del informe no cambia el sitio.

  11. Abra el archivo CSV generado y revise cada elemento que haga referencia a tablas de modelo de datos estándar. Asigne un propietario y un paso de validación para cada corrección necesaria antes de la migración de producción.

    Categoría de personalización Plan
    Columnas personalizadas en tablas de metadatos de adx_ Mueva los datos personalizados a una tabla personalizada compatible relacionada con powerpagecomponent.
    Relaciones con tablas de metadatos de adx_ Vuelva a crear la relación con la tabla de modelo de datos mejorada admitida.
    Referencias de Liquid o FetchXML a las tablas adx_ Actualice el código para usar objetos Liquid, tablas virtuales o powerpagecomponent compatibles.
    Flujos de trabajo y complementos en tablas de adx_ Refactorice y registre la lógica en las tablas de modelo de datos mejoradas admitidas.

    Nota:

    Un informe de personalización no demuestra que todo el comportamiento del sitio funciona después de la migración; la validación sigue siendo necesaria.

  12. Elija el modo de migración para determinar qué migra la utilidad en una sola operación.

    Mode Lo que migra Cuándo usarla
    configurationData Metadatos de configuración del sitio web admitidos, como páginas, plantillas web, fragmentos de código, configuraciones, formularios, listas, roles del sitio web y permisos de tabla. Desarrollo, donde se corrige la configuración y se traslada entre soluciones.
    configurationDataReferences Registros compatibles que hacen referencia a la configuración del sitio migrada. Pruebas, UAT y producción después de que la configuración del sitio se reciba mediante la importación de una solución.
    all Tanto la configuración como los registros relacionados compatibles. Un único entorno o una migración sencilla que no usa la secuencia de entorno basada en soluciones.

Fase 2: Configuración del sitio

Pista de creación: desarrollo o un único entorno

  1. Descargue una línea base de SDM ejecutando pac pages download --webSiteId "<WEBSITE_ID>" --modelVersion 1 --path "<OUTPUT>\site-sdm". El comando crea una carpeta secundaria denominada para el sitio. Anote la carpeta que contiene directamente website.yml.

  2. Migre la configuración del sitio ejecutando pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --mode configurationData. Si desea la ruta de una sola operación, reemplace configurationData por all.

  3. Compruebe el estado de la migración ejecutando pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --checkMigrationStatus. Use el siguiente bucle de PowerShell para comprobar el estado una vez por minuto durante un máximo de 30 minutos:

    $webSiteId = "<WEBSITE_ID>"
for ($i = 1; $i -le 30; $i++) {
    $output = pac pages migrate-datamodel `
        --webSiteId $webSiteId `
        --checkMigrationStatus 2>&1 | Out-String
    if ($output -match "Completed|Failed|Reverted") {
        Write-Host $output
        break
    }
    Write-Host "Attempt $i/30 - migration is still running."
    Start-Sleep -Seconds 60
}

    Si el bucle finaliza mientras el estado sigue en ejecución, la comprobación continúa con --checkMigrationStatus. Una operación de larga duración no es necesariamente una operación con errores.

  4. Corrija las personalizaciones notificadas mediante el informe de personalización y las instrucciones de este artículo para actualizar FetchXML, Liquid, columnas personalizadas, relaciones, flujos de trabajo y complementos afectados. Vuelva a probar cada componente modificado. Si actualiza el código fuente descargado, suba la carpeta del sitio que contiene directamente website.yml ejecutando pac pages upload --path "<OUTPUT>\site-sdm\<site-slug>" --modelVersion 1.

Pista de bajada: prueba, UAT o producción

  1. Importe la solución que contiene la configuración de sitio migrada y corregida. Use el Centro de administración de Power Platform o la canalización de implementación establecida.

    pac solution import --path "<PATH_TO_SOLUTION_ZIP>" --activate-plugins true --publish-changes true

  2. Confirme que la configuración del sitio está presente abriendo la aplicación administración de Power Pages en el entorno de destino. El registro de sitio y la configuración esperada deben estar presentes antes de migrar los registros relacionados.

  1. Migre los registros relacionados compatibles. Si ya ha usado --mode all, omita este paso. Compruebe el estado hasta que informe completado.

    pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --mode configurationDataReferences
pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --checkMigrationStatus

  2. Una vez que el estado de la migración indique que se ha completado correctamente, cambie el sitio activo para que use el modelo de datos mejorado. El registro del sitio web del modelo de datos estándar se desactiva y el registro del sitio web del modelo de datos mejorado correspondiente se activa.

    pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --updateDatamodelVersion --portalId "<PORTAL_ID>"

  3. Reinicia el sitio.

    1. Abra el Centro de administración de Power Platform.
    2. Vaya al entorno y, a continuación, seleccione Recursos>sitios de Power Pages.
    3. Seleccione el sitio.
    4. Seleccione Reiniciar. Si Reiniciar no está disponible, desactive el sitio y vuelva a activarlo.
    5. Espere a que finalice la operación antes de la validación.

  4. Confirme el modelo de datos activo mediante uno o varios de estos métodos:

    1. En el Centro de administración de Power Platform, seleccione el sitio y confirme que el modelo de datos muestra Mejorado.
    2. Abra el área de trabajo Configuración del sitio en el estudio de diseño de Power Pages y confirme el modelo de datos que se muestra.
    3. Confirme que se abre la configuración avanzada en la aplicación administración de Power Pages.
    4. Ejecute pac pages list -v y confirme la versión del modelo de datos.

    Sugerencia

    La dirección URL del sitio y el diseño visual no cambian solo porque el modelo de datos activo ha cambiado. Para comprobar la migración, use estas comprobaciones, no la apariencia del sitio.

Fase 4: Validar el sitio migrado

Complete la validación antes de volver a abrir un sitio de producción a los usuarios. Use cuentas de prueba para cada tipo de usuario importante y rol web y registre el resultado de cada prueba crítica.

Área Qué validar
Páginas y contenido Página principal, páginas de contenido representativas, plantillas web, fragmentos de contenido, archivos web, navegación, redirecciones y contenido multilingüe.
Authentication Inicio de sesión, cierre de sesión, registro, invitaciones, proveedores de identidades externos y experiencias de acceso denegado.
Authorization Los roles web, los permisos de tabla, los permisos de columna y las reglas de acceso a páginas permiten y deniegan las acciones esperadas.
Formularios y listas Formularios básicos, formularios de varios pasos, listas, metadatos de formulario, envíos, registros relacionados y sesiones de formulario web usadas por el sitio.
recorridos prediseñados de Dynamics 365 Los principales flujos de cliente, empleado, comunidad o socio que utiliza su implementación, incluidas las páginas específicas de la plantilla y los patrones de acceso.
Código personalizado Liquid, FetchXML, JavaScript, complementos, flujos de trabajo e integraciones identificados en el informe de personalización.
Configuración y archivos del sitio La configuración del sitio, las imágenes, los datos adjuntos, los archivos SVG y otros archivos web se cargan correctamente.
Datos y referencias Los recuentos importantes de registros y los registros relacionados compatibles apuntan a los componentes correctos del sitio migrado.
Administración y ALM El sitio se abre en Power Pages Management y se puede agregar a, exportar e importar desde soluciones según lo previsto.

Comprobación de los diagnósticos del explorador

Abra las herramientas de desarrollo del explorador al probar páginas representativas. Investigar:

  • Errores de consola que mencionan adx\_, entidades, Liquid o FetchXML.
  • Respuestas HTTP 401 o 403 desde \_api, que pueden indicar un problema de permisos o de rol web.
  • Respuestas HTTP 500, que pueden indicar un error de Liquid, de FetchXML, de complemento o de integración.

Criterios de finalización de la migración

Tenga en cuenta que la migración solo se completa cuando el sitio muestra el modelo de datos mejorado, se confirma el paso de recorridos empresariales críticos, se confirma el comportamiento de seguridad esperado y se resuelve o acepta cada búsqueda de personalización de alto impacto.

Secuencia de migración de producción

Use la siguiente secuencia de producción para reducir el riesgo de migración:

  1. Cree una copia completa del entorno de producción para ensayo.
  2. Confirmar los requisitos previos de la CLI, del paquete y de la plantilla de solución en el entorno copiado.
  3. Genere y revise el informe de personalización.
  4. Migre la configuración en el entorno de desarrollo copiado.
  5. Corrija las personalizaciones y capture la configuración del sitio validado en una solución administrada.
  6. Importe la solución en el entorno de ensayo, migre los registros relacionados admitidos, active el modelo de datos mejorado y complete la lista de comprobación de validación completa.
  7. Repita la corrección y el ensayo hasta que se superen todas las pruebas críticas.
  8. Programe la ventana de mantenimiento de producción, comunique los puntos de decisión de validación y reversión y realice una copia de seguridad de producción.
  9. Confirme de nuevo los requisitos previos del paquete de producción y la solución de plantilla.
  10. Importe la solución administrada validada en el entorno de producción.
  11. Ejecute configurationDataReferences, compruebe el estado de la migración, cambie el modelo de datos activo y reinicie el sitio.
  12. Ejecute la lista de comprobación de validación de producción y devuelva el sitio a uso normal solo después de que se superen las pruebas críticas.

Revertir un sitio migrado al modelo de datos estándar

Si la validación identifica un problema crítico después de la activación, use el siguiente comando para reactivar el registro del sitio web del modelo de datos estándar:

pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --revertToStandardDataModel --portalId "<PORTAL_ID>"

Una vez finalizado el comando:

  1. Reinicie el sitio desde el Centro de administración de Power Platform.
  2. Confirme que el sitio muestra Standard como modelo de datos activo.
  3. Vuelva a ejecutar las pruebas de validación críticas del sitio.
  4. Conserve el informe de migración, los detalles de error y las notas de corrección antes de intentar otra migración.

Importante

Planee la decisión de reversión antes de la migración de producción. Revise los cambios realizados después del modificador de modelo de datos mejorado antes de revertir, ya que los registros de sitios web estándar y mejorados son registros independientes.

Troubleshooting

Mensaje o síntoma Causa probable Action
pac powerpages migrate-datamodel no se reconoce El comando usa el espacio de nombres incorrecto o una CLI obsoleta. Actualice la CLI de Power Platform y use pac pages migrate-datamodel.
CDSBasePortal o PowerPages_Core no aparece Las soluciones del sistema no se incluyeron en la salida del comando o el paquete no está instalado. Ejecute pac solution list --includeSystemSolutions. Instale o actualice el paquete que falta desde el Centro de administración de Power Platform.
Sitio web no compatible con la migración No se admite la plantilla original, las versiones del paquete no son suficientes o falta la solución de plantilla de EDM coincidente. Confirme la idoneidad de la plantilla, las versiones del paquete y la solución EDM que se muestra en la referencia de la solución de plantilla.
Se pasó un argumento --webSiteId desconocido para pac pages upload El comando upload no acepta el argumento id. del sitio web. Omita el argumento. El sitio se identifica a partir de website.yml.
La carga tiene como destino el sitio incorrecto o no encuentra el sitio La ruta de acceso apunta a la carpeta contenedora en lugar de a la carpeta del sitio. Use la carpeta secundaria que contiene directamente website.yml.
El identificador del portal muestra Unknown o N/A El sitio está inactivo o la CLI instalada no devuelve el valor. Obtenga el identificador del portal desde el Centro de administración de Power Platform o la página del /_services/about sitio. No use el identificador de la aplicación.
Los informes de migración muestran Completed, pero el sitio sigue mostrando Standard El modelo de datos activo no se cambió o se usó el identificador de portal incorrecto. Ejecute el comando de activación con el identificador del sitio web y el identificador de portal correcto y, a continuación, reinicie y compruebe el sitio.
El estado sigue siendo Running La migración está procesando un gran volumen de datos o está bloqueada. Continúe comprobando el estado. Recopile los detalles del entorno, el paquete, la CLI, la hora de inicio y los comandos antes de ponerse en contacto con el soporte técnico. No inicie una segunda migración.
El estado es Failed Un error de paquete, plantilla, personalización, datos o servicio detuvo la operación. Guarde la salida completa del comando, corrija la causa identificada y vuelva a intentarlo solo después de revisar el estado de la migración fallida.
Se abre el sitio, pero los usuarios no pueden acceder a los datos esperados. Los roles web, los permisos de tabla o las consultas personalizadas no se comportan según lo previsto después de la migración. Revise los roles web, los permisos de tabla, los permisos de columna, FetchXML, Liquid y los errores de red del explorador.

Consideración de las personalizaciones del sitio

El informe de personalización identifica las dependencias directas de las tablas del modelo de datos estándar. Realice las acciones correctivas necesarias antes de usarlo en producción.

Columnas personalizadas en tablas de metadatos

Si una tabla de modelo de datos estándar, como adx_webpage contiene una columna personalizada, cree una tabla personalizada para almacenar los datos personalizados y agregue una búsqueda a powerpagecomponent. Migre los valores personalizados a la nueva tabla y actualice el código que lee o escribe la columna.

Relaciones entre tablas personalizadas y tablas de metadatos

Vuelva a crear las relaciones personalizadas que apunten a tablas adx_ para que apunten a la tabla adecuada del modelo de datos mejorado, normalmente powerpagecomponent. Actualice los formularios dependientes, las vistas, los complementos, los flujos y las integraciones.

Referencias liquidas a tablas de metadatos

Sustituya el acceso directo entities['adx_*'] por un objeto Liquid admitido cuando exista uno. Por ejemplo, use el objeto Liquid weblinks en lugar de consultar directamente adx_weblinkset o sus tablas relacionadas. Revise cada uso porque el objeto devuelto y los atributos disponibles pueden diferir.

Referencias de FetchXML a tablas de metadatos

Reemplace las referencias de entidad directas adx_ por la tabla virtual o consulta powerpagecomponent correspondiente y filtre por powerpagecomponenttype

Ejemplo de modelo de datos estándar:

<fetch>
  <entity name="adx_webpage">
    <attribute name="adx_name" />
    <filter>
      <condition attribute="adx_partialurl" operator="eq" value="home" />
    </filter>
  </entity>
</fetch>

Ejemplo de modelo de datos mejorado:

<fetch>
  <entity name="powerpagecomponent">
    <attribute name="name" />
    <filter type="and">
      <condition attribute="powerpagecomponenttype" operator="eq" value="2" />
      <condition attribute="partialurl" operator="eq" value="home" />
    </filter>
  </entity>
</fetch>

Flujos de trabajo y complementos personalizados

Refactoriza el flujo de trabajo personalizado y la lógica del plugin registrados en tablas adx_. Registre la lógica actualizada en la tabla de modelo de datos mejorada adecuada y use el esquema y los atributos mejorados. Pruebe el comportamiento de creación, actualización, eliminación y seguridad en un entorno que no sea de producción.

Referencia de comandos

Purpose Command
Comprobación de la versión de la CLI pac --version
Enumeración de perfiles de autenticación pac auth list
Creación de un perfil de autenticación pac auth create -u "<ENV_URL>"
Enumeración de sitios e identificadores pac pages list -v
Lista de soluciones del sistema pac solution list --includeSystemSolutions
Comprobación del estado de la migración pac pages migrate-datamodel --webSiteId "<ID>" --checkMigrationStatus
Descargar el código fuente de SDM pac pages download --webSiteId "<ID>" --modelVersion 1 --path "<OUT>\site-sdm"
Descargar la fuente de EDM pac pages download --webSiteId "<ID>" --modelVersion 2 --path "<OUT>\site-edm"
Generación de un informe de personalización pac pages migrate-datamodel --webSiteId "<ID>" --siteCustomizationReportPath "<OUT>"
Migración de la configuración pac pages migrate-datamodel --webSiteId "<ID>" --mode configurationData
Migración de registros relacionados pac pages migrate-datamodel --webSiteId "<ID>" --mode configurationDataReferences
Migración de ambas categorías pac pages migrate-datamodel --webSiteId "<ID>" --mode all
Cargar origen del sitio pac pages upload --path "<SITE_ROOT>" --modelVersion 1
Activar EDM pac pages migrate-datamodel --webSiteId "<ID>" --updateDatamodelVersion --portalId "<PORTAL_ID>"
Revertir a SDM pac pages migrate-datamodel --webSiteId "<ID>" --revertToStandardDataModel --portalId "<PORTAL_ID>"

Referencia de tipos de componentes del sitio

Al consultar powerpagecomponent, use los valores siguientes en el filtro powerpagecomponenttype .

Component Valor Component 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 Lista 17
Permiso de tabla 18 Formulario avanzado 19
Paso avanzado del formulario 20 Metadatos de formulario avanzado Veintiuno
Ubicación de sondeo 24 Ubicación de anuncio 26
Cliente 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 Shortcut 32
Flujo de nube 33 Componente de experiencia de usuario 34

Referencia de la solución de plantilla de EDM

Ejecute pac solution list --includeSystemSolutions para confirmar que la solución del modelo de datos mejorado para la plantilla del sitio está instalada.

Plantilla Nombre único de la solución EDM
Diseño de inicio 1 DefaultPortalTemplate_V2
Diseño de inicio 2 PowerPages_BlankDesign002_V2
Diseño de inicio 3 PowerPages_BlankDesign003_V2
Diseño de inicio 4 PowerPages_BlankDesign004_V2
Diseño de inicio 5 PowerPages_BlankDesign005_V2
Página en blanco PowerPages_BlankTemplate_V2
FAQ PowerPages_FAQ_V2
Procesamiento de la aplicación PowerPages_BuildingPermit_V2
Registro en el programa PowerPages_ProgramRegistration_V2
Programar y administrar reuniones PowerPages_BookMeeting_V2
Portal de la comunidad (Dynamics 365) PowerPages_CommunityPortal_V2
Portal de Self-Service de clientes (Dynamics 365) PowerPages_CustomerPortal_V2
Portal de autoservicio del empleado (Dynamics 365) PowerPages_ESSPortal_V2
Portal de partners (Dynamics 365) PowerPages_PartnerPortal_V2

Contenido relacionado

  • Last updated on