Guida in linea > Panoramica della creazione DITA > Interfaccia utente di supporto DITA > Gestione risorse DITA > Modifica attributi - Attributi di riferimento
  
Modifica attributi - Attributi di riferimento
In Gestione risorse DITA è disponibile un'interfaccia che consente di modificare i riferimenti per più tag diversi in una mappa o un argomento DITA. È possibile richiamare Gestione risorse DITA per modificare gli attributi di riferimento dalla finestra di dialogo Modifica attributi, dalla Mappa documento e dalla vista in colonne. Per richiamare Gestione risorse DITA, selezionare l'opzione Sfoglia accanto all'attributo che si desidera modificare. In questo caso, Gestione risorse DITA viene visualizzato con la scheda per la modifica degli attributi attiva. L'elemento e l'attributo da modificare sono visualizzati nel titolo della scheda (ad esempio, lq/href).
È possibile utilizzare Gestione risorse DITA sia per modificare i riferimenti a documenti locali che per modificare riferimenti a documenti esterni referenziati tramite URL. Per la maggior parte degli elementi e attributi, è possibile utilizzare entrambi i tipi di riferimento. Tuttavia alcuni tipi di elementi e attributi, richiedono un tipo di riferimento specifico.
Opzioni per la modifica dei riferimenti a documenti locali
Per modificare i riferimenti a documenti locali, Gestione risorse DITA include le opzioni indicate di seguito per la modifica degli attributi.
• 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. Se si seleziona Il Web in questo elenco, lo stato dell'interfaccia cambia per consentire l'inserimento di riferimenti a documenti su Internet.
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.
◦ Cancella risultati ricerca CMS - Cancella tutti gli oggetti CMS aggiunti alla parte 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.
• 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 Cerca nel Web - Cambia lo stato della finestra di dialogo in modo da consentire la modifica di riferimenti da Internet.
• Pulsante Usa il browser oggetti CMS - Visualizza il browser per PTC Server Connection o per 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 Argomento, il browser visualizza in un documento DITA gli elementi disponibili da usare come un riferimento ad argomento in base al contesto corrente nel documento. Se è disponibile un titolo per un elemento, il titolo viene visualizzato nel browser accanto all'elemento. Viene anche visualizzato 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, . Se si seleziona una definizione chiave, il nome della chiave viene inserito nell'opzione Riferimento chiave. Se si modifica il riferimento con la definizione chiave selezionata, per il riferimento modificato viene utilizzato il valore degli attributi href, scope, type e format dalla definizione chiave. 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 su un documento o un elemento documento per sostituire il riferimento ad argomento corrente nel documento con un riferimento all'elemento o al documento selezionato.
• 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:
◦ Argomento - Visualizza solo i documenti argomento DITA.
◦ Topic or Map - Consente di visualizzare documenti mappa o argomento DITA.
◦ Map - Consente di visualizzare solo i documenti mappa DITA.
◦ Immagine - Consente di visualizzare solo i file delle immagini.
◦ DITAVAL - Consente di visualizzare solo file DITAVAL.
Questa scelta è disponibile solo quando si modifica un attributo href per l'elemento data. In questo caso inoltre, se si imposta l'attributo href su un file DITAVAL, l'attributo name viene impostato automaticamente su ditavalref.
◦ PDF - Visualizza solo i documenti PDF.
◦ HTML - Consente di visualizzare solo i documenti HTML.
◦ Qualsiasi - Consente di visualizzare tutti i tipi di documenti.
• Mostra - Determina il tipo di documenti visualizzati per i documenti DITA 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. Il contenuto di questo elenco varia in base al tipo di documento che si sta modificando.
• Riferimento chiave - Consente di immettere il nome di una chiave da inserire nell'attributo keyref per il riferimento.
Utilizzare questa opzione quando si desidera aggiungere un riferimento chiave al riferimento che si sta modificando. 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.
• Pulsante Modifica - Sostituisce il riferimento corrente nel documento con un riferimento al documento selezionato nel browser.
Opzioni per la modifica dei riferimenti a documenti referenziati da un URL
Per modificare riferimenti a documenti referenziati da un URL, Gestione risorse DITA per la modifica degli attributi contiene le opzioni indicate di seguito.
• Cerca in - Determina lo stato dell'interfaccia.
Quando si modifica un riferimento a un documento su Internet, questa opzione è sempre impostata su Il Web. Se si seleziona una posizione diversa dall'elenco a discesa, lo stato della scheda cambia per consentire la modifica dei riferimenti ai documenti locali.
Pulsante Menu - Visualizza un menu contenente le opzioni riportate di seguito.
◦ Apri (con suffisso Documento) - Questa scelta è disabilitata.
◦ Cancella risultati ricerca CMS - Cancella tutti gli oggetti CMS aggiunti alla parte Risultati ricerca CMS del browser Gestione risorse DITA.
• Pulsante Cartella precedente - Sposta la posizione visualizzata nel browser sull'ultima cartella visualizzata nel browser.
Se l'ultima posizione visualizzata nel browser non è The Web, lo stato della scheda cambia per consentire la modifica dei riferimenti ai documenti locali.
• Pulsante Su di un livello - Questo pulsante è disattivato.
• Pulsante Aggiorna - Questo pulsante è disattivato.
• Pulsante Cerca nel Web - Questo pulsante è disattivato.
• Pulsante Documento corrente - Apre il documento corrente nella vista del browser.
Lo stato della scheda diventa quello per la modifica dei riferimenti a documenti locali.
• 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.
• URL - Visualizza l'URL da inserire per il link o il riferimento incrociato.
È possibile modificare questo campo per aggiungere l'URL desiderato o selezionare il pulsante Recupera URL browser per inserire l'URL per la pagina Web visualizzata nel browser Web attivo all'interno dell'opzione.
• Apri browser - Apre il browser Web di default.
Se è presente un URL nell'opzione URL, il browser Web viene aperto con quella pagina Web visualizzata. Per utilizzare questa opzione è necessario disporre di un browser Web di default impostato nel sistema operativo o nelle preferenze di Posizioni dei file nella finestra di dialogo Preferenze.
• Recupera URL browser - Consente di inserire l'URL della pagina Web visualizzata nel browser Web attivo all'interno dell'opzione URL.
Per utilizzare questa opzione è necessario disporre di un browser Web di default impostato nel sistema operativo o nelle preferenze di Posizioni dei file nella finestra di dialogo Preferenze.
• Riferimento chiave - Consente di immettere il nome di una chiave da inserire nell'attributo keyref per il riferimento.
Utilizzare questa opzione quando si desidera aggiungere un riferimento chiave al riferimento che si sta modificando. 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 ditakeycontexto ditakeybaselist per l'URL visualizzato nel browser, tali chiavi vengono visualizzate per default nell'elenco a discesa.
• Pulsante Modifica - Sostituisce il riferimento nel documento con un riferimento all'URL specificato.