AEM 6.4 ha raggiunto la fine del supporto esteso e questa documentazione non viene più aggiornata. Per maggiori dettagli, consulta la nostra periodi di assistenza tecnica. Trova le versioni supportate qui.
Quando crei una pagina devi selezionare un modello, che verrà utilizzato come base per la creazione della nuova pagina. Il modello definisce la struttura della pagina risultante, eventuali contenuti iniziali e i componenti che possono essere utilizzati.
Con l’Editor modelli, la creazione e la manutenzione dei modelli non è più un’attività che riguarda solo gli sviluppatori. Può essere coinvolto anche un tipo di “power user”, detto autore dimodelli. Gli sviluppatori devono comunque occuparsi di configurare l’ambiente, creare le librerie client e i componenti da utilizzare, ma una volta che questi elementi di base sono implementati, l’autore del modello avrà la flessibilità di creare e configurare i modelli senza un progetto di sviluppo.
La Console Modelli consente agli autori di modelli di:
La Editor modelli consente agli autori di modelli di:
Questo documento spiega come autore di modelli Puoi utilizzare la console e l’editor dei modelli per creare e gestire modelli modificabili.
Per informazioni dettagliate sul funzionamento dei modelli modificabili a livello tecnico, consulta il documento per sviluppatori Modelli di pagina - Modificabili per ulteriori informazioni.
AEM 6.4.5.0 o versione successiva è necessario per utilizzare modelli modificabili con Editor SPA.
L’Editor modelli non supporta il targeting diretto a livello di modello. È possibile impostare come destinazione le pagine create in base a un modello modificabile, ma non i modelli stessi.
Pagine e modelli creati con Console Modelli non sono progettati per essere utilizzati con l’interfaccia classica e tale uso non è supportato.
Un amministratore deve configurare una cartella di modelli nel browser delle configurazioni e applicare le autorizzazioni appropriate prima che un autore possa creare un modello in tale cartella.
Prima di iniziare, è importante considerare i seguenti punti:
La creazione di un nuovo modello richiede collaborazione. Per questo motivo per ogni attività è indicato il relativo Ruolo.
A seconda di come è configurata l’istanza, potrebbe essere utile sapere che AEM ora fornisce due tipi di modello di base. Questo non influisce sul modo in cui utilizzare un modello per creare una pagina, ma influisce sul tipo di modello che è possibile creare e sul modo in cui una pagina si relaziona al suo modello.
La creazione di un nuovo modello tramite Templates Console (Console modelli) e Editor modelli richiede la collaborazione tra i seguenti ruoli:
Amministratore:
admin
.Sviluppatore:
Autore del modello:
Questo è un autore specifico che è membro del gruppo template-authors
Può configurare l’uso di componenti e altri dettagli di alto livello che richiedono:
Alcune conoscenze tecniche
Informazioni tecniche fornite dallo sviluppatore.
A causa della natura di alcune attività, come la creazione di una cartella, è necessario un ambiente di sviluppo, che richiede conoscenza/esperienza.
I compiti descritti nel presente documento sono elencati con il ruolo che ne è responsabile.
AEM ora offre due tipi di modelli di base:
Modelli modificabili
Modelli statici
Per definizione, la console modelli e l’editor modelli consentono solo la creazione e la modifica di modelli modificabili. Pertanto, questo documento si concentra esclusivamente sui modelli modificabili.
Quando si utilizza un modello per creare una nuova pagina non vi è alcuna differenza visibile e nessuna indicazione tra modelli statici e modificabili. Per l’autore della pagina, il processo è trasparente.
Quando crei un nuovo modello modificabile:
Utilizza la Modello console. È disponibile nella Generale della sezione Strumenti console.
Se necessario, puoi creare una cartella per i modelli.
Crea un nuovo modello, che sarà inizialmente vuoto.
Definire proprietà aggiuntive per il modello, se necessario
Modificare il modello per definire:
Attiva il modello da utilizzare per la creazione di una pagina
Consenti modello per la pagina o la sezione richiesta del sito web
Pubblicare il modello per renderlo disponibile nell’ambiente di pubblicazione
I Modelli consentiti sono spesso predefiniti al momento della configurazione iniziale del sito web.
Non inserire mai informazioni che devono essere internazionalizzato in un modello.
È necessario creare una cartella di modelli per il progetto, che conterrà i modelli specifici per il progetto. Si tratta di un’attività amministrativa descritta nel documento Modelli di pagina - Modificabili.
Apri Console Modelli (tramite Strumenti -> Generale), quindi passa alla cartella desiderata.
In un’istanza AEM standard la cartella globale esiste già nella console modelli. Questa contiene i modelli predefiniti e funge da fallback se nella cartella corrente non sono presenti criteri e/o tipi di modello.
Si consiglia di utilizzare una cartella di modelli creata per il progetto.
Seleziona Crea, seguito da Crea modello per aprire la procedura guidata.
Scegli una Tipo di modello, quindi seleziona Successivo.
I tipi di modello sono layout di modelli predefiniti e possono essere considerati modelli per un modello. Questi sono predefiniti dagli sviluppatori o dall’amministratore di sistema. Ulteriori informazioni sono disponibili nel documento per sviluppatori Modelli di pagina - Modificabili.
Completa il Dettagli modello:
Seleziona Crea. Viene visualizzata una conferma; seleziona Apri🔗 per iniziare a modificare il modello o Fine per tornare alla console dei modelli.
Quando viene creato un nuovo modello, questo viene contrassegnato come Bozza nella console, a indicare che non è ancora disponibile per l’uso da parte degli autori di pagine.
Un modello può avere le seguenti proprietà:
Immagine
Immagine da utilizzare come miniatura del modello per facilitare la selezione, ad esempio nella procedura guidata Crea pagina .
Titolo
Descrizione
Per visualizzare e/o modificare le proprietà:
Lo stato di un modello (bozza, attivato o disattivato) è indicato nella console.
Per definire la miniatura del modello:
Modifica le proprietà del modello.
Scegli se caricare una miniatura o generarla dal contenuto del modello.
Per entrambi i metodi verrà visualizzata un’anteprima della miniatura.
Se non è soddisfacente, tocca o fai clic su Cancella per caricare un’altra immagine o rigenerare la miniatura.
Una volta ottenuta la miniatura desiderata, tocca o fai clic su Salva e chiudi.
Per poter utilizzare un modello quando si crea una pagina, è necessario svolgere le seguenti operazioni:
Un modello può essere abilitato o disabilitato per renderlo disponibile o non disponibile nel Crea pagina procedura guidata.
Una volta abilitato un modello, viene visualizzato un avviso quando un autore inizia ad aggiornare ulteriormente il modello. In questo modo si informa l’utente che è possibile fare riferimento al modello, in modo che eventuali modifiche possano influenzare le pagine che fanno riferimento al modello.
Lo stato di un modello (bozza, attivato o disattivato) è indicato nella console.
Un modello può essere reso disponibile o non disponibile per alcuni rami di pagina.
Apri le Proprietà pagina per la pagina principale del ramo in cui desideri rendere disponibile il modello.
Apri la scheda Avanzate.
In Impostazioni modello utilizza Aggiungi campo per specificare il percorso del modello.
Il percorso può essere esplicito o utilizzare pattern. Esempio:
/conf/<your-folder>/settings/wcm/templates/.*
L’ordine dei percorsi è irrilevante, tutti i percorsi verranno analizzati e gli eventuali modelli recuperati.
Se la Modelli consentiti l’elenco viene lasciato vuoto, quindi la struttura viene ascesa fino a quando non viene trovato un valore o un elenco.
Consulta Disponibilità dei modelli: i principi per i modelli consentiti rimangono gli stessi.
Fai clic su Salva per salvare le modifiche alle proprietà della pagina.
Spesso i modelli consentiti sono predefiniti per l’intero sito quando è configurato.
Poiché al modello viene fatto riferimento quando viene eseguito il rendering di una pagina, il modello completamente configurato deve essere pubblicato in modo che sia disponibile nell’ambiente di pubblicazione.
Nella console Modelli, seleziona il modello.
Seleziona Pubblica nella barra degli strumenti per aprire la procedura guidata.
Seleziona Criteri per contenuto da pubblicare in tandem.
Seleziona Pubblica dalla barra degli strumenti per completare l’azione.
Quando crei o modifichi un modello, puoi definire diversi aspetti. La modifica dei modelli è simile alla creazione delle pagine.
È possibile modificare i seguenti aspetti di un modello:
I componenti aggiunti qui non possono essere spostati o rimossi dalle pagine risultanti dagli autori delle pagine. Se si desidera che gli autori delle pagine siano in grado di aggiungere e rimuovere componenti alle pagine risultanti, è necessario aggiungere un sistema di paragrafi al modello.
Quando i componenti sono bloccati, è possibile aggiungere contenuti che non possono essere modificati dagli autori delle pagine. È possibile sbloccare i componenti per definire Contenuto iniziale.
In modalità struttura non è possibile spostare, tagliare o eliminare i componenti principali di un componente sbloccato.
Quando un componente è stato sbloccato, è possibile definire il contenuto iniziale che verrà copiato nelle pagine risultanti, create dal modello. I componenti sbloccati possono essere modificati nella pagina o nelle pagine risultanti.
Nella modalità Contenuto iniziale e nelle pagine risultanti, tutti i componenti sbloccati che hanno un elemento padre accessibile (ad esempio i componenti all’interno di un contenitore di layout) possono essere eliminati.
Qui è possibile predefinire il layout del modello per i formati di dispositivo richiesti. La modalità Layout per la creazione dei modelli ha le stesse funzionalità della modalità Layout per la creazione delle pagine.
In Criteri di pagina è possibile collegare alla pagina i criteri di pagina predefiniti. I criteri di pagina definiscono le varie configurazioni di progettazione.
Il sistema di stili consente all’autore del modello di definire le classi di stile nel criterio del contenuto di un componente, in modo che un autore di contenuti possa sceglierli quando modifica un componente in una pagina. Gli stili possono essere varianti visive alternative di un componente, per renderlo più flessibile.
Per ulteriori informazioni, consulta la documentazione sul sistema di stili.
Il selettore Modalità nella barra degli strumenti consente di selezionare e modificare l’aspetto appropriato del modello:
L’opzione Criterio pagina nel menu Informazioni pagina consente invece di selezionare i criteri di pagina richiesti:
Se un autore inizia a modificare un modello già abilitato, viene visualizzato un avviso. In questo modo si informa l’utente che è possibile fare riferimento al modello, in modo che eventuali modifiche possano influenzare le pagine che fanno riferimento al modello.
In Struttura La modalità consente di definire i componenti e i contenuti per il modello e i criteri per il modello e i suoi componenti.
I componenti definiti nella struttura del modello non possono essere spostati su una pagina risultante né eliminati da alcuna pagina risultante.
Se desideri che gli autori delle pagine siano in grado di aggiungere e rimuovere componenti, aggiungi al modello un sistema di paragrafi.
I componenti possono essere sbloccati e bloccati di nuovo per consentire di definire il contenuto iniziale.
Vengono definiti i criteri di design per i componenti e la pagina.
In Struttura modalità dell’editor modelli:
Aggiungi componenti
Esistono diversi meccanismi per aggiungere componenti al modello:
Una volta aggiunto, ogni componente è contrassegnato con:
Quando si aggiunge al modello un componente Titolo pronto per l’uso, questo conterrà la struttura di testo predefinita.
Se si modifica questa impostazione e si aggiunge un proprio testo, questo testo aggiornato verrà utilizzato quando si crea una pagina dal modello.
Se si lascia il testo (struttura) predefinito, il titolo predefinito corrisponde al nome della pagina risultante.
Sebbene non sia identica, l’aggiunta di componenti e risorse a un modello ha molte somiglianze con azioni simili quando authoring delle pagine.
Azioni dei componenti
Una volta aggiunti al modello, esegui azioni sui componenti. Ogni singola istanza dispone di una barra degli strumenti che consente di accedere alle azioni disponibili, a seconda del tipo di componente.
Può anche dipendere dalle azioni intraprese, ad esempio se un criterio è stato associato al componente, in tal caso l’icona di configurazione del progetto diventa disponibile.
Modifica e Configura
Con queste due azioni è possibile aggiungere contenuti ai componenti.
Bordo per indicare la Struttura
Quando si lavora in Struttura modalità e bordo arancione indica il componente attualmente selezionato. Una linea tratteggiata indica anche il componente principale.
Ad esempio, nella schermata sottostante il Testo è selezionato all’interno di un Contenitore di layout (responsivegrid).
Criteri e proprietà (Generale)
I criteri di progettazione o di contenuto definiscono le proprietà di progettazione di un componente. Ad esempio, i componenti disponibili o le dimensioni minima/massima. Sono applicabili al modello (e alle pagine create con il modello).
Crea un criterio per i contenuti o selezionane uno esistente per un componente. In questo modo è possibile definire i dettagli del progetto.
La finestra di configurazione è divisa in due parti.
Le proprietà disponibili dipendono dal componente selezionato. Ad esempio, per un componente di testo, le proprietà definiscono, tra le altre opzioni, le opzioni di copia e incolla, le opzioni di formattazione e lo stile del paragrafo.
Criterio
I criteri di progettazione o di contenuto definiscono le proprietà di progettazione di un componente. Ad esempio, i componenti disponibili o le dimensioni minima/massima. Sono applicabili al modello (e alle pagine create con il modello).
In Criterio puoi selezionare un criterio esistente da applicare al componente tramite il menu a discesa.
Puoi aggiungere un nuovo criterio selezionando il pulsante di aggiunta accanto al menu a discesa Seleziona criterio. Quindi devi assegnare un nuovo titolo nel campo Titolo criterio.
Il criterio esistente selezionato nel menu a discesa Seleziona criterio può essere copiato come nuovo criterio utilizzando il pulsante Copia, accanto al menu a discesa. Quindi devi assegnare un nuovo titolo nel campo Titolo criterio. Per impostazione predefinita, il criterio copiato si chiama Copia di X, dove X è il titolo del criterio da cui è stato copiato.
La descrizione del criterio nel campo Descrizione criterio è facoltativa.
Nella sezione Altri modelli che utilizzano il criterio selezionato, è possibile vedere facilmente quali altri modelli utilizzano i criteri selezionati nell’elenco a discesa Seleziona criterio.
Se vengono aggiunti come contenuto iniziale più componenti dello stesso tipo, lo stesso criterio si applica a tutti i componenti. Questo riflette la stessa restrizione in Modalità Progettazione per i modelli statici.
Proprietà
Sotto la Proprietà Puoi definire le impostazioni del componente. L’intestazione ha due schede:
Principale
Sulla Principale vengono definite le impostazioni più importanti del componente.
Ad esempio, per un componente immagine è possibile definire le larghezze consentite e abilitare il caricamento lento.
Se un’impostazione consente più configurazioni, tocca o fai clic sul pulsante Aggiungi per aggiungere un’altra configurazione.
Per rimuovere una configurazione, tocca o fai clic sul pulsante Elimina situato a destra della configurazione.
Per rimuovere una configurazione, tocca o fai clic sul pulsante Elimina.
Funzioni
La Funzioni consente di abilitare o disabilitare funzioni aggiuntive del componente.
Ad esempio, per un componente immagine puoi definire le proporzioni di ritaglio, gli orientamenti consentiti per le immagini e se sono consentiti caricamenti.
In AEM i rapporti di ritaglio sono definiti come altezza/larghezza. Questo differisce dalla definizione tradizionale di larghezza/altezza ed è eseguito per motivi di compatibilità legacy. Gli utenti che creano le pagine non noteranno alcuna differenza, purché sia stato definito chiaramente il Nome, che verrà visualizzato nell’interfaccia utente.
I criteri dei contenuti per i componenti che si avvalgono dell’editor Rich Text possono essere definiti solo per le opzioni disponibili mediante tale editor tramite le impostazioni di interfaccia utente.
Criteri e proprietà (contenitore di layout)
Le impostazioni dei criteri e delle proprietà di un contenitore di layout sono simili all’utilizzo generale, ma con alcune differenze.
La configurazione di un criterio è obbligatoria per i componenti contenitore, in quanto consente di definire i componenti che saranno disponibili nel contenitore .
La finestra di configurazione è divisa in due, come nell'uso generale della finestra.
Criterio
I criteri di progettazione o di contenuto definiscono le proprietà di progettazione di un componente. Ad esempio, i componenti disponibili o le dimensioni minima/massima. Sono applicabili al modello (e alle pagine create con il modello).
In Criterio puoi selezionare un criterio esistente da applicare al componente tramite il menu a discesa. Questo funziona come nell’uso generale della finestra.
Proprietà
Sotto la Proprietà Puoi scegliere i componenti disponibili per il contenitore layout e definirne le impostazioni. L’intestazione ha tre schede:
Componenti consentiti
Sulla Componenti consentiti definisci quali componenti sono disponibili per il contenitore layout.
Componenti standard
Sulla Componenti predefiniti , definisci quali componenti vengono associati automaticamente a determinati tipi di file multimediali in modo che, quando un autore trascina una risorsa dal browser delle risorse, AEM sappia a quale componente associarla. Per tale configurazione sono disponibili solo componenti con zone di rilascio.
Tocca o fai clic su Aggiungi mappatura per aggiungere un componente completamente nuovo e la mappatura del tipo MIME.
Seleziona un componente nell’elenco e tocca o fai clic su Aggiungi tipo per aggiungere un altro tipo MIME a un componente già mappato. Fai clic sull’icona Elimina per rimuovere un tipo di MIME.
Impostazioni reattive
Nella scheda Impostazioni reattive è possibile configurare il numero di colonne nella griglia risultante del contenitore layout.
Sblocca/Blocca componenti
Sblocca/blocca i componenti per definire se il contenuto è disponibile per la modifica in Contenuto iniziale modalità.
Quando un componente è stato sbloccato:
Sul bordo viene visualizzato un indicatore di lucchetto aperto.
La barra degli strumenti del componente viene regolata di conseguenza.
Il contenuto già inserito non verrà più visualizzato in Struttura modalità.
L’elemento padre di un componente sbloccato non può essere spostato, tagliato o cancellato.
Ciò include lo sblocco di componenti contenitore in modo che possano essere aggiunti altri componenti, sia in modalità Contenuto iniziale che sulle pagine risultanti. Se hai già aggiunto componenti/contenuti al contenitore prima di sbloccarlo, questi non saranno più visualizzati in modalità Struttura ma saranno presenti in modalità Contenuto iniziale. In Modalità struttura, verrà mostrato solo il componente del contenitore stesso con il suo elenco di Componenti consentiti.
Per risparmiare spazio, il contenitore di layout non cresce per adattarsi all’elenco dei componenti consentiti. Il contenitore diventa invece un elenco scorrevole.
I componenti configurabili vengono visualizzati con l’icona Policy, che può essere toccata o su cui è possibile fare clic per modificare la policy e le proprietà del componente.
Relazione con le pagine esistenti
Se la struttura viene aggiornata dopo la creazione di pagine basate sul modello, a tali pagine verranno applicate le modifiche apportate al modello. Questo fatto è segnalato da un avviso nella barra degli strumenti e da finestre di dialogo di conferma.
Contenuto iniziale viene utilizzata per definire il contenuto che verrà visualizzato quando una pagina viene creata per la prima volta in base al modello. Il contenuto iniziale può quindi essere modificato dagli autori delle pagine.
Sebbene tutto il contenuto creato in modalità Struttura sia visibile nel Contenuto iniziale, solo i componenti sbloccati possono essere selezionati e modificati.
La modalità Contenuto iniziale è in pratica una modalità di modifica per le pagine create con quel modello. Pertanto, i criteri non vengono definiti in modalità Contenuto iniziale, ma in modalità Struttura.
I componenti sbloccati disponibili per la modifica sono contrassegnati. Quando sono selezionati, hanno un bordo blu:
I componenti sbloccati dispongono di una barra degli strumenti che consente di modificare e configurare il contenuto:
Se un componente del contenitore è stato sbloccato (in modalità Struttura), è possibile aggiungervi nuovi componenti (in modalità Contenuto iniziale). I componenti aggiunti in modalità Contenuto iniziale possono essere spostati o eliminati dalle pagine risultanti.
È possibile aggiungere un componente utilizzando l’area Trascina qui i componenti o l’opzione Inserisci nuovo componente dalla barra degli strumenti del contenitore appropriato.
Se il contenuto iniziale del modello viene aggiornato dopo la creazione delle pagine basate sul modello, tali pagine non saranno influenzate dalle modifiche apportate al contenuto iniziale del modello.
Il contenuto iniziale è destinato alla preparazione dei componenti e del layout di pagina che fungono da punto di partenza per la creazione del contenuto. Non è destinato ad essere il contenuto effettivo che rimarrebbe invariato. Per questo motivo, il contenuto iniziale non può essere tradotto.
È possibile definire il layout del modello per una serie di dispositivi. Il Layout reattivo per i modelli funziona come per la creazione delle pagine.
Le modifiche al layout verranno applicate in modalità Contenuto iniziale, ma non in modalità Struttura.
La progettazione della pagina, comprese le librerie lato client e le policy di pagina obbligatorie, viene mantenuta nell’opzione Progettazione pagina del menu Informazioni pagina.
Per accedere al Progettazione pagina finestra di dialogo:
Da Editor modelli, seleziona Informazioni pagina dalla barra degli strumenti, quindi Progettazione pagina per aprire la finestra di dialogo.
La Progettazione pagina viene aperta una finestra di dialogo divisa in due sezioni:
È possibile applicare un criterio per i contenuti al modello o alle pagine risultanti. In tal modo si definiscono i criteri dei contenuti per il sistema di paragrafi principale della pagina.
Puoi selezionare un criterio esistente per la pagina dal menu a discesa Seleziona criterio.
Puoi aggiungere un nuovo criterio selezionando il pulsante di aggiunta accanto al menu a discesa Seleziona criterio. Quindi devi assegnare un nuovo titolo nel campo Titolo criterio.
Il criterio esistente selezionato nel menu a discesa Seleziona criterio può essere copiato come nuovo criterio utilizzando il pulsante Copia, accanto al menu a discesa. Quindi devi assegnare un nuovo titolo nel campo Titolo criterio. Per impostazione predefinita, il criterio copiato si chiama Copia di X, dove X è il titolo del criterio da cui è stato copiato.
Aggiungi un titolo al criterio nel campo Titolo criterio. Un criterio deve avere un titolo che permetta di riconoscerlo facilmente nel menu a discesa Seleziona criterio.
La descrizione del criterio nel campo Descrizione criterio è facoltativa.
Nella sezione Altri modelli che utilizzano il criterio selezionato, è possibile vedere facilmente quali altri modelli utilizzano i criteri selezionati nell’elenco a discesa Seleziona criterio.
Con le proprietà della pagina è possibile definire le librerie lato client richieste mediante la finestra di dialogo Progettazione pagina. Le librerie lato client includono fogli di stile e Javascript da caricare con il modello e le pagine create con tale modello.
Specifica le librerie lato client da applicare alle pagine create con questo modello. Immetti il nome di una libreria nel campo di testo nella sezione Librerie lato client sezione .
Se sono necessarie più librerie, fai clic sul pulsante Aggiungi per aggiungere un ulteriore campo di testo al nome della libreria.
Aggiungi tutti i campi di testo necessari per le librerie lato client.
Se necessario, definisci la posizione relativa delle librerie trascinando i campi con la maniglia di trascinamento.
L’autore del modello può specificare il criterio della pagina sul modello, ma dovrà ottenere i dettagli delle librerie appropriate lato client dallo sviluppatore.
L’opzione Proprietà pagina iniziale consente di definire le proprietà della pagina iniziale da utilizzare per la creazione delle pagine risultanti.
Dall’editor dei modelli, seleziona Informazioni pagina dalla barra degli strumenti, quindi Proprietà pagina iniziale per aprire la finestra di dialogo.
Nella finestra di dialogo è possibile definire le proprietà che si desidera applicare alle pagine create con questo modello.
Conferma le definizioni con Fine.
Durante la creazione di modelli è consigliabile tenere in considerazione:
L’impatto delle modifiche apportate al modello una volta che le pagine sono state create da quel modello.
Di seguito è riportato un elenco delle diverse operazioni possibili sui modelli e del loro impatto sulle pagine create da essi:
Modifiche alla struttura:
Modifiche ai criteri dei contenuti e alle configurazioni di progettazione:
Modifiche al contenuto iniziale:
Le modifiche al layout dipendono dal fatto che il componente modificato faccia parte di:
Presta particolare attenzione quando:
Blocco o sblocco di componenti su modelli abilitati.
Questo può avere effetti collaterali, in quanto le pagine esistenti possono già utilizzarlo. In genere:
AEM fornisce avvisi espliciti quando si modifica lo stato di blocco dei componenti su modelli che non sono più bozze.
Creazione di cartelle personalizzate per i modelli specifici per il sito.
Pubblicare i modelli dal Modelli console.