Show Menu
TÓPICOS×

Implementação de um conector AEM

As referências úteis para a criação de conectores aemconnectors.html AEM são fornecidas a seguir e devem ser lidas em conjunto com orientações sobre envio e manutenção de conectores.
Observe que uma licença de desenvolvedor para AEM pode ser obtida por meio do Adobe Exchange Program .

Padrões de integração comuns

O AEM é uma solução de gerenciamento de experiência na Web de ponta e oferece muitas áreas potenciais de integração. Padrões comuns de integração incluem:
  • Como extrair dados de um sistema externo para o AEM. Por exemplo, exportar informações de contato de um CRM para disponibilizá-las a um público maior que visite um site compatível com o AEM. As implementações devem usar os Serviços apache-sling-eventing-and-job-handling.html#scheduled-jobsProgramados do Sling, que garantem que a ordem de produção seja executada mesmo que os contêineres fiquem inativos. O código deve ser projetado para supor 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 de boletins informativos enviadas em um site compatível com AEM para um CRM.
  • Recuperando ativos do AEM. Por exemplo, um Sistema de gerenciamento de conteúdo externo (CMS) que faz referência a um ativo armazenado nos ativos AEM. Ou como outro exemplo, um sistema PIM vinculado a uma imagem nos ativos AEM.
  • Armazenar ativos na infraestrutura do AEM. Por exemplo, um sistema de gerenciamento de recursos de marketing (MRM) armazenando um ativo aprovado nos ativos AEM.
  • Configuração e renderização de um componente de interface personalizada. Por exemplo, permita que um autor arraste e solte um componente de vídeo e configure um vídeo específico para ser reproduzido no site ativo.
  • Agir 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 console de administração do AEM. Por exemplo, fazer recomendações de SEO para uma página existente ou não publicada.
  • Acesso de nível de página aos dados do usuário mantidos por um serviço externo. Por exemplo, aproveite as informações demográficas para personalizar a experiência do site. Leia sobre o ContextHub, uma estrutura para armazenar, manipular e apresentar dados de contexto.
  • Traduzindo cópia do site ou metadados do ativo. Consulte o Conector de inicialização da estrutura de tradução do AEM para obter exemplos de código usando a estrutura de tradução do AEM, que é a implementação preferencial dos conectores de tradução.

Documentação útil

O Experience Manager como uma documentação do serviço em nuvem fornece informações importantes sobre o desenvolvimento no AEM. Abaixo estão alguns tópicos e referências técnicas específicos que podem ser úteis ao implementar um conector AEM:
  • Amostras de AEM dos Serviços de consultoria da Adobe (ACS) para obter um código bem comentado que ajuda a educar desenvolvedores do AEM
  • Os vários links de documentação na seção Padrões de integração comuns 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 colocar um conector no mercado:
  • O Fórum do AEM da Comunidade Adobe é um site ativo no qual seus colegas fazem perguntas e respondem a perguntas
  • 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 professional-consulting-training.html 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 oferecer suporte a implantações contínuas, o AEM como pacotes de serviço em nuvem, dos quais os conectores são exemplos, tem uma separação estrita entre conteúdo "mutável" e "mutável". Os pacotes devem ser cuidadosamente separados entre os que incluem:
  • /apps
  • /content e /conf
Os conectores devem seguir essas diretrizes de embalagem, descritas neste artigo . Os conectores existentes também devem ser refatorizados para estarem em conformidade.
Além disso, somente a Adobe deve gravar código /libs , com clientes e parceiros que escrevem para /apps .
Os conectores existentes também podem precisar ser refatorizados para mover qualquer configuração que tenha sido colocada /etc em outras pastas de nível superior, como /conf . Isso é descrito na documentação do AEM.
Recomenda-se que a maioria do código do conector seja colocada /apps/connectors/<vendor> para promover uma estrutura de repositório limpa para clientes que tenham 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 é aberto onde o cliente seleciona a pasta pai 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 Sites ou na guia de propriedades Ativos.

Configurações sensíveis ao contexto

As Configurações sensíveis ao contexto permitem colocar a configuração em camadas em diferentes pastas, incluindo /libs , /apps e subpastas em /conf /conf . Suporta herança para que um cliente possa configurar a configuração global e fazer alterações específicas para cada microsite. Como é possível aproveitar esse recurso para Configurações de serviços em nuvem, o código do conector deve fazer referência à configuração usando a API de configuração sensível ao contexto em vez de fazer referência a um nó de configuração específico.
Se configurações modificadas forem usadas no Conector, arquive o Conector para lidar com a inclusão/união de futuras atualizações nas configurações padrão fornecidas pelo Conector com quaisquer configurações do cliente. Lembre-se de que alterar o conteúdo personalizado (como 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 como serviço em nuvem é uma solução nativa da nuvem, há algumas diretrizes que podem afetar as estratégias de código de um conector. Consulte AEM como Diretrizes de desenvolvimento de serviços em nuvem para obter mais detalhes.

Teste do conector AEM

Novos conectores devem ser criados (ou conectores existentes modificados) usando técnicas locais de desenvolvimento ambiental. A equipe do parceiro fornecerá aos parceiros ISV um ambiente de caixa de proteção onde eles poderão implantar seu conector AEM em um aplicativo baunilha para garantir que ele funcione.