Planifier une migration avec le catalogue de sites site-catalog-skill

Le catalogue de sites de l’agent de modernisation de l’expérience répertorie les pages d’un site que vous êtes autorisé à migrer et les regroupe avant toute importation. Les pages qui partagent une disposition de blocs forment un modèle. Des blocs similaires sur plusieurs pages forment une variante de bloc : une version d’un bloc qui diffère par sa structure ou son aspect. Lors de l’importation, une variante dont les champs sont différents devient un bloc à part entière. Avec ce regroupement, vous migrez et vérifiez un exemple de page par modèle, puis importez le reste du modèle en bloc. Les modèles, blocs et paramètres régionaux trouvés par le catalogue vous donnent également une estimation du projet, et son rapport peut être partagé avec les parties prenantes qui n’utilisent pas la console.

Le catalogue lit le site source et n’importe rien. Pour l’ensemble du workflow de migration, consultez Migration d’un site de production.

Démarrer la planification invoking

Vérifiez que vous êtes autorisé à lire le site source et que la console peut y accéder. Commencez ensuite la planification dans la console de modernisation de l’expérience de l’une des manières suivantes :

  • Ouvrez la vue Planification. Si le projet n’a pas encore de plan, l’écran indique Planifier la migration. Saisissez l’adresse du site et sélectionnez Planifier ma migration. Commencez par la page d’accueil ; l’agent trouve les autres pages.

  • Demandez à l’agent dans la conversation :

    scope site https://www.example.com

Lors des exécutions de planification, la vue Planification affiche Planification de votre migration avec l’étape actuelle, le nombre de pages trouvées et lues et le temps écoulé. Vous pouvez consulter les résultats avant la fin de l’exécution.

L’agent analyse chaque page qu’il détecte. Lorsqu’il trouve plus de 1 000 pages, il vous indique approximativement combien de temps l’analyse prendra, et continue. Pour un site très volumineux, demandez à l’agent de vous proposer comment diviser la migration, puis cataloguez les sections de votre choix.

Pour arrêter une exécution, utilisez la commande d’arrêt dans le chat. La vue Planification affiche alors Planification arrêtée avant la fin, et vous pouvez reprendre là où elle s’est arrêtée ou recommencer. Le thread de conversation indique ce qui s’est passé avant son arrêt.

La planification se déroule en quatre phases :

  1. Analyse : l’agent charge chaque page, prend une capture d’écran et divise la page en blocs en fonction de son contenu modifiable par l’auteur. Les captures d’écran laissent de côté les bannières de cookies et d’autres grandes boîtes de dialogue qui couvrent la page. L’analyse exclut l’en-tête et le pied de page du site, car un site Edge Delivery Services les crée une fois à partir d’un contenu de navigation et de pied de page distinct.
  2. Catalogage des blocs : l’agent regroupe les blocs similaires sur plusieurs pages en variantes de bloc, mappe chaque variante à un bloc de la bibliothèque de blocs et lui attribue un nom.
  3. Modèle : l’agent regroupe les pages qui partagent la même disposition de blocs dans des modèles candidats.
  4. Dénomination : L’agent fusionne les modèles candidats qui sont structurellement identiques et donne à chaque modèle un nom significatif.

Résultats et statut output

Une fois l’exécution terminée, l’agent publie un résumé dans la conversation : le nombre de pages, de modèles et de variantes de bloc, une répartition par paramètre régional et le statut de l’exécution. La vue Planning affiche le même statut.

Statut
Signification
terminé
Toutes les pages ont été analysées, soit 10 % ou moins d’échecs.
incomplet
Plus de 10 % des pages ont échoué ou la détection des blocs a échoué sur plus de la moitié d’entre elles. Les résultats sont utilisables mais partiels.
échec
Aucune page n’a été analysée.

Une exécution terminée peut encore comporter des pages en échec. Vérifiez donc les URL en échec de toute façon. Comparez les URL découvertes à la portée que vous avez convenue : les pages auxquelles rien ne renvoie nécessitent une décision de leur part. Séparer les nombres de pages découvertes, analysées, importées et approuvées.

Vue Planification planning-ui

La vue Planning du panneau de l’espace de travail 🔗 affiche les modèles, les pages et les blocs identifiés par l’agent, avec des captures d’écran, afin que vous puissiez les corriger avant la migration. Chaque étape ultérieure s’appuie sur ce regroupement. Par conséquent, passez-le en revue avant d’importer des pages. La vue n’est pas liée au mode Plan de la conversation, dans lequel l’agent propose son approche d’une requête avant de modifier des fichiers.

Ouvrir la vue Planification accessing-planning-ui

  • Dans l’en-tête du panneau Espace de travail, ouvrez le sélecteur d’affichage et sélectionnez Planification sous Projet. Il est toujours là; il n’est pas nécessaire de l’activer.
  • Accédez à https://aemcoder.adobe.io/chat/project/plan.
  • Une fois l’exécution terminée, sélectionnez Afficher le plan dans la notification Votre plan de migration est prêt.

Sélection de la vue Planification à partir du sélecteur de vue

Si vous n’avez pas catalogué un site dans le projet actuel, la vue demande l’adresse du site afin que vous puissiez commencer la planification.

La vue affiche un plan de migration par espace de travail de console, à partir des fichiers du dossier catalog/. Vous ne pouvez pas conserver plusieurs plans côte à côte, par exemple un par site de pays. Planifiez et migrez les sites l’un après l’autre et téléchargez l’ensemble de rapports de chaque plan si vous souhaitez en conserver un enregistrement.

Tableau de bord dashboard

Le tableau de bord résume le site catalogué. Son en-tête affiche le titre du site, le statut d’exécution 🔗 et la date d’analyse. Sélectionnez Ouvrir le site dans l’en-tête de l’espace de travail pour ouvrir le site source dans un nouvel onglet.

Tableau de bord de planification du site

Les cartes de tableau de bord affichent :

  • Contenu : URL découvertes, modèles identifiés, pages analysées et documents trouvés.
  • Pages : Les pages analysées et ayant échoué, et la manière dont les URL ont été découvertes, par exemple à partir du plan du site ou en suivant les liens. Sélectionnez le nombre d’URL ayant échoué pour ouvrir les URL ayant échoué.
  • Blocs : blocs et variantes de bloc identifiés.
  • Paramètres régionaux : les pages par paramètre régional. Cette carte s’affiche uniquement pour un site avec plusieurs paramètres régionaux.

Sous les cartes, un bouton bascule le tableau entre Modèles, avec la description et le nombre de pages de chaque modèle, et Blocs, avec chaque bloc et ses variantes. Sélectionnez un nom de modèle pour ouvrir ses détails de modèle, ou une variante pour afficher ses instances. Les deux tableaux peuvent être recherchés et triés. Sélectionnez Agrandir le tableau pour masquer les cartes et donner plus d’espace au tableau.

Tableau Blocs blocks-table

Le tableau des blocs affiche une ligne extensible par bloc, avec les variantes du bloc imbriquées en dessous. Pour chaque bloc, il affiche le nombre de variantes, de pages et de modèles sur lesquels il se trouve, ainsi que son statut de code.

Table Blocs dans la vue Planification

Chaque bloc affiche son nom et le type de bloc de la bibliothèque de blocs sur laquelle il est basé, par exemple un bloc cards-story de type cards. Ses variantes sont répertoriées sous par leur classe de variante, par exemple .with-button. Une variante sans classe est la valeur par défaut du bloc. L’en-tête, le pied de page et le contenu par défaut, tel que les en-têtes simples et le texte, ne sont pas répertoriés comme des blocs.

La colonne Code indique si du code a été généré pour le bloc.

Statut
Signification
Prêt
Le code de bloc a été généré.
Mise à jour requise
Le code de bloc existe, mais ne couvre pas encore toutes les variantes du bloc.
Pas prêt
Le code de bloc n’a pas encore été généré.
Nom non valide
Le nom de bloc ou de variante ne peut pas être utilisé comme nom de dossier de bloc ou de classe CSS. Renommez le bloc ou la variante pour le corriger.
Non Classé
Le type de bloc n’a pas été identifié, aucun code ne sera donc généré pour lui. Utilisez Classifier le type de bloc pour le corriger.

Ready signifie uniquement que le code existe. La possibilité pour les auteurs de modifier le bloc et son fonctionnement font partie des vérifications avant la publication.

La colonne Confiance indique à quel point l’agent est sûr qu’une variante de bloc a été correctement regroupée et classée :

  • Élevé ou Faible est défini par catalogage. Sélectionnez l’icône d’information en regard du niveau pour lire la raison. Examinez d’abord les variantes Low.
  • Utilisateur signifie qu’une personne a confirmé ou modifié la variante, par exemple par le biais d’une révision guidée ou d’une action d’affinement.

Une fois que le code a été généré avec un exemple de contenu, sélectionnez Afficher l’exemple dans le menu d’actions d’un bloc pour ouvrir l’exemple de page du bloc dans l’aperçu.

Les détails des modèles et des pages affichent le même tableau de blocs, limité à ce modèle ou à cette page.

Détails du modèle template-details

Sélectionnez un modèle pour afficher chaque page qui l’utilise, avec le chemin d’accès, le titre et le nombre de blocs de la page. Sélectionnez un chemin de page pour ouvrir ses détails de page. Utilisez le bouton bascule Pages / Blocs pour passer aux blocs utilisés par le modèle.

Détails du modèle dans la vue Planification

Une fois les pages d’un modèle migrées, le modèle indique le nombre de pages importées et le nombre d’échecs. Chaque page indique également son statut d’importation. Le statut est mis à jour pendant l’exécution de l’importation.

Statut
Signification
Importé
La page a été importée. Sélectionnez le libellé pour ouvrir la page importée dans l’aperçu.
Échec de l’import
L’importation a échoué. La raison s’affiche sous le statut .
Non importé
La page fait partie de la migration mais n’a pas encore été importée.

Un tiret signifie que le modèle de la page ne fait pas partie de la migration actuelle.

Détails de la page page-details

Détails de la page répertorie les blocs trouvés sur la page, avec des détails de l’analyse tels que le nombre de sections et de blocs. Sélectionnez Afficher la capture d’écran dans l’en-tête pour afficher la capture d’écran pleine page. Sélectionnez Localiser sur la page dans une variante de bloc pour afficher la capture d’écran avec ce bloc en surbrillance.

Détails de la page dans la vue Planification

Instances de variante variant-instances

Sélectionnez une variante de bloc pour afficher côte à côte chaque instance de cette variante sur le site, avec le nombre d’instances, de pages et de modèles sur lesquels elle apparaît. Une instance du mauvais groupe se démarque.

Instances de variante dans la vue Planification

Le menu d’actions de chaque instance vous permet d’afficher sa capture d’écran, de la localiser sur sa page, d’ouvrir les détails de sa page ou d’ouvrir la page source.

Pour corriger le regroupement, sélectionnez une ou plusieurs instances et choisissez l’une des actions suivantes :

  • Fractionner dans une nouvelle variante : Déplace les instances sélectionnées dans une nouvelle variante.
  • Déplacer vers une autre variante : Déplace les instances sélectionnées vers une variante existante.

Au moins une instance doit rester dans la variante d’origine. Pour déplacer chaque instance d’une variante, utilisez Donner à cette variante son propre bloc ou Faire de cette variante une variante d’un autre bloc sur la variante à la place. Vos modifications de fractionnement et de déplacement sont conservées lors de la régénération du catalogue.

URL ayant échoué failed-urls

La liste des URL ayant échoué affiche chaque page qui n’a pas pu être analysée, avec la raison et l’heure. Les fichiers qui ne sont pas des pages, tels que les images et les documents, sont ignorés, comptabilisés séparément et ne sont pas répertoriés.

Consulter le catalogue review-catalog

Une fois la planification terminée, l’agent propose de passer en revue les résultats de la définition de la portée. Utilisez-le comme point de départ pour vérifier le catalogue, en particulier pour les sites volumineux.

  1. Choisissez Examiner chaque étape pour répondre aux questions de l’agent, ou Pilote automatique pour le laisser décider.
  2. L’agent corrige d’abord les problèmes qui n’ont qu’une seule réponse logique et vous indique ce qui a changé. Par exemple, elle déplace les valeurs aberrantes vers la variante où elles se trouvent, transforme les liens et boutons isolés en texte de page, combine des variantes semblables et corrige les noms non valides.
  3. Il vous interroge ensuite sur les éléments restants un par un, en commençant par des erreurs évidentes. Chaque question montre les captures d’écran et la suggestion de l’agent, et vous répondez en une seule étape. Demandez pourquoi si vous voulez son raisonnement.
  4. Sélectionnez Terminer pour moi sur n’importe quelle étape pour permettre à l’agent de terminer le reste de la révision sans plus de questions.
  5. L’examen se termine par un bref rapport sur les modifications apportées et les éléments à vérifier dans le plan. Les éléments dont l’agent n’est toujours pas sûr sont laissés inchangés et marqués. Sélectionnez Passer en revue les éléments restants pour continuer, ou Démarrer la migration du site lorsque le catalogue sera prêt.

La révision modifie uniquement le catalogue. Il n’importe pas de pages et ne génère pas de code.

La migration du site de démarrage migre un modèle à la fois. L’agent demande avec quel modèle commencer, puis utilise les pages du catalogue et les blocs associés. Vérifiez les pages de ce modèle avant de poursuivre avec la suivante et vous attendez à corriger certaines d’entre elles.

Affinage du catalogue planning-actions

Ouvrez le menu d’actions (…) de n’importe quel modèle, page, bloc ou variante et sélectionnez Actions d’IA pour afficher les actions disponibles. Vous pouvez également sélectionner jusqu’à 20 éléments pour agir ensemble sur ces éléments.

Lorsque vous choisissez une action, la console ajoute les éléments sélectionnés à la conversation avec une requête. Passez en revue sa portée et les modifications proposées avant de confirmer. Vous pouvez également choisir Ajouter au chat et écrire votre propre invite, y compris ce qui ne doit pas changer et si l’agent peut charger du contenu.

Élément
Actions
Modèle
Migrer le modèle vers AEM, Renommer le modèle, Ajouter des pages au modèle, Créer un modèle à partir d’un sous-ensemble, Suggérer des refactorisations structurelles
Page
Migrer la page vers AEM, Déplacer vers un autre modèle, Vérifier la structure de la page
Bloc
Générer le code de bloc, Classer le type de bloc, Renommer le bloc, Faire de ce bloc une variante d’un autre bloc
Bloquer la variante
Renommer la variante, Donner à cette variante son propre bloc, Faire de cette variante une variante d’un autre bloc
Bloquer sur une page
Classer le type de bloc
Instances de variante
Diviser en une nouvelle variante, Déplacer vers une autre variante

Certaines actions s’affichent uniquement là où elles s’appliquent. Par exemple, les options Générer le code de bloc et Renommer le bloc ne sont disponibles que pour les blocs dont le type a été classé, et Donner à cette variante son propre bloc uniquement pour les variantes ayant une classe de variante.

Dans Migrer la page vers AEM et Migrer le modèle vers AEM, AEM fait référence au projet connecté à la console. Le contenu importé reste dans l’espace de travail de la console jusqu’à ce que vous le chargiez : vers Experience Workspace pour les projets basés sur des documents ou vers l’instance d’auteur pour la création dans Experience Manager.

Les corrections de regroupement et de dénomination modifient le catalogue, et non les pages que vous avez déjà importées. Générer le code de bloc modifie le code et les actions de migration importent le contenu. Vérifiez donc leur sortie séparément. Un refacteur structurel dans le catalogue n’est pas un refacteur de code bloc ; pour cela, consultez Refactoriser sans modifier le résultat.

Réexécution d’une phase additional-prompts

Pour réexécuter une phase, par exemple après modification du site source, demandez à l’agent de la répéter par son nom :

repeat block cataloging

L’agent réexécute également toutes les phases ultérieures et conserve les phases précédentes. Les modifications apportées à la vue Planning, telles que le fractionnement ou le déplacement d’instances de bloc, sont conservées.

Si la vue Planning indique que Le catalogue de blocs est obsolète, le catalogue a été créé dans un format antérieur que la version actuelle ne peut pas lire. Exécutez à nouveau la planification à partir de la conversation avec scope site et l’adresse du site. Si la planification s’est arrêtée avant la fin, Recommencer dans la vue Planification démarre également une nouvelle exécution pour le même site.

Workflow d’importation en bloc bulk-import

Pour migrer un modèle de site complet par modèle :

  1. Exécutez le catalogue de sites pour obtenir les modèles et bloquer les variantes.
  2. Vérifiez-les dans la vue Planification et corrigez les erreurs d’identification. La révision guidée est le moyen le plus rapide de commencer.
  3. Générez du code pour les blocs dont vous avez besoin. Vous pouvez sélectionner plusieurs blocs et générer du code pour ceux-ci uniquement.
  4. Pour chaque modèle, ouvrez ses détails de modèle et utilisez Migrer la page vers AEM sur un ou deux exemples de pages. Affinez l’importation jusqu’à ce que la sortie soit correcte.
  5. Utilisez Migrer le modèle vers AEM pour importer les pages restantes de ce modèle. Suivez le statut d’importation de chaque page et réessayez les pages ayant échoué après avoir corrigé la cause.
  6. Répétez l’opération pour chaque modèle.

Si la sortie d’un modèle est incorrecte, corrigez-la sur un exemple de page avant d’importer d’autres pages. Si l’analyse échoue, vérifiez les URL ayant échoué, corrigez l’accès source et réessayez ces pages. L’importation d’une page remplace à nouveau les modifications que les auteurs y ont apportées depuis ; consultez Importer par lots.

Fichiers de catalogue catalog-files

La plupart des utilisateurs ont uniquement besoin de la vue Planification. Pour partager un rapport hors ligne ou utiliser les données dans d’autres outils, recherchez la sortie brute dans le dossier catalog/ de votre projet.

File
Description
template-catalog-report-bundle.zip
Rapport HTML interactif avec captures d’écran que vous pouvez télécharger, ouvrir localement et partager avec les parties prenantes qui n’utilisent pas la console
summary.json
Totaux et statut de l’exécution
template-catalog.json
Chaque modèle avec les URL qui l’utilisent
block-catalog.json
Chaque variante de bloc avec son nom, son type et ses captures d’écran
urls-all.json
Chaque URL découverte
catalog.log
Log d’exécution

Le dossier contient également des fichiers intermédiaires, y compris une analyse par page et des captures d’écran dans .pages/ et des métadonnées par variante dans .blocks/.

Restrictions limitations

  • Accès à Source : L’agent lit la source à partir de son environnement hébergé. Par conséquent, le fait d’être connecté à la source dans votre propre navigateur ne lui donne pas accès. Pour les pages qui nécessitent une connexion ou un en-tête secret, configurez l’authentification de site protégée et vérifiez une page protégée avant de démarrer une exécution complète. Ne supposez pas que la configuration de l’authentification pour le mode automatique s’applique également au catalogage. Si la source bloque les visiteurs automatisés, consultez Sites Source avec protection des robots.
  • Contenu derrière les interactions : Le catalogue charge chaque page dans un navigateur, comme le fait l’importation, de sorte que le contenu qui s’affiche uniquement après qu’un visiteur clique ou saisit n’est pas capturé. Vérifiez les captures d’écran par rapport à la source. Voir Limites.
  • Couverture : Discovery utilise le plan du site ou suit les liens de la page de démarrage, de sorte qu’elle ne trouve pas les pages qui ne contiennent ni listes ni liens, telles que les pages de destination de la campagne. Comparez le résultat avec votre propre liste d’URL et enregistrez les échecs, les URL manquantes et les exclusions approuvées.

Pour transmettre l’analyse, enregistrez sa date, la portée source, le rapport, vos corrections, les URL non résolues et les exemples de pages que vous avez vérifiés lors de la remise du projet.

recommendation-more-help
experience-manager-cloud-service-help-main-toc