Une introduction à la rédaction de documents (DA) pour les services de livraison en ligne (Edge Delivery Services)

Il existe une nouvelle technologie de gestion des sites Edge Delivery Services, très convaincante et en accès anticipé, appelée Document Authoring (un projet anciennement connu sous le nom de Dark Alley). C'est une bouffée d'air frais pour l'édition, la traduction, le stockage et la gestion des implémentations Edge Delivery, et en tant qu'architecte principal du premier projet client à utiliser cette technologie, je serais ravi de vous en parler un peu et de vous faire part de mes expériences et de mes réflexions. Si vous évaluez la prochaine étape pour un site basé sur AEM (ou qui pourrait migrer vers AEM), vous devez DEFINITIVEMENT connaître le DA.

Qu'est-ce que la rédaction de documents (ou DA) pour les services Edge Delivery ?

Document Authoring ou DA (l'artiste anciennement connu sous le nom de "Project Dark Alley") est une solution intégrée ultra-rapide, native des Edge Delivery Services ou Helix, pour la gestion, l'édition et la publication de sites basés sur les Edge Delivery Services.

DA est actuellement une technologie d'accès anticipé d'Adobe, ce qui signifie qu'Adobe est actuellement en train de co-innover avec des partenaires comme nous et des partenaires qui ont choisi cette voie. Si, à un moment ou à un autre de cet article, vous vous dites : "I'M IN SIGN ME UP", faites défiler la page jusqu'en bas pour obtenir les coordonnées de Slack/Discord &.

Pour tous ceux qui essaient de comprendre où se situe l'AD dans un paradigme d'infrastructure AEM traditionnel ou dans une architecture Edge Delivery quasi-moderne basée sur des documents, il convient d'abord de clarifier quelques termes :

Qu'est-ce que les services de livraison de pointe ?

Edge Delivery Services d'Adobe est un système de pointe basé sur l'informatique en nuage pour la diffusion de sites web qui prend des documents rédigés & images (et quelques vidéos) et les publie sur le web d'une manière optimisée pour une vitesse de diffusion extrême. Dans une architecture moderne, les Edge Delivery Services jouent essentiellement le même rôle que les serveurs AEM traditionnels "Publisher" et "Dispatcher", et présentent les avantages suivants :

• Vitesse de livraison très rapide - dans une comparaison dos à dos entre AEM traditionnel et Edge Delivery (que j'appellerai EDS par souci d'économie de frappe), les pages EDS étaient 3x-6x plus rapides qu'avec AEM 6.5 sur site.
• La livraison globale est intégrée au système. (note : la Chine peut encore être un défi)
• Capacité de trafic pratiquement illimitée - il n'y a pas de nombre fixe de serveurs qui fournissent le site, de sorte que le système est capable de gérer sans problème un pic de trafic de la taille d'une publicité pour le Super Bowl. La capacité de l'Edge Delivery à absorber des pics de trafic ridicules est déjà légendaire. Demandez à quiconque possède un site EDS qui a mené une grande campagne publicitaire à la télévision.
• Publication d'un aperçu intégré, permettant de prévisualiser un contenu entièrement fonctionnel avant qu'il ne soit mis en ligne. De plus, grâce à l'ensemble des fonctionnalités CI/CD intégrées, chaque BRANCHE de code dispose de son propre environnement de prévisualisation instantanément fourni, ce qui offre une flexibilité exceptionnelle lorsqu'il s'agit de l'UAT au niveau de l'escouade et de la ramification des fonctionnalités.
• Développement de contenu simple basé sur des "blocs": Les services Edge Delivery proposent des pages composées de "blocs", c'est-à-dire d'éléments de contenu tels que des tableaux, des onglets, des accordéons ou des colonnes. Ceux-ci sont ensuite rédigés dans une interface simple de type google-doc.

N'oubliez pas : Edge Delivery n'est PAS un CMS

Edge Delivery est un cadre de développement et un pipeline de livraison proposé dans le cadre de la solution AEM, mais il ne dicte PAS la solution que vous utilisez pour gérer votre contenu, contrôler l'accès aux modifications, déployer des traductions, intégrer des systèmes de gestion des actifs numériques, etc. Par conséquent, il existe un NOMBRE de systèmes entièrement valides et entièrement pris en charge pour la rédaction des publications & sur les services de diffusion Edge, notamment

• Rédaction de documents
• Sharepoint
• Google Docs
• Adobe Experience Manager Universal Editor

Dans certains cas, chacun de ces ensembles d'outils peut s'avérer utile pour le travail à effectuer, et il est important de comprendre les avantages et les inconvénients, les caractéristiques et les limites de chacun d'entre eux. Notez également que TOUS les sites ne sont pas adaptés aux Edge Delivery Services, et que certains peuvent être mieux adaptés à l'AEM traditionnel à l'heure actuelle.

Autre point de clarté dans la nomenclature Edge Delivery :

• "La création de documents ( " ) implique que l'on traite des documents en tant qu'unité primaire de contenu. La rédaction de documents utilise des documents HTML. Sharepoint utilise des documents Word, Google utilise évidemment des documents Google. Contrairement à la rédaction basée sur le JCR, où les documents individuels et leurs métadonnées sont stockés sous forme de nœuds dans le référentiel de contenu Java d'AEM.
• "Helix" = Edge Delivery Services: Cette technologie a connu de nombreux changements de nom, depuis son nom de code initial "Helix" jusqu'aux noms "Franklin" et "Next-Generation Composability". Mais pour l'instant, si vous voyez une référence à "Helix", cela renvoie au bloc Edge Delivery Services dans le diagramme ci-dessous.

Rédaction de documents & Diagramme de l'architecture de diffusion Edge

Avant de plonger dans l'ensemble des fonctionnalités de Document Authoring, examinons d'abord un diagramme d'architecture de l'endroit où DA pourrait se situer dans un exemple de déploiement AEM / Edge Delivery :

Dans l'architecture ci-dessus, le DA joue le rôle de CMS et de surface de création, et de point d'intégration pour les activités de gestion des documents telles que la taxonomie, la gestion des actifs et les traductions. Il n' est généralement PAS le point d'intégration central pour l'intégration des données publiques ou de backend, comme pourrait l'être un auteur AEM traditionnel.

Dans l'architecture ci-dessus, nous supposons que

• Document Authoring est la surface pour la création, la gestion, la publication et le déploiement de traductions de documents web.
• Adobe Edge Delivery Services est le niveau de publication qui prend en charge les documents créés dans Document Authoring et les diffuse dans un format ultra-rapide, réactif et prêt pour le web.
• Adobe Managed CDN fait office de réseau de distribution de contenu, de pare-feu web et de couche de redirection configurable.
• Adobe Experience Manager Assets pour la gestion des ressources web (images, documents et autres fichiers fournis par le site web)
• Hubspot pour les formulaires web et les courriels de confirmation/transactionnels. (Ce rôle pourrait également être rempli par AEM Forms, Marketo Forms ou un grand nombre d'autres fournisseurs de gestion de formulaires).
• Vidyard pour la gestion et la diffusion de vidéos
• La recherche de traductions

Je pourrais (et je le ferai) m'étendre longuement sur la flexibilité de cette configuration et sur la manière dont on peut contourner les exigences en matière de résidence des données et d'accès à des éléments tels que les données sur les produits, les systèmes PIM, les systèmes existants et autres, mais c'est un sujet pour un autre jour.

L'ensemble des fonctionnalités de création de documents (DA)

L'ensemble des fonctionnalités du DA comprend

Gestion de l'arborescence des documents

La gestion du contenu de votre site Edge Delivery se fait à partir de l'interface DA (par opposition à Sharepoint ou à AEM) avec des documents stockés en interne et versionnés dans le nuage. L'interface de gestion et de publication des fichiers de DA permet les copier/coller/déplacer habituels, et contient des appels intégrés à Edge Delivery pour indiquer l'état de la publication/de la révision.

Éditeur de documents & Fiches

DA comprend un éditeur de documents & pour les documents web et les données structurées. L'éditeur est simple et extrêmement rapide. Il comprend un menu de barres obliques pour des fonctions rapides &, une bibliothèque de blocs pour un accès rapide aux blocs (par ex. "Composants" en langage AEM) que vous avez créés dans votre projet.

Le cadre du plugin de l'éditeur pour ajouter d'autres fonctionnalités d'interface utilisateur personnalisées à votre projet. Parmi les plugins que nous avons utilisés, citons un navigateur de balises pour parcourir & et sélectionner des balises AEM à partir d'une instance AEM, ou un sélecteur de date pour saisir des formats de date dans un format attendu dans une interface utilisateur de gestion d'événements.

Collaboration en temps réel

DA inclut une collaboration robuste en temps réel, permettant à un nombre pratiquement illimité d'utilisateurs de modifier simultanément un document. Nous avons fini par tester cela en temps réel lors de la conférence AdaptTo() où j'ai présenté la création de documents. Dans le cadre de mon exposé, j'ai fini par inviter les plus de 200 membres de l'auditoire à se connecter simultanément à un document et à commencer à l'éditer & en le prévisualisant, et le backend de collab a parfaitement tenu le coup - ce qui est plus que ce que l'on peut dire de l'édition dans Office parfois.

Intégration d'AEM Assets

DA comprend l'intégration d'AEM Assets à l'aide du Micro Frontend (MFE) d'AEM Assets. Cela permet aux organisations de continuer à utiliser AEM Assets comme système central d'enregistrement pour la gestion des ressources numériques, tout en donnant aux auteurs la liberté de travailler dans un système Edge Delivery rapide et basé sur les documents.

La mise en œuvre de cette mesure est excellente et c'est vraiment l'une des caractéristiques les plus intéressantes de l'AD.

Version intégrée du document

DA dispose d'un système intégré de gestion des versions des documents et d'un historique des audits. Chaque modification apportée à un document par un utilisateur est auditée avec un horodatage ( & ), et la gestion des points de restauration est effectuée automatiquement chaque fois qu'une page est publiée, ou de manière ad hoc à tout moment où vous souhaitez créer un point de restauration.

Le versionnage est également disponible en masse et par l'intermédiaire de l'API.

Aperçu en direct

DA fournit un aperçu en direct dans la fenêtre d'édition, avec plusieurs tailles d'écran (mobile, tablette, ordinateur de bureau) disponibles.

Outillage en vrac

Il s'agit encore d'une implémentation précoce de cette technologie en accès anticipé, mais DA contient déjà des outils en vrac EXTRÊMEMENT utiles pour la prévisualisation en vrac, la publication en vrac, la réindexation en vrac et la mise en version en vrac.

Combiné à une recherche rapide comme l'éclair ( & replace) dans des arborescences entières de contenu, il est très rapide ( & ) de procéder à des changements massifs et sûrs dans de grandes parties du contenu, puis de les déployer.

Par exemple, dans une sous-section du site contenant environ 4000 pages, j'ai dû remplacer le nom d'un fragment que nous utilisions pour la sous-navigation. Au lieu de demander à un développeur d'écrire un script groovy (comme on le ferait dans le monde AEM), nous avons effectué une recherche & replace dans l'interface utilisateur DA, ce qui a été fait en moins de 8 secondes.

Mieux encore, j'ai pu procéder à une version globale de toute cette section du site, de sorte que je disposais d'une version de sauvegarde instantanée à laquelle revenir en cas de problème avec le remplacement de la recherche &. Encore une fois....L'AIR FRAIS.

Traduction/Rollout et remplacement de "MSM" pour Edge Delivery

L'une des principales raisons pour lesquelles notre client de lancement a choisi DA pour son déploiement Edge Delivery au lieu de Sharepoint/Universal Editor est le cadre de localisation robuste de DA et la fonctionnalité de réintégration de page-rollout &. L'une des principales difficultés liées à la mise en œuvre de sites Edge Delivery localisés avec Google Docs ou Sharepoint (ou même de sites Crosswalk avec Universal Editor) est l'absence d'un cadre établi pour remplacer le gestionnaire multisite (MSM) d'AEM.

Sans connecteur de système de gestion de la traduction (TMS) ni fonctionnalité MSM, toute personne mettant en œuvre un site localisé sur Edge Delivery est obligée de concevoir et de construire son PROPRE flux de travail sur mesure et son propre désastre de brassage de documents pour collecter les documents à traduire, les envoyer au TMS (c.-à-d. le système de gestion de la traduction) et les envoyer au système de gestion de la traduction. Smartling ou Translations.com, etc.), pour les récupérer, traiter les modifications locales et les déployer. Cette seule fonctionnalité pourrait représenter une part importante du travail de développement pour passer à l'Edge Delivery et annuler une grande partie des avantages liés à la rapidité de développement de l'EDS. DA résout ce problème en fournissant un arrangement robuste et TRES flexible pour l'envoi de traductions et pour modifier ensuite les changements locaux lors du rapatriement de ces traductions.

Rédaction & Publication Contrôle d'accès

Le DA contient un modèle ACL robuste pour le contrôle d'accès à la publication &. Edge Delivery peut être un peu intéressant à cet égard, car contrairement à un système unifié comme AEM où la création & la publication fait partie du même système, Edge Delivery est séparé. Si l'on se réfère au diagramme ci-dessus, "Helix" ou Edge Delivery possède son propre système d'autorisation de prévisualisation/publipostage - et n'est PAS à granularité fine. En d'autres termes, vous pouvez pousser le contenu dans la page "aem.page" ou "aem.live" ou pas. Le contrôle d'accès précis (par exemple, seul le groupe "bloggers" peut écrire du contenu dans l'arbre de contenu /blog, mais il ne peut pas le publier - seulement l'écrire - etc.

Ainsi, DA prend en charge à la fois le contrôle d'accès au niveau de la surface de création (à grain fin) et un mécanisme de configuration de la publication protégée dans Helix afin de verrouiller les utilisateurs qui peuvent prévisualiser & et publier du contenu dans Edge Delivery.

OMG la vitesse brute

Le dernier commentaire que je dois faire à propos de DA (qui pourrait très bien être le premier) est que DA est sans aucun doute le CMS le plus rapide que j'ai jamais utilisé. Si vous trouvez un CMS plus rapide, n'hésitez pas à me le faire savoir.

Le temps de chargement des documents, le temps de publication et la rapidité générale de l'interface utilisateur sont inégalés, ce qui s'explique bien sûr par le fait que DA est LUI-MÊME un projet Edge Delivery. Les auteurs d'onboarding du côté client qui utilisent DA en parallèle avec AEM 6.5 sont tous choqués par la rapidité de l'outil. La différence est particulièrement marquée lorsqu'il s'agit de pages complexes qui, dans AEM, contiennent des composants imbriqués ou des dialogues multiples qui prennent tous du temps à se charger à partir du JCR.

Comment obtenir la rédaction de documents

Pour rappel, l'AD est encore une technologie d'accès précoce pour les services de livraison de pointe.

Edge Delivery Services fait partie d'AEM as a Cloud Service et constitue à ce jour une offre unifiée avec AEM as a Cloud Service. Donc, si vous envisagez de passer à l'AEM en tant que service en nuage (ou si vous l'avez déjà), le DA peut être une option pour vous.

Si vous êtes déjà sur un Slack de mise en œuvre avec Adobe, demandez-leur de vous parler de DA et ils vous aideront à démarrer.

Vous pouvez également contacter Adobe Discord, où un canal DA est dédié.

Enfin, n'hésitez pas à nous contacter soit sur le site, soit directement sur Linkedin ou Twitter/X. Je serais ravie de vous faire part de mon expérience en la matière !

Ou bien, venez nous voir à l'Adobe Summit et nous serons ravis de vous faire une démonstration !

Vous avez aimé ce que vous avez entendu ? Vous avez des questions sur ce qui vous convient le mieux ? Nous aimerions en parler ! Contact avec nous

Episodes de podcast & Articles de blog