Créer, mettre à jour et refactoriser des blocs block-development

Utilisez l’agent de modernisation de l’expérience pour le développement Edge Delivery Services en cours ainsi que la migration. Commencez par le besoin de création et le contenu réel, puis choisissez la plus petite implémentation qui les prend en charge.

L’agent suit le développement piloté par le contenu (CDD) pour ce travail. Il part d’un contenu réel et de la manière dont les créateurs le créeront, puis écrit du code. Cela permet aux auteurs et aux autrices d’utiliser facilement les modèles de contenu et évite les blocs que seuls les développeurs et développeuses peuvent remplir.

Connectez le référentiel et la branche prévus, confirmez les autorisations de modification et identifiez l’emplacement de stockage du contenu. Conservez une ligne de base avant de modifier le code partagé ou les modèles de contenu.

Composer avant de créer un bloc composition

Les éléments HTML sont les unités de construction de base, ou atomes : en-têtes, paragraphes, liens, listes et images. Dans la mesure du possible, les auteurs doivent utiliser le contenu par défaut, c’est-à-dire le contenu en dehors des blocs. Les styles globaux et les propriétés personnalisées CSS, ou jetons de conception, définissent la typographie, les couleurs, l’espacement et la présentation des liens et des boutons partagés.

Un bloc permet aux auteurs et autrices de marquer le contenu qui forme un composant, tel qu’un jeu de cartes ou un carrousel, où le code ne pourrait pas le distinguer du contenu par défaut environnant. Dans l’HTML que votre site diffuse, un bloc est un div dont la classe porte le nom. Les blocks/<name>/<name>.js et blocks/<name>/<name>.css du projet l’ornent dans le navigateur. Lorsque le code peut reconnaître un modèle dans le contenu par défaut, il peut créer le bloc lui-même, que aem.live appelle blocage automatique : le modèle AEM, par exemple, transforme un lien vers une page /widgets/ en un bloc de widget. Gardez un bloc léger et concentré. Une différence visuelle seule n’a pas besoin d’un nouveau bloc : CSS et JavaScript peuvent appliquer un style au contenu par défaut, et une variante ou un style de section peut faire la différence.

Le modèle de David collecte les règles aem.live pour le contenu que les auteurs peuvent créer facilement : préférez le contenu par défaut, évitez les blocs à l’intérieur des blocs, limitez le nombre de blocs et de variantes et laissez les boutons utiliser leur style à partir du bloc ou de la section dans lequel ils se trouvent. Lorsqu’un bloc effectue le même travail qu’un bloc de la collection de blocs, réutilisez le modèle de contenu de ce bloc.

Vérifiez les conventions du projet avant de générer le code :

Besoin
Décision de vérifier
Call to action (CTA)
comment un lien créé devient un bouton (voir l’exemple), quelles variantes existent et comment le libellé et la destination restent modifiables ;
Groupe de boutons
Si les liens adjacents/le contenu par défaut prennent déjà en charge le regroupement ou si un modèle réutilisable est nécessaire pour l’ordre, l’habillage et les variantes.
Note de bas de page
Création et conservation des marqueurs, des identifiants de cible, des liens de retour et de l’ordre de lecture.
Contenu répété
Si un bloc ou une variante de cartes/liste existant le représente sans champs de création supplémentaires.

Edge Delivery Services n’a pas de contrôle intégré de groupe de boutons ou de note de bas de page. Chaque étant une convention que le code du projet applique au contenu créé, vérifiez comment votre projet l’implémente et testez le résultat rendu.

Exemple : Un Teaser Flexible Sans Blocs Atomiques composition-example

Les projets Adobe Experience Manager basés sur des composants fournissent souvent un composant Teaser ou des composants d’en-tête, d’image, de texte et de bouton distincts, afin que les auteurs puissent les combiner. La page d’accueil de l’exemple de site WKND, par exemple, promeut chaque voyage avec un teaser des composants principaux. Avec Edge Delivery Services, les auteurs écrivent les mêmes éléments directement en tant que contenu par défaut, soit dans une section, soit dans une cellule de bloc :

[Image]
## Downhill Skiing Wyoming
A skier's paradise far from crowds and close to nature.
**[View trip](/adventures/downhill-skiing-wyoming)**
_[All adventures](/adventures)_

Dans le modèle AEM standard actuel, un lien qui est seul dans son paragraphe devient un bouton lorsqu’il est formaté : gras pour un bouton principal, italique pour un bouton secondaire et gras plus italique pour un bouton d’accentuation. Un lien simple, ou un lien à l’intérieur d’une phrase, reste un lien. Les styles globaux donnent à ces boutons le même aspect dans le contenu par défaut et dans les blocs.

Les auteurs peuvent ajouter, supprimer ou réorganiser l’en-tête, le texte, l’image et les liens sans nouveaux composants. Un teaser ou un bloc principal n’est nécessaire que dans les cas où les auteurs doivent marquer les éléments qui font partie du même texte ; CSS et JavaScript peuvent également placer l’image à côté du texte dans le contenu par défaut. Les projets peuvent modifier ces conventions, aussi demandez à l’agent de vérifier les scripts et les styles du projet avant de s’y fier.

Demander un bloc block-prompts

Vous pouvez commencer par une courte invite, telle que « Créer un bloc de témoignages ». Ajoutez un contexte où l’agent peut ainsi faire correspondre quelque chose de spécifique :

Pour afficher l’agent
Fournir
Une conception sur un site existant
L’URL de la page et la section à faire correspondre.
Un design qui n’est pas en ligne
Capture d’écran ou image (JPEG, PNG, GIF ou WebP), avec Joindre des fichiers dans l’entrée d’invite. Pour les conceptions Figma, voir Créer un bloc à partir de Figma.
Un élément dans l’aperçu de la console
Sélectionnez-le avec le mode d’inspection dans les vues de contenu, de sorte que l’agent limite ses modifications à cet élément. Voir Apporter Votre Première Modification.
Comment les auteurs et autrices remplissent le bloc
Exemple de contenu, les parties facultatives ou répétées et les variantes dont vous avez besoin.

Une page de référence ou une capture d’écran affiche l’apparence de la cible. Il ne définit pas ce que les auteurs et autrices modifient, alors dites-le aussi.

Réutiliser les blocs existants reuse-blocks

Avant de créer un bloc, l’agent en recherche un à réutiliser ou à adapter : dans le dossier blocks de votre projet, et dans la Collection de blocs et la Partie de blocs pour le code de référence. Lors de la migration, il vérifie également votre bibliothèque de blocs, si vous en avez une.

  • Pour réutiliser des blocs provenant d’un autre référentiel, ajoutez-les d’abord au dossier blocks de ce projet, par exemple en les poussant vers votre branche, puis en extrayant le code dans la console.
  • Enregistrez vos conventions de nommage, de variante et de contenu dans les fichiers d’instructions de projet, de sorte que de nouveaux blocs les suivent.

Créer des blocs un par un iterate-blocks

Lorsque vous avez besoin de plusieurs blocs, ne les demandez pas tous en une seule invite. Créez d’abord un ou deux blocs représentatifs, puis vérifiez leur modèle de contenu, leur style et leur création. Continuez ensuite avec les autres, de sorte que les décisions que vous avez prises, telles que les noms, les variantes et l’espacement, soient conservées. Dans une migration, générez et validez les blocs d’un modèle représentatif avant le reste. Voir Workflow d’importation en bloc.

Définition du comportement de bloc avant une migration block-instructions

La migration génère des blocs à partir du contenu qu’elle trouve sur les pages source. Pour piloter la création d’un bloc avant que l’agent ne le génère :

  • Décrivez-la dans l’invite de migration, par exemple quelles sections source deviennent un bloc avec des variantes, quelles parties les auteurs modifient ou qu’une liste doit charger ses éléments dynamiquement.
  • Écrivez des conventions durables dans les fichiers d’instructions de projet avant de commencer.
  • Dans la vue Planification, corrigez les types de blocs et les variantes avant de générer le code. Pour décrire le comportement d’un bloc, sélectionnez-le, choisissez Ajouter au chat et écrivez votre demande.

Le mode automatique ne prend pas d’instructions lors d’une exécution. Affinez ses blocs dans la console par la suite.

Créer un bloc create

Fournissez la tâche de création, un exemple de contenu, le comportement et la conception souhaités, l’emplacement de stockage du contenu, ainsi qu’une page de test.

  1. Demandez à l’agent d’inspecter les blocs existants et les implémentations de référence appropriées. Préférez la réutilisation ou une variante à un doublon.
  2. Définissez un modèle de contenu que les auteurs peuvent comprendre. Utilisez naturellement des en-têtes, des liens, des images et du contenu groupé plutôt que d’exposer les détails de CSS ou d’implémentation sous forme de champs.
  3. Créez d’abord un contenu représentatif. Incluez du texte long, des valeurs facultatives manquantes, plusieurs éléments et des images/liens significatifs.
  4. Implémentez uniquement la décoration HTML, le CSS et le JavaScript nécessaires. Réutilisez les jetons de projet et les utilitaires partagés.
  5. Pour la création Experience Manager, mettez à jour la configuration des composants/modèles sources et régénérez les agrégats par le biais du workflow du projet. Le modèle d’un bloc définit les champs que les auteurs et autrices modifient dans l’éditeur universel ; l’éditeur ou l’éditrice lit le modèle, et non un tableau dans un document. Le bloc n’est donc modifiable qu’une fois que son modèle définit ces champs. Vérifiez les indications de conversion et de création.
  6. Valider, puis documenter un exemple que les auteurs peuvent modifier et les variantes autorisées.

Par exemple :

Créez un bloc de témoignages pour nos pages basées sur des documents. Commencez par ces exemples de contenu réel : /about et /customers. Vérifiez d’abord les blocs existants. Les auteurs doivent modifier le guillemet, l’attribution et l’image facultative sans configuration de disposition. Utilisez nos jetons. Incluez du texte long et des exemples sans image. Ne chargez, ne poussez pas et ne publiez pas.

Remplacez les exemples de chemins par les vôtres.

Le résultat est un code réutilisable, un modèle dont les auteurs ont besoin, et un exemple de contenu que les auteurs peuvent modifier.

Éléments fournis par l’agent avec un bloc block-deliverables

  • Documentation des blocs : lorsque la migration crée un bloc, elle génère le bloc à partir du modèle de contenu figurant sur vos pages et ajoute un fichier README pour les développeurs et un guide de création pour les auteurs. Examinez les deux, tenez-les à jour lorsque vous modifiez le bloc et référencez-les à partir des fichiers d’instructions du projet afin que les conversations ultérieures respectent les conventions du bloc.
  • Exemple de contenu : L’agent génère un exemple de contenu pour les blocs afin que vous puissiez les prévisualiser avec du contenu réaliste. Dans le catalogue de sites, utilisez Afficher l’exemple pour ouvrir la page d’exemple d’un bloc.
  • Bibliothèque de blocs : la bibliothèque de blocs permet aux auteurs de trouver vos blocs personnalisés et de les insérer dans les pages, avec un exemple de contenu qui montre comment chaque bloc est destiné à être utilisé. Pour la configurer, demandez à l’agent de générer une bibliothèque de blocs, y compris un exemple de contenu et la configuration de la bibliothèque, pour la création Experience Workspace (qui remplace la création de documents) ou la création Experience Manager. La configuration de la bibliothèque de blocs est une fonctionnalité facultative qu’elle offre pour activer pour votre projet. Vérifiez le résultat dans l’expérience de création. Définissez l’URL de la bibliothèque dans les paramètres sur le fichier library.json de la bibliothèque, qui répertorie les blocs disponibles, leurs variations et un exemple de contenu.

Mettre à jour un bloc existant update

Indiquez le nom du bloc, les exemples/variantes actuels, la modification demandée et les exigences de compatibilité.

  1. Identifiez les pages à l’aide du bloc, des styles/utilitaires partagés et des tests existants.
  2. Indiquez ce qui doit rester inchangé, y compris les structures et interactions de contenu existantes.
  3. Apportez la modification. Une modification de présentation est uniquement au format CSS ou JavaScript, afin de ne pas toucher aux modèles de contenu et de ne pas nécessiter de réimportation de contenu.
  4. Testez le comportement modifié et les variantes non affectées sur du contenu représentatif.
  5. Si une modification de modèle incompatible est nécessaire, convenez de la manière dont le contenu existant sera migré et qui accepte l’impact de création avant de l’appliquer.

Par exemple :

Mettez à jour cards pour que la variante de lien secondaire approuvée fonctionne sur /products et /blog. conserver les variantes d’image et par défaut existantes et leur contenu créé ; Vérifiez l’interaction du clavier et l’encapsulation du dispositif mobile. Ne réécrivez pas d’autres pages et ne chargez pas de contenu.

Remplacez les exemples de chemins par les vôtres.

Transmettez le comportement modifié, les variantes affectées, les instructions de création et les modifications de contenu requises.

Refactoriser sans modifier le résultat refactor

La refactorisation améliore l’implémentation tout en préservant le comportement convenu. Cela n’est pas identique au regroupement d’un catalogue, à la reconception d’un bloc ou à la migration de son modèle de contenu.

  1. Nommez le code à améliorer et la raison, comme la logique de décoration dupliquée.
  2. Enregistrez les éléments qui ne doivent pas changer : le modèle de contenu, l’apparence, le comportement réactif, l’accessibilité, les sélecteurs et les API sur lesquels repose l’autre code et les intégrations.
  3. Établissez des exemples de référence et des tests existants. Vérifiez les utilisations du code et des styles partagés avant de les consolider.
  4. Demandez la plus petite refactorisation qui réponde à l’objectif. Gardez explicite et distinct tout changement de comportement/modèle nécessaire.
  5. Effectuez une comparaison avant et après sur les pages et variantes concernées, exécutez les vérifications de projet et examinez la comparaison.

Par exemple :

Refactorisation de la logique de décoration de carte dupliquée dans blocks/cards/cards.js et blocks/teaser/teaser.js. Conservez les modèles créés, la sémantique de sortie, l’apparence, le comportement des liens, l’accès au clavier et les points d’extension Analytics. Utilisez /products et /blog comme exemples de régression. Signalez les risques de compatibilité et les résultats des tests. Ne migrez pas le contenu et ne poussez pas les modifications.

Remplacez les exemples de chemins par les vôtres.

Il n’y a pas de commande de refactorisation distincte : vous demandez dans le chat, et l’agent modifie le code comme le ferait un développeur, dans les limites que vous avez définies.

Création d’un bloc dynamique dynamic-blocks

Un bloc dynamique charge ou calcule son contenu dans le navigateur, plutôt que de n’afficher que ce que les auteurs écrivent. Il peut s’agir, par exemple, d’une liste des derniers articles, des résultats de recherche ou d’une liste filtrée. Demandez à l’agent d’en créer un après la migration comme tout autre bloc, ou de modifier un bloc migré pour qu’il fonctionne de cette manière. Décrire :

  • La source de données, telle que l’index de requête du site, une feuille de calcul fournie au format JSON ou une API.
  • Ce que les auteurs contrôlent, comme le nombre d’éléments, le dossier à répertorier ou l’ordre de tri. L’agent modélise ces paramètres sous la forme d’un bloc de configuration : un tableau à deux colonnes de clés et de valeurs. Utilisez-le uniquement pour les paramètres qui modifient ce que le bloc charge ou affiche, et utilisez des variantes pour les différences de style.
  • Ce que chaque élément affiche et ce que le bloc affiche lorsqu’il n’y a aucun résultat ou que les données ne peuvent pas être chargées.

Par exemple :

Créez un bloc de liste d’articles qui affiche les six articles les plus récents de l’index de requête du site, avec une image, un titre et une date. Les auteurs définissent le nombre d’articles et le dossier à répertorier dans un tableau clé-valeur. Afficher un court message en l’absence d’articles. Testez-le sur /news. Ne chargez, ne poussez pas et ne publiez pas.

L’index de requête inclut uniquement les pages publiées et uniquement les propriétés extraites par sa configuration. Vérifiez donc les deux avant de procéder au test. Validez les états vide et erreur, ainsi que le résultat normal.

Connecter des services et des applications integrations

L’agent écrit le code qui connecte votre site à d’autres systèmes, y compris des systèmes que ses modules complémentaires ne couvrent pas. Au-delà de Edge Delivery Services explique comment travailler avec une intégration. Cette section décrit l’emplacement d’exécution de ce code.

Les pages Edge Delivery Services exécutent ce code dans le navigateur du visiteur. De ce fait, chaque connexion fait partie d’un bloc, d’un widget ou des scripts du projet. Si l’agent doit appeler une API qui a besoin d’une clé pendant son fonctionnement, ajoutez la clé dans Settings, et non dans la conversation.

  • Applications : un formulaire, une page de recherche, un localisateur de magasin ou une zone de compte a peu de contenu créé. Créez-le en tant que widget : application autonome dans le dossier /widgets/ du référentiel, que les auteurs placent sur une page en insérant son lien. Une application existante, telle que celle créée avec React, peut être adaptée de la même manière.
  • API : un bloc ou un widget appelle une API à partir du navigateur. L’API doit accepter les requêtes provenant des domaines de votre site, y compris les sites d’aperçu et en ligne. Si d’autres sites doivent lire les ressources de votre site, configurez les en-têtes personnalisés pour les chemins dont ils ont besoin, jamais pour toutes les origines.
  • Secrets : Tout le contenu du référentiel est diffusé au navigateur, il ne peut donc pas contenir de clés ou de jetons API. Lorsqu’une API a besoin d’un secret, appelez-le via un service côté serveur qui le conserve, tel qu’Adobe App Builder ou le maillage API, et laissez le bloc appeler ce service.
  • Mappages, vidéos et autres services incorporés : certains services génèrent des clés destinées au navigateur, comme de nombreux services de mappages, et vous limitez chaque clé aux domaines de votre site, y compris les sites d’aperçu et en direct. Cette restriction protège la clé, car chaque visiteur peut la lire. Chargez le service lorsque le visiteur l’atteint, pas avec le reste de la page, afin qu’il ne ralentisse pas la page.
  • Commerce : Les pages Commerce couvrent le module complémentaire pour les vitrines Adobe Commerce et l’itinéraire pour les autres plateformes commerciales.
  • Forms: Les envois de formulaires couvrent le module complémentaire pour Adobe Experience Manager Forms et la connexion d’un formulaire à n’importe quelle destination.
  • Analytics, gestion des balises et consentement : chargez ces scripts après le rendu de la page, afin qu’ils ne la ralentissent pas. Voir Maintien Du Score Lighthouse À 100. Avec les intégrations d’inclusion du mode automatique, l’agent ajoute les paramètres pris en charge, désactivés jusqu’à ce que vous les activiez.

Les modules complémentaires sont des fonctionnalités facultatives que l’agent propose d’activer lorsqu’une tâche en a besoin. Les systèmes qui se connectent, qui en est propriétaire et qui accepte le résultat sont des décisions de projet. Voir Ce qui reste du travail de projet.

Envois de formulaire form-submissions

Edge Delivery Services diffuse un formulaire, mais il ne stocke pas les envois ni n’exécute ce qui suit. Sur le site source, un serveur a géré chaque envoi, et l’importation de page ne peut pas voir ce serveur. La connexion d’une destination est la même sur n’importe quel site Edge Delivery Services, migré ou non, et comme l’agent est un agent de codage à usage général, vous pouvez le demander à tout moment.

Fonctionnement du module complémentaire Forms forms-add-on

Le module complémentaire Forms est conçu pour les organisations qui disposent d’une licence pour Adobe Experience Manager Forms. Il prépare les formulaires de Edge Delivery Services pour Experience Manager Forms. Pour chaque formulaire source comportant deux champs ou plus, il enregistre les champs dans une définition de formulaire, une feuille enregistrée en regard de la page avec une ligne par champ : son nom, son libellé, son type, ses options et sa validation. Il place ensuite un bloc de formulaire sur la page qui pointe vers la définition. Les champs et les libellés sont du contenu dans cette définition, et non des données contenues dans un serveur principal de formulaires. Chaque formulaire utilise le même bloc, nommé form, et sa définition décide de ce qu’il affiche, de sorte que l’agent ne crée pas de variantes du bloc. Le module complémentaire enregistre chaque définition dans le dossier de la page, nommé d’après le formulaire source, et ne recherche pas le même formulaire sur d’autres pages. Pour gérer un formulaire que plusieurs pages affichent à un seul endroit, demandez à l’agent de lier ces pages à une seule définition.

Si le projet ne comporte pas encore de bloc de formulaire, le module complémentaire ajoute le bloc de formulaire de Experience Manager Forms. Ce bloc envoie chaque envoi au service d’envoi Forms, qui identifie le formulaire par le chemin de sa définition et stocke les données dans la feuille de calcul liée dans la ligne d’envoi de la définition. Le module complémentaire ne lie pas de feuille de calcul et ne conserve pas l’adresse à laquelle le formulaire source a été envoyé. Connectez-vous donc à une destination avant que le formulaire ne soit activé. Voir Choisir une destination. Le module complémentaire lui-même n’a pas besoin de licence, mais le bloc de formulaire et le service d’envoi Forms nécessitent une licence Experience Manager Forms.

Sans Experience Manager Forms, l’inventaire des champs du module complémentaire est la partie qui reste utile : elle capture les champs, les libellés, les types, les options et la validation de chaque formulaire. L’agent n’a aucune compétence pour d’autres plateformes de formulaires. Faites-le donc lire d’abord la documentation de votre plateforme, comme décrit dans Travailler au-delà de Edge Delivery Services. Il peut ensuite créer un bloc de formulaire qui lit les mêmes définitions et les envoie à votre plateforme, ou incorporer le formulaire que votre plateforme héberge.

Le module complémentaire lit chaque formulaire d’HTML que le serveur source envoie, y compris les formulaires de fournisseurs tiers lorsque leurs champs sont présents dans cette HTML. Un formulaire ajouté par un script dans le navigateur, tel qu’un formulaire incorporé à partir d’une plateforme marketing, ne se trouve pas dans cette HTML. Par conséquent, le module complémentaire ne l’importe pas. Demandez à l’agent de recréer ce formulaire ou de l’incorporer à nouveau à partir de votre plateforme.

Choisir une destination form-destination

Les formulaires de prospect se trouvent là où vos équipes gèrent déjà des prospects, dans une plateforme d’automatisation du marketing ou un système de gestion de la relation client (GRC), par exemple :

  • Adobe Marketo Engage
  • Salesforce, par le biais de l’engagement de compte de Sales Cloud ou Marketing Cloud
  • Microsoft Dynamics 365
  • HubSpot
  • Oracle Eloqua

Lorsque les envois doivent atteindre plusieurs systèmes, envoyez-les à une plateforme d’intégration, telle qu’Adobe Workfront Fusion ou Microsoft Power Automate, ou à votre propre API. Avec Experience Manager Forms, le service d’envoi de Forms stocke les envois dans une feuille de calcul ou les envoie par e-mail, et les actions d’envoi qui s’exécutent sur Experience Manager les transfèrent vers d’autres systèmes, tels que Marketo Engage, Workfront Fusion, Power Automate ou un point d’entrée REST. Voir Configurer Les Actions Envoyer.

La plupart de ces plateformes acceptent un envoi du navigateur à un point d’entrée de formulaire qui ne nécessite aucun secret. Si l’API de la plateforme a besoin d’une clé, envoyez l’envoi par l’intermédiaire d’un service côté serveur qui la conserve, comme décrit dans la section Secrets ci-dessus.

Dites à l’agent :

  • Destination : la plateforme et le formulaire, la liste ou la campagne qui reçoit les données, avec son point d’entrée et sa documentation, ou l’URL de votre service côté serveur.
  • Mappage des champs : quel champ de formulaire va à quel champ de plateforme, quels champs sont obligatoires et leurs formats.
  • Valeurs masquées : valeurs que les visiteurs ne saisissent pas, telles que la source du prospect, la campagne, l’URL de la page et les paramètres UTM de la visite.
  • Consentement : les cases à cocher de souscription, leur libellé approuvé et le lien vers votre politique de confidentialité.
  • Protection antispam : méthode prise en charge par votre plateforme, telle qu’un CAPTCHA ou un champ de leurre masqué.
  • Après l’envoi : le message de confirmation ou la page de remerciement et ce que les visiteurs voient si l’envoi échoue.
  • Test : d’un formulaire ou d’un sandbox de test et de la manière dont les entrées de test sont marquées.

Par exemple :

Commencez par lire la documentation de notre CRM sur les envois de formulaires à https://developer.example.com/forms. Ensuite, connectez le formulaire le /contact au formulaire CRM contact-us à https://forms.example.com/submit/contact-us. Mappez le prénom, le nom, l’adresse e-mail, la société et le pays aux champs CRM FirstName, LastName, Email, Company et Country ; l’adresse e-mail et la société sont obligatoires. Ajoutez des champs masqués pour la source de prospect « Website », l’URL de la page et les paramètres UTM de la visite. Afficher cette case à cocher de consentement, décochée : « J’accepte de recevoir les actualités des produits par e-mail. » Après un envoi réussi, affichez le message « Merci, nous vous contacterons. » ; si l’envoi échoue, conservez les entrées du visiteur et affichez une erreur avec une nouvelle tentative. Testez le sandbox du CRM à https://sandbox.example.com. Ne chargez, ne poussez pas et ne publiez pas.

Remplacez les exemples d’URL, de noms et de libellés par les vôtres.

L’agent met à jour la définition du formulaire et le code du bloc de formulaire. Il peut également écrire le code d’un service côté serveur, que votre équipe déploie avec le secret. Dans la plateforme de réception, son administrateur configure :

  • Le formulaire ou le point d’entrée, avec les champs attendus et leur validation.
  • Les domaines autorisés à envoyer : votre aperçu et vos sites actifs, ainsi que votre domaine de production.
  • Filtrage des spams sur le serveur. Les enregistrements dans le navigateur aident les visiteurs et visiteuses à remplir le formulaire ; ils ne protègent pas la plateforme.
  • comment une nouvelle soumission est mise en correspondance avec des contacts existants, de sorte qu’une personne ne devienne pas deux prospects.
  • Attribution, notation et routage de la source de lead et de la campagne à la bonne équipe de vente.
  • E-mails de confirmation, notifications internes et programmes de suivi.
  • Les enregistrements de consentement, ainsi que le lieu et la durée de conservation des données personnelles.

Envoyez une entrée de test à partir du site d’aperçu. Vérifiez qu’il est arrivé avec chaque champ, qu’il a démarré le workflow attendu et qu’il a été marqué comme test. Répétez la vérification sur le domaine de production après le commutateur.

Pages Commerce commerce-pages

Le module complémentaire Pages commerciales étend le workflow d’importation de page de l’agent de modernisation d’Experience pour les storefronts Adobe Commerce. Il reconnaît les pages de détails du produit et les pages de liste de produits sur le site source, quelle que soit la plateforme qui l’exécute, à partir de signaux tels que des données structurées de produit, des modèles d’URL et des éléments de page tels qu’un champ de quantité, une grille de produit ou des filtres. Il les reconstruit en tant que page ne contenant que le SKU du produit ou le chemin d’accès de la catégorie, dans un bloc commercial, et le contenu environnant, tel que les bannières et les promotions, dans des blocs standard. Les données sur les produits ne sont pas importées : le bloc de commerce les charge à partir du catalogue chaque fois qu’un visiteur ouvre la page. L’agent migre d’autres pages avec le workflow standard.

Le module complémentaire n’écrit pas les blocs commerciaux. Il utilise le produit et les blocs de liste que le projet possède déjà, et s’attend dans le cas contraire aux blocs product-details et product-list-page de la norme standard du storefront commerce. Démarrez le projet à partir de ce standard et connectez le storefront à votre catalogue, de sorte que les pages importées affichent les produits lorsque vous les vérifiez. Le module complémentaire lui-même n’a pas besoin de licence, mais les composants déroulants du storefront nécessitent une licence Adobe Commerce as a Cloud Service ou Adobe Commerce Optimizer. Adobe Commerce Optimizer peut également fournir le catalogue lorsqu’une autre plateforme commerciale gère le panier, le passage en caisse et les commandes. Voir Options du serveur principal.

Pour une autre plateforme commerciale sans Adobe Commerce Optimizer, le module complémentaire ne s’applique pas. L’agent crée des blocs de produit et de liste qui chargent leurs données à partir de l’API de la plateforme, en travaillant à partir de la documentation de la plateforme comme décrit dans Travailler au-delà de Edge Delivery Services.

Le module complémentaire fonctionne avec le contenu basé sur des documents. Pour les projets qui utilisent la création Experience Manager, l’agent utilise la migration standard, qui importe ce que chaque page de produit affiche à ce moment. Décidez avec votre équipe de la manière dont ces pages se connectent au catalogue.

Valider et diffuser validation

Utilisez les commandes de ligne et de test déclarées du projet, ainsi que les contrôles du navigateur sur le contenu réel. Demandez à l’agent de signaler les commandes et les résultats, et pas simplement ceux qu’il a testés.

Vérifier :

  • Toutes les variantes et tous les cas de périphérie de contenu affectés.
  • Disposition pour poste de travail/appareil mobile, contenu long et comportement des images.
  • Accès au clavier, focus, sémantique, libellés et ordre de lecture.
  • Interactions et intégrations existantes.
  • Lorsque des modèles ou du contenu sont modifiés, que les auteurs peuvent modifier, enregistrer et rouvrir le contenu dans leur éditeur et qu’il soit prévisualisé correctement.
  • Contrôles de performances pertinents et aucune nouvelle erreur de navigateur.

Si une vérification échoue, conservez l’exemple d’échec et corrigez la plus petite couche affectée. Distinguer les problèmes d’aperçu/de branche de code obsolètes des échecs de modèle ou d’implémentation. Réexécutez la vérification ayant échoué et les régressions pertinentes.

Vérifiez la comparaison, transférez uniquement les fichiers prévus et utilisez la stratégie du référentiel. Chargez le contenu de test ou de production uniquement lorsque cela est autorisé, sans enregistrer le code push. Une fois fusionné en main, le code de bloc s’applique à chaque page du site actif qui utilise le bloc. Consultez Comment les modifications sont mises en œuvre.

Pour la récupération, revenez le code via Git et restaurez le contenu distant modifié séparément. Conservez les anciens exemples compatibles jusqu’à ce que toute migration de contenu requise soit acceptée.

Utilisez la remise de projet pour conserver les fichiers modifiés, les modèles, les exemples, les résultats de validation, les risques restants et l’approche de récupération pour la personne ou l’agent suivant(e).

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