Sviluppo con CRXDE Lite

Questa sezione descrive come sviluppare l'applicazione AEM utilizzando CRXDE Lite.

Per ulteriori informazioni sui diversi ambienti di sviluppo disponibili, consulta la documentazione di panoramica.

CRXDE Lite è integrato in AEM e consente di eseguire attività di sviluppo standard nel browser. Con i CRXDE Lite, potete creare un progetto, creare e modificare file (come .jsp e .java), cartelle, modelli, componenti, finestre di dialogo, nodi, proprietà e bundle durante la registrazione.
CRXDE Lite è consigliato quando non si dispone dell'accesso diretto al server AEM, quando si sviluppa un'applicazione estendendo o modificando i componenti out-of-the-box e i bundle Java o quando non è necessario un debugger dedicato, completamento del codice e evidenziazione della sintassi.

NOTE

A partire dal AEM 6.5.5.0, l'accesso anonimo di CRXDE Lite non è più possibile.
Gli utenti vengono reindirizzati alla schermata di accesso.

NOTE

È consigliabile utilizzare AEM Developer Tools for Eclipse e AEM HTL Brackets Extension durante lo sviluppo del progetto.

Guida introduttiva all'CRXDE Lite

Per iniziare con CRXDE Lite, procedere come segue:

  1. Installare AEM.

  2. Nel browser, immettere https://<host>:<port>/crx/de. Per impostazione predefinita è https://localhost:4502/crx/de.

  3. Immettere username e password. Per impostazione predefinita è admin e admin.

  4. Fai clic su OK.

L’interfaccia utente CRXDE Lite si presenta come segue nel browser:

chlimage_1-18

È ora possibile utilizzare CRXDE Lite per sviluppare l'applicazione.

Panoramica dell'interfaccia utente

CRXDE Lite offre le seguenti funzionalità:

Barra di commutazione superiore Consente di passare rapidamente da CRXDE Lite, Package Manager e Package Share.
Widget percorso nodo

Visualizza il percorso del nodo attualmente selezionato.

Potete anche utilizzarlo per passare a un nodo, immettendo il percorso a mano, o incollandolo da un'altra posizione, e premendo Invio.

Fornisce inoltre supporto per la ricerca di nodi con un nome di nodo specifico. Inserite il nome del nodo da trovare e attendete (o toccate il simbolo di ricerca sul lato destro). Potete provare a inserire, ad esempio, la stringa quercia nel widget per vedere come funziona. Se un determinato nodo o nodi viene caricato nel riquadro di esplorazione, verrà visualizzato l'elenco, quindi sarà possibile selezionare il percorso e premere Invio per passare a tale percorso. Si noti che funziona solo per i nodi attualmente caricati nell'applicazione client CRXDE nel browser. Se si desidera eseguire una ricerca nell'intero repository, utilizzare Strumenti, quindi Query.

Riquadro di Esplora risorse

Visualizza una struttura ad albero di tutti i nodi della directory archivio.

Fare clic su un nodo per visualizzarne le proprietà nella scheda Proprietà. Dopo aver fatto clic su un nodo, è possibile selezionare un'azione nella barra degli strumenti. Fare di nuovo clic sul nodo per rinominarlo.

Filtro di navigazione albero (icona binoculare): consente di filtrare i nodi della directory archivio per i quali il nome contiene il testo di input. Si applica solo ai nodi caricati localmente.

Riquadro di modifica

Hometab: consente di effettuare ricerche nei contenuti e/o nella documentazione e di accedere alle risorse per gli sviluppatori (documentazione, blog per sviluppatori, knowledge base) e al supporto ( pagina iniziale e centro di assistenza).

Fare doppio clic su un file nel riquadro Esplora risorse per visualizzarne il contenuto; come ad esempio un file .jsp o .java. Potete quindi modificarlo e salvare le modifiche.

Dopo aver modificato un file nel riquadro Modifica, nella barra degli strumenti sono disponibili i seguenti strumenti:

- Mostra nella struttura: mostra il file nella struttura del repository.
- Cerca/Sostituisci ...: eseguire ricerche o sostituire.

Fate doppio clic sulla riga di stato del riquadro Editpane per aprire la finestra di dialogo Vai a linea, in modo da immettere un numero di riga specifico a cui passare.
scheda Proprietà
Visualizza le proprietà del nodo selezionato. È possibile aggiungere nuove proprietà o eliminare quelle esistenti.
Scheda Controllo accesso

Visualizza le autorizzazioni in base al percorso, al livello del repository o all'entità corrente.

Le autorizzazioni sono suddivise in

- Criterio di controllo degli accessi applicabile: Criteri che possono essere applicati alla selezione corrente.

- Criteri per il controllo degli accessi locali: Criteri correnti applicati localmente alla selezione corrente.

- Criteri di controllo di accesso effettivi: I criteri correnti applicati alla selezione corrente possono essere impostati localmente o ereditati dai nodi padre.

Nota. Per poter visualizzare le informazioni sul controllo di accesso, l'utente che ha eseguito l'accesso al CRXDE Lite deve disporre dei diritti per la lettura delle voci ACL. L'utente anonimo non può visualizzare queste informazioni per impostazione predefinita. Per visualizzare le informazioni, effettuate l'accesso, ad esempio, come amministratore.

Scheda Replica

Visualizza lo stato di replica del nodo corrente. È possibile replicare e replicare l'eliminazione del nodo corrente.

Scheda Console

Registri del server:

Visualizza i messaggi dei registri. È possibile configurare il livello di registro, cancellare la console, fissare la posizione di scorrimento selezionata e attivare/disattivare la visualizzazione dei messaggi.

Controllo della versione:

Visualizza i messaggi relativi al controllo delle versioni.

Scheda Informazioni build
Visualizza informazioni durante la creazione di un bundle.
Aggiorna
Aggiorna la selezione corrente. Le modifiche apportate da altri utenti vengono aggiornate nella visualizzazione della directory archivio. Le modifiche apportate non vengono applicate.
Salva tutto

Salva tutto:

Salva tutte le modifiche apportate. Fino a quando non si fa clic su Salva, le modifiche sono temporanee e andranno perse quando si esce dalla console.

Versione precedente:

Ignora tutte le modifiche apportate al nodo selezionato dall'ultima azione di salvataggio, quindi ricarica lo stato corrente del repository per il nodo selezionato.

Ripristina tutto:

Elimina tutte le modifiche apportate all’intero repository dall’ultima azione di salvataggio, quindi ricarica lo stato corrente dell’archivio.

Crea ...

Menu a discesa per creare quanto segue sotto il nodo selezionato:

- Node: un nodo con un tipo di nodo arbitrario

- File: nt:nodo file e relativo nodo secondario nt:resource

- Cartella: nt:folder, nodo

- Modello: modello AEM

- Componente: Componente AEM

- Finestra di dialogo: AEM, finestra di dialogo

Elimina
Elimina il nodo selezionato.
Copia Copia il nodo selezionato.
Incolla
Incolla il nodo copiato sotto il nodo selezionato.
Sposta ...
Sposta il nodo selezionato nel nodo impostato attraverso la finestra di dialogo.
Rinomina ...
Rinomina il nodo selezionato.
Mixin...
Consente di aggiungere tipi di mixin al tipo di nodo. I tipi di mixin vengono utilizzati principalmente per aggiungere al nodo funzioni avanzate quali controllo delle versioni, controllo degli accessi, riferimenti e blocco.
Strumenti

Menu a discesa con i seguenti strumenti:

- Configurazione server ...: per accedere alla console Felix.

- Query ...: per eseguire una query nell'archivio.

- Privilegi ...: per aprire la gestione dei privilegi, dove puoi visualizzare e aggiungere privilegi.

- Controllo di accesso alla prova ...: un luogo in cui è possibile verificare l'autorizzazione per determinati percorsi e/o entità.

- Tipo di nodo di esportazione: per esportare i tipi di nodi nel sistema come notazione cnd.

- Importa tipo di nodo ...: per importare i tipi di nodo utilizzando la notazione cnd.

- Installare il debugger di SiteCatalyst ...: istruzioni su come installare Analytics Debugger.

Widget di accesso

Visualizza gli utenti attualmente connessi e l’area di lavoro in cui sono connessi, ad esempio admin@crx.default.

Fate clic su di esso per accedere o effettuare nuovamente l'accesso come utente specifico. Se non specificate un'area di lavoro a cui accedere, vi verrà eseguito l'accesso all'area di lavoro predefinita, crx.default.

Se si desidera sfogliare l'archivio come utente anonimo, utilizzare anonimo come nome di login e qualsiasi password (ad esempio, uno spazio o un punto).

Se l'autorizzazione non è più valida (ad esempio, è scaduta), nel widget di accesso viene visualizzato "Non autorizzato - Accesso...". Fate clic su di esso per effettuare nuovamente l'accesso.

Creazione di una cartella

Per creare una cartella con un CRXDE Lite:

  1. Aprite il CRXDE Lite nel browser.

  2. Nel riquadro di navigazione, fare clic con il pulsante destro del mouse sulla cartella in cui si desidera creare la nuova cartella, selezionare Crea …, quindi Crea cartella ….

  3. Immettere la cartella Name e fare clic su OK.

  4. Fare clic su Salva tutto per salvare le modifiche sul server.

Creazione di un modello

Per creare un modello con un CRXDE Lite:

  1. Aprite il CRXDE Lite nel browser.

  2. Nel riquadro di navigazione, fare clic con il pulsante destro del mouse sulla cartella in cui si desidera creare il modello, selezionare Crea …, quindi Crea modello ….

  3. Immettere Label, Title, Description, Resource Type e Ranking del modello. Fai clic su Avanti.

  4. Questo passaggio è facoltativo: impostare i Percorsi consentiti. Fai clic su Avanti

  5. Questo passaggio è facoltativo: impostare Genitori consentiti. Fai clic su Avanti.

  6. Questo passaggio è facoltativo: impostare Elementi secondari consentiti. Fai clic su OK.

  7. Fare clic su Salva tutto per salvare le modifiche sul server.

Crea:

  • Un nodo di tipo cq:Template con proprietà Modello

  • Un nodo figlio di tipo cq:PageContent con proprietà Contenuto pagina

Potete aggiungere proprietà al modello: fare riferimento alla sezione Creazione di una proprietà.

Creazione di un componente

La funzione qui descritta è disponibile solo se CQ5 è installato, ovvero se il tipo di nodo cq:Component è disponibile nella directory archivio.

Per creare un componente con CRXDE Lite:

  1. Aprite il CRXDE Lite nel browser.

  2. Nel riquadro di navigazione, fare clic con il pulsante destro del mouse sulla cartella in cui si desidera creare il componente, selezionare Crea …, quindi Crea componente ….

  3. Immettere Label, Title, Description, Super Resource Type e Group del componente. Fai clic su Avanti.

  4. Questo passaggio è facoltativo: impostare le proprietà del componente Contenitore Is, No Decoration, Cell Name e Dialog Path. Fai clic su Avanti.

  5. Questo passaggio è facoltativo: impostare la proprietà del componente Parametri consentiti. Fai clic su Avanti.

  6. Questo passaggio è facoltativo: impostare la proprietà del componente Elementi secondari consentiti. Fai clic su OK.

  7. Fare clic su Salva tutto per salvare le modifiche sul server.

Crea:

  • Un nodo di tipo cq:Component
  • Proprietà dei componenti
  • Script .jsp di un componente

Creazione di una finestra di dialogo

Per creare una finestra di dialogo con un CRXDE Lite:

  1. Aprite il CRXDE Lite nel browser.

  2. Nel riquadro di navigazione, fare clic con il pulsante destro del mouse sul componente in cui si desidera creare la finestra di dialogo, selezionare Crea …, quindi Crea finestra di dialogo ….

  3. Immettere Label e Title. Fai clic su OK.

  4. Fare clic su Salva Al l per salvare le modifiche sul server.

Viene creata una finestra di dialogo con la struttura seguente:

dialog[cq:Dialog]/items[cq:Widget]/items[cq:WidgetCollection]/tab1[cq:Panel]

È ora possibile adattare la finestra di dialogo alle proprie esigenze modificando le proprietà o creando nuovi nodi.

È inoltre possibile utilizzare l'Editor finestre di dialogo per modificare una finestra di dialogo. Facendo doppio clic sul nodo della finestra di dialogo nel CRXDE Lite, verrà visualizzato l'editor. Ulteriori informazioni sull'Editor finestra di dialogo sono disponibili qui.

Creazione di un nodo

Per creare un nodo con CRXDE Lite:

  1. Aprite il CRXDE Lite nel browser.
  2. Nel riquadro di navigazione, fare clic con il pulsante destro del mouse sul nodo in cui si desidera creare il nuovo nodo, selezionare Crea …, quindi Crea nodo ….
  3. Immettere Name e Type. Fai clic su OK.
  4. Fare clic su Salva tutto per salvare le modifiche sul server.

È ora possibile adattare il nodo alle proprie esigenze modificando le proprietà o creando nuovi nodi.

NOTE

La maggior parte delle operazioni di modifica, incluso Create Node, conserva tutte le modifiche in memoria e le memorizza nella directory archivio solo al momento del salvataggio (tramite il pulsante "Save All"). Tuttavia, alcune operazioni come quella di spostamento vengono automaticamente mantenute.

La convalida relativa all'eventuale autorizzazione del nodo appena creato da parte del tipo di nodo padre viene eseguita anche dall'archivio JCR prima del salvataggio delle modifiche. Se durante il salvataggio di un nodo viene visualizzato un messaggio di errore, verificare se la struttura del contenuto è valida (ad esempio, non è possibile creare un nodo nt:unstructured come elemento secondario di nt:folder nodo).

Creazione di una proprietà

Per creare una proprietà con un CRXDE Lite:

  1. Aprite il CRXDE Lite nel browser.

  2. Nel riquadro di navigazione, selezionare il nodo in cui si desidera aggiungere la nuova proprietà.

  3. Nella scheda Proprietà del riquadro inferiore, immettere Nome, Tipo e Valore. Fate clic su Aggiungi.

  4. Fare clic su Salva tutto per salvare le modifiche sul server.

Creazione di uno script

Per creare un nuovo script:

  1. Aprite il CRXDE Lite nel browser.

  2. Nel riquadro di navigazione, fare clic con il pulsante destro del mouse sul componente in cui si desidera creare lo script, selezionare Crea …, quindi Crea file ….

  3. Immettere il file Name, inclusa l'estensione. Fai clic su OK.

  4. Il nuovo file si apre come scheda nel riquadro Modifica.

  5. Modificate il file.

  6. Fare clic su Salva tutto per salvare le modifiche.

Esportazione e importazione di tipi di nodo

Con il CRXDE Lite è possibile importare e/o esportare le definizioni dei tipi di nodo nella notazione CND (Compact Namespace and Node Type Definition).

Per esportare una definizione di tipo di nodo:

  1. Aprite il CRXDE Lite nel browser.

  2. Selezionare il nodo desiderato.

  3. Selezionare Strumenti, quindi Esporta tipo di nodo.

  4. La definizione, nella notazione cnd, verrà visualizzata nel browser. Se necessario, salvate le informazioni.

Per importare una definizione di tipo di nodo:

  1. Aprite il CRXDE Lite nel browser.

  2. Selezionare Strumenti, quindi Importa tipo di nodo….

  3. Immettete la notazione CND per la definizione nella casella di testo.

  4. Selezionare Consenti aggiornamento se si sta aggiornando una definizione esistente.

  5. Fai clic su Importa.

Registrazione

Con CRXDE Lite è possibile visualizzare il file error.log che si trova nel file system in <crx-install-dir>/crx-quickstart/server/logs e filtrarlo con il livello di registro appropriato. Procedere come segue:

  1. Aprite il CRXDE Lite nel browser.

  2. Nella scheda Console in fondo alla finestra, nel menu a discesa a destra, selezionare Registri server.

  3. Fare clic sull'icona Stop per visualizzare i messaggi.

Operazioni disponibili:

  • Per regolare i parametri di registro nella console Felix, fai clic sull'icona Configurazioni di registrazione.
  • Cancella i messaggi facendo clic sull'icona Pennello.
  • Inserire il messaggio nella selezione corrente facendo clic sull'icona Pin.
  • Abilita o disabilita la visualizzazione dei messaggi facendo clic sull'icona Stop.

Controllo accesso

NOTE

Per ulteriori informazioni, consultate Utenti, gruppi e amministrazione dei diritti di accesso.

In questa pagina