[AEM Sites]{class="badge positive" title="Si applica ad AEM Sites)."}
Definizione dei modelli per frammenti di contenuto defining-content-fragment-models
I modelli per frammenti di contenuto in Adobe Experience Manager (AEM) as a Cloud Service definiscono la struttura per il contenuto dei frammenti di contenuto. Questi frammenti possono quindi essere utilizzati per l’authoring delle pagine o come base per i contenuti headless.
Questa pagina illustra come definire il modello per frammenti di contenuto utilizzando l’editor dedicato. Consulta Gestione dei modelli per frammenti di contenuto per ulteriori attività e opzioni disponibili dopo la creazione dei frammenti, tra cui azioni disponibili nella Console Frammenti di contenuto, autorizzazione del modello nella cartella e pubblicazione del modello.
- "Questo modello ha uno schema di interfaccia utente personalizzato configurato. L’ordine dei campi visualizzati in questa interfaccia utente potrebbe non corrispondere allo schema dell’interfaccia utente. Per visualizzare i campi allineati con lo schema dell’interfaccia utente, devi passare al nuovo Editor frammento di contenuto."
Definizione del modello per frammenti di contenuto defining-your-content-fragment-model
Il modello per frammenti di contenuto definisce efficacemente la struttura dei frammenti di contenuto risultanti utilizzando una selezione di Tipi di dati. Utilizzando l’editor modelli è possibile aggiungere istanze dei tipi di dati, quindi configurarle per creare i campi richiesti:
-
Nella Console Frammenti di contenuto, seleziona il pannello per Modelli per frammenti di contenuto e passa alla cartella contenente il modello per frammenti di contenuto.
note NOTE Puoi anche aprire un modello direttamente dopo averlo creato. -
Apri il modello richiesto per Modifica. Utilizza uno dei collegamenti di azione rapida oppure seleziona il modello e quindi l’azione dalla barra degli strumenti.
Una volta aperto, l’editor modelli mostra:
-
superiore:
- Icona Home
- opzione per passare da original al nuovo editor
- Annulla
- Salva
-
a sinistra: Tipi di dati disponibili per la creazione di campi
-
middle: campi già definiti insieme all’opzione Aggiungi
-
a destra: utilizzando le icone all’estrema destra puoi scegliere tra:
- Proprietà: definire e visualizzare le proprietà per il campo selezionato
- Dettagli modello: mostra lo stato Enabled, Titolo modello, Tag, Descrizione e URL anteprima
-
-
Per aggiungere un campo
-
Effettua una delle seguenti operazioni:
- Trascina un tipo di dati dal pannello di sinistra alla posizione desiderata per un campo nel pannello centrale.
- Selezionare l’icona + per un tipo di dati per aggiungerla alla fine dell’elenco dei campi.
- Seleziona Aggiungi nel pannello centrale e quindi il tipo di dati richiesto dall’elenco a discesa risultante per aggiungere un campo alla fine dell’elenco.
note NOTE I campi segnaposto scheda devono essere sempre visualizzati sopra i campi esistenti. -
Puoi riposizionare un campo utilizzando la formazione di punti a sinistra della casella del campo:
-
Una volta aggiunto un campo al modello (e selezionato), il pannello di destra mostra le Proprietà che possono essere definite per quel particolare tipo di dati. Qui puoi definire cosa è necessario per il
campo.-
Molte proprietà sono auto-esplicative. Per ulteriori dettagli, vedere Proprietà (tipi di dati).
-
La digitazione di un Etichetta campo completa automaticamente il Nome proprietà - se vuoto, e può essere aggiornato manualmente in seguito.
note caution CAUTION Quando si aggiorna manualmente la proprietà Nome proprietà per un tipo di dati, i nomi devono contenere solo caratteri A-Z, a-z, 0-9 e il carattere speciale di sottolineatura "_". Se i modelli creati in versioni precedenti di AEM contengono caratteri non validi, rimuovi o aggiorna tali caratteri.
Ad esempio:
note NOTE Quando un campo è definito come Obbligatorio, l'Etichetta indicata nel riquadro centrale è contrassegnata con un asterisco (*). -
-
-
Per rimuovere un campo
Seleziona l’icona cestino per il campo appropriato nel pannello centrale.
-
Aggiungi tutti i campi obbligatori e definisci le relative proprietà in base alle esigenze.
-
Seleziona Salva per mantenere la definizione.
Tipi di dati data-types
Per definire il modello è disponibile una selezione di tipi di dati:
-
Testo su riga singola
- Aggiungi un campo per una singola riga di testo; è possibile definire la lunghezza massima
- Il campo può essere configurato per consentire agli autori di frammenti di creare nuove istanze del campo
-
Testo su più righe
- Area di testo che può essere RTF, Testo normale o Markdown
- Il campo può essere configurato per consentire agli autori di frammenti di creare nuove istanze del campo
note NOTE Se l'area di testo è RTF, Testo normale o Markdown, è definito nel modello dalla proprietà Tipo predefinito. Questo formato non può essere modificato dall'Editor frammento di contenuto, ma solo dal modello. -
Numero
- Aggiungere un campo numerico
- Il campo può essere configurato per consentire agli autori di frammenti di creare nuove istanze del campo
-
Booleano
- Aggiungi una casella di controllo booleana
-
Data e ora
- Aggiungere un campo data e/o ora
-
Enumerazione
- Aggiungere un set di campi Casella di controllo, Pulsante di scelta o A discesa
- Puoi specificare le opzioni disponibili per l’autore del frammento
- Aggiungere un set di campi Casella di controllo, Pulsante di scelta o A discesa
-
Tag
- Consente agli autori di frammenti di accedere alle aree dei tag e di selezionarle
-
Riferimento frammento
-
I riferimenti ad altri frammenti di contenuto possono essere utilizzati per creare contenuto nidificato
-
Il tipo di dati può essere configurato in modo da consentire agli autori di frammenti di:
- Modificare direttamente il frammento a cui si fa riferimento.
- Creare un nuovo frammento di contenuto basato sul modello appropriato
- Crea nuove istanze del campo
-
Il riferimento specifica il percorso della risorsa di riferimento, ad esempio
/content/dam/path/to/resource
note NOTE AEM dispone di protezione di ricorrenza per: -
Riferimenti al contenuto> In questo modo si impedisce all’utente di aggiungere un riferimento al frammento corrente e si potrebbe creare una finestra di dialogo di selezione Riferimento frammento vuota.
-
Riferimenti frammento in GraphQL> Se crei una query approfondita che restituisce più frammenti di contenuto a cui si fa riferimento l’un l’altro, alla prima occorrenza restituisce null.
note caution CAUTION Se esegui una query su più frammenti a cui si fa riferimento, non è consigliabile che i vari modelli di frammenti abbiano nomi di campo con lo stesso nome, ma tipi diversi. Per ulteriori dettagli vedi API GraphQL di AEM per l'utilizzo con Frammenti di contenuto - Limitazioni Riferimento contenuto content-reference
Il tipo di dati Riferimento contenuto consente di eseguire il rendering del contenuto da un’altra origine, ad esempio immagine, pagina o frammento di esperienza.
Oltre alle proprietà standard puoi specificare:
-
Percorso principale, che specifica o rappresenta la posizione in cui archiviare il contenuto a cui si fa riferimento
note NOTE Questo è obbligatorio se desideri caricare e fare riferimento direttamente alle immagini in questo campo quando utilizzi l’editor di frammenti di contenuto. Per ulteriori dettagli, vedi Immagini di riferimento. -
I tipi di contenuto a cui è possibile fare riferimento
note NOTE Devono includere Immagine se desideri caricare e fare riferimento direttamente alle immagini in questo campo quando utilizzi l'editor di frammenti di contenuto. Per ulteriori dettagli, vedi Immagini di riferimento. -
Le limitazioni per le dimensioni dei file
-
Se si fa riferimento a un’immagine:
- Mostra miniatura
- Limiti di altezza e larghezza dell’immagine
Riferimento frammento (frammenti nidificati) fragment-reference-nested-fragments
Il tipo di dati Riferimento frammento può fare riferimento a uno o più frammenti di contenuto. Questa funzione è particolarmente interessante per il recupero dei contenuti da utilizzare nell’app, in quanto consente di recuperare dati strutturati con più livelli.
Ad esempio:
- Un modello che definisce i dettagli di un dipendente, tra cui:
- Un riferimento al modello che definisce il datore di lavoro (azienda)
code language-xml type EmployeeModel { name: String firstName: String company: CompanyModel } type CompanyModel { name: String street: String city: String }note NOTE I riferimenti ai frammenti sono di particolare interesse per la distribuzione di contenuti headless tramite frammenti di contenuto con GraphQL. Oltre alle proprietà standard puoi definire:
-
Rendering come:
-
multifield: l’autore del frammento può creare più riferimenti individuali
-
fragmentreference: consente all’autore del frammento di selezionare un singolo riferimento a un frammento
-
-
Tipo di modello
È possibile selezionare più modelli. Quando si aggiungono riferimenti a un frammento di contenuto, tutti i frammenti a cui si fa riferimento devono essere stati creati utilizzando questi modelli. -
Percorso principale
Specifica o rappresenta un percorso principale per tutti i frammenti a cui si fa riferimento. -
Consenti creazione di frammenti
Questo consente all’autore del frammento di creare un frammento basato sul modello appropriato.
- fragmentreferencecomposite: consente all’autore del frammento di creare un elemento composito selezionando più frammenti
note NOTE È presente un meccanismo di protezione per evitare le ricorrenze. Non consente all’utente di selezionare il frammento di contenuto corrente nel riferimento frammento e può causare una finestra di dialogo vuota per la selezione del riferimento frammento. In GraphQL è inoltre disponibile una protezione di ricorrenza per i riferimenti di frammenti. Se crei una query approfondita tra due frammenti di contenuto che si riferiscono l’uno all’altro, restituisce null. -