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 :
- 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.
- 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.
- Modèle : l’agent regroupe les pages qui partagent la même disposition de blocs dans des modèles candidats.
- 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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
- Choisissez Examiner chaque étape pour répondre aux questions de l’agent, ou Pilote automatique pour le laisser décider.
- 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.
- 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.
- 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.
- 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.
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 :
- Exécutez le catalogue de sites pour obtenir les modèles et bloquer les variantes.
- 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.
- 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.
- 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.
- 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.
- 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.
template-catalog-report-bundle.zipsummary.jsontemplate-catalog.jsonblock-catalog.jsonurls-all.jsoncatalog.logLe 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.