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 la Programma di scambio Adobe.

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 gli Processi pianificati, che garantisce 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.
  • 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, 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 il AEM Translation Framework, che è l’implementazione preferita dei connettori di traduzione.

Documentazione utile

Experience Manager as a Cloud Service documentazione 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, la comunità degli Adobi e AEM offre risorse per contribuire a immettere sul mercato un connettore:

  • La comunità di Adobi Forum AEM è un sito attivo in cui i tuoi pari chiedono e rispondono alle domande
  • A determinati livelli dei partner sono disponibili risorse tecniche Adobi aggiuntive. Ulteriori informazioni sulle Programma di scambio Adobe.
  • 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, AEM pacchetti 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 sugli imballaggi, descritte in articolo. Anche i connettori esistenti devono essere riadattati per adeguarsi.

Inoltre, solo l'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 della AEM 6.5 ed è descritta nella Documentazione di AEM 6.5.

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

Configurazioni servizi cloud

Un aspetto dell’implementazione del connettore è il codice che supporta la configurazione del connettore. Questo codice fa apparire una scheda con il nome del connettore in Strumenti > Operazioni > Cloud Services. Quando fai clic su un pulsante browser di configurazione viene visualizzato il punto in cui il cliente seleziona la cartella padre 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 /conf. Supporta l’ereditarietà in modo che un cliente possa configurare 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 nel connettore vengono utilizzate configurazioni modificate, architettare il connettore per gestire, inclusi/raggruppando eventuali aggiornamenti futuri alle configurazioni predefinite fornite dal connettore con eventuali configurazioni del cliente. Ricorda che la modifica del contenuto o della configurazione personalizzati (come modificata 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 as a Cloud Service AEM 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 vaniglia per garantire che funzioni.

In questa pagina