Prise en main de l’agent de modernisation de l’expérience pour les projets de création Experience Manager getting-started-aem-authoring
Utilisez ce workflow lorsqu’une exigence dépend du contenu qui reste dans le JCR. L’éditeur universel est l’éditeur visuel d’Adobe pour le contenu dans Experience Manager. Il ne s’agit pas d’une migration vers une diffusion basée sur HTL, et la technologie du site web source ne détermine pas l’emplacement de stockage de votre contenu.
Vous avez besoin d’un accès à la console, des autorisations de référentiel et des autorisations pour créer ou mettre à jour du contenu et des ressources sur l’instance d’auteur cible. Enregistrez l’hôte de l’instance d’auteur, l’identifiant du site, la racine de page, la destination de gestion des ressources numériques (le dossier Experience Manager Assets pour les images et les fichiers), le référentiel de code et la branche de travail avant l’importation. Le mode automatique produit du contenu basé sur des documents, il ne s’applique donc pas à cette configuration.
Création De Votre Référentiel De Projet Edge Delivery Services create-repo
Pour un nouveau projet :
- Utilisez le référentiel
aem-block-collection-xwalkcomme modèle plutôt que comme modèle standard basé sur des documents. Les modèles de création Experience Manager portent le nomxwalk, abréviation de Crosswalk. - Vérifiez que
fstab.yaml, le fichier qui pointe Edge Delivery Services vers la source de contenu du site, fait référence à l’hôte de votre instance de création, au propriétaire Git et au référentiel Git. Vérifiez et validez la configuration dans la branche utilisée pour l’installation.- Voir Configurer la source de contenu pour obtenir des instructions.
- Suivez le tutoriel de l’éditeur universel pour configurer votre référentiel.
- Arrêtez lorsque l’on vous demande de créer un site dans Experience Manager.
- Pour cette configuration de nouveau projet, supprimez le
paths.jsondu modèle et validez la modification. Ne supprimez pas les mappages de chemins d’accès d’un site existant sans passer en revue leur objectif et leur remplacement. - Ajoutez l’application AEM Code Connector à votre référentiel afin que la console puisse pousser les modifications. Pour connaître ses différences avec la synchronisation du code AEM, consultez Démarrer à partir d’un référentiel.
Pour un projet existant qui stocke son contenu dans le JCR, réutilisez sa configuration et ses modèles de contenu. Ne recréez pas le site et ne remplacez pas son référentiel par le modèle. Confirmez la synchronisation du code et l’accès au référentiel sans répéter la configuration basée sur le document.
Création d’un site dans Experience Manager create-site
-
Dans la console Sites, sélectionnez Créer > Site à partir du modèle.
-
Sélectionnez le site AEM avec modèle Edge Delivery Services.
- Vous ne le voyez pas répertorié ? Installez le modèle.
-
Pour cette configuration de modèle, conservez le nom du site (et non le titre) fourni.
- Le nom du site est utilisé comme identifiant unique.
- Le titre peut être modifié pour l’affichage.
-
Sélectionnez Créer.
- Vous êtes redirigé vers la page Sites.
- Actualisez la page si le nouveau site n’apparaît pas immédiatement.
Ignorer la création du site si le site cible existe déjà. Confirmez plutôt son identifiant et ses destinations ; ne renommez pas un site actif pour qu’il corresponde à un exemple.
Connexion au site et importation d’une page continue
Les étapes de la console sont les mêmes que dans le guide principal. Seules la demande d’import et les vérifications diffèrent.
-
Demandez à l’agent d’importer une page et indiquez que le contenu est stocké dans le JCR. Remplacez l’exemple d’URL :
- « Migrez uniquement
https://www.example.com/aboutvers la racine de page convenue dans ce projet de création Experience Manager. Conserver le contenu et les liens. Réutilisez les modèles de bloc du projet et validez la conversion JCR. Ne effectuez aucun chargement, aucune notification push ni aucune publication. »
- « Migrez uniquement
-
Validez le contenu, téléchargez-le en tant que package de contenu et vérifiez que les auteurs peuvent le modifier et le prévisualiser.
-
Demandez un style, comme dans les étapes de style de Importer une page étape par étape et pousser le code.
Valider le contenu validate-content
Validez la page sélectionnée dans le panneau de contenu. Utilisez la vue Markdown, la vue XML JCR et les erreurs pour vérifier le contenu et la conversion. Utilisez Ajouter à la conversation pour corriger une page ou l’un des scripts d’importation générés par l’agent.
Dans les projets de création Experience Manager, chaque bloc possède également un modèle : configuration qui définit les champs que les auteurs et autrices modifient pour ce bloc dans l’éditeur universel. L’éditeur universel modifie uniquement les champs définis par le modèle d’un bloc afin qu’une page puisse s’afficher correctement dans l’aperçu d’HTML. Les blocs qui ne correspondent pas à leur modèle ne peuvent pas être modifiés. Demandez à l’agent de vérifier que les modèles de bloc source, les définitions de composant et la configuration d’agrégat générée sont corrects. Mettez à jour la configuration source par le biais du workflow de génération du projet au lieu de corriger uniquement un fichier généré. Vérifiez les mappages de champs et les indications de création, les chemins de page, les références d’image et les destinations de site/gestion des ressources numériques prévues.
Résolvez les erreurs de conversion sur un exemple de page avant de créer un package plus volumineux.
Chargement du contenu upload-content
Le chargement de package écrit du contenu dans l’instance d’auteur. Confirmez les pages, l’hôte, le site, la racine de page et la destination de ressource sélectionnés avec le propriétaire de la cible. conserver le contenu existant avant de le remplacer ; la validation en local ne rend pas un remplacement sûr ;
Le chargement utilisant votre connexion à Adobe, l’instance de création applique vos propres autorisations aux pages et aux ressources. Voir Autorisations des notifications push de contenu.
-
Assurez-vous que vous êtes dans une vue de Contenu et sélectionnez le bouton Charger le contenu en haut à droite.
-
Dans la boîte de dialogue Créer un package de contenu, choisissez les pages à inclure dans le package.
- Vous pouvez éventuellement saisir un nom du package (par défaut le nom du site s’il est vide).
- Utilisez Sélectionner tout, Effacer la sélection, Développer tout ou Réduire tout pour gérer la liste.
-
Sélectionnez Créer un package.
-
Une fois le package créé, la boîte de dialogue Télécharger le package de contenu indique que le package est prêt.
- Vous pouvez télécharger le package pour l’enregistrer localement ou procéder au chargement.
- Sous Charger vers AEM, confirmez le site AEM et l’hôte AEM (pré-renseigné à partir des paramètres du projet).
- Vous pouvez également laisser Charger les images coché pour inclure les images.
- Sélectionnez Charger vers AEM.
-
La boîte de dialogue affiche la progression du chargement au fur et à mesure que les pages et les ressources sont envoyées à l’instance de création. Vérifiez le journal de chargement, y compris les échecs individuels, avant de fermer la boîte de dialogue.
En cas d’échec du chargement de package ou d’image, conservez le journal et les chemins sélectionnés. Corrigez la conversion, les informations d’identification, les autorisations ou les destinations comme indiqué, puis réessayez la portée affectée. Le téléchargement de package seul n’importe pas le contenu dans l’instance de création. Vérifiez quelles pages et ressources sont arrivées avant de réessayer d’éviter les remplacements involontaires.
Si Créer un package signale une configuration de site manquante, la console ne connaît pas le chemin d’accès au site du projet, /content/{site-name}, et le dossier de gestion des ressources numériques, /content/dam/{folder-name}. Il les trouve en recherchant le site sur l’instance d’auteur vers laquelle la source de contenu du projet pointe, comme défini dans fstab.yaml ou dans la configuration du site. Vérifiez que le site existe sur cette instance de création et que le compte Adobe avec lequel vous vous êtes connecté peut y accéder, puis rechargez la console. Si le message persiste, demandez une assistance. S’il signale URL de base de site manquante, saisissez l’URL d’origine du site source, telle que https://www.example.com, comme URL de base de site dans Paramètres.
Si l’environnement Experience Manager as a Cloud Service est mis en veille, la boîte de dialogue de chargement et les paramètres le indiquent et renvoient vers le Developer Console. Réactivez l’environnement à cet endroit, puis relancez le chargement. Voir Réactiver un programme Sandbox à partir du Developer Console.
Vérifiez et insérez le code et la configuration correspondants dans la stratégie de référentiel de votre projet. Ceci est distinct du chargement de package. Consultez Comment les modifications sont mises en œuvre.
Validation de la création et de la prévisualisation preview-site
- Dans la console Sites , localisez la page importée sous la racine de site choisie.
- Ouvrez-la dans l’éditeur universel. Vérifiez que les champs et blocs attendus peuvent être sélectionnés et modifiés, et non pas simplement rendus.
- Modifiez du texte et une image, enregistrez et rouvrez la page. Vérifiez que le contenu et les références de ressources persistent.
- Utilisez le workflow d’aperçu configuré du projet (les pages d’aperçu sont diffusées sur
*.aem.page). Vérifiez la page par rapport à la branche de code prévue et vérifiez la disposition réactive, les liens et les images. - Pour la production, effectuez les vérifications avant la publication, puis publiez les pages à partir de l’éditeur universel ou de la console Sites. Voir Publication de contenu avec l’éditeur universel.
Le chargement réussi du package, la création réussie, la prévisualisation et la publication sont des points de contrôle distincts. Si la modification échoue, revoyez les mappages de modèle et la configuration générée ; n’acceptez pas un aperçu statique comme étant terminé.
Enregistrez le package chargé, les chemins d’accès, la révision du code, les URL de création/prévisualisation, les erreurs restantes et le propriétaire de la récupération lors du transfert. La restauration du code ne restaure pas les pages JCR ni les ressources de gestion des ressources numériques ; restaurez-les séparément à l’aide du processus approuvé de l’environnement cible.
Ressources supplémentaires additional-resources
- Prise en main de l’agent de modernisation de l’expérience - Workflow complet comprenant la console, l’invite, le chargement et la prévisualisation
- Console de modernisation de l’expérience - Référence de console
- Tutoriel de l’éditeur universel - Configuration d’un projet avec la création Experience Manager et l’éditeur universel
aem-block-collection-xwalk- Référentiel de modèles pour ces projets