Uma introdução à criação de documentos (DA) para serviços de entrega de borda

Há uma tecnologia nova, altamente atraente e de acesso antecipado para gerenciar sites do Edge Delivery Services chamada Document Authoring (um projeto anteriormente conhecido como Dark Alley). É uma lufada de ar fresco para a edição, tradução, armazenamento e gerenciamento das implementações do Edge Delivery e, como arquiteto líder do primeiro projeto de cliente a usar essa tecnologia, adoraria explicar um pouco sobre isso e contar minhas experiências e ideias. Se você está avaliando sua próxima mudança para um site baseado no AEM (ou que pode migrar para o AEM), você DEFINITIVAMENTE deve conhecer o DA.

O que é criação de documentos (ou DA) para Edge Delivery Services?

Document Authoring ou DA (o artista anteriormente conhecido como " Project Dark Alley ") é uma solução integrada extremamente rápida, nativa do Edge Delivery Services ou Helix, para gerenciar, editar e publicar sites com base no Edge Delivery Services.

Atualmente, o DA é uma tecnologia de acesso antecipado da Adobe, o que significa que a Adobe está atualmente inovando com parceiros como nós e parceiros que escolheram esse caminho. Se em algum momento deste artigo você disser: " I'M IN SIGN ME UP ", vá até o final para ver as informações de contato do Slack/Discord &.

Para quem está tentando entender onde o DA se encaixa em um paradigma tradicional de infraestrutura de AEM ou em uma arquitetura quase moderna de entrega de borda baseada em documentos, vamos primeiro esclarecer alguns termos:

O que é o Edge Delivery Services?

O Adobe Edge Delivery Services é um sistema de ponta baseado em nuvem para entrega de sites que pega imagens & de documentos de autoria (e alguns vídeos) e os publica na web de maneira otimizada para uma velocidade de entrega extrema. O Edge Delivery Services desempenha essencialmente a mesma função em uma arquitetura moderna que as camadas tradicionais de servidores “Publisher” e “Dispatcher” do AEM, e tem vantagens como:

• Velocidade de entrega MUITO rápida - na comparação consecutiva do AEM tradicional com o Edge Delivery (que até agora chamarei de EDS para economizar digitação), as páginas do EDS foram 3 a 6 vezes mais rápidas do que com o AEM 6.5 local.
• A entrega global está incorporada ao sistema. (nota: a China ainda pode ser um desafio)
• Capacidade de tráfego praticamente ilimitada - não há um número definido de servidores entregando o site, então o sistema é capaz de lidar com até mesmo um pico do tamanho de um anúncio do Super Bowl sem problemas. A capacidade do Edge Delivery de engolir picos de tráfego ridículos já é lendária, pergunte a qualquer pessoa com um site da EDS que já realizou uma grande campanha publicitária de TV.
• Publicação prévia integrada, para que você possa visualizar o conteúdo totalmente funcional antes que ele seja publicado. Além disso, devido ao conjunto de recursos de CI/CD incorporado, cada BRANCH de código tem seu próprio ambiente de visualização provisionado instantaneamente, para uma flexibilidade incrível quando se trata de UAT em nível de equipe e ramificação de recursos.
• Desenvolvimento simples de conteúdo baseado em “blocos”: os serviços Edge Delivery atendem páginas compostas por “Blocos”, que são elementos de conteúdo como tabelas, guias, acordeões ou colunas. Em seguida, eles são criados em uma interface simples no estilo google-doc.

Lembre-se: o Edge Delivery em si NÃO é um CMS

O Edge Delivery é uma estrutura de desenvolvimento e um pipeline de entrega oferecidos como parte da solução AEM, mas NÃO determina a solução que você usa para gerenciar seu conteúdo, controlar o acesso a modificações, implementar traduções, integrar sistemas de gerenciamento de ativos digitais etc. Como resultado, há vários sistemas totalmente válidos e totalmente compatíveis para criar a publicação & no Edge Delivery Services, incluindo:

• Criação de documentos
• Sharepoint
• Documentos do Google
• Editor universal do Adobe Experience Manager

Há casos em que cada um desses conjuntos de ferramentas pode fazer sentido como a ferramenta para o trabalho, e é importante entender os prós e os contras, os recursos e as limitações de cada um. Observe também que nem TODOS os sites são adequados para o Edge Delivery Services, e alguns podem ser os melhores para o AEM tradicional no momento.

Como outro ponto de clareza na nomenclatura Edge Delivery:

• " A criação de " baseada em documentos implica que se está lidando com documentos como a principal unidade de conteúdo. A criação de documentos usa documentos HTML. O Sharepoint usa documentos do Word, o Google obviamente usa o Google Docs. Isso se opõe à criação baseada em JCR, em que os documentos individuais e seus metadados são armazenados como nós no AEM Java Content Repository.
• " Helix " = Edge Delivery Services: Essa tecnologia passou por uma série de mudanças de nome, começando pelo codinome original " Helix " e depois sendo chamada de " Franklin " e " Next-Generation Composibilidade ". Mas agora, se você ver uma referência ao " Helix ", está se referindo ao bloco do Edge Delivery Services no diagrama abaixo.

Criação de documentos & Diagrama da arquitetura Edge Delivery

Antes de mergulhar no conjunto de recursos da criação de documentos, vamos primeiro examinar um diagrama de arquitetura de onde o DA poderia se posicionar em um exemplo de implantação do AEM/Edge Delivery:

Na arquitetura acima, o DA desempenha o papel de CMS e da superfície de criação e é o ponto de integração para atividades de gerenciamento de documentos, como taxonomia, gerenciamento de ativos e traduções. No entanto, geralmente NÃO é o ponto central de integração para back-end ou integração de dados públicos da mesma forma que um autor tradicional do AEM poderia ser.

Na arquitetura acima, assumimos:

• A criação de documentos é a superfície para criação, gerenciamento, publicação e implantação de traduções de documentos na Web
• Adobe Edge Delivery Services como camada de publicação, que pega documentos criados na Autoria de Documentos e os entrega em formato ultrarrápido, responsivo e pronto para a Web
• Adobe Managed CDN como rede de distribuição de conteúdo, firewall da web e camada de redirecionamento configurável.
• Adobe Experience Manager Assets para gerenciamento de ativos da web (imagens, documentos e outros arquivos fornecidos pelo site)
• Hubspot para formulários da web e e-mails de confirmação/transacionais. (Essa função também pode ser preenchida pelo AEM Forms, pelo Marketo Forms ou por uma série de outros provedores de gerenciamento de formulários)
• Vidyard para gerenciamento e entrega de vídeo
• Smartling para traduções

Eu poderia (e vou) dedicar um tempo considerável explicando a flexibilidade dessa configuração e como contornar os requisitos de residência e acesso de dados para coisas como dados de produtos, sistemas PIM, sistemas legados e afins, mas isso é uma postagem para outro dia.

O conjunto de recursos de criação de documentos (DA)

O conjunto de recursos do DA inclui:

Gerenciamento da árvore de documentos

O gerenciamento de conteúdo do seu site Edge Delivery é feito na interface do DA (em oposição ao Sharepoint ou no AEM) com documentos armazenados internamente e versionados na nuvem. A interface de gerenciamento e publicação de arquivos do DA permite copiar/colar/mover normalmente conforme o esperado e contém chamadas embutidas para o Edge Delivery para indicar o status de publicação/visualização.

Editor de documentos & Sheets

O DA inclui um editor de documentos & editor de folhas para documentos da web, bem como dados estruturados. O editor é simples e incrivelmente rápido, incluindo um menu de barras para funções rápidas, formatação &, uma biblioteca de blocos para acesso rápido aos blocos (i.e. " Componentes " (na linguagem antiga do AEM) que você criou em seu projeto.

A estrutura do plugin do editor para adicionar outros recursos de interface de usuário personalizados ao seu projeto. Alguns desses plug-ins que usamos são um navegador de tags para navegar em & escolhendo tags do AEM de uma instância do AEM ou um seletor de data para inserir formatos de data em um formato esperado em uma interface de gerenciamento de eventos.

COLABORAÇÃO EM TEMPO REAL

O DA inclui colaboração robusta em tempo real, permitindo que praticamente qualquer número de usuários edite simultaneamente um documento. Na verdade, acabamos testando isso em tempo real na conferência adaptTo (), onde fiz uma palestra sobre a criação de documentos. Como parte da palestra, acabei convidando todos os mais de 200 membros da platéia a entrarem em um documento simultaneamente e começarem a editar a pré-visualização &, e o backend da colaboração funcionou perfeitamente — o que às vezes é mais do que você pode dizer sobre edição no Office.

Integração com o AEM Assets

O DA inclui a integração integrada do AEM Assets usando o AEM Assets Micro Frontend (MFE). Isso permite que a organização continue usando o AEM Assets como seu sistema central de registro para gerenciamento de ativos digitais, além de dar aos autores a liberdade de trabalhar em um sistema de entrega de borda rápido e baseado em documentos.

A implementação disso é A+ e é realmente um dos recursos mais importantes do DA.

Controle de versão de documentos incorporado

O DA tem controle de versão de documentos e histórico de auditoria integrados. Cada edição feita em um documento por qualquer usuário é auditada com um carimbo de data/hora &, e o controle de versão do ponto de restauração é feito automaticamente sempre que uma página é publicada, ou ad-hoc em qualquer ponto em que você queira cortar um ponto de restauração.

O controle de versão também está disponível em massa e por meio da API.

Pré-visualização ao vivo

O DA fornece uma visualização ao vivo na janela de edição, com vários tamanhos de tela (celular, tablet, desktop) disponíveis.

Ferramentas a granel

Ainda é uma implementação inicial dessa tecnologia de acesso antecipado, mas o DA já contém ferramentas em massa EXTREMAMENTE úteis para visualização em massa, publicação em massa, reindexação em massa e controle de versão em massa.

Isso, combinado com a rápida substituição da busca & em árvores inteiras de conteúdo, é muito rápido que & é viável para fazer mudanças seguras e em massa em grandes áreas de conteúdo e, em seguida, implementá-las.

Por exemplo, em uma subseção do site contendo cerca de 4000 páginas, tive que substituir o nome de um fragmento que estávamos usando para subnavegação. Em vez de precisar que um desenvolvedor escrevesse um script bacana (como se faria no mundo do AEM), pesquisamos & replace na interface do usuário do DA, que concluiu tudo em menos de 8 segundos.

Melhor ainda, consegui primeiro criar uma versão em massa de toda a seção do site, então tive uma versão de backup instantâneo para a qual reverter, caso algo desse errado com a substituição da pesquisa &. Mais uma vez... LUFADA DE AR FRESCO.

Tradução/lançamento e um substituto " do MSM " para o Edge Delivery

Um grande motivo pelo qual nosso cliente lançador selecionou o DA para o lançamento do Edge Delivery em vez do Sharepoint/Universal Editor é a estrutura robusta de localização da DA e a funcionalidade de reintegração & do lançamento de páginas. Um grande desafio na implementação de sites localizados do Edge Delivery com o Google Docs ou o Sharepoint (ou mesmo sites Crosswalk com o Universal Editor) é a falta de uma estrutura estabelecida para substituir o gerenciador de vários sites (MSM) do AEM.

Sem um conector de sistema de gerenciamento de tradução (TMS) e a funcionalidade MSM para acessar, qualquer pessoa que implemente um site localizado no Edge Delivery é forçada a projetar e criar seu próprio fluxo de trabalho personalizado e a confusão de documentos para coletar documentos para tradução e enviá-los para o TMS (i.e. Smartling ou Translations.com etc.), para recuperá-los, processar alterações locais e implementá-las. Só essa funcionalidade pode representar uma grande parte do trabalho de desenvolvimento para migrar para o Edge Delivery e anular muitos dos benefícios da rapidez com que o EDS se desenvolve. A DA resolve isso fornecendo um arranjo robusto e MUITO flexível para enviar traduções e, em seguida, diferenciar quaisquer alterações locais ao trazer essas traduções de volta.

Autoria & Publishing Access Control

O DA contém um modelo de ACL robusto para o controle de acesso de autoria da publicação &. O Edge Delivery pode ser um pouco interessante nesse aspecto, pois, diferentemente de um sistema unificado como o AEM, em que a publicação & da autoria faz parte do mesmo sistema, o Edge Delivery é separado. Referindo-se ao diagrama acima, " Helix " ou Edge Delivery tem seu próprio sistema de permissão de visualização/publicação - e NÃO é refinado. Ou seja, você pode enviar conteúdo para a página " aem." ou " aem.live " baldes ou você não pode. Controle de acesso refinado (como apenas o grupo " bloggers " pode escrever conteúdo na árvore de conteúdo /blog, mas eles não podem publicá-lo, apenas escrever - etc.), que cabe à superfície de criação implementar.

Portanto, o DA tem suporte tanto para o controle de acesso em nível de superfície de criação (refinado) quanto para um mecanismo para configurar a publicação protegida no Helix para bloquear quais usuários podem visualizar o conteúdo de publicação & no Edge Delivery.

Meu Deus, a velocidade bruta

O último comentário que devo fazer sobre o DA (que poderia muito bem ser o primeiro) é que o DA é sem dúvida o CMS mais rápido que já usei. Se você puder encontrar um CMS mais rápido, por favor me avise.

O tempo de carregamento do documento, o tempo de publicação e a rapidez geral da interface do usuário são incomparáveis, decorrentes, é claro, do fato de que o DA é em si um projeto Edge Delivery. Autores de integração do lado do cliente que usam o DA consecutivamente com o AEM 6.5 estão uniformemente chocados com a rapidez. A diferença é especialmente nítida ao lidar com páginas complexas que no AEM contêm componentes aninhados ou várias caixas de diálogo que demoram para serem carregadas do JCR.

Como obter a criação de documentos

Para reiterar, o DA ainda é uma tecnologia de acesso antecipado para Edge Delivery Services.

O próprio Edge Delivery Services faz parte do AEM como serviço de nuvem e, a partir desse momento, é uma oferta unificada com o AEM como serviço em nuvem. Portanto, se você está pensando em migrar para o AEM como um serviço de nuvem (ou se já o tem), o DA pode ser uma opção para você.

Se você já está implementando o Slack com a Adobe, pergunte a eles sobre o DA e eles vão te ajudar.

Você também pode entrar em contato no Adobe Discord, onde há um canal dedicado do DA.

Por fim,entre em contato conosco pelo site ou diretamente no Linkedin ou no Twitter/X. Eu adoraria contar minhas experiências com isso!

Ou venha nos ver no Adobe Summit e adoraríamos fazer uma demonstração!

Gostou do que você ouviu? Tem dúvidas sobre o que é certo para você? Adoraríamos conversar! Entre em contato conosco

Episódios de podcast & Postagens no blog