Introducción a la creación de documentos (DA) para los servicios de entrega perimetral

Existe una nueva tecnología de acceso temprano muy atractiva para administrar los sitios de Edge Delivery Services llamada Document Authoring (un proyecto anteriormente conocido como Dark Alley). Es un soplo de aire fresco para la edición, traducción, almacenamiento y gestión de implementaciones de Edge Delivery, y como arquitecto principal en el primer proyecto de cliente en utilizar esta tecnología, me encantaría explicarle un poco y compartir mis experiencias y pensamientos. Si está evaluando su próximo movimiento para un sitio basado en AEM (o que podría migrar a AEM), DEFINITIVAMENTE debe conocer DA.

¿Qué es la creación de documentos (o DA) para los servicios de entrega perimetral?

Document Authoring o DA (el artista anteriormente conocido como "Project Dark Alley") es una solución integrada ultrarrápida, Edge Delivery Services o Helix-native para administrar, editar y publicar sitios basados en Edge Delivery Services.

DA es actualmente una tecnología de acceso temprano de Adobe, lo que significa que Adobe está co-innovando con socios como nosotros y socios que han elegido este camino. Si en algún momento a lo largo de este artículo dices: "ESTOY EN REGÍSTRATE", desplázate hasta la parte inferior para ver la información de contacto y Slack/Discord.

Para cualquiera que intente comprender dónde encaja DA en un paradigma de infraestructura AEM tradicional o una arquitectura de entrega perimetral cuasi moderna basada en documentos, primero aclaremos algunos términos:

¿Qué son los servicios de entrega periféricos?

Edge Delivery Services de Adobe es un sistema de vanguardia basado en la nube para la entrega de sitios web que toma documentos e imágenes de autor (y algunos videos) y los publica en la web de una manera optimizada para una velocidad de entrega extrema. Edge-Delivery Services desempeña esencialmente la misma función en una arquitectura moderna que los niveles de servidor "Publisher" y "Dispatcher" tradicionales de AEM, y tiene ventajas como:

• Velocidad de entrega MUY rápida : en la comparación consecutiva de AEM tradicional frente a Edge Delivery (a la que me referiré como EDS hasta ahora para ahorrar escribir), las páginas EDS fueron de 3 a 6 veces más rápidas que con AEM 6.5 local.
• La entrega global está integrada en el sistema. (nota: China todavía puede ser un desafío)
• Capacidad de tráfico prácticamente ilimitada : no hay un número determinado de servidores que entreguen el sitio, por lo que el sistema es capaz de manejar incluso un pico del tamaño de un anuncio del Super Bowl sin problemas. La capacidad de Edge Delivery para tragarse picos de tráfico de tamaño ridículo ya es legendaria, pregúntele a cualquiera con un sitio EDS que haya realizado una campaña publicitaria de televisión importante.
• Publicación de vista previa incorporada, para que uno pueda obtener una vista previa del contenido completamente funcional antes de que se publique. No solo esto, sino que debido al conjunto de características de CI/CD incorporado, cada rama de código tiene su propio entorno de vista previa aprovisionado al instante, para una flexibilidad increíble cuando se trata de UAT a nivel de escuadrón y ramificación de funciones.
• Desarrollo de contenido simple basado en "bloques": Los servicios de entrega perimetral sirven páginas que se componen de "bloques" que son elementos de contenido como tablas, pestañas, acordeones o columnas. A continuación, se crean en una sencilla interfaz de estilo google-doc.

Remember: Edge Delivery itself is NOT a CMS

Edge Delivery is a development framework and a delivery pipeline offered as a part of the AEM solution, but it does NOT dictate the solution you use to manage your content, control access to modifications, roll out translations, integrate digital asset management systems, etc. As a result, there are a NUMBER of fully-valid, fully-supported systems for authoring & publishing on Edge Delivery Services, including:

• Document Authoring
• Sharepoint
• Google Docs
• Adobe Experience Manager Universal Editor

There are cases where each of these toolsets could make sense as the tool for the job, and it's important to understand the pros and cons, features and limitations of each one. Note too that not EVERY site is a good fit for Edge Delivery Services, and some may be best for traditional AEM at this point in time.

Como otro punto de claridad en la nomenclatura de Edge Delivery:

• La creación "basada en documentos" implica que se trata de documentos como unidad principal de contenido. La creación de documentos utiliza documentos HTML. Sharepoint usa Word Docs, Google obviamente usa Google Docs. Esto se opone a la creación basada en JCR, donde los documentos individuales y sus metadatos se almacenan como nodos en el repositorio de contenido Java de AEM.
• "Helix" = Edge Delivery Services: Esta tecnología ha pasado por una gran cantidad de cambios de nombre, comenzando desde su nombre en clave original de "Helix" y luego se llamó "Franklin", así como "Next-Generation Composability". Pero en este momento, si ve una referencia a "Helix", se refiere a ese bloque de servicios de entrega periférica en el diagrama a continuación.

Diagrama de arquitectura de creación de documentos y entrega perimetral

Antes de sumergirnos en el conjunto de funciones de la creación de documentos, veamos primero un diagrama de arquitectura de dónde podría ubicarse DA en una implementación de AEM / Edge Delivery de ejemplo:

En la arquitectura anterior, DA desempeña el papel de CMS y superficie de creación, y el punto de integración para las actividades de gestión de documentos, como la taxonomía, la gestión de activos y las traducciones. It is generally NOT the central integration point for backend or public data-integration in the way that a traditional AEM author might be, however.

In the architecture above, we assume:

• Document Authoring is the surface for web document creation, management, publishing and translations rollout
• Adobe Edge Delivery Services as the publishing tier, which takes documents authored in Document Authoring and delivers them out in ultra-fast, responsive, web-ready format
• Adobe Managed CDN como red de distribución de contenido, firewall web y capa de redireccionamiento configurable.
• Adobe Experience Manager Assets for web asset management (images, documents and other files delivered by the website)
• Hubspot for web forms and confirmation/transactional emails. (This role could also be filled by AEM Forms, Marketo Forms, or a host of other form management providers)
• Vidyard for video management and delivery
• Smartling for translations

I could (and will) expend considerable time expounding on the flexibility of this setup, and how one could architect one's way around data residency and access requirements for things like product data, PIM systems, legacy systems and the like, but that's a post for another day.

El conjunto de características de creación de documentos (DA)

El conjunto de características de DA incluye:

Gestión de Árbol de Documentos

La administración de contenido para el sitio de entrega perimetral se realiza desde la interfaz DA (a diferencia de Sharepoint o AEM) con documentos almacenados y versionados internamente en la nube. La interfaz de publicación y administración de archivos de DA permite copiar/pegar/mover normalmente, como cabría esperar, y contiene llamadas incorporadas a Edge Delivery para indicar el estado de publicación/vista previa.

Editor de Documentos y Hojas de Cálculo

DA incluye un editor de documentos y un editor de hojas para documentos web, así como datos estructurados. El editor es sencillo y increíblemente rápido, incluyendo un menú de barra diagonal para funciones y formatos rápidos, una biblioteca de bloques para un acceso rápido a los bloques (p. ej. "Componentes" en la antigua expresión AEM) que ha creado en su proyecto.

El marco del complemento del editor para agregar otras funciones de interfaz de usuario personalizadas a su proyecto. Algunos de estos complementos que hemos puesto en uso son un explorador de etiquetas para explorar y seleccionar etiquetas AEM de una instancia de AEM, o un selector de fecha para ingresar formatos de fecha en un formato esperado en una interfaz de usuario de administración de eventos.

Colaboración en tiempo real

DA incluye una sólida colaboración en tiempo real, lo que permite que prácticamente cualquier número de usuarios edite un documento simultáneamente. De hecho, terminamos probando esto en tiempo real en la conferencia AdaptTo() donde di una charla sobre la creación de documentos. Como parte de la charla, terminé invitando a los 200+ miembros de la audiencia a iniciar sesión en un documento simultáneamente y comenzar a editar y previsualizar en él, y el backend de la colaboración se mantuvo perfectamente, que es más de lo que se puede decir de la edición en Office a veces.

Integración de AEM Assets

DA incluye la integración integrada de AEM Assets mediante AEM Assets Micro Frontend (MFE). Esto permite a la organización seguir utilizando AEM Assets como su sistema central de registro para la administración de recursos digitales, al tiempo que proporciona a los autores la libertad de trabajar en un sistema de entrega perimetral rápido y basado en documentos.

La implementación de esto es A + y es realmente una de las características asesinas de DA.

Control de versiones de documentos integrado

DA tiene un historial de auditorías y control de versiones de documentos incorporado. Cada edición realizada en un documento por cualquier usuario se audita con una marca de fecha y tiempo, y el control de versiones del punto de restauración se realiza automáticamente cada vez que se publica una página, o ad-hoc en cualquier punto en el que desee cortar un punto de restauración.

El control de versiones también está disponible de forma masiva y a través de la API.

Vista previa en vivo

DA proporciona una vista previa en vivo en la ventana de edición, con varios tamaños de pantalla (móvil, tableta, escritorio) disponibles.

Utillaje a granel

Todavía es una implementación temprana de esta tecnología de acceso temprano, pero DA ya contiene herramientas masivas EXTREMADAMENTE útiles para la vista previa masiva, la publicación masiva, la reindexación masiva y el control de versiones masivo.

Esto, combinado con la búsqueda y reemplazo a toda velocidad en árboles enteros de contenido, es muy rápido y factible para realizar cambios seguros y masivos en grandes franjas de contenido, y luego implementarlos.

Por ejemplo, en una subsección del sitio que contenía alrededor de 4000 páginas, tuve que reemplazar el nombre de un fragmento que estábamos usando para la subnavegación. En lugar de tener que pedirle a un desarrollador que escribiera un script genial (como se haría en el mundo de AEM), buscamos y reemplazamos en la interfaz de usuario de DA, que se completó todo en cuestión de menos de 8 segundos.

Aún mejor, pude hacer una versión masiva de toda esa sección del sitio primero, por lo que tenía una versión de respaldo instantánea a la que volver, en caso de que algo saliera mal con la búsqueda y reemplazo. Otra vez.... UN SOPLO DE AIRE FRESCO.

Traducción/Implementación y un reemplazo de "MSM" para Edge Delivery

Una gran razón por la que nuestro cliente de lanzamiento seleccionó DA para su implementación de Edge Delivery en lugar de Sharepoint/Universal Editor es el sólido marco de localización de DA y la funcionalidad de implementación y reintegración de páginas. Un desafío importante con la implementación de sitios de entrega perimetral localizados con Google Docs o Sharepoint (o incluso sitios Crosswalk con Universal Editor) es la falta de un marco establecido para reemplazar el administrador de varios sitios (MSM) de AEM.

Sin un conector de sistema de gestión de traducciones (TMS) y la funcionalidad de MSM que aprovechar, cualquiera que implemente un sitio localizado en Edge Delivery se ve obligado a diseñar y construir su propio flujo de trabajo a medida y el desastre de barajado de documentos para recopilar documentos para su traducción, enviarlos al TMS (es decir, enviarlos al TMS). Smartling o Translations.com etc), para recuperarlos, procesar los cambios locales y desplegarlos. Solo esa funcionalidad podría representar una parte masiva del trabajo de desarrollo para pasar a Edge Delivery y anular gran parte del beneficio de la rapidez con la que se desarrolla EDS. DA resuelve esto proporcionando un acuerdo sólido y MUY flexible para el envío de traducciones y para luego diferenciar cualquier cambio local al traer esas traducciones de vuelta.

Control de acceso de creación y publicación

DA contiene un modelo de ACL robusto para el control de acceso de publicación y creación. Edge Delivery puede ser un poco interesante en este sentido, ya que, a diferencia de un sistema unificado como AEM, donde la creación y la publicación forman parte del mismo sistema, Edge Delivery es independiente. Refiriéndose al diagrama anterior, "Helix" o Edge Delivery tiene su propio sistema de permisos de vista previa/publicación, y NO es de grano fino. Es decir, puede empujar el contenido al "aem.page" o "aem.live" cubos o no se puede. Control de acceso detallado (como que solo el grupo "bloggers" puede escribir contenido en el árbol de contenido /blog, pero no pueden publicarlo, solo escribir, etc.), eso depende de la superficie de creación para implementar.

Por lo tanto, DA tiene soporte tanto para el control de acceso a nivel de superficie de creación (detallado) como para un mecanismo para configurar la publicación protegida en Helix para bloquear qué usuarios pueden obtener una vista previa y publicar contenido en Edge Delivery.

Dios mío, la velocidad bruta

El último comentario que debo hacer sobre DA (que bien podría ser el primero) es que DA es sin duda el CMS más rápido que he usado. Si puedes encontrar un CMS más rápido, por favor házmelo saber.

El tiempo de carga de documentos, el tiempo de publicación y la agilidad general de la interfaz de usuario son inigualables, derivado, por supuesto, del hecho de que DA es en sí mismo un proyecto de entrega perimetral. Los autores de incorporación del lado del cliente que utilizan DA de forma consecutiva con AEM 6.5 se sorprenden uniformemente por la rapidez que es. La diferencia es especialmente marcada cuando se trata de páginas complejas que en AEM contienen componentes anidados o varios cuadros de diálogo que tardan en cargarse fuera del JCR.

Cómo obtener la creación de documentos

Para reiterar, DA sigue siendo una tecnología de acceso temprano para los servicios de entrega periférica.

Los propios servicios de entrega perimetral forman parte de AEM as a Cloud Service y, a partir de este momento, son una oferta unificada con AEM as a Cloud Service. Por lo tanto, si está considerando pasar a AEM as a Cloud Service (o si ya lo tiene), DA puede ser una opción para usted.

Si ya estás en una implementación de Slack con Adobe, pregúntales sobre DA y te pondrán en marcha.

También puedes ponerte en contacto con el Discord de Adobe, donde hay un canal dedicado a DA.

Por último, póngase en contacto con nosotros en el sitio o directamente en Linkedin o Twitter/X. ¡Me encantaría contarte mis experiencias con esto!

O ven a vernos a Adobe Summit y nos ENCANTARÍA darte una demostración.

¿Te gustó lo que escuchaste? ¿Tiene preguntas sobre lo que es adecuado para usted? ¡Nos encantaría hablar! Contáctenos

Episodios de podcast y publicaciones de blog