Partager via

Migrer les sites du modèle de données standard vers le modèle de données amélioré (version préliminaire)

  • Article

[Cette rubrique fait partie de la documentation en version préliminaire et peut faire l’objet de modifications.]

Dans cet article, découvrez comment migrer le site de votre modèle de données standard existant vers le modèle de données amélioré.

Important

  • Il s’agit d’une fonctionnalité préliminaire.
  • Les fonctionnalités en version préliminaire ne sont pas destinées à une utilisation en production et peuvent être restreintes. Ces fonctionnalités sont disponibles avant une publication officielle afin que les clients puissent y accéder de façon anticipée et fournir des commentaires.

Conditions préalables

Étape 1. Télécharger et vérifier la personnalisation des métadonnées du site standard existantes

  1. Ouvrez une invite de commandes.

  2. Utilisez la commande suivante pour vous authentifier auprès de l’organisation Dataverse de votre environnement Power Platform afin de télécharger l’enregistrement du site web pour la migration.

    pac auth create -u [Dataverse URL]

    Exemple

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

    Plus d’informations : pac auth create

  3. Utilisez la commande suivante pour générer une liste de sites web dans l’organisation actuelle.

    pac powerpages list

    Plus d’informations : pac powerpages list

  4. Utilisez la commande suivante pour télécharger le rapport de personnalisation.

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

    Exemple

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

Si vous trouvez une personnalisation dans le rapport téléchargé, suivez les instructions du rapport pour la corriger après la migration vers le modèle de données amélioré. Plus d’informations : Considérations sur la personnalisation du site lors de la migration de sites du modèle de données standard vers le modèle de données amélioré

Étape 2. Migrer les données du site du modèle de données standard au modèle de données amélioré

Utilisez la commande suivante pour migrer les données de votre site vers le modèle de données amélioré.

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

Le Mode peut avoir 3 valeurs :

Exemple

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

L’outil de migration vérifie les solutions. Si une solution du modèle de données standard est présente sans une solution respective du modèle de données amélioré pour le modèle mentionné, un avertissement s’affiche : Found template <template-name>. One of the prerequisite for migrate needs Enchanged data model template

Il existe des modèles spécifiques, tels que Inscription au programme et Planifier et gérer les réunions, qui nécessitent la mise en correspondance des packages du modèle de données amélioré pour garantir le bon fonctionnement du site web migré. Pour obtenir ces packages du modèle de données amélioré, vous devez créer un nouveau site pour le modèle correspondant (l’environnement doit être activé pour le modèle de données amélioré) afin de fournir des solutions compatibles avec le modèle de données amélioré pour la migration.

Modèles pris en charge pour la migration

Les sites avec les modèles suivants sont pris en charge pour la migration :

  • Disposition de démarrage 1-5
  • Traitement de l’application
  • Page vierge
  • Inscription au programme
  • Planifier et gérer les réunions

Étape 3. Vérifier le statut de migration

Utilisez la commande suivante pour vérifier le statut de migration de votre site :

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

Exemple

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

Note

Si la migration de votre site prend plus de temps que prévu, cela peut être dû au volume de données. Si votre invite de commande se ferme, ouvrez une nouvelle invite de commande et utilisez la commande de cette étape pour vérifier le statut de votre site.

Étape 4. Mettre à jour la version du modèle de données du site après une migration de données réussie

Utilisez la commande suivante pour mettre à jour la version du modèle de données du site :

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

Note

  • Vous pouvez trouver l’ID du portail en accédant au site web avec « /_services/about » ajouté à l’URL du site web. Pour voir ces options, l’utilisateur doit disposer d’un rôle web avec toutes les autorisations d’accès au site web attribuées.
  • Une fois la version du modèle de données du site mise à jour, l’enregistrement du site web lié au modèle de données standard sera désactivé. À la place, le site fera désormais référence à l’enregistrement du site web associé au modèle de données amélioré.
  • L’utilisateur doit disposer de l’un des rôles suivants pour exécuter la commande de migration avec les arguments updateDatamodelVersion ou revertToStandardDataModel. Une action d’administration sera effectuée pour changer votre site en modèle de données amélioré ou vice versa.

Exemple

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

Rétablir le site migré du modèle de données amélioré au modèle de données standard

Utilisez la commande suivante pour rétablir un site du modèle de données standard au modèle de données amélioré après la migration :

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

Note

Lorsque vous changez un site migré du modèle de données amélioré au modèle de données standard, l’enregistrement du site web associé au modèle de données amélioré sera désactivé et l’enregistrement du site web pour le modèle de données standard sera réactivé.

Exemple

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

Migrer un site de production du modèle de données standard au modèle de données amélioré

Avant de migrer un site de production, nous vous recommandons de créer une copie complète du site de production. Nous recommandons également que la migration du site de production soit effectuée en dehors des heures de travail.

Utilisez ces étapes pour migrer votre site de production vers le modèle de données amélioré :

  1. Testez la migration sur le site dans l’environnement copié à l’aide de la commande migrate-datamodel de PAC CLI.
  2. Ajoutez les données de configuration du site à la solution gérée et importez-les dans l’environnement de production.
  3. Utilisez les commandes PAC CLI pour migrer des données autres que des données de configuration et terminez-les en mettant à jour la version du modèle de données pour la production.

Note

Pour la migration, l’ID du site web source et de production est identique.

Considérations sur la personnalisation du site lors de la migration de sites du modèle de données standard vers le modèle de données amélioré

Cette section fournit des conseils pour résoudre la personnalisation de la migration d’un site du modèle de données standard vers le modèle de données amélioré.

Il existe cinq types de personnalisations de site sur les tables de métadonnées adx :

Note

Tous les correctifs liés à la personnalisation seront effectués après la migration vers le modèle de données amélioré.

Colonnes personnalisées dans les tables de métadonnées adx

Pour corriger cette personnalisation dans le modèle de données amélioré, créez une relation entre les tables système et la nouvelle table personnalisée et migrez les données vers la nouvelle table.

Modèle de données standard : la table adx_webpage contient une colonne personnalisée comme contoso_pagetype.

Modèle de données amélioré : créez une nouvelle table nommée contoso_webpage. Cela inclura une colonne appelée contoso_pagetype et une colonne de recherche contoso_webpage_id associée à powerpagescomponent. Utilisez l’espace de travail Données pour la création de tables.

Créer la table contoso_webpage dans un modèle de données amélioré pour corriger le code

Relation entre les tables personnalisées et les tables adx

Pour corriger cette personnalisation dans le modèle de données amélioré, créez une relation entre les tables personnalisées et les tables système.

Modèle de données standard : la table adx_webpage a une relation nommée adx_webpage_contoso_pagelogs avec la table contoso_pagelogs.

Modèle de données amélioré : créez une nouvelle relation nommée powerpagecomponent_contoso_pagelogs avec la table contoso_webpage. Utilisez l’espace de travail Données pour la création de tables.

Références de la table adx dans l’extrait de code Liquid

Pour corriger cette personnalisation dans le modèle de données amélioré, remplacez les références de la table adx dans le code Liquid par les références mspp des tables virtuelles du modèle de données amélioré. Vous pouvez également utiliser la table Composant du site (nom logique powerpagecomponent) avec l’attribut Type de composant (nom logique powerpagecomponenttype) pour récupérer les références correspondantes.

Modèle de données standard : la balise Liquid entities est utilisée pour accéder aux valeurs liens web dans le code {% assign app_weblinks= entities['adx_weblinks'] %}.

Modèle de données amélioré : au lieu d’utiliser des liens web via la balise Liquid entities, utilisez les objets Liquid respectifs. entities[adx_weblinks] directement. Dans ce cas, entities['adx_weblinks'] peut être remplacé par l’objet Liquid weblinks.

Références de la table adx dans fetch xml

Pour corriger cette personnalisation dans le modèle de données amélioré, remplacez les références de la table adx dans fetch xml par les références directes des tables virtuelles du modèle de données amélioré. Vous pouvez également utiliser la table Composant du site (nom logique powerpagecomponent) avec l’attribut Type de composant (nom logique powerpagecomponenttype) pour récupérer les références correspondantes.

Modèle de données standard : le nom de la table adx_webrole est utilisé dans la requête fetch xml.

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

Modèle de données amélioré : utilisez la table Composant du site (nom logique powerpagecomponent) conjointement avec l’attribut Type de composant (nom logique powerpagecomponenttype) pour récupérer les références correspondantes.

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

Type et valeurs du composant du site

Type de composant Valeur
État de publication 1
Page web 2
Fichier web 3
Jeu de liens Web 4
Lien Web 5
Modèle de page 6
Extrait de contenu 7
Modèle web 8
Paramètre du site 9
Règle du contrôle d’accès de la page Web 10
Rôle Web 11
Accès au site Web 12
Marqueur de site 13
Formulaire de base 15
Métadonnées de formulaire de base 16
List 17
Autorisation de table 18
Formulaire avancé 19
Étape de formulaire avancé 20
Métadonnées de formulaire avancé 21
Placement de sondage 24
Placement publicitaire 26
Consommateur de bot 27
Profil d’autorisation de colonne 28
Autorisation de colonne 29
Rediriger 30
Règle de transition de l’état de publication 31
Raccourci 32
Flux de cloud 33
Composant UX 34

Workflow personnalisé et plug-ins dans les tables adx

Pour corriger cette personnalisation dans le modèle de données amélioré, la logique du workflow et du plug-in doit être refactorisée et réenregistrée sur la table respective du site.

Par exemple, si un utilisateur a enregistré le workflow/plug-in dans l’Entité principale en tant que table Page web (nom logique adx_webpage) dans le modèle de données standard, le code au sein du workflow/plug-in doit être modifié en table Composant du site (nom logique powerpagecomponent) et ses attributs pour le modèle de données amélioré.

Utiliser la table Composant du site dans le workflow et ses attributs pour le modèle de données amélioré

Problèmes connus

La commande de migration traite uniquement un lot de 5 000 enregistrements du modèle de données standard vers le modèle de données amélioré.