editor DITAVAL ditaval-editor
I file DITAVAL vengono utilizzati per generare output condizionale. In un singolo argomento, puoi aggiungere condizioni utilizzando gli attributi dell’elemento per condizionare il contenuto. Quindi, create un file DITAVAL in cui specificate le condizioni che devono essere selezionate per generare il contenuto e quali condizioni devono essere escluse dall'output finale.
AEM Guides consente di creare e modificare facilmente i file DITAVAL mediante l'editor DITAVAL. L'editor DITAVAL recupera gli attributi (o tag) definiti nel sistema ed è possibile utilizzarli per creare o modificare file DITAVAL. Per ulteriori dettagli sulla creazione e la gestione dei tag in AEM, vedere la sezione Amministrazione dei tag nella documentazione AEM.
Crea file DITAVAL
Per creare un file DITAVAL, effettuate le seguenti operazioni:
-
Nell’interfaccia utente di Assets, individua il percorso in cui desideri creare il file DITAVAL.
-
Fare clic su Crea > Argomento DITA.
-
Nella pagina Blueprint, seleziona il modello di file DITAVAL e fai clic su Avanti.
-
Nella pagina Proprietà, specifica Titolo e Nome per il file DITAVAL.
note note NOTE Il nome viene suggerito automaticamente in base al Titolo del file. Se si desidera specificare manualmente il nome del file, assicurarsi che il nome non contenga spazi, apostrofi o parentesi graffe e che termini con .ditaval. -
Fai clic su Crea. Viene visualizzato il messaggio Topic Created (Creazione argomento).
Potete scegliere di aprire il file DITAVAL per la modifica nell'editor DITAVAL o salvare il file dell'argomento nel repository AEM.
Modifica file DITAVAL
Per modificare un file DITAVAL, effettuare le seguenti operazioni:
-
Nell’interfaccia utente di Assets, individua il file DITAVAL da modificare.
-
Per ottenere un blocco esclusivo sul file, selezionare il file e fare clic su Estrai.
-
Selezionare il file e fare clic su Modifica per aprire il file nell'editor DITAVAL di AEM Guides.
L'editor DITAVAL consente di eseguire le seguenti operazioni:
A: Attiva/Disattiva pannello sinistro
Attiva/disattiva la visualizzazione del pannello sinistro. Se avete aperto il file DITAVAL tramite mappa DITA, la mappa e l'archivio vengono visualizzati in questo pannello. Per ulteriori informazioni sull'apertura di un file tramite mappa DITA, vedere Modificare gli argomenti tramite mappa DITA.B: Salva
Salva le modifiche apportate nel file. Tutte le modifiche vengono salvate nella versione corrente del file.C: Aggiungi proprietà
Aggiungi una singola proprietà nel file DITAVAL.
Nel primo elenco a discesa sono elencati gli attributi DITA consentiti che è possibile utilizzare nel file DITAVAL. Sono supportati cinque attributi:
audience,platform,product,propseotherprops.Il secondo elenco a discesa mostra i valori configurati per l’attributo selezionato. Nell'elenco a discesa successivo vengono quindi visualizzate le azioni che è possibile configurare per l'attributo selezionato. I valori consentiti nel menu a discesa delle azioni sono -
include,exclude,passthrougheflag. Per ulteriori informazioni su questi valori, vedere la definizione dell'elemento prop nella documentazione OASIS DITAD: Aggiungi tutte le proprietà
Se desiderate aggiungere tutte le proprietà condizionali o gli attributi definiti nel sistema con un solo clic, utilizzate la funzione Aggiungi tutte le proprietà.note note NOTE Se tutte le proprietà condizionali definite esistono già nel file DITAVAL, non è possibile aggiungere altre proprietà. Viene visualizzato un messaggio di errore in questo scenario. 
-
Dopo aver modificato il file DITAVAL, fai clic su Salva.
note note NOTE Se si chiude il file senza salvare, le modifiche andranno perse. Se non si desidera eseguire il commit delle modifiche nel repository AEM, fare clic su Chiudi, quindi su Chiudi senza salvare nella finestra di dialogo Modifiche non salvate.
Visualizzazioni dell’editor DITAVAL
L’editor DITAVAL di AEM Guides supporta la visualizzazione dei file DITAVAL in due diverse modalità o visualizzazioni:
Autore: Questa è una tipica visualizzazione di What You See is What You Get (WYSISYG) dell'editor DITAVAL. Puoi aggiungere o rimuovere proprietà utilizzando la semplice interfaccia utente, che presenta le proprietà, i relativi valori e le azioni nell’elenco a discesa. Nella vista Autore sono disponibili le opzioni per inserire una singola proprietà e tutte le proprietà con un solo clic.
Per trovare la versione del file DITAVAL su cui si sta attualmente lavorando, posizionare il puntatore del mouse sul nome del file.
Source: Nella vista Source viene visualizzato il codice XML sottostante che costituisce il file DITAVAL. Oltre a eseguire modifiche regolari del testo in questa visualizzazione, un autore può anche aggiungere o modificare proprietà utilizzando Smart Catalog.
Per richiamare lo Smart Catalog, posizionare il cursore alla fine di qualsiasi definizione di proprietà e immettere "<". Nell'editor verrà visualizzato un elenco di tutti gli elementi XML validi che è possibile inserire in tale posizione.
