Implementação de um conector do AEM

As referências úteis para a criação de Conectores do AEM são fornecidas a seguir e devem ser lidas em conjunto com orientações sobre envio e manutenção de conectores.

Uma licença de desenvolvedor para AEM pode ser obtida por meio do Programa Adobe Exchange.

Padrões comuns de integração

O AEM é uma solução de gerenciamento de experiência online de ponta e oferece muitas áreas em potencial de integrações. Padrões comuns de integração incluem:

• Extrair dados de um sistema externo para o AEM. Por exemplo, exportar informações de contato de um CRM para torná-lo disponível para um público-alvo maior que visita um site viabilizado pelo AEM. As implementações devem usar as Tarefas agendadas do Sling, que garante que a tarefa seja executada mesmo se os contêineres fiquem inativos. O código deve ser projetado supondo que a tarefa possa ser acionada mais de uma vez.
• Exportar dados do AEM para um sistema externo. Por exemplo, as configurações de assinatura do boletim informativo enviadas em um site viabilizado pelo AEM para um CRM.
• Recuperar ativos do AEM. Por exemplo, um Sistema de gerenciamento de conteúdo (CMS) externo que faz referência a um ativo armazenado no AEM Assets. Ou como outro exemplo, um sistema PIM vinculado a uma imagem no AEM Assets.
• Armazenar ativos na infraestrutura do AEM. Por exemplo, um sistema de Gestão de Recursos de Marketing (MRM) que armazena um ativo aprovado no AEM Assets.
• Configurar e renderizar um componente de interface personalizado. Por exemplo, permitir que um autor arraste e solte um componente de vídeo e configure um vídeo específico para ser reproduzido no site ativo.
• Atuar em um ativo com um serviço de parceiro. Por exemplo, enviar um ativo para uma plataforma de vídeo quando uma página é publicada.
• Analisar um site, página ou ativo no Admin Console do AEM. Por exemplo, fazer recomendações de SEO para uma página existente ou não publicada.
• Acesso em nível de página a dados do usuário mantidos por um serviço externo. Por exemplo, o uso de informações demográficas para personalizar a experiência no site. Leia sobre o ContextHub, uma estrutura para armazenar, manipular e apresentar dados de contexto.
• Traduzir uma cópia do site ou metadados de ativos. Consulte o Conector de bootstrap da estrutura de tradução do AEM para obter códigos de exemplo usando a Estrutura de tradução do AEM, que é a implementação preferida dos conectores de tradução.

Documentação útil

A documentação do Experience Manager as a Cloud Service fornece informações valiosas sobre desenvolvimento no AEM. Abaixo estão alguns tópicos e referências técnicas específicos que podem ser úteis ao implementar um conector do AEM:

• Serviços Adobe Consulting (ACS) Exemplos do AEM para código bem comentado para ajudar a educar desenvolvedores do AEM
• Os vários links de documentação na seção Padrões comuns de integração deste artigo

Recursos da comunidade

Além da documentação estática acima, a Adobe e a comunidade do AEM oferecem recursos para ajudar a trazer um conector para a produção:

• O Fórum AEM da comunidade da Adobe é um site ativo no qual seus colegas fazem perguntas e respondem a dúvidas
• Recursos técnicos adicionais da Adobe estão disponíveis para determinados níveis de parceiros. Saiba mais sobre o Programa Adobe Exchange.
• Se sua organização deseja obter ajuda de implementação, considere a equipe de Serviços profissionais da Adobe ou consulte o Localizador de parceiros de soluções para obter uma lista de parceiros da Adobe em todo o mundo

Regras de estrutura do pacote

Para dar suporte a implantações contínuas, os pacotes do AEM as a Cloud Service, dos quais os conectores são exemplos, têm uma separação rigorosa entre conteúdo “imutável” e “mutável”. Os pacotes devem ser claramente separados entre aqueles que incluem:

• /apps
• /content e /conf

Os conectores devem seguir essas diretrizes de pacotes, descritas neste artigo. Os conectores existentes também devem ser alterados para estarem em conformidade.

Além disso, somente a Adobe deve gravar código no /libs, com clientes e parceiros escrevendo em /apps.

Os conectores existentes também podem precisar ser refatorados para mover qualquer configuração que tenha sido colocada /etc em outras pastas de nível superior, como /conf. Esta reestruturação foi realizada no âmbito do AEM 6.5 e é descrita na Documentação do AEM 6.5.

Recomenda-se que a maioria do código do conector seja colocada em /apps/connectors/<vendor> para promover uma estrutura de repositório limpa para clientes que têm vários conectores.

Configurações dos serviços em nuvem

Um aspecto da implementação do conector é o código que suporta a configuração do conector. Esse código faz com que um cartão com o nome do conector apareça em Ferramentas > Operações > Serviços em nuvem. Quando clicado, um navegador de configuração aparece onde o cliente seleciona a pasta principal para conter a configuração do conector. O código do conector deve resultar em um formulário com todas as propriedades que devem ser configuradas, armazenando os valores em uma pasta de configuração em /conf. Posteriormente, essa pasta pode ser selecionada na guia de propriedades do Sites ou na guia de propriedades do Assets.

Configurações sensíveis ao contexto

Configurações sensíveis ao contexto permitem criar camadas de configuração em diferentes pastas, incluindo /libs, /apps, /conf e subpastas em /conf. Elas suportam herança, para que um cliente possa configurar a configuração global enquanto faz alterações específicas para cada microsite. Como é possível usar esse recurso para configurações do Cloud Services, o código do conector deve fazer referência à configuração usando a API de configuração com reconhecimento de contexto em vez de fazer referência a um nó de configuração específico.

Se as configurações modificadas forem usadas no conector, desenvolva-o para lidar com a inclusão/fusão de qualquer atualização futura nas configurações padrão fornecidas pelo conector com qualquer configuração de cliente. Lembre-se de que alterar o conteúdo personalizado (alterado pelo cliente) ou a configuração sem aviso e consentimento do cliente pode quebrar (ou criar um comportamento inesperado) com seu conector.

Práticas recomendadas de codificação

Como o AEM as a Cloud Service é uma solução nativa em nuvem, há algumas diretrizes que podem afetar as estratégias de código de um conector. Consulte Diretrizes de desenvolvimento do AEM as a Cloud Service para obter mais detalhes.

Testar o conector do AEM

Novos conectores devem ser criados (ou conectores existentes modificados) usando técnicas de desenvolvimento de ambiente local. A Equipe parceira fornecerá aos parceiros de ISV um ambiente de sandbox onde poderão implantar o conector do AEM em um aplicativo padrão para garantir o funcionamento.