Installazione della documentazione in z/OS Explorer

Se la propria organizzazione dispone di processi e procedure operativi del sistema, è possibile includerli nei Contenuti della guida di z/OS® Explorer in modo che siano disponibili durante l'utilizzo di z/OS Explorer. È possibile creare il plug-in della propria documentazione e integrarlo completamente con i Contenuti della guida di z/OS Explorer oppure, come passaggio provvisorio, è possibile integrare i file HTML e di testo esistenti con la funzione di ricerca nella Guida di z/OS Explorer.

Creazione di un plug-in

z/OS Explorer è costruito sulla piattaforma open source Eclipse che fornisce un ambiente di sviluppo integrato estensibile. Mediante la piattaforma Eclipse, chiunque può costruire strumenti che si integrano perfettamente con l'ambiente e con altri strumenti. La chiave per la perfetta integrazione tra gli strumenti ed Eclipse è il plug-in. Ad eccezione di un piccolo kernel di runtime, tutto in Eclipse è un plug-in. Ciò significa che un plug-in sviluppato dall'utente viene integrato con Eclipse, e quindi con z/OS Explorer, esattamente come gli altri plug-in.

Quando si crea un plug-in della documentazione, esso viene integrato completamente con z/OS Explorer e gli argomenti vengono visualizzati nei Contenuti della guida.

È possibile creare il plug-in della propria documentazione utilizzando il PED (Plug-in Development Environment) Eclipse disponibile nell'IDE (Integrated Development Environment) Eclipse. L'IDE Eclipse è open source e può essere scaricato dal sito Web Eclipse all'indirizzo http://www.eclipse.org. La documentazione contiene informazioni preliminari e una scheda di riferimento rapido fornisce le istruzioni dettagliate per la creazione di un plug-in.

Integrazione dei file HTML e di testo con la ricerca nella Guida di z/OS Explorer

Se non è stato ancora creato un plug-in della documentazione ma si dispone di file HTML o di testo a cui si desidera accedere da z/OS Explorer, è possibile posizionare i file in una cartella speciale in modo che possano essere inclusi nell'indice di ricerca di z/OS Explorer. Quando si effettua una ricerca di informazioni contenute nella guida, vengono visualizzate tutte le corrispondenze rilevate con la propria documentazione insieme ai risultati di z/OS Explorer. Tuttavia, quando si visualizzano i Contenuti della guida, i propri documenti non vengono mostrati.

Questo metodo di integrazione dei file HTML e di testo è inteso solo come soluzione provvisoria finché non si crea un plug-in della documentazione.

Per includere i file HTML o di testo nella ricerca della guida z/OS Explorer, completare la seguente procedura:

  1. Fare clic su Guida > Gestisci documentazione personalizzata dal menu del workbench. Il gestore file apre una finestra sul desktop che mostra i contenuti della cartella mydocs di z/OS Explorer.
  2. Copiare i file HTML o di testo che si desidera includere in z/OS Explorer e incollarli nella cartella mydocs.
  3. Chiudere la finestra mydocs.
  4. Fare clic su Guida > Ricrea indice di ricerca dal menu del workbench. Viene visualizzata una finestra di dialogo con la richiesta di conferma. L'operazione richiede il riavvio di z/OS Explorer.
  5. Fare clic su OK per procedere o fare clic su Annulla se non si desidera riavviare immediatamente z/OS Explorer. È necessario eseguire la fase di ricreazione per i file da includere nella funzione di ricerca nella Guida.

Al riavvio di z/OS Explorer, tutte le ricerche nella Guida verranno effettuate sia nella propria documentazione che nella documentazione di z/OS Explorer. I risultati trovati nella propria documentazione vengono elencati prima dei risultati riscontrati nella documentazione di z/OS Explorer.

Nota: quando i risultati della ricerca vengono trovati nei file HTML, viene visualizzato il nome file nelle tag <Titolo></Titolo>. Tuttavia, i file di testo non includono tag di titolo e pertanto i risultati dei file di testo visualizzano il percorso file come mostrato in questa acquisizione schermo Acquisizione schermo dei risultati della ricerca che mostrano i risultati nella documentazione del cliente in cima all'elenco. I primi due risultati hanno dei titoli corretti perché si trovano nei file HTML. I 3 risultati successivi mostrano i percorsi dei file, in quanto sono file di testo..

Argomento principale: Attività