Authoring dei frammenti di contenuto authoring-content-fragments

L’authoring dei frammenti di contenuto si concentra sia sulla distribuzione headless che sull’authoring delle pagine.

Sono disponibili due editor per i frammenti di contenuto. L’editor descritto in questa sezione:

  • è stato sviluppato per la distribuzione di contenuti headless (anche se può essere utilizzato per tutti gli scenari)
  • è disponibile dalla console Frammenti di contenuto

Questo editor fornisce:

WARNING
L'editor descritto in questa sezione è only disponibile nell'as a Cloud Service online Adobe Experience Manager (AEM).

Editor frammento di contenuto content-fragment-editor

La prima volta che apri l’Editor frammento di contenuto vengono visualizzate quattro aree principali:

  • Barra degli strumenti superiore: per informazioni chiave e azioni

  • Pannello a sinistra: presenta le Varianti del frammento di contenuto e i relativi Campi:

  • pannello a destra: presenta le schede che mostrano le proprietà (metadati) e i tag, informazioni sulla cronologia delle versioni e informazioni relative a copie per lingua

    • Scheda Proprietà, in cui puoi aggiornare il Titolo e la Descrizione del frammento, oppure la Variante
  • Pannello centrale: presenta i campi e il contenuto effettivi della variante selezionata

    • Consente di modificare il contenuto
      • se configurati (come più) nel modello, vari tipi di dati ti consentono di Aggiungere istanze del campo pertinente
    • Se i campi Segnaposto scheda sono definiti all'interno del modello, vengono visualizzati qui e possono essere utilizzati per la navigazione. Verranno presentati orizzontalmente o come elenco a discesa.
    note note
    NOTE
    A seconda delle definizioni nel modello sottostante, i campi possono essere soggetti a determinati tipi di convalida.

Editor frammento di contenuto - Panoramica

Un singolo frammento di contenuto;

  • È costituito da due livelli:

    • Varianti del frammento di contenuto
    • Campi - definiti dal modello per frammenti di contenuto e utilizzati da ogni variante
  • Può contenere diversi riferimenti.

Varianti e campi variations-and-fields

Nel pannello a sinistra puoi vedere:

  • l'elenco di Varianti create per questo frammento:

    • Principale è la variante presente al momento della creazione del frammento di contenuto. Puoi aggiungerne altre in un secondo momento
    • Puoi utilizzare Genera varianti (#generate-variations) per utilizzare un modello basato su prompt creato da Adobe per un caso d’uso specifico.
    • puoi anche creare una variante
  • Campi all'interno del frammento e relative varianti:

    • l'icona indica il Tipo di dati
    • il testo è il nome del campo
    • insieme, forniscono un collegamento diretto al contenuto del campo nel pannello centrale (per la variante corrente)

In varie parti dell’editor è possibile visualizzare l’icona del collegamento. Può essere utilizzato per aprire l’elemento visualizzato, ad esempio un Modello per frammento di contenuto, un Riferimento principale o un frammento a cui si fa riferimento:

Editor frammento di contenuto - Icona collegamento

Albero struttura structure-tree

Apri la scheda Struttura dalla barra degli strumenti dell'editor per visualizzare la struttura gerarchica del frammento di contenuto e i relativi riferimenti. Utilizza le icone dei collegamenti per passare ai riferimenti.

Editor frammento di contenuto - Struttura

Salvataggio e salvataggio automatico saving-autosaving

Con ogni aggiornamento effettuato, il frammento di contenuto viene salvato automaticamente. L’ultimo salvataggio viene visualizzato nella barra degli strumenti superiore.

Varianti variations

Le varianti sono una caratteristica importante dei frammenti di contenuto dell'AEM. Consentono di creare e modificare copie del contenuto Principale da utilizzare su canali e scenari specifici, rendendo ancora più flessibile la distribuzione di contenuti headless e l'authoring delle pagine.

Dall’editor è possibile:

Crea una variante create-variation

Per creare una variante del frammento di contenuto:

  1. Nel pannello a sinistra, seleziona il segno più (Crea variante) a destra di Varianti.

    note note
    NOTE
    Dopo aver creato la prima variante, le varianti esistenti vengono elencate nello stesso pannello.

    Editor frammento di contenuto - Crea la tua prima variante

  2. Nella finestra di dialogo, immetti un Titolo per la variante e una Descrizione se necessario:

    Editor frammento di contenuto - Finestra di dialogo Crea variante

  3. Crea la variante. Viene visualizzato nell'elenco.

Rinominare una variante rename-variation

Per rinominare una variante:

  1. Seleziona la variante desiderata.

  2. Apri la scheda Proprietà nel pannello di destra.

  3. Aggiorna la variante Titolo.

  4. Premi Invio o passa a un altro campo per salvare automaticamente la modifica. Il titolo viene aggiornato nel pannello Varianti a sinistra.

Creare varianti utilizzando GenAI con Genera varianti generate-variations-ai

Utilizza le varianti generative per sfruttare l’intelligenza artificiale generativa per accelerare la creazione dei contenuti.

Per utilizzare le Varianti generative nell’Editor frammento di contenuto:

  1. Apri l’Editor frammento di contenuto. Nell’intestazione troverai il punto di ingresso per Generare varianti:

    Genera varianti nelleditor frammenti di contenuto

  2. Genera varianti si apre in una nuova scheda. Nella barra a sinistra puoi vedere l’istanza di AEM Cloud e il Frammento di contenuto per cui stai creando i contenuti. Selezionare il prompt da utilizzare o crearne uno nuovo.

    note note
    NOTE
    I modelli di prompt di Adobe disponibili sono ora limitati, ma ne verranno aggiunti altri in versioni future.

    Esporta per generare varianti nel frammento di contenuto

  3. Genera il contenuto compilando i prompt. Il modello di contenuto del frammento verrà utilizzato automaticamente per generare contenuto utilizzando GenAI.

    note note
    NOTE
    Al momento sono supportati solo i campi di testo.

    Esporta per generare varianti nel frammento di contenuto

  4. Seleziona la variante di generazione desiderata e fai clic su "Esporta variante". Conferma il nome della variante del frammento di contenuto e seleziona una delle seguenti opzioni:

    • Esporta: esporta la variante nel frammento di contenuto e resta nell'applicazione Genera variante.

    • Esporta e apri: esporta la variante in Frammento di contenuto e apri una nuova scheda che mostra il Frammento di contenuto con la nuova variante GenAI.

      Esporta per generare varianti nel frammento di contenuto

  5. Le varianti generate vengono visualizzate nell’Editor frammento di contenuto principale.

    Visualizza generazione varianti nel frammento di contenuto

Per ulteriori informazioni, consulta Generare varianti.

Eliminare una variante delete-variation

Per eliminare una variante del frammento di contenuto:

<div class="extension note">
<div>NOTE</div>
<div>
<p>Impossibile eliminare <strong>Main</strong>.</p>
</div>
</div>
  1. Seleziona la Variante.

  2. Nel pannello Variante, seleziona l'icona Elimina (Cestino):

    Editor frammento di contenuto - Icona Elimina variante

  3. Viene visualizzata una finestra di dialogo. Seleziona Elimina per confermare l'azione.

Modifica campi di testo su più righe - Testo normale o Markdown edit-multi-line-text-fields-plaintext-markdown

I campi di testo su più righe possono avere uno dei tre formati seguenti:

I campi definiti come Testo normale o Markdown hanno una casella di testo semplice, senza opzioni di formattazione (su schermo):

Editor frammento di contenuto - Testo su più righe - schermo intero

Modifica campi di testo su più righe - Testo formattato edit-multi-line-text-fields-rich-text

Per i campi Testo su più righe definiti come Testo formattato, sono disponibili diverse funzionalità:

  • Modifica il contenuto:

    • Annulla/Ripristina
    • Incolla/Incolla come testo
    • Copiare
    • Seleziona formato paragrafo
    • Crea/gestisci tabella
    • Formato testo; grassetto, corsivo, sottolineato, colore
    • Imposta allineamento paragrafo
    • Crea/gestisci elenchi; puntati, numerati
    • Rientro testo; riduzione, aumento
    • Cancella formattazione corrente
    • Inserisci collegamenti
    • Selezionare e inserire riferimenti a risorse immagine
    • Aggiungi caratteri speciali
  • Editor a schermo intero - passaggio da schermo intero a flusso interno

  • Statistiche

  • Confronta e sincronizza

Ad esempio:

Editor frammento di contenuto - Testo su più righe - Attiva/Disattiva schermo intero

NOTE
I campi di testo su più righe sono inoltre indicati dall'icona appropriata nel pannello Campi.

Editor a schermo intero - Rich Text full-screen-editor-rich-text

L’editor a schermo intero offre le stesse opzioni di modifica disponibili durante il flusso, ma offre più spazio per il testo.

Ad esempio:

Editor frammento di contenuto - Testo su più righe - schermo intero

Statistiche - Rich Text statistics-rich-text

L'azione Statistiche visualizza un intervallo di informazioni sul testo in un campo Multiriga.

Ad esempio:

Editor frammento di contenuto - Statistiche

Confronta e sincronizza - Testo formattato compare-and-synchronize-rich-text

L'azione Confronta è disponibile per i campi con più righe quando è aperta una variante.

Questo apre il campo Multiriga a schermo intero e:

  • visualizza in parallelo il contenuto per Principale e la Variante corrente, evidenziando le eventuali differenze

  • le differenze sono indicate dal colore:

    • Il contenuto aggiunto alla variante è indicato in verde
    • II contenuto rimosso dalla variante è indicato in rosso
    • Il testo sostituito è indicato in blu.
  • fornisce l'azione Sincronizza, che sincronizza il contenuto da Principale alla variante corrente

    • se Principale è stato aggiornato, queste modifiche verranno trasferite nella variante
    • se la variante è stata aggiornata, queste modifiche verranno sovrascritte dal contenuto di Main
    note caution
    CAUTION
    La sincronizzazione è disponibile solo per copiare le modifiche da Principale ​alla variante.
    Il trasferimento delle modifiche da una variante a Principale non è disponibile come opzione.

Ad esempio, uno scenario in cui il contenuto della variante è stato completamente riscritto, in modo che una sincronizzazione sostituisca il nuovo contenuto con il contenuto di Main:

Editor frammenti di contenuto - Confronta e sincronizza

Gestisci riferimenti manage-references

Riferimenti ai frammenti fragment-references

I riferimenti ai frammenti possono essere utilizzati per:

Creare un riferimento a un frammento di contenuto esistente create-reference-existing-content-fragment

Per creare un riferimento a un frammento di contenuto esistente:

  1. Seleziona il campo.

  2. Seleziona Aggiungi frammento esistente.

  3. Seleziona il frammento richiesto dal selettore di frammenti.

    note note
    NOTE
    È possibile selezionare un solo frammento alla volta.

Creare un frammento di contenuto e un riferimento create-reference-content-fragment

In alternativa, è possibile selezionare Crea nuovo frammento per aprire la finestra di dialogo Crea. Una volta creato, viene fatto riferimento a questo frammento.

Riferimenti al contenuto content-references

I riferimenti ai contenuti vengono utilizzati per fare riferimento ad altri tipi di contenuti AEM, ad esempio immagini, pagine e frammenti di esperienza.

Immagini di riferimento reference-images

Nei campi Riferimento contenuto è possibile:

  • risorse di riferimento già esistenti nell’archivio

  • caricali direttamente nel campo; questo evita la necessità di utilizzare la console Assets per caricare

    note note
    NOTE
    Per caricare direttamente un'immagine nel campo Riferimento contenuto, deve:
    • hanno un Percorso principale definito (nel Modello per frammenti di contenuto). Specifica dove verrà memorizzata l'immagine.
    • includi Immagine nell'elenco dei tipi di contenuto accettati

Per aggiungere una risorsa, puoi effettuare le seguenti operazioni:

  • trascina e rilascia il nuovo file di risorse direttamente (ad esempio, dal file system) nel campo Riferimento contenuto

  • utilizza l'azione Aggiungi risorsa, quindi seleziona Sfoglia Assets o Carica per aprire il selettore appropriato da utilizzare:

    Editor frammento di contenuto - Aggiungi opzioni risorsa

Pagine di riferimento reference-pages

Per aggiungere riferimenti a pagine AEM, frammenti di esperienza o altri tipi di contenuto di questo tipo:

  1. Selezionare Aggiungi percorso contenuto.

  2. Aggiungi il percorso richiesto nel campo di input.

  3. Conferma con Aggiungi.

NOTE
Questo non deve essere utilizzato per riferimenti a:

Visualizza riferimenti padre view-parent-references

Selezionando l’icona del collegamento nella barra degli strumenti superiore si apre un elenco di tutti i riferimenti principali.

Ad esempio:

Editor frammento di contenuto - Mostra riferimenti

Viene visualizzata una finestra in cui sono elencati tutti i riferimenti correlati. Per aprire un riferimento, selezionate il nome o il titolo o l'icona del collegamento.

Ad esempio:

Editor frammento di contenuto - Mostra riferimenti

Visualizza proprietà e tag view-properties-tags

Nella scheda delle proprietà del pannello di destra, è possibile visualizzare le proprietà (metadati) e i tag. Le proprietà possono essere:

  • per Frammento di contenuto - se Principale è attualmente selezionato
  • per una variante specifica

Editor frammento di contenuto - Proprietà

Modifica proprietà e tag edit-properties-tags

Nella scheda delle proprietà (pannello a destra) puoi anche modificare:

  • Titolo

  • Descrizione

  • Tag: utilizzo dell'elenco a discesa o della finestra di dialogo di selezione

    Editor frammento di contenuto - Gestisci tag

Aprire il modello per frammenti di contenuto open-content-fragment-model

Quando hai selezionato Principale, il nome del modello per frammenti di contenuto sottostante viene visualizzato nella sezione delle proprietà. Selezionando l’icona del collegamento, apre il modello in una scheda separata.

Ad esempio:

Editor frammento di contenuto - Apri modello frammento di contenuto

Visualizzare la cronologia delle versioni view-version-history

Nella scheda Cronologia versioni del pannello di destra vengono visualizzati i dettagli delle versioni corrente e precedente:

NOTE
Al momento della pubblicazione del frammento di contenuto viene creata una nuova versione.

Editor frammento di contenuto - Panoramica cronologia versioni

Confronta versione compare-version

Per un frammento di contenuto è possibile confrontare una versione precedente con la versione corrente.

Per confrontare una versione precedente con la versione corrente:

  1. Seleziona l’icona dei tre punti accanto alla versione.

  2. Seleziona Confronta.

Editor frammento di contenuto - Confronto cronologia versioni

Viene aperta una visualizzazione in cui sono visualizzate le differenze tra la versione corrente del contenuto e la versione precedente selezionata del frammento di contenuto. Dal menu a discesa Varianti con modifiche, puoi selezionare di visualizzare le differenze rispetto al contenuto principale e/o al contenuto di una variante.

Le differenze sono indicate dal colore:

  • Verde: indica il contenuto aggiunto (alla versione corrente)
  • Rosso: indica il contenuto rimosso (dalla versione corrente)

Editor frammento di contenuto - Cronologia versioni - Confronta versioni

Ripristina una versione revert-version

Puoi ripristinare qualsiasi versione.

Per ripristinare una versione specifica:

  1. Seleziona l’icona dei tre punti accanto alla versione.

  2. Seleziona Ripristina.

Editor frammento di contenuto - Ripristino cronologia versioni

Visualizzare le copie per lingua view-language-copies

Nella scheda Proprietà lingua vengono visualizzati i dettagli di tutte le copie delle lingue correlate. Selezionando un’icona di collegamento, apre la copia in una scheda separata.

Ad esempio:

Editor frammento di contenuto - Apri copia lingua

NOTE
Per ulteriori dettagli sulla traduzione di un frammento di contenuto e sulla creazione di copie per lingua, consulta Percorso di traduzione headless AEM.

Visualizzare l’anteprima del frammento preview-content-fragment

L’editor dei frammenti di contenuto offre agli autori la possibilità di visualizzare in anteprima le modifiche apportate in un’applicazione front-end esterna.

Per utilizzare questa funzione, devi innanzitutto:

  • Collabora con il tuo team IT per configurare l’applicazione front-end esterna che eseguirà il rendering del frammento di contenuto consumando il relativo output JSON.
  • Quando l'applicazione front-end esterna è configurata, il Pattern URL di anteprima predefinito deve essere definito come proprietà del modello per frammenti di contenuto appropriato.

Una volta definito l'URL, il pulsante Anteprima è attivo. Puoi selezionare questo pulsante per avviare l’applicazione esterna (in una scheda separata) per eseguire il rendering del frammento di contenuto.

Publish del frammento publish-content-fragment

Puoi Publish il frammento in:

  • Anteprima istanza
  • istanza Publish

Puoi pubblicare il frammento dall’editor o dalla console. Per informazioni dettagliate, consulta Pubblicazione e anteprima di un frammento.

Annullare la pubblicazione del frammento unpublish-content-fragment

Puoi anche Annullare la pubblicazione del frammento da:

  • Anteprima istanza
  • istanza Publish

Puoi annullare la pubblicazione del frammento dall’editor o dalla console. Per informazioni dettagliate, vedere Annullamento della pubblicazione di un frammento.

Campi, tipi di dati e icone fields-datatypes-icons

Nel pannello Campi sono elencati tutti i campi all'interno del frammento di contenuto. L'icona indica il tipo di dati:

Testo su riga singola
Testo su più righe
Numero
Booleano
Data e ora
Enumerazione
Tag
Riferimento contenuto
Riferimento frammento
Oggetto JSON

Segnaposto scheda

Sebbene non rappresentato da un'icona effettiva, nel pannello sinistro è rappresentato un segnaposto scheda.
È rappresentato anche nel pannello centrale, orizzontalmente come mostrato, o in un elenco a discesa (quando ce ne sono troppi da mostrare orizzontalmente).

Buono a sapersi good-to-know

  • Per modificare un frammento di contenuto sono necessarie le autorizzazioni appropriate. Se riscontri problemi, contatta l’amministratore del sistema.

    Ad esempio, se non disponi delle autorizzazioni edit, l'editor sarà di sola lettura.

  • Un modello per frammenti di contenuto può spesso definire campi di dati denominati Titolo e Descrizione. Se questi campi esistono, sono definiti dall'utente e possono essere aggiornati nel pannello centrale durante la modifica del frammento.

    Il frammento di contenuto e le relative varianti dispongono anche di campi di metadati (proprietà variante) denominati Titolo e Descrizione. Questi campi sono parte integrante di qualsiasi frammento di contenuto e sono stati inizialmente definiti durante la creazione del frammento. Possono essere aggiornati nel pannello di destra durante la modifica del frammento.

  • Consulta la documentazione di Assets per informazioni complete sull'editor originale per frammenti di contenuto, disponibile sia nella console Assets che nella console Frammenti di contenuto.

  • Se necessario, il team del progetto può personalizzare l’editor. Per ulteriori dettagli, consulta Personalizzazione della console e dell'editor dei frammenti di contenuto.

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab