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.
Observe que é possível obter uma licença de desenvolvedor para AEM por meio do Programa Adobe Exchange.
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:
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:
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:
Para oferecer suporte a implantações móveis, os pacotes do AEM as a Cloud Service, dos quais os conectores são exemplos, têm uma separação estrita 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.
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 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 aproveitar esse recurso para configurações do serviço 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 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.
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.
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.