Oltre alla visualizzazione delle risorse, potrebbe essere necessario documentare le applicazioni che si stanno creando. WebSphere Integration Developer fornisce uno strumento per generare la documentazione per le risorse nei moduli, nei moduli di mediazione e nelle librerie.
Iniziare la generazione della documentazione richiamando una procedura guidata. E' possibile personalizzare il contenuto della documentazione selezionando più risorse da uno o più moduli e librerie, in modo che tutte le informazioni siano scritte in un report unico, ovvero un file PDF. Inoltre, è possibile specificare il layout e i font dell'output. Per istruzioni dettagliate sulla generazione della documentazione, consultare le attività correlate.
L'utilità di generazione della documentazione produce le seguenti informazioni per le risorse di seguito riportate:
Altre risorse non verranno documentate dall'utilità di generazione della documentazione.
Inoltre, l'utilità di generazione della documentazione può produrre la documentazione per le risorse selezionate e le risorse cui si fa riferimento. Ad esempio, nella procedura guidata Generazione della documentazione, è possibile selezionare il processo business e l'opzione Includi file di riferimento. Come risultato, il report PDF generato dispone anche delle informazioni per le risorse (quali le interfacce richiamate dalle relative attività) cui fa riferimento il processo.
Il report PDF generato dispone della seguente struttura:
Dispone del titolo, del nome dell'autore e della data del report.
Elenca i numeri di pagina e di sezione del report.
Elenca le proprietà delle risorse. Escluso per il modulo e la libreria, tutte le risorse dispongono anche di immagini delle risorse aperte nella vista Editor.
Elenca per ciascuna risorsa documentata la risorsa utilizzata (elenco Provider) e dove viene utilizzata (elenco Destinatari).
Elenca le impostazioni relative alla generazione della documentazione specificate nella procedura guidata Generazione della documentazione ed utilizzate per il report PDF.
Il layout e lo stile del report PDF generato può essere personalizzato con la procedura guidata Generazione della documentazione. Se si modificano le impostazioni di layout e di stile, tali modifiche vengono salvate per tutte le successive generazioni della documentazione, fino a quando non vengono di nuovo modificate.
E' possibile modificare le seguenti impostazioni di layout:
Definisce la dimensione della carta della documentazione generata.
Valore predefinito: Letter
Definisce il livello massimo degli argomenti da elencare nell'indice del report.
Valore predefinito: 7
Testo normale
Titolo capitolo
Testo del codice sorgente
Testo titolo
Testo di definizione
Testo intestazione
Indice
Un file master è un profilo della risorsa che definisce il contenuto (non gli stili del font) da includere nella documentazione generata. Quando si utilizza la procedura guidata Generazione della documentazione, creare un file master per salvare le selezioni della risorsa e utilizzare, la volta successiva, la procedura guidata per generare lo stesso report, selezionando solo il file master.
L'utilità di generazione della documentazione fornisce tre font predefiniti che è possibile utilizzare nella documentazione. Tali font sono Helvetica, Courier e Times con gli stili di font: regolare, corsivo, grassetto e corsivo grassetto.
E' possibile aggiungere un nuovo font, ovvero un file true type (.ttf) o un file di raccolta true type (.ttc) registrandolo. La registrazione dei font viene effettuata dalla procedura guidata Generazione della documentazione. Una volta registrato un font, può essere utilizzato per tutti i report fino a quando non viene rimosso. I font predefiniti non possono essere rimossi. Per istruzioni sul modo in cui effettuare attività con la procedura guidata Generazione della documentazione, consultare l'argomento "Generazione della documentazione" negli argomenti correlati.
L'utilità di generazione della documentazione può scrivere messaggi di traccia relativi alla generazione della documentazione in un file di traccia. Nota: non attivare la funzione di traccia se non si è verificato un problema con l'utilità di generazione della documentazione, poiché la traccia ha un impatto sulle prestazioni del sistema e occupa molto spazio su disco. La traccia viene impostata nella finestra Preferenze e l'output viene scritto in un file di testo nella directory dei metadati (nome dello spazio di lavoro\.metadata\.plugins\com.ibm.wbit.reporting.infrastructure\trace\). Le voci di log vengono apposte e mai cancellate.
Informazioni correlate