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.

È possibile ottenere una licenza per sviluppatori per AEM tramite Adobe Exchange Program.

Modelli di integrazione comuni
​---------------------------

AEM è una soluzione di gestione dell’esperienza web all’avanguardia e offre molte aree potenziali di integrazioni. I modelli di integrazione comuni includono:

  • Estrazione di dati da un sistema esterno in AEM. Ad esempio, esportando le informazioni di contatto da un CRM per renderle disponibili a un pubblico più ampio che visita un sito Web basato su AEM. Le implementazioni devono utilizzare i Processi pianificati, che garantiscono l’esecuzione del processo anche in caso di esaurimento dei contenitori. Il codice deve essere progettato per presumere che il processo possa essere attivato potenzialmente più di una volta.
  • Esportazione di dati da AEM in un sistema esterno. Ad esempio, le impostazioni di abbonamento a una newsletter sono state inviate su un sito Web basato su AEM a un CRM.
  • Recupero risorse da AEM. Ad esempio, un sistema di gestione dei contenuti esterno (CMS) che fa riferimento a una risorsa memorizzata in AEM Assets. Oppure, come altro esempio, un sistema PIM che si collega a un'immagine in AEM Assets.
  • Memorizzazione delle risorse nell’infrastruttura AEM. Ad esempio, un sistema di gestione delle risorse di marketing (MRM) che memorizza una risorsa approvata in AEM Assets.
  • Configurazione e rendering di un componente dell’interfaccia utente personalizzato. Ad esempio, puoi consentire all’autore di trascinare e rilasciare un componente video e configurare un video specifico da riprodurre sul sito live.
  • Intervento 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, di una pagina o di una risorsa in AEM Admin Console. Ad esempio, l’elaborazione di consigli SEO per una pagina esistente o non pubblicata.
  • Accesso a livello di pagina ai dati utente gestito da un servizio esterno. Ad esempio, sfrutta le informazioni demografiche per personalizzare l’esperienza del sito. Scopri ContextHub, un framework per l’archiviazione, la manipolazione e la presentazione dei dati contestuali.
  • Traduzione della copia del sito o dei metadati della risorsa. Consulta la sezione Connettore Bootstrap di AEM Translation Framework per il codice di esempio che utilizza l'AEM Translation Framework, che è l’implementazione preferita dei connettori di traduzione.

Documentazione utile
​--------------------

La documentazione Experience Manager as a Cloud Service fornisce informazioni utili 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:

  • Servizi di consulenza Adobe (ACS) esempi AEM per un codice ben commentato per aiutare gli sviluppatori AEM
  • I vari collegamenti alla documentazione nella sezione Modelli di integrazione comuni di questo articolo

Risorse della community
​--------------------

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

  • La comunità di Adobe AEM Forum è un sito attivo in cui i tuoi colleghi chiedono e rispondono alle domande
  • Ulteriori risorse tecniche Adobe sono disponibili per determinati livelli di partner. Scopri di più su 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 della struttura del pacchetto
​-----------------------

Per supportare le distribuzioni continue, i pacchetti AEM as a Cloud Service, di cui i connettori sono esempi, hanno 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 sui pacchetti, descritte in questo articolo. Anche i connettori esistenti devono essere riadattati per adeguarsi.

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

È inoltre possibile che sia necessario eseguire il refactoring dei connettori esistenti per spostare eventuali configurazioni posizionate una volta /etc in altre cartelle di livello superiore, come /conf. La ristrutturazione è stata effettuata nell'ambito di AEM 6.5 ed è descritta nella documentazione di AEM 6.5.

Ti consigliamo di posizionare la maggior parte del codice del connettore sotto /apps/connectors/<vendor> per promuovere una struttura dell’archivio pulita per i clienti con diversi connettori.

Configurazioni servizi cloud
​-----------------------------

Un aspetto dell’implementazione del connettore è il codice che ne supporta la configurazione. Questo codice fa apparire una scheda con il nome del connettore in Strumenti > Operazioni > Cloud Services. Se cliccato, viene visualizzato un browser di configurazione in cui il cliente seleziona la cartella genitore per contenere la configurazione del connettore. Il codice del connettore deve tradursi in un modulo con tutte le proprietà che devono essere configurate, in ultima analisi memorizzando i valori in una cartella di configurazione in /conf. Questa cartella può essere successivamente selezionata nella scheda Proprietà siti o nella scheda Proprietà risorse.

Configurazioni in base al contesto
​-----------------------------

Configurazioni in base al contesto consente la configurazione dei livelli in diverse cartelle, tra cui /libs, /apps, /conf e sottocartelle in /conf. Supporta l’ereditarietà in modo che un cliente possa impostare la configurazione globale mentre apporta modifiche specifiche a ciascun microsito. Poiché è possibile sfruttare questa funzione per le configurazioni dei 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 sono usate nel connettore, occorre architettare il connettore in modo da gestire l'inclusione/unione di qualsiasi aggiornamento futuro delle configurazioni predefinite fornite dal connettore con le configurazioni del cliente. Ricordate che la modifica di contenuti o configurazioni personalizzate (cioè modificate dal cliente) senza l'avviso e il consenso del cliente può interrompere (o creare un comportamento imprevisto) con il connettore.

Best practice di codifica
​----------------------

Poiché AEM as a Cloud Service è una soluzione nativa per il cloud, esistono alcune linee guida che possono influenzare le strategie di codice di un connettore. Vedi Linee guida per lo sviluppo in AEM as a Cloud Service per ulteriori dettagli.

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 connettore AEM in un'applicazione standard per garantire che funzioni.

In questa pagina