Modelli per frammenti di contenuto

ATTENZIONE

L'API AEM GraphQL per la distribuzione dei frammenti di contenuto è disponibile su richiesta.

Per abilitare l'API per il AEM come programma di Cloud Service, contattate il supporto di Adobe.

I modelli di frammenti di contenuto definiscono la struttura del contenuto per i frammenti di contenuto.

Per utilizzare i modelli di frammenti di contenuto, effettuare le seguenti operazioni:

  1. Abilitare la funzionalità del modello di frammento di contenuto per l’istanza
  2. Creare e configurare i modelli di frammenti di contenuto
  3. Abilitare i modelli di frammenti di contenuto per la creazione di frammenti di contenuto da utilizzare durante la creazione di frammenti di contenuto

Creazione di un modello di frammento di contenuto

  1. Andate a Strumenti, Risorse, quindi aprite Modelli di frammenti di contenuto.

  2. Andate alla cartella appropriata per la configurazione.

  3. Utilizzare Create per aprire la procedura guidata.

    ATTENZIONE

    Se l'utilizzo di modelli di frammento di contenuto non è stato abilitato, l'opzione Crea non sarà disponibile.

  4. Specifica il Titolo modello. È inoltre possibile aggiungere Tag e Descrizione se necessario.

    titolo e descrizione

  5. Utilizzare Create per salvare il modello vuoto. Un messaggio indica l'esito positivo dell'azione, è possibile selezionare Apri per modificare immediatamente il modello, oppure Fine per tornare alla console.

Definizione del modello di frammento di contenuto

Il modello di frammento di contenuto definisce in modo efficace 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:

ATTENZIONE

La modifica di un modello di frammento di contenuto esistente può avere un impatto sui frammenti dipendenti.

  1. Andate a Strumenti, Risorse, quindi aprite Modelli di frammenti di contenuto.

  2. Individuate la cartella che contiene il modello di frammento di contenuto.

  3. Aprire il modello richiesto per Edit; utilizzare l'azione rapida oppure selezionare il modello e quindi l'azione dalla barra degli strumenti.

    Una volta aperto l'editor modelli mostra:

    • left: campi già definiti
    • A destra: Tipi di dati disponibili per la creazione di campi, oltre alle Proprietà da utilizzare dopo la creazione.
    NOTA

    Quando un campo è obbligatorio, l’Etichetta indicata nel riquadro a sinistra sarà contrassegnata con un asterisco (*).

  4. Aggiunta di un campo

    • Trascinare un tipo di dati richiesto nella posizione desiderata per un campo.

    • Una volta aggiunto un campo al modello, il pannello a destra mostrerà le Proprietà che possono essere definite per quel particolare tipo di dati. Qui è possibile definire i requisiti necessari per tale campo.
      Molte proprietà sono autoesplicative, per ulteriori dettagli vedere Proprietà.

  5. Rimozione di un campo

    Selezionate il campo desiderato, quindi toccate o fate clic sull'icona del cestino. Viene richiesto di confermare l’operazione.

  6. Aggiungete tutti i campi obbligatori e definite le relative proprietà, a seconda delle necessità.

  7. Selezionare Save per mantenere la definizione.

Tipi di dati

È disponibile una selezione di tipi di dati per definire il modello:

  • Testo su riga singola
    • aggiungere uno o più campi di una singola riga di testo; la lunghezza massima può essere definita
  • Testo su più righe
    • Un'area di testo che può essere RTF, Testo normale o Marcatura
  • Numero
    • Aggiungere uno o più campi numerici
  • Booleano
    • Aggiungi una casella di controllo booleana
  • Data e ora
    • Aggiungere una data e/o un’ora
  • Enumerazione
    • Aggiungere un set di caselle di controllo, pulsanti di scelta o campi a discesa
  • Tag
    • Consente agli autori dei frammenti di accedere e selezionare le aree dei tag
  • Riferimento contenuto

Proprietà

Molte proprietà sono auto-esplicative, per alcune proprietà ulteriori dettagli sono di seguito:

  • Rendering
    con nome: varie opzioni per realizzare/eseguire il rendering del campo in un frammento. Spesso questo consente di definire se l’autore visualizzerà una singola istanza del campo o se potrà creare più istanze.

  • Etichetta
    campoImmissione di un
    L' etichetta campo genererà automaticamente un nome ​proprietà, che potrà quindi essere aggiornato manualmente, se necessario.

  • La convalida
    ValidationBasic è disponibile tramite meccanismi quali la proprietà ​Requiredproperty. Alcuni tipi di dati dispongono di campi di convalida aggiuntivi. Per ulteriori informazioni, vedere Convalida.

  • Per il tipo di dati Testo su più righe è possibile definire il Tipo predefinito come:

    • Formato RTF
    • Markdown
    • Testo normale

    Se non viene specificato, per questo campo viene utilizzato il valore predefinito Rich Text.

    La modifica del Tipo predefinito in un modello per frammenti di contenuto avrà effetto solo su un frammento esistente correlato, una volta che il frammento è stato aperto nell’editor e successivamente salvato.

Convalida

Diversi tipi di dati ora includono la possibilità di definire i requisiti di convalida per l'immissione di contenuto nel frammento risultante:

  • Testo su riga singola
    • Confrontate con un regex predefinito.
  • Numero
    • Verificate la presenza di valori specifici.

Abilitazione o disattivazione di un modello di frammento di contenuto

Per il controllo completo sull’utilizzo dei modelli di frammenti di contenuto, è possibile impostare uno stato.

Abilitazione di un modello di frammento di contenuto

Una volta creato, il modello deve essere abilitato in modo che:

  • È disponibile per la selezione quando si crea un nuovo frammento di contenuto.
  • È possibile fare riferimento all'interno di un modello di frammento di contenuto.
  • È disponibile per GraphQL; in modo che lo schema venga generato.

Per abilitare un modello contrassegnato come:

  • Bozza : mew (mai attivato).
  • Disattivato : è stato specificamente disabilitato.

È possibile utilizzare l'opzione Abilita da:

  • La barra degli strumenti superiore, quando è selezionato il modello richiesto.
  • Azione rapida corrispondente (posizionamento del mouse sul modello richiesto).

Abilita una bozza o un modello disattivato

Disattivazione di un modello di frammento di contenuto

È inoltre possibile disattivare un modello in modo che:

  • Il modello non è più disponibile come base per la creazione di nuovi frammenti di contenuto.
  • However:
    • Lo schema GraphQL continua a essere generato ed è ancora interrogabile (per evitare di influenzare l'API JSON).
    • Eventuali frammenti di contenuto basati sul modello possono ancora essere interrogati e restituiti dall'endpoint GraphQL.
  • Non è più possibile fare riferimento al modello, ma i riferimenti esistenti vengono mantenuti invariati e possono comunque essere interrogati e restituiti dall'endpoint GraphQL.

Per disabilitare un modello contrassegnato come Abilitato, utilizzare l'opzione Disattiva da:

  • La barra degli strumenti superiore, quando è selezionato il modello richiesto.
  • Azione rapida corrispondente (posizionamento del mouse sul modello richiesto).

Disattivazione di un modello abilitato

Eliminazione di un modello di frammento di contenuto

ATTENZIONE

L'eliminazione di un modello di frammento di contenuto può avere un impatto sui frammenti dipendenti.

Per eliminare un modello di frammento di contenuto:

  1. Andate a Strumenti, Risorse, quindi aprite Modelli di frammenti di contenuto.

  2. Individuate la cartella che contiene il modello di frammento di contenuto.

  3. Selezionare il modello, seguito da Elimina dalla barra degli strumenti.

    NOTA

    Se al modello viene fatto riferimento, verrà visualizzato un avviso. Adottare le misure appropriate.

Pubblicazione di un modello di frammento di contenuto

I modelli di frammenti di contenuto devono essere pubblicati quando/prima che vengano pubblicati eventuali frammenti di contenuto dipendenti.

Per pubblicare un modello di frammento di contenuto:

  1. Andate a Strumenti, Risorse, quindi aprite Modelli di frammenti di contenuto.

  2. Individuate la cartella che contiene il modello di frammento di contenuto.

  3. Selezionate il modello, seguito da Pubblica dalla barra degli strumenti.
    Lo stato di pubblicazione verrà indicato nella console.

    NOTA

    Se si pubblica un frammento di contenuto per il quale il modello non è ancora stato pubblicato, verrà visualizzato un elenco di selezione e il modello verrà pubblicato insieme al frammento.

Annullamento della pubblicazione di un modello di frammento di contenuto

È possibile annullare la pubblicazione dei modelli di frammento di contenuto se non vi fanno riferimento alcun frammento.

Per annullare la pubblicazione di un modello di frammento di contenuto:

  1. Andate a Strumenti, Risorse, quindi aprite Modelli di frammenti di contenuto.

  2. Individuate la cartella che contiene il modello di frammento di contenuto.

  3. Selezionate il modello, seguito da Annulla pubblicazione dalla barra degli strumenti.
    Lo stato di pubblicazione verrà indicato nella console.

In questa pagina