Documentazione AEM Guides Documentazione di AEM Guides

Abilitazione delle variabili di contenuto contestuale (CCVAR) nelle pagine AEM Sites generate da AEM Guides

Last update: Mon May 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Argomenti:

Creato per:

Utente
Amministratore

Le variabili di contenuto contestuali (CCVAR) sono una funzionalità ACS Commons che consente agli autori di utilizzare variabili di contenuto dinamiche direttamente nel testo creato. Anche se CCVAR è comunemente utilizzato in AEM Sites, questo articolo spiega come ottenere funzionalità simili tramite pagine generate da contenuto creato in AEM Guides principalmente utilizzando parole chiave definite nella mappa DITA.

Cosa sono le variabili di contenuto contestuali (CCVAR)?

CCVAR consente agli autori di inserire nel contenuto variabili dinamiche che vengono risolte in fase di esecuzione in base al contesto. Ad esempio, variabili come ((page_properties.pageTitle)) possono richiamare dinamicamente il titolo della pagina durante il rendering del contenuto.

Come abilitare il CCVAR nelle pagine AEM Sites generate da AEM Guides?

Considerando che AEM Guides viene utilizzato come origine di tutti i contenuti (inclusi AEM Sites, PDF o HTML5), per abilitare i CCVAR sulle pagine generate da AEM Guides, è necessario utilizzare parole chiave per definire il nome del CCVAR. Per eseguire questa operazione nelle Guide, definire parole chiave nella mappa DITA utilizzando <keydef> elementi. Queste parole chiave possono corrispondere a valori dinamici (o nomi CCVAR), consentendo di farvi riferimento negli argomenti DITA.

Prerequisiti

Prima di procedere, verifica che siano soddisfatti i seguenti prerequisiti:

Comuni ACS AEM installati:
- Assicurati che ACS AEM Commons sia installato nell'istanza AEM. Questa opzione è necessaria per l’utilizzo di CCVAR.
Configurazione variabili di contenuto contestuali:
- Completa la configurazione per Variabili di contenuto contestuali in AEM utilizzando la documentazione ufficiale. Ciò include:
  - Abilitazione dell'aggregazione di proprietà .
  - Configurazione della riscrittura di HTML (se si utilizza l'output di HTML).
  - Configurazione della riscrittura JSON (se si utilizza l'output JSON).

Passaggi per abilitare CCVAR in AEM Guides

1. Definire le parole chiave nella mappa DITA

In AEM Guides, definisci le parole chiave utilizzando gli elementi <keydef> nella mappa DITA per corrispondere al CCVAR.
Ad esempio:

  <keydef keys="product">
    <topicmeta>
      <keywords>
        <keyword>((page_properties.pageTitle))</keyword>
      </keywords>
    </topicmeta>
  </keydef>

L'attributo keys (product in questo esempio) verrà utilizzato per fare riferimento a questa variabile negli argomenti DITA.

2. Utilizzare le parole chiave negli argomenti DITA

Nell'argomento, utilizzare la parola chiave ovunque debba essere utilizzato CCVar.
Ad esempio:

  <p>This is the title of the product: <keyword keyref="product"/> </p>

L'attributo keyref punta al valore keys definito nell'elemento <keydef> (product in questo caso).
Durante la generazione dell’output, la parola chiave verrà sostituita con il valore CCVar corrispondente.

3. Genera output

Quando si genera l'output per AEM Sites, i riferimenti delle parole chiave vengono risolti nei valori dinamici corrispondenti.
Ad esempio:
- Se ((page_properties.pageTitle)) viene risolto in My Product, l'output verrà visualizzato:

   This is the title of the product: My Product.

Caso d’uso di esempio

Si supponga di voler inserire in modo dinamico la lingua della pagina negli argomenti DITA. Ecco come ottenere questo:

Definire la parola chiave nella mappa DITA:

   <keydef keys="pageLanguage">
     <topicmeta>
       <keywords>
         <keyword>((inherited_page_properties.jcr:language))</keyword>
       </keywords>
     </topicmeta>
   </keydef>

Riferimento alla parola chiave in un argomento DITA:

   <p>The title of this page is: <keyword keyref="pageLanguage"/>.</p>

Output generato:

Se ((inherited_page_properties.jcr:language)) viene risolto in en, l'output verrà visualizzato:

     The language of this page is: en.

Riferimenti

Per ulteriori dettagli sulle variabili di contenuto contestuali, consulta la documentazione ufficiale:
Variabili di contenuto contestuali in AEM Commons

recommendation-more-help

11125c99-e1a1-4369-b5d7-fb3098b9b178