Introduzione alla creazione di documenti per i servizi di recapito edge

Esiste una nuova tecnologia di accesso anticipato altamente convincente per gestire i siti di Edge Delivery Services chiamata Document Authoring (un progetto precedentemente noto come Dark Alley). Si tratta di una boccata d'aria fresca per l'editing, la traduzione, l'archiviazione e la gestione delle implementazioni di Edge Delivery e, in qualità di architetto principale del primo progetto del cliente che utilizza questa tecnologia, mi piacerebbe illustrarvi un po' e fornirvi le mie esperienze e i miei pensieri. Se stai valutando la tua prossima mossa per un sito basato su AEM (o che potrebbe migrare ad AEM), dovresti ASSOLUTAMENTE conoscere DA.

Che cos'è l'authoring dei documenti (o DA) per i servizi di distribuzione Edge?

Document Authoring o DA (l'artista precedentemente noto come "Project Dark Alley") è una soluzione integrata velocissima, Edge Delivery Services o Helix-native, per la gestione, l'editing e la pubblicazione di siti basati su Edge Delivery Services.

DA è attualmente una tecnologia ad accesso anticipato di Adobe, il che significa che Adobe sta attualmente collaborando con partner come noi e partner che hanno scelto questo percorso. Se in qualsiasi momento lungo questo articolo ti chiedi, "SONO IN ISCRIVIMI", scorri fino in fondo per Slack / Discord e le informazioni di contatto.

Per chiunque cerchi di capire dove si inserisce DA in un paradigma di infrastruttura AEM tradizionale o in un'architettura Edge Delivery basata su documenti quasi moderna, togliamo di mezzo alcuni termini:

Che cosa sono i servizi di consegna Edge?

Edge Delivery Services di Adobe è un sistema all'avanguardia basato su cloud per la distribuzione di siti Web che prende documenti e immagini creati (e alcuni video) e li pubblica sul Web in modo ottimizzato per una velocità di consegna estrema. Edge Delivery Services ricopre essenzialmente lo stesso ruolo in un'architettura moderna dei tradizionali livelli di server AEM "Publisher" e "Dispatcher" e presenta vantaggi quali:

• Velocità di consegna MOLTO elevata : nel confronto back-to-back tra AEM tradizionale e Edge Delivery (che d'ora in poi chiamerò EDS per risparmiare la digitazione), le pagine EDS erano 3x-6x più veloci rispetto a AEM 6.5 on-premise.
• La consegna globale è integrata nel sistema. (nota: la Cina può ancora essere una sfida)
• Capacità di traffico praticamente illimitata : non esiste un numero prestabilito di server che forniscono il sito, quindi il sistema è in grado di gestire senza problemi anche un picco di dimensioni pubblicitarie del Super Bowl. La capacità di Edge Delivery di ingoiare picchi di traffico di dimensioni ridicole è già leggendaria, chiedete a chiunque abbia un sito EDS che abbia eseguito un'importante campagna pubblicitaria televisiva.
• Pubblicazione di anteprima integrata, in modo da poter visualizzare in anteprima i contenuti completamente funzionanti prima che vengano pubblicati. Non solo, ma grazie al set di funzionalità CI/CD integrato, ogni ramo di codice ha il proprio ambiente di anteprima con provisioning istantaneo, per una flessibilità pazzesca quando si tratta di UAT a livello di squadra e diramazione delle funzionalità.
• Semplice sviluppo di contenuti basato su "blocchi": i servizi Edge Delivery servono pagine composte da "blocchi" che sono elementi di contenuto come tabelle, schede, fisarmoniche o colonne. Questi vengono poi creati in una semplice interfaccia in stile google-doc.

Ricorda: Edge Delivery in sé NON è un CMS

Edge Delivery è un framework di sviluppo e una pipeline di distribuzione offerti come parte della soluzione AEM, ma NON determina la soluzione utilizzata per gestire i contenuti, controllare l'accesso alle modifiche, implementare le traduzioni, integrare i sistemi di gestione delle risorse digitali, ecc. Di conseguenza, esiste un numero di sistemi completamente validi e completamente supportati per l'authoring e la pubblicazione su Edge Delivery Services, tra cui:

• Creazione di documenti
• Visualizzazione di Sharepoint
• Documenti Google
• Adobe Experience Manager Universal Editor

Ci sono casi in cui ognuno di questi set di strumenti potrebbe avere senso come strumento per il lavoro, ed è importante comprendere i pro e i contro, le caratteristiche e i limiti di ciascuno di essi. Tieni inoltre presente che non TUTTI i siti sono adatti per i servizi di distribuzione Edge e alcuni potrebbero essere i migliori per AEM tradizionale in questo momento.

Come altro punto di chiarezza nella nomenclatura Edge Delivery:

• L'authoring "basato sui documenti" implica che si ha a che fare con i documenti come unità primaria di contenuto. L'authoring dei documenti utilizza documenti HTML. Sharepoint utilizza i documenti di Word, Google ovviamente utilizza i documenti di Google. Ciò è a differenza dell'authoring basato su JCR, in cui i singoli documenti e i relativi metadati vengono memorizzati come nodi nell'archivio di contenuti Java AEM.
• "Helix" = Edge Delivery Services: questa tecnologia ha subito una serie di modifiche al nome, a partire dal suo nome in codice originale di "Helix" e poi è stata chiamata "Franklin" e "Next-Generation Composability". Ma in questo momento, se vedi un riferimento a "Helix", si riferisce a quel blocco Edge Delivery Services nel diagramma seguente.

Diagramma dell'architettura di creazione dei documenti e distribuzione edge

Prima di addentrarci nel set di funzioni di Document Authoring, diamo un'occhiata a un diagramma dell'architettura in cui potrebbe trovarsi DA in un esempio di distribuzione AEM/Edge Delivery:

Nell'architettura di cui sopra, DA svolge il ruolo di CMS e superficie di authoring, nonché il punto di integrazione per le attività di gestione dei documenti come la tassonomia, la gestione delle risorse e le traduzioni. In genere NON è il punto di integrazione centrale per il back-end o l'integrazione dei dati pubblici nel modo in cui potrebbe essere un autore AEM tradizionale.

Nell'architettura precedente, assumiamo:

• Document Authoring è la piattaforma per la creazione, la gestione, la pubblicazione e l'implementazione delle traduzioni di documenti Web
• Adobe Edge Delivery Services come livello di pubblicazione, che prende i documenti creati in Document Authoring e li distribuisce in un formato ultraveloce, reattivo e pronto per il Web
• Adobe Managed CDN come rete di distribuzione dei contenuti, firewall Web e livello di reindirizzamento configurabile.
• Adobe Experience Manager Assets per la gestione delle risorse web (immagini, documenti e altri file forniti dal sito web)
• Hubspot per moduli web ed e-mail di conferma/transazionali. Questo ruolo può essere ricoperto anche da AEM Forms, Marketo Forms o da una serie di altri fornitori di servizi di gestione dei moduli.
• Vidyard per la gestione e la consegna dei video
• Smartling per le traduzioni

Potrei (e lo farò) dedicare molto tempo a spiegare la flessibilità di questa configurazione e come si potrebbe progettare la propria strada intorno ai requisiti di residenza e accesso ai dati per cose come i dati di prodotto, i sistemi PIM, i sistemi legacy e simili, ma questo è un post per un altro giorno.

Set di funzionalità di creazione di documenti

Il set di funzionalità DA include:

Gestione dell'albero dei documenti

La gestione dei contenuti per il sito di distribuzione Edge viene eseguita dall'interfaccia DA (anziché da SharePoint o da AEM) con i documenti archiviati internamente e con controllo delle versioni nel cloud. L'interfaccia di gestione e pubblicazione dei file di DA consente il normale copia/incolla/spostamento come ci si aspetterebbe e contiene chiamate integrate a Edge Delivery per indicare lo stato di pubblicazione/anteprima.

Editor per Documenti e Fogli

DA include un editor di documenti e un editor di fogli per documenti Web e dati strutturati. L'editor è senza fronzoli e incredibilmente veloce, include un menu a barre per funzioni e formattazione rapide, una libreria di blocchi per un rapido accesso ai blocchi (ad es. "Componenti" nel vecchio linguaggio AEM) che hai creato nel tuo progetto.

Il framework del plug-in dell'editor per l'aggiunta di altre funzionalità dell'interfaccia utente personalizzate al progetto. Alcuni di questi plug-in che abbiamo messo in uso sono un browser di tag per sfogliare e selezionare i tag AEM da un'istanza AEM, o un selettore di data per inserire i formati di data in un formato previsto in un'interfaccia utente di gestione degli eventi.

Collaborazione in tempo reale

DA include una solida collaborazione in tempo reale, consentendo praticamente a qualsiasi numero di utenti di modificare contemporaneamente un documento. In realtà abbiamo finito per testarlo in tempo reale alla conferenza AdaptTo() dove ho tenuto un discorso introducendo l'authoring dei documenti. Come parte del discorso, ho finito per invitare tutti i 200+ membri del pubblico ad accedere a un documento contemporaneamente e iniziare a modificarlo e visualizzarlo in anteprima, e il backend di collaborazione ha retto perfettamente, il che è più di quanto si possa dire per l'editing in Office a volte.

Integrazione di AEM Assets

DA include l'integrazione integrata di AEM Assets tramite AEM Assets Micro Frontend (MFE). Ciò consente all'organizzazione di continuare a utilizzare AEM Assets come sistema di registrazione centrale per la gestione delle risorse digitali, offrendo al contempo agli autori la libertà di lavorare in un sistema di distribuzione Edge veloce e basato su documenti.

L'implementazione su questo è A+ ed è davvero una delle caratteristiche killer di DA.

Controllo delle versioni dei documenti integrato

DA dispone di una cronologia di controllo e controllo delle versioni dei documenti incorporata. Ogni modifica apportata a un documento da qualsiasi utente viene verificata con una data e un timestamp e il controllo delle versioni del punto di ripristino viene eseguito automaticamente ogni volta che viene pubblicata una pagina o ad hoc in qualsiasi punto in cui si desidera tagliare un punto di ripristino.

Il controllo delle versioni è disponibile anche in blocco e tramite l'API.

Anteprima dal vivo

DA fornisce un'anteprima dal vivo nella finestra di modifica, con diverse dimensioni dello schermo (cellulare, tablet, desktop) disponibili.

Utensili sfusi

Si tratta ancora di un'implementazione iniziale di questa tecnologia di accesso anticipato, ma DA contiene già strumenti di massa ESTREMAMENTE utili per l'anteprima di massa, la pubblicazione di massa, la reindicizzazione di massa e il controllo delle versioni di massa.

Questo, combinato con la ricerca e la sostituzione velocissime su interi alberi di contenuti, è molto veloce e praticabile per apportare modifiche sicure e di massa su grandi quantità di contenuti, e poi implementarle.

Ad esempio, in una sottosezione del sito contenente circa 4000 pagine, ho dovuto sostituire il nome di un frammento che stavamo utilizzando per la navigazione secondaria. Invece di dover chiedere a uno sviluppatore di scrivere uno script groovy (come si farebbe nel mondo AEM) abbiamo fatto search & replace nell'interfaccia utente DA, che ha completato tutto in meno di 8 secondi.

Ancora meglio, sono stato in grado di eseguire prima la versione di massa dell'intera sezione del sito, quindi ho avuto una versione di backup istantanea a cui tornare, nel caso qualcosa fosse andato storto con la ricerca e la sostituzione. Di nuovo.... UNA BOCCATA D'ARIA FRESCA.

Traduzione/Rollout e sostituzione "MSM" per Edge Delivery

Uno dei motivi principali per cui il nostro cliente di lancio ha scelto DA per l'implementazione di Edge Delivery invece di Sharepoint/Universal Editor è il solido framework di localizzazione e la funzionalità di rollout e reintegrazione delle pagine di DA. Una delle principali sfide con l'implementazione di siti Edge Delivery localizzati con Google Docs o Sharepoint (o anche siti Crosswalk con Universal Editor) è la mancanza di un framework consolidato per sostituire il multi-site manager (MSM) di AEM.

Senza un connettore del sistema di gestione delle traduzioni (TMS) e una funzionalità MSM a cui attingere, chiunque implementi un sito localizzato su Edge Delivery è costretto a progettare e costruire il proprio flusso di lavoro su misura e il disastro del rimescolamento dei documenti per raccogliere i documenti da tradurre e spedirli al TMS (ad es. Smartling o Translations.com ecc.), per recuperarli, elaborare le modifiche locali e implementarle. Solo questa funzionalità da sola potrebbe rappresentare una parte enorme del lavoro di sviluppo per passare a Edge Delivery e annullare gran parte dei vantaggi della velocità di sviluppo di EDS. DA risolve questo problema fornendo un accordo robusto e MOLTO flessibile per la spedizione delle traduzioni e per poi differenziare eventuali modifiche locali quando si ripristinano tali traduzioni.

Controllo dell'accesso all'authoring e alla pubblicazione

DA contiene un robusto modello ACL per il controllo degli accessi di pubblicazione e authoring. Edge Delivery può essere un po' interessante a questo proposito, poiché a differenza di un sistema unificato come AEM in cui l'authoring e la pubblicazione fanno tutti parte dello stesso sistema, Edge Delivery è separato. Facendo riferimento al diagramma precedente, "Helix" o Edge Delivery ha un proprio sistema di autorizzazione di anteprima/pubblicazione e NON è a grana fine. Ciò significa che puoi inserire i contenuti nel "aem.page" o "aem.live" secchi o non puoi. Controllo granulare degli accessi (ad esempio solo il gruppo "blogger" può scrivere contenuti nell'albero dei contenuti /blog, ma non possono pubblicarli solo scrivere - ecc.), che spetta alla superficie di authoring implementare.

Pertanto, DA supporta sia il controllo degli accessi a livello di superficie di authoring (granulare finemente) sia un meccanismo per la configurazione della pubblicazione protetta in Helix per bloccare gli utenti che possono visualizzare in anteprima e pubblicare i contenuti su Edge Delivery.

OMG la velocità pura

L'ultimo commento che dovrei fare su DA (che potrebbe benissimo essere il primo) è che DA è senza dubbio il CMS più veloce che abbia mai usato. Se riesci a trovare un CMS più veloce, per favore fammelo sapere.

Il tempo di caricamento dei documenti, il tempo di pubblicazione e la rapidità complessiva dell'interfaccia utente non hanno eguali, derivanti ovviamente dal fatto che DA è ESSO stesso un progetto Edge Delivery. Gli autori di onboarding dal lato client che utilizzano DA back-to-back con AEM 6.5 sono costantemente scioccati dalla sua velocità. La differenza è particolarmente evidente quando si tratta di pagine complesse che in AEM contengono componenti nidificati o di più finestre di dialogo che richiedono tempo per essere caricate dal JCR.

Come ottenere l'authoring dei documenti

Per ribadire, DA è ancora una tecnologia ad accesso anticipato per i servizi di consegna edge.

Edge Delivery Services stesso fa parte di AEM as a Cloud Service e, a partire da questo momento, è un'offerta unificata con AEM as a Cloud Service. Quindi, se stai pensando di passare a AEM as a Cloud Service (o se lo hai già), DA potrebbe essere un'opzione per te.

Se hai già implementato Slack con Adobe, chiedi loro informazioni su DA e ti aiuteranno a iniziare.

Puoi anche contattare Adobe Discord, dove c'è un canale DA dedicato.

Infine, contattateci sul sito o direttamente su Linkedin o Twitter/X. Mi piacerebbe raccontarvi le mie esperienze con questo!

Oppure, vieni a trovarci all'Adobe Summit e ci piacerebbe darti una demo!

Ti piace quello che hai sentito? Hai domande su cosa è giusto per te? Ci piacerebbe parlare! Contattaci

Episodi di podcast e post del blog