Visualizzare l'anteprima di un argomento id1696II000QR

Una volta creato un argomento, AEM Guides genera un’anteprima dell’argomento. La modalità Anteprima offre diverse funzionalità che è possibile utilizzare per l'utilizzo del documento.

Per visualizzare in anteprima un argomento, effettua le seguenti operazioni:

  1. Nell’interfaccia utente di Assets, individua l’argomento da visualizzare.

  2. Fare clic sull'argomento da visualizzare.

    Nell’interfaccia utente di Assets viene visualizzata un’anteprima dell’argomento.

    note note
    NOTE
    La versione dell'argomento attivo o della mappa DITA è visibile nell'angolo superiore destro della scheda File dell'argomento.
    note important
    IMPORTANT
    Il posizionamento delle seguenti funzioni nella barra degli strumenti Anteprima potrebbe variare in base alla configurazione del server AEM. Alcune delle funzioni potrebbero essere disponibili nella barra degli strumenti principale, mentre altre nel menu Altro.

Funzioni disponibili in modalità anteprima

{width="800"}

Nella modalità anteprima della barra degli strumenti puoi eseguire le seguenti operazioni:

Proprietà

Visualizza le proprietà dell'argomento selezionato. In base alla versione dell’AEM in uso, puoi visualizzare proprietà quali metadati, pianificazione (de)attivazione, riferimenti, stato del documento e altro ancora.

NOTE
La proprietà del titolo di un argomento viene compilata automaticamente dal tag title dell'argomento o della mappa DITA. Se si apportano modifiche al titolo utilizzando la finestra delle proprietà, tali modifiche andranno perse. Se desideri aggiornare la proprietà title, utilizza l’editor web.

La pagina Proprietà contiene informazioni utili sui riferimenti, ad esempio dove viene utilizzata una mappa o un argomento oppure quali riferimenti sono contenuti in un documento. Nella pagina Proprietà sono elencati due tipi di riferimenti per un documento: Usato in e Riferimenti in uscita.

I riferimenti Usati in elencano i documenti in cui viene fatto riferimento o utilizzato il file corrente. Riferimenti in uscita elenca i documenti a cui si fa riferimento nel documento corrente.

L'icona (+) nella sezione Riferimenti di Usati in consente di spostarsi verso l'alto per individuare l'argomento utilizzato o a cui si fa riferimento.

{width="800"}

Facendo clic sull'icona accanto a un documento, vengono visualizzati i file mappa o argomento a cui il documento viene ulteriormente associato.

Filtro condizionale (A/B)

Se il tuo argomento ha contenuto condizionale, sulla barra degli strumenti verrà visualizzata l’icona A/B. Facendo clic su questa icona si apre un pop-up che consente di filtrare il contenuto in base alle condizioni disponibili nell’argomento.

NOTE
Il contenuto condizionale viene evidenziato utilizzando il colore di sfondo chiaro nell’editor web.

{width="300"}

Modifica

  • Aprire l'argomento per la modifica nell'Editor Web. L'opzione Modifica non sarà disponibile se l'amministratore ha abilitato l'opzione Disattiva modifica senza estrazione. Se l'opzione è attivata, l'opzione Modifica verrà visualizzata solo dopo aver estratto un file di argomenti.

Risoluzione chiave

  • Se si desidera utilizzare un file keyspace per l'argomento, fare clic sull'icona Risoluzione tasti. Potete quindi scegliere uno spazio chiave dalla finestra a comparsa Risoluzione chiave.

Origine

  • Aprire il codice sorgente XML di un file. Per visualizzare il codice XML sottostante di una mappa, di un argomento o di un file DITAVAL, aprire il file in modalità Anteprima e fare clic sull'icona Source. Nel pop-up Source XML viene visualizzato il codice sorgente XML. È possibile selezionare un codice specifico dal file oppure premere Ctrl+a per selezionare l'intero contenuto.

    note note
    NOTE
    Per visualizzare il codice sorgente di un file di mappa DITA, selezionare il file nell'interfaccia utente di Assets e fare clic su Source.

    {width="800"}

Condividi collegamento UUID

  • AEM Guides consente di condividere i collegamenti basati su UUID per mappe DITA, argomenti e file di immagini dalle seguenti posizioni:

    • Interfaccia utente di Assets
    • Console della mappa DITA
    • Anteprima argomento o immagine

Una nuova opzione Condividi collegamento UUID è visualizzata nella barra degli strumenti delle aree sopra indicate. La schermata seguente mostra l'opzione Condividi collegamento UUID nella modalità Anteprima di un argomento:

{width="800"}

Nell’interfaccia utente Assets, questa opzione è visibile quando selezioni un file. In modalità Anteprima, questa opzione è disponibile per impostazione predefinita nella barra degli strumenti principale. In una console di mappe DITA, questa opzione è visibile nella sezione Predefiniti di output.

Una volta copiato l’URL, lo stesso può essere condiviso con altri utenti per consentire loro di accedere direttamente al file. Questo collegamento rimane valido anche quando il file viene spostato in un’altra posizione nell’archivio. L’unica volta che il collegamento non riesce è quando il file viene eliminato dal repository.

Se condividi il collegamento dalla console delle mappe DITA o dalla modalità di anteprima di un file, l’utente passa alla stessa visualizzazione del file. Tuttavia, quando condividi il collegamento di un file mappa dall’interfaccia utente di Assets, l’utente viene indirizzato alla console della mappa. Analogamente, per un file di argomento o immagine viene visualizzata l'anteprima del file.

IMPORTANT
Il collegamento non può essere utilizzato come collegamento di riferimento in un altro argomento, ma fornisce solo accesso diretto al file nell’archivio. Inoltre, il collegamento rimane valido finché il file è disponibile nell’archivio. Anche se il file viene spostato in un’altra posizione nell’archivio, il collegamento rimane valido. Il collegamento avrà esito negativo solo quando il file viene eliminato dal repository.

Estrai/Archivia

  • Attiva/disattiva le funzioni Check-Out e Check-In. Quando un file viene estratto, l'utente corrente ottiene un'autorizzazione di scrittura esclusiva sul file. Un file estratto può essere aperto nell'editor Web per la modifica. Dopo aver apportato le modifiche necessarie, fai clic sull’icona Archivia per salvare il file in DAM.

Quando si estrae un argomento, lo stato del file viene visualizzato come estratto nella vista a schede e nella vista a elenco.

File estratto nella vista a schede:

{width="300"}

File estratto nella visualizzazione elenco:

{width="550"}

Se la colonna Estratto non è visibile, selezionare Visualizza impostazioni in Visualizzazione elenco e selezionare lo stato Estratto nella finestra di dialogo Configura colonne.

{width="800"}

TIP
Consulta la sezione Controllo delle versioni del contenuto nella guida alle best practice per informazioni sulle procedure consigliate per l’estrazione e l’archiviazione dei file.

Differenza di versione basata sul Web

  • Se l'argomento è stato modificato, è possibile individuare facilmente le modifiche apportate in versioni diverse dell'argomento. Per individuare le modifiche apportate a versioni diverse di un argomento:

    note important
    IMPORTANT
    Il metodo descritto nella procedura seguente è applicabile solo ai file DITA. Per i file non DITA, utilizzate la vista Timeline per creare versioni o ripristinare una versione esistente di un file.
    1. Aprire l'argomento in modalità Anteprima.

    2. Nella barra a sinistra, fai clic su Cronologia versioni e seleziona una versione.

      {width="800"}

    3. Tra le versioni elencate, selezionare quella che si desidera utilizzare come versione di base e fare clic su Anteprima versione. L'anteprima della versione selezionata viene visualizzata nella finestra Anteprima versione.

    4. Nell'elenco Mostra differenze selezionare la versione con cui si desidera confrontare la versione di base.

      {width="800"}

      Il contenuto modificato viene evidenziato nell’anteprima dell’argomento. Il contenuto evidenziato in verde indica che il contenuto appena aggiunto e il contenuto in rosso quello eliminato.

      {width="800"}

Branch, ripristino e versioni successive id193PG0Y051X

  • In un ambiente di authoring tipico, è necessario creare un nuovo ramo di un argomento per soddisfare una versione specifica. Come qualsiasi altro sistema di gestione delle versioni, AEM Guides consente di creare un ramo da una versione esistente di un argomento o di ripristinare una versione precedente di un argomento. Utilizzando le funzioni di gestione delle versioni offerte da AEM Guides, puoi eseguire le seguenti attività:

    • Creare un ramo da una versione esistente di un argomento
    • Creare versioni successive in un nuovo ramo
    • Ripristino di una versione specifica di un argomento

    Nella figura seguente viene illustrato il tipico sistema di ramificazione e di versioni successive:

    {align="center" width="550"}

    Per qualsiasi nuovo argomento, la prima versione viene numerata come 1.0. In seguito, ogni nuova versione dell'argomento viene salvata con un numero incrementale come 1.1, 1.2 e così via. Dopo aver creato un ramo di un argomento, viene creato un nuovo ramo che prende il numero di versione dal punto in cui è stato creato il ramo e aggiunge 0 alla fine della versione. Come mostrato nell’illustrazione, viene creato un nuovo ramo dalla versione 1.1 di un argomento. Il nuovo ramo dispone di una versione 1.1.0. Successivamente, ogni volta che si salva una nuova versione dell'argomento in questo ramo, viene assegnato un numero di versione incrementale, ad esempio 1.1.1, 1.1.2 e così via.

    Analogamente alla diramazione, è inoltre possibile ripristinare la versione in uso o corrente a qualsiasi versione esistente nell'archivio. Per ripristinare una versione, è sufficiente selezionare la versione desiderata dell'argomento e fare clic su Ripristina questa versione nel pannello Cronologia versione.

    Per creare un ramo, ripristinare una versione e gestire le versioni successive di un argomento, effettua le seguenti operazioni:

    note important
    IMPORTANT
    Il metodo descritto nella procedura seguente è applicabile solo ai file DITA. Per i file non DITA, utilizzate la vista Timeline per creare versioni o ripristinare una versione esistente di un file.
    1. Accedi all’argomento nell’interfaccia utente di Assets.

      note note
      NOTE
      È inoltre possibile aprire l'argomento in modalità Anteprima e procedere con il passaggio 3.
    2. Selezionare l'argomento per il quale si desidera creare un ramo.

    3. Nella barra a sinistra, fai clic su Cronologia versioni.

      note note
      NOTE
      Viene visualizzato un elenco delle versioni disponibili per l'argomento selezionato. Ogni versione contiene timestamp, nome utente, commento sulla versione e informazioni sull'etichetta.
    4. Seleziona una versione da cui desideri creare un ramo. Nella schermata seguente, è selezionata la versione 1.2 per la creazione di un ramo.

      {width="300"}

      note note
      NOTE
      La versione corrente di un argomento contiene (Current) indicato accanto al numero di versione.
    5. Fare clic su Ripristina questa versione.

      Viene visualizzato un messaggio che richiede di confermare la creazione di un nuovo ramo.

    6. (Facoltativo) Nel prompt dei messaggi, si ottiene un'opzione per selezionare Salva la copia di lavoro corrente come nuova versione. In base alla selezione di questa opzione sono possibili le due azioni seguenti:

      • Se selezioni questa opzione, viene creato un ramo dalla versione 1.1. Viene inoltre creata una nuova versione dell'argomento dalla copia di lavoro corrente dell'argomento e salvata come versione successiva, ovvero 1.4.

        {width="300"}

        La versione 1.2 diventa la copia corrente dell'argomento. Qualsiasi versione salvata dopo questa viene creata nel nuovo ramo di 1.1. Ad esempio, la versione successiva di un nuovo argomento in questo ramo verrà salvata come 1.2.0.

        {width="300"}

      • Se non si seleziona questa opzione, non verrà creata alcuna nuova versione dalla copia di lavoro corrente dell'argomento. Dalla versione 1.2 dell’argomento viene creato un nuovo ramo. Qualsiasi versione successiva dell’argomento viene salvata nel ramo 1.2 come 1.2.0, 1.2.1 e così via.

        {width="300"}

    7. Fai clic su OK.

    Viene creato un nuovo ramo dalla versione selezionata dell'argomento. Il processo descritto sopra è applicabile anche per il ripristino di una versione specifica di un argomento. Il ripristino di una versione specifica implica tecnicamente la creazione di un nuovo ramo dalla versione selezionata e l'impostazione di tale versione come copia di lavoro corrente dell'argomento. È inoltre possibile visualizzare la cronologia dei file ripristinati nel rapporto Cronologia ripristino versione. Per ulteriori dettagli su questo report, vedere Report cronologia versioni file ripristinati.

Argomento padre: Crea e visualizza in anteprima argomenti

recommendation-more-help
11125c99-e1a1-4369-b5d7-fb3098b9b178