Scheda Riferimento contenuto
La scheda Riferimento a contenuto consente di inserire riferimenti a contenuto negli argomenti e nelle mappe DITA. Se si seleziona la scelta di menu > e la funzione Gestione risorse DITA non è già aperta, la finestra di Gestione risorse DITA viene visualizzata con la scheda Riferimento a contenuto attiva. Per una mappa DITA, la scheda Riferimento a contenuto viene visualizzata in una finestra dialogo Gestione risorse DITA separata e non ancorata.
Se non è stato ancora assegnato un ID all'elemento che si sta inserendo come riferimento a contenuto, viene generato un ID per l'elemento (se si dispone dell'accesso in scrittura sul file di origine). Se un elemento di riferimento valido non è attualmente presente nel documento, Gestione risorse DITA inserisce automaticamente un nuovo elemento vuoto nel documento in modo che diventi la destinazione del riferimento a contenuto. Questa scheda è disponibile in Gestione risorse DITA quando si modifica un argomento, una mappa o una specializzazione di un argomento o di una mappa.
La scheda Riferimento a contenuto include le opzioni indicate di seguito.
• Cerca in - Determina la posizione dei contenuti visualizzati nel browser di Gestione risorse DITA.
Selezionare una posizione dall'elenco a discesa. Questo campo contiene sempre la posizione attualmente disponibile nel browser. Se si fa doppio clic su una cartella nel browser, tale cartella viene visualizzata nel campo Cerca in.
L'elenco contiene una scelta
Posizioni preferite
. Selezionando questa opzione, ci si sposta nella posizione visualizzata nel browser al nodo
Posizioni preferite in cui si trova un elenco delle posizioni preferite salvate.
L'elenco contiene anche l'opzione
Cronologia
. Selezionando questa scelta, ci si sposta nella posizione visualizzata nel browser al nodo
Cronologia in cui si trova un elenco di tutte le posizioni visitate nella sessione corrente.
• Pulsante
Menu
- Visualizza un menu contenente le opzioni riportate di seguito.
◦ Apri (con suffisso Documento) - Se nel browser è selezionato un documento, tale documento viene aperto in una nuova finestra.
I documenti XML, DITA, SGML e HTML selezionati vengono aperti in una nuova finestra di Arbortext Editor. Altri tipi di documenti o di immagini vengono aperti nell'applicazione associata. Ad esempio, un'immagine viene visualizzata nell'applicazione per la gestione delle immagini di default.
◦ Cancella cronologia - Cancella l'elenco di posizioni visitate dal nodo Cronologia nel browser.
Questa scelta è disponibile solo se è selezionato il nodo Cronologia.
◦ Aggiungi a preferiti - Aggiunge la posizione selezionata all'elenco Posizioni preferite.
Questa scelta è disponibile solo se nel browser è selezionata una cartella del file system, una cartella del sistema di gestione dei contenuti (CMS) o una posizione simile.
◦ Rimuovi da preferiti - Rimuove la posizione selezionata dall'elenco Posizioni preferite.
Questa scelta è disponibile solo se è selezionato un elemento nell'elenco Posizioni preferite.
◦ Sposta su - Sposta un elemento nell'elenco Posizioni preferite di un livello superiore nell'elenco.
Questa scelta è disponibile solo se è selezionato un elemento nell'elenco Posizioni preferite.
◦ Sposta giù - Sposta un elemento nell'elenco Posizioni preferite di un livello inferiore nell'elenco.
Questa scelta è disponibile solo se è selezionato un elemento nell'elenco Posizioni preferite.
◦ Esporta preferiti - Visualizza la finestra di dialogo Salva con nome in cui è possibile salvare l'elenco delle posizioni preferite correnti in un file XML.
Questa scelta è disponibile solo se nel browser è selezionato il nodo Posizioni preferite. Con questa opzione è possibile salvare in un file XML i preferiti che possono essere quindi importati come elenco dei preferiti utilizzando la scelta di menu Importa preferiti. Non modificare questo file XML, poiché è destinato esclusivamente al salvataggio di un elenco dei preferiti.
◦ Importa preferiti - Visualizza la finestra di dialogo Apri in cui è possibile selezionare un file XML contenente un elenco dei preferiti Gestione risorse DITA esportato.
Questa scelta è disponibile solo se nel browser è selezionato il nodo Posizioni preferite. Questa opzione consente di importare come elenco dei preferiti esportati utilizzando la scelta di menu Esporta preferiti.
Dopo avere selezionato un file nella finestra di dialogo Apri e avere fatto clic su Apri, si apre un'altra finestra di dialogo in cui viene chiesto: Unire all'elenco o sostituire l'elenco dei preferiti corrente? Fare clic su Unisci per aggiungere all'elenco dei preferiti le posizioni presenti nell'elenco importato ma non ancora disponibili nell'elenco corrente. Fare clic su Sostituisci per sostituire completamente l'elenco dei preferiti corrente con l'elenco importato.
◦ Check-Out e modifica - Consente di aprire l'oggetto CMS selezionato in Arbortext Editor per la modifica.
Se l'oggetto non è stato sottoposto a Check-Out, Gestione risorse DITA esegue tale operazione, bloccandolo. È possibile sottoporre a Check-Out anche qualsiasi oggetto dipendente, nella stessa operazione. Questa scelta di menu è disponibile solo per gli oggetti di PTC Server Connection.
◦ Check-Out - Sottopone a Check-Out (blocca) l'oggetto CMS sbloccato selezionato.
È possibile sottoporre a Check-Out anche qualsiasi oggetto dipendente, nella stessa operazione. Questa scelta di menu è disponibile solo per gli oggetti di PTC Server Connection.
◦ Annulla Check-Out - Annulla il Check-Out di un oggetto CMS e ignora le modifiche apportate alla versione sottoposta a Check-Out.
Dopo l'annullamento del Check-Out di un oggetto, se l'oggetto documento è aperto in Arbortext Editor, diventerà di sola lettura. Questa scelta di menu è disponibile solo per gli oggetti di PTC Server Connection.
◦ Proprietà - Visualizza la finestra di dialogo
Proprietà oggetto, che contiene le proprietà dell'oggetto selezionato.
Questa scelta di menu è disponibile solo per gli oggetti di PTC Server Connection.
◦ Cerca CMS - Visualizza la finestra di dialogo
Cerca.
Questa scelta di menu è disponibile solo per gli oggetti di PTC Server Connection. La finestra di dialogo Cerca consente di immettere un'interrogazione per individuare tutti gli oggetti CMS corrispondenti a specifici criteri di ricerca. I risultati della ricerca vengono visualizzati nel nodo Risultati ricerca CMS del browser Gestione risorse DITA.
◦ Cancella risultati ricerca CMS - Cancella tutti gli oggetti CMS aggiunti al nodo Risultati ricerca CMS del browser Gestione risorse DITA.
Questa scelta di menu è disponibile solo per gli adattatori CMS supportati. Questa azione non rimuove questi oggetti da CMS, ma solo dal browser Gestione risorse DITA.
◦ Sincronizza posizione tra schede - Determina se la posizione selezionata nel browser Gestione risorse DITA viene mantenuta quando si passa a una scheda differente o si apre un'altra finestra di dialogo di Gestione risorse DITA.
L'impostazione della preferenza avanzata ditasynctabs determina lo stato di attivazione o disattivazione per default.
• Pulsante
Cartella precedente - Sposta la posizione visualizzata nel browser sull'ultima cartella visualizzata nel browser.
Gestione risorse DITA conserva una cronologia delle cartelle visualizzate nella sessione corrente, quindi è possibile utilizzare questo pulsante per spostare la vista del browser indietro attraverso tale cronologia. Se è stata visualizzata solo una cartella nella sessione corrente, il pulsante è disattivato.
• Pulsante
Su di un livello
- Sposta la posizione visualizzata nel browser di un livello in alto nella gerarchia corrente.
Se la posizione è già al livello superiore della gerarchia, tale pulsante è disattivato.
• Pulsante
Aggiorna 
- Aggiorna la vista del browser in modo che rifletta eventuali modifiche apportate agli oggetti visualizzati nel browser.
• Pulsante
Documento corrente
- Apre il documento corrente nella vista del browser.
• Pulsante
Usa il browser oggetti CMS
- Richiama il
browser per
PTC Server Connection o un adattatore repository.
Questo pulsante è disponibile solo quando si è connessi a un sistema di gestione dei contenuti (CMS) tramite PTC Server Connection o un adattatore repository.
• Pulsante
Cerca CMS
- Richiama la finestra di dialogo
Cerca.
Questo pulsante è disponibile solo per gli oggetti PTC Server Connection. La finestra di dialogo Cerca consente di immettere un'interrogazione per individuare tutti gli oggetti CMS corrispondenti a specifici criteri di ricerca. I risultati della ricerca vengono visualizzati nella parte Risultati ricerca CMS del browser Gestione risorse DITA.
• Filtro - Consente di filtrare l'elenco dei file e degli elementi dei documenti visualizzati nel browser.
Quando si immette del testo in questa opzione, l'elenco dei file e degli elementi dei documenti visualizzati nel browser viene filtrato esclusivamente per mostrare i file o gli elementi le cui etichette contengono il testo immesso. In questo caso, l'opzione Filtro e il browser sono visualizzati in un colore di sfondo giallo chiaro a indicare che si sta filtrando il contenuto del browser.
Ad esempio, se si immette "test", solo gli oggetti con le etichette che contengono "Test", "testing", "test cases" e così via vengono visualizzati nel browser. Se un documento è stato espanso per visualizzare gli elementi all'interno del documento, vengono filtrati anche gli elementi visualizzati. In questo caso, il documento continua a essere visualizzato nel browser anche se la sua etichetta non contiene il testo per il filtro.
Il filtro non distingue tra caratteri maiuscoli e minuscoli. Cartelle e oggetti simili non vengono filtrati. Se si immettono più termini nell'opzione Filtro, le etichette corrispondenti devono contenere tutti i termini.
• Browser di Gestione risorse DITA - Fornisce un file system, un sistema di gestione dei contenuti (CMS) o la gerarchia dei documenti.
Il browser di Gestione risorse DITA consente di individuare il contenuto in un file system o in un sistema CMS da inserire nel documento. Il browser fornisce una visualizzazione gerarchica del contenuto del file system o del sistema CMS. Oltre a mostrare cartelle e file, il browser consente di visualizzare il contenuto dei documenti DITA. Ad esempio, quando si utilizza la scheda Riferimento a contenuto, il browser visualizza in un documento DITA gli elementi disponibili da usare come riferimento a contenuto in base al contesto corrente nel documento. Nel browser vengono anche visualizzati il tipo di elemento, un breve estratto del contenuto dell'elemento e l'ID dell'elemento (a seconda dell'impostazione della preferenza avanzata ditahideids).
Se si sta esplorando il contenuto di una mappa DITA che contiene definizioni chiave, è possibile espandere la mappa e le definizioni chiave vengono indicate da un'icona a forma di chiave,
. Nel browser vengono visualizzate solo le definizioni chiave che presentano nell'attributo
format lo stesso valore del documento corrente. È possibile espandere la definizione chiave in modo da mostrare i tag nel documento referenziato dalla chiave. Se si seleziona un tag nella definizione chiave, il nome della chiave viene inserito nell'opzione
Conkeyref. Se si inserisce il riferimento con un tag nella definizione chiave selezionata, per il riferimento a contenuto inserito vengono impostati i valori degli attributi
conref e
keyconref. L'impostazione della preferenza avanzata
ditakeyrefui determina l'eventuale disponibilità di questa opzione nel browser di
Gestione risorse DITA.
Il browser contiene un nodo
Posizioni preferite contenente l'elenco delle posizioni preferite salvate. Facendo doppio clic su uno dei preferiti, tale posizione viene aperta nel browser. Se una posizione preferita non è al momento disponibile, ad esempio se la posizione è stata eliminata o è una cartella CMS e non è stato effettuato l'accesso al CMS, la cartella presenta una particolare icona,
che indica lo stato.
Il browser contiene inoltre un nodo
Cronologia con un elenco di tutte le posizioni visitate nella sessione corrente. Facendo doppio clic su una delle posizioni, tale posizione viene aperta nel browser.
Fare clic sul segno più (+) nella gerarchia per aprire un livello nella gerarchia o il contenuto di un documento. Fare clic sul segno meno ( – ) per chiudere un livello o un documento. Fare clic su un oggetto nella gerarchia per selezionarlo. Fare doppio clic su una cartella per spostare l'attivazione del browser su tale cartella. Fare doppio clic sull'elemento di un documento per inserire un riferimento a contenuto a tale elemento nel documento.
È possibile inserire un riferimento al contenuto visualizzato nel browser all'interno del documento, come segue:
◦ Evidenziando un elemento e selezionando il pulsante Inserisci
◦ Facendo doppio clic su un elemento
◦ Utilizzando il trascinamento selezione
• Tipo - Determina il tipo di documento visualizzato nel browser di Gestione risorse DITA.
Utilizzare questo elenco a discesa per filtrare i documenti visualizzati nel browser in base al tipo di documento. È possibile scegliere i seguenti tipi di documenti:
◦ Map - Consente di visualizzare solo i documenti mappa DITA.
◦ Map or Topic - Consente di visualizzare i documenti mappa o argomento DITA.
◦ Argomento - Visualizza solo i documenti argomento DITA.
◦ Qualsiasi - Consente di visualizzare tutti i tipi di documenti.
• Mostra - Determina il tipo di elementi visualizzati per i documenti nel browser di Gestione risorse DITA.
Utilizzare questo elenco a discesa per filtrare gli elementi visualizzati per i documenti nel browser in base al tipo di elemento.
• Conkeyref - Consente di immettere un riferimento chiave da inserire nell'attributo conkeyref per il riferimento.
Utilizzare questa opzione quando si desidera aggiungere un riferimento chiave a contenuto al riferimento che si sta inserendo. L'impostazione della preferenza avanzata ditakeyrefui determina l'eventuale disponibilità di questa opzione in Gestione risorse DITA. Se sono state definite delle chiavi in una delle mappe di definizione della chiave impostate nella preferenza avanzata ditakeycontext o ditakeybaselist per l'oggetto selezionato nel browser, tali chiavi vengono visualizzate per default nell'elenco a discesa.
• Inserisci - Inserisce un riferimento all'elemento selezionato nel documento che si sta modificando.
Se il contesto corrente nel documento non è un punto di inserimento valido, questo pulsante è disattivato.