Show Menu
TEMAS×

Implementación de un conector de AEM

A continuación se proporcionan referencias útiles para la creación de Conectores AEM y deben leerse junto con directrices sobre el envío y el mantenimiento de los conectores.
Tenga en cuenta que se puede obtener una licencia de desarrollador para AEM a través del Programa de Adobe Exchange.

Patrones de integración comunes

AEM es una solución de administración de experiencias web de vanguardia y oferta muchas áreas potenciales de integraciones. Los patrones de integración comunes incluyen:
  • Extracción de datos de un sistema externo en AEM. Por ejemplo, exportar la información de contacto desde un CRM para que esté disponible para una audiencia más amplia que visite un sitio web con tecnología AEM. Las implementaciones deben utilizar los trabajos programados de Sling, lo que garantiza que el trabajo se ejecute incluso si los contenedores se desactivan. El código debe estar diseñado para suponer que el trabajo puede activarse más de una vez.
  • Exportación de datos de AEM a un sistema externo. Por ejemplo, la configuración de suscripción de newsletter se envía en un sitio web con tecnología AEM a un CRM.
  • Recuperando recursos de AEM. Por ejemplo, un sistema Gestor de contenido externo (CMS) que hace referencia a un recurso almacenado en AEM Assets. O como otro ejemplo, un sistema PIM que se vincula a una imagen en AEM Assets.
  • Almacenamiento de recursos en la infraestructura AEM. Por ejemplo, un sistema de administración de Recursos de marketing (MRM) que almacena un recurso aprobado en AEM Assets.
  • Configuración y representación de un componente de interfaz de usuario personalizado. Por ejemplo, permita que un autor arrastre y suelte un componente de vídeo y configure un vídeo específico para que se reproduzca en el sitio de lanzamiento.
  • Actuar en un recurso con un servicio asociado. Por ejemplo, enviar un recurso a una plataforma de vídeo cuando se publica una página.
  • Análisis de un sitio, página o recurso en la consola de administración de AEM. Por ejemplo, hacer recomendaciones SEO para una página existente o no publicada.
  • Acceso de nivel de página a los datos de usuario que mantiene un servicio externo. Por ejemplo: aproveche la información demográfica para personalizar la experiencia del sitio. Obtenga información sobre ContextHub, un marco para almacenar, manipular y presentar datos de contexto.
  • Traduciendo la copia del sitio o los metadatos del recurso. Consulte el Conector del Bootstrap de AEM para obtener el código de muestra con el módulo de traducción de AEM, que es la implementación preferida de los conectores de traducción.

Documentación útil

La documentación de Experience Manager como Cloud Service proporciona información valiosa sobre el desarrollo de AEM. A continuación se presentan algunos temas técnicos específicos y referencias que puede resultar útiles a la hora de implementar un conector de AEM:
  • Adobe Consulting Services (ACS) AEM Ejemplos de código bien comentado para ayudar a educar a los desarrolladores AEM
  • Los diversos vínculos de documentación de la sección Patrones de integración comunes de este artículo

Recursos de la comunidad

Además de la documentación estática anterior, Adobe y los recursos de oferta de la comunidad AEM para ayudar a llevar un conector al mercado:
  • El AEM Foro de la comunidad Adobe es un sitio activo en el que sus colegas formulan preguntas y responden a ellas
  • Hay recursos técnicos de Adobe adicionales disponibles para ciertos niveles de socios. Obtenga más información sobre el Programa de Adobe Exchange.
  • Si su organización desea ayuda para la implementación, considere al equipo de Servicios profesionales de Adobe o consulte el Buscador de socios de soluciones para obtener una lista de los socios de Adobe de todo el mundo

Reglas de estructura de paquetes

A fin de admitir implementaciones móviles, AEM como paquetes de Cloud Service, de los cuales los conectores son ejemplos, tienen una estricta separación entre el contenido "inmutable" y el "mutable". Los paquetes deben separarse de forma limpia entre los que incluyen:
  • /apps
  • /content y /conf
Los conectores deben atenerse a estas directrices de empaquetado, que se describen en este artículo . Los conectores existentes también deben refactorizarse para ajustarse a ellos.
Además, solo Adobe debe escribir código en /libs , con clientes y socios escribiendo en /apps .
Es posible que también sea necesario refactorizar los conectores existentes para mover cualquier configuración que alguna vez se haya colocado /etc en otras carpetas de nivel superior, como /conf . Esto se describe en la documentación repository-restructuring.html AEM.
Se recomienda colocar la mayoría del código de conector en /apps/connectors/<vendor> para promocionar una estructura de repositorio limpia para los clientes que tienen varios conectores.

Configuración de servicios de nube

Un aspecto de la implementación del conector es el código que respalda la configuración del conector. Este código hace que una tarjeta con el nombre del conector aparezca en Herramientas > Operaciones > Cloud Services. Al hacer clic en él, aparece un navegador de configuración donde el cliente selecciona la carpeta principal para contener la configuración del conector. El código del conector debe resultar en un formulario con todas las propiedades que deben configurarse, almacenando finalmente los valores en una carpeta de configuración debajo de /conf . Esta carpeta se puede seleccionar posteriormente en la ficha Propiedades del sitio o en la ficha Propiedades de los recursos.

Configuraciones según el contexto

Las configuraciones según el contexto permiten crear capas de configuración en diferentes carpetas, incluidas /libs , /apps /conf y subcarpetas en /conf . Admite herencia para que un cliente pueda configurar la configuración global mientras realiza cambios específicos para cada micrositio. Dado que es posible aprovechar esta función para configuraciones de Cloud Services, el código del conector debe hacer referencia a la configuración mediante la API de configuración según el contexto en lugar de hacer referencia a un nodo de configuración específico.
Si se utilizan configuraciones modificadas en el conector, diseñe el conector para gestionar incluyendo/fusionando cualquier actualización futura de las configuraciones predeterminadas proporcionadas por el conector con cualquier configuración del cliente. Recuerde que cambiar el contenido o la configuración personalizados (como en el caso de los cambios realizados por el cliente) sin previo aviso y consentimiento del cliente puede dañar (o crear un comportamiento inesperado) con su conector.

Prácticas recomendadas de codificación

Dado que AEM como Cloud Service es una solución nativa de la nube, existen algunas directrices que pueden afectar a las estrategias de código de un conector. Consulte AEM como directrices de desarrollo para Cloud Service para obtener más detalles.

Comprobación del conector AEM

Se deben crear nuevos conectores (o modificar los existentes) utilizando técnicas de desarrollo de entornos locales. El equipo de socios proporcionará a los socios ISV un entorno de simulación de pruebas en el que pueden implementar su conector de AEM en una aplicación de vainilla para garantizar su funcionamiento.