Implementazione di un connettore AEM

Di seguito sono riportati alcuni riferimenti utili per la creazione di connettori AEM, che devono essere letti insieme alle indicazioni relative all’invio e alla manutenzione dei connettori.

Si noti che è possibile ottenere una licenza Developer per AEM tramite il Adobe Exchange Program.

Modelli di integrazione comuni

AEM è una soluzione all'avanguardia per la gestione dell'esperienza Web e offre numerose aree potenziali di integrazioni. I pattern di integrazione comuni includono:

• Estrazione di dati da un sistema esterno in AEM. Ad esempio, l'esportazione delle informazioni di contatto da un CRM per renderle disponibili a un pubblico più ampio che visita un sito Web AEM. Le implementazioni devono utilizzare i Processi programmati di Sling, che garantiscono l'esecuzione del processo anche se i contenitori non rientrano. Il codice deve essere progettato in modo da presupporre che il processo possa essere attivato più di una volta.
• Esportazione di dati da AEM a un sistema esterno. Ad esempio, le impostazioni di iscrizione alla newsletter inviate a un CRM su un sito Web AEM.
• Recupero delle risorse da AEM. Ad esempio, un CMS (Content Management System) esterno che fa riferimento a una risorsa memorizzata in AEM Assets. Oppure, come altro esempio, un sistema PIM che collega un'immagine in AEM Assets.
• Memorizzazione delle risorse nell'infrastruttura AEM. Ad esempio, un sistema Marketing Resource Management (MRM) che memorizza una risorsa approvata in AEM Assets.
• Configurazione e rendering di un componente dell’interfaccia utente personalizzata. Ad esempio, potete consentire a un autore di trascinare e rilasciare un componente video e configurare un video specifico da riprodurre sul sito dal vivo.
• Funzionamento su una risorsa con un servizio partner. Ad esempio, l’invio di una risorsa a una piattaforma video quando viene pubblicata una pagina.
• Analisi di un sito, una pagina o una risorsa nella console di amministrazione AEM. Ad esempio, la creazione di raccomandazioni SEO per una pagina esistente o non pubblicata.
• Accesso a livello di pagina ai dati utente gestito da un servizio esterno. Ad esempio, potete sfruttare le informazioni demografiche per personalizzare l'esperienza del sito. Leggi ContextHub, un framework per la memorizzazione, la manipolazione e la presentazione dei dati contestuali.
• Traduzione dei metadati di una copia del sito o di una risorsa. Per il codice di esempio, vedere il AEM Translation Framework Bootstrap Connector utilizzando il AEM Translation Framework, che è l'implementazione preferita dei connettori di traduzione.

Documentazione utile

Experience Manager come Cloud Service documentazione fornisce informazioni preziose sullo sviluppo in AEM. Di seguito sono riportati alcuni argomenti tecnici e riferimenti specifici che possono essere utili durante l'implementazione di un connettore AEM:

• Adobe Consulting Services (ACS) AEM Samples per un codice ben commentato per aiutare AEM sviluppatori
• I vari collegamenti della documentazione nella sezione Modelli comuni di integrazione di questo articolo

Risorse della community

Oltre alla documentazione statica di cui sopra, Adobe e la comunità AEM offrono risorse per aiutare a immettere sul mercato un connettore:

• Il AEM forum della community di Adobe è un sito attivo in cui i colleghi possono porre e rispondere alle domande
• A determinati livelli di partner sono disponibili ulteriori risorse tecniche Adobe. Ulteriori informazioni sul Adobe Exchange Program.
• Se la tua azienda desidera ricevere assistenza nell’implementazione, può consultare il team Servizi professionali di Adobe o consultare Solution Partner Finder per ottenere un elenco dei partner Adobe presenti in tutto il mondo

Regole di struttura del pacchetto

Per supportare distribuzioni continue, AEM come pacchetti di Cloud Service, di cui i connettori sono esempi, esiste una netta separazione tra contenuti "immutabili" e contenuti "mutabili". I pacchetti devono essere separati in modo pulito tra quelli che includono:

• /apps
• /content e /conf

I connettori devono attenersi alle presenti linee guida sulla creazione di pacchetti, descritte in questo articolo. Anche i connettori esistenti devono essere adattati.

Inoltre, solo Adobe dovrebbe scrivere il codice in /libs, con clienti e partner che scrivono in /apps.

I connettori esistenti potrebbero inoltre dover essere reinseriti per spostare qualsiasi configurazione eventualmente inserita /etc in altre cartelle di livello principale, come /conf. Questo è descritto nella documentazione AEM.

Si consiglia di posizionare la maggior parte del codice del connettore in /apps/connectors/<vendor> per promuovere una struttura del repository pulita per i clienti che dispongono di diversi connettori.

Configurazioni servizi cloud

Un aspetto dell'implementazione del connettore è il codice che supporta la configurazione del connettore. Questo codice causa la visualizzazione di una scheda con il nome del connettore in Strumenti > Operazioni > Cloud Services. Quando un utente fa clic su di esso, viene visualizzato un browser di configurazione in cui il cliente seleziona la cartella principale per contenere la configurazione del connettore. Il codice del connettore deve generare un modulo con tutte le proprietà che devono essere configurate, memorizzando i valori in una cartella di configurazione in /conf. Questa cartella può essere selezionata in un secondo momento nella scheda Proprietà siti o nella scheda Proprietà risorse.

Configurazioni basate sul contesto

Le configurazioni basate sul contesto consentono di configurare i livelli tra diverse cartelle, incluse /libsle sottocartelle /appse /conf le sottocartelle in /conf. Supporta l'ereditarietà, in modo che un cliente possa configurare la configurazione globale mentre apporta modifiche specifiche per ogni microsito. Poiché è possibile sfruttare questa funzione per Configurazioni di Cloud Services, il codice del connettore dovrebbe fare riferimento alla configurazione utilizzando l'API di configurazione in base al contesto invece di fare riferimento a un nodo di configurazione specifico.

Se le configurazioni modificate vengono utilizzate nel connettore, architettare il connettore per gestire, inclusi/uniti eventuali aggiornamenti futuri alle configurazioni predefinite fornite dal connettore con qualsiasi configurazione cliente. Ricorda che la modifica del contenuto o della configurazione personalizzati (come modificato dal cliente) senza preavviso e consenso da parte del cliente potrebbe interrompere (o creare un comportamento imprevisto) con il connettore.

Tecniche consigliate per la codifica

Poiché AEM come Cloud Service è una soluzione nativa di Cloud, esistono alcune linee guida che possono influenzare le strategie di codice di un connettore. Per ulteriori informazioni, vedere AEM come guida allo sviluppo del Cloud Service.

Verifica del connettore AEM

È necessario creare nuovi connettori (o modificare i connettori esistenti) utilizzando tecniche di sviluppo dell'ambiente locale. Il Partner Team fornirà ai partner ISV un ambiente sandbox in cui possono implementare il proprio connettore AEM in un'applicazione vaniglia per assicurarsi che funzioni.