Sviluppo locale AEM con l’editor universale local-dev-ue

Scopri in che modo Universal Editor supporta la modifica sulle istanze AEM locali a scopo di sviluppo.

Panoramica overview

Il servizio Universal Editor è ciò che lega Universal Editor e il sistema di back-end. Per poter sviluppare in locale per Universal Editor, è necessario eseguire una copia locale del servizio. Ciò è dovuto al fatto che:

  • Il servizio ufficiale dell’editor universale di Adobe è ospitato a livello globale e l’istanza AEM locale dovrebbe essere esposta a Internet.
  • Durante lo sviluppo con un SDK AEM locale, non è possibile accedere al servizio Universal Editor di Adobe da Internet.
  • Se l'istanza dell'AEM ha restrizioni IP e il servizio Universal Editor di Adobe non è incluso in un intervallo IP definito, è possibile ospitarlo personalmente.

In questo documento viene illustrato come eseguire AEM in HTTPS insieme a una copia locale del servizio Universal Editor per sviluppare in locale AEM da utilizzare con Universal Editor.

Configurare AEM per l’esecuzione su HTTPS aem-https

All’interno di un frame esterno protetto con HTTPS non è possibile caricare un frame HTTP non protetto. Il servizio Universal Editor viene eseguito su HTTPS, pertanto anche su HTTPS deve essere eseguito AEM o qualsiasi altra pagina remota.

A questo scopo, devi configurare l’AEM per l’esecuzione su HTTPS. A scopo di sviluppo, puoi utilizzare un certificato autofirmato.

Consulta questo documento su come configurare l'AEM in esecuzione su HTTPS, incluso un certificato autofirmato che puoi utilizzare.

Installare il servizio Universal Editor install-ue-service

Universal Editor Service non è un'intera copia di Universal Editor, ma solo un sottoinsieme delle sue funzioni per garantire che le chiamate dall'ambiente AEM locale non vengano instradate su Internet, ma da un endpoint definito controllato.

Per eseguire una copia locale del servizio Editor universale è necessario NodeJS versione 16.

Il servizio Universal Editor è disponibile tramite Software Distribution. Per informazioni dettagliate su come accedervi, consultare la documentazione sulla distribuzione software.

Salvare il file universal-editor-service.cjs da Distribuzione software nell'ambiente di sviluppo locale.

Creare un certificato per eseguire il servizio Universal Editor con HTTPS ue-https

Il servizio Editor universale richiede inoltre un certificato per l'esecuzione su HTTPS nell'ambiente di sviluppo.

Esegui il comando seguente.

$ openssl req -newkey rsa:2048 -nodes -keyout key.pem -x509 -days 365 -out certificate.pem

Il comando genera un file key.pem e un file certificate.pem. Salvare questi file nello stesso percorso del file universal-editor-service.cjs.

Configurazione del servizio Editor universale setting-up-service

È necessario impostare alcune variabili di ambiente in NodeJS per eseguire il servizio Universal Editor in locale.

Nello stesso percorso dei file universal-editor-service.cjs, key.pem e certificate.pem, creare un file .env con il contenuto seguente.

EXPRESS_PORT=8000
EXPRESS_PRIVATE_KEY=./key.pem
EXPRESS_CERT=./certificate.pem
NODE_TLS_REJECT_UNAUTHORIZED=0

La variabile ha i seguenti significati:

Esecuzione del servizio Editor universale running-ue

Per avviare il servizio Universal Editor, eseguire il comando seguente:

$ node ./universal-editor-service.cjs

Dovrebbe trasmettere quanto segue al terminale:

Universal Editor Service listening on port 8000 as HTTPS Server

Verificare che il servizio avvii il server HTTPS e non il server HTTP.

Utilizzo del servizio Editor universale locale anziché del servizio globale using-local-ue

Universal Editor conosce il servizio Universal Editor da utilizzare per modificare una pagina in base alla strumentazione. Questa operazione viene eseguita tramite i metatag nella pagina caricata nell’editor universale.

Per modificare una pagina con il servizio Universal Editor locale, è necessario impostare il seguente tag meta:

<meta name="urn:adobe:aue:config:service" content="https://localhost:8000">

Una volta impostato, ogni chiamata di aggiornamento del contenuto dovrebbe passare a https://localhost:8000 anziché al servizio Universal Editor predefinito.

NOTE
Il tentativo di accedere direttamente a https://localhost:8000 genera un errore 404. Questo è il comportamento previsto.
Per verificare l'accesso al servizio Universal Editor locale, utilizzare https://localhost:8000/corslib/LATEST. Per informazioni dettagliate, consulta la sezione successiva.
TIP
Per ulteriori dettagli sulla strumentazione delle pagine per l'utilizzo del servizio Global Universal Editor, vedere il documento Guida introduttiva all'editor universale in AEM

Modifica di una pagina con il servizio Local Universal Editor editing

Con il servizio Universal Editor Service in esecuzione localmente e la pagina di contenuto dotata di strumenti per l'utilizzo del servizio locale, ora è possibile avviare l'editor.

  1. Apri il browser per https://localhost:8000/corslib/LATEST.
  2. Indirizza il browser per accettare il certificato autofirmato.
  3. Una volta che il certificato autofirmato è attendibile, è possibile modificare la pagina utilizzando il servizio Universal Editor locale.
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab