除了檢視資源外,您可能需要為您要建置的應用程式產生文件。WebSphere® Integration Developer 提供一項工具,讓您為模組、調解模組和程式庫中的資源產生相關文件。
若要開始產生文件,請呼叫精靈。您可以自訂文件的內容,其做法是從一或多個模組和程式庫中選取多個資源,
以便將所有資訊寫到單一報告(PDF 檔)中。您也可以指定輸出的佈置和字型。有關如何產生文件的詳細指示,
請參閱相關作業。
資源文件
文件產生器會為這些資源產生下列資訊:
- 程式庫
- 模組或調解模組
- 商業物件
- 「編輯器」視圖中之商業物件的「概觀」圖
- 商業物件的內容
- 介面
- 人工作業
- 「編輯器」視圖中之人工作業的「概觀」圖
- 人工作業的內容
- 程序
文件產生器不會產生其他資源的相關文件。
參照檔
文件產生器也可以為所選的資源和它們所參照的資源產生相關文件。例如,
在「產生文件」精靈中,您可以選取商業程序和併入參照檔選項。如此一來,
在產生的 PDF 報告中,亦含有程序所參照之資源的相關資訊(例如,其活動所呼叫的介面)。
文件結構
產生的 PDF 報告的結構如下:
- 標題頁
內含報告標題、作者名稱和報告日期。
- 目錄
列出報告中的章節和頁碼。
- 資源文件章節
列出資源的內容。所有資源(但不包括模組和程式庫)亦會在「編輯器」視圖中開啟資源圖。
- 交互參照
針對每一個有產生文件的資源,列出哪種資源有用到它(「提供者」清單)以及其使用所在(「接收者」清單)。
- 附錄:文件產生設定
列出「產生文件」精靈中所指定並用在 PDF 報告上的文件產生設定。
文件的佈置和樣式
產生之 PDF 報告的佈置和樣式可使用「產生文件」精靈來自訂。如果您變更佈置和樣式設定,
則會加以儲存,以供後續所有的產生文件程序用,
直到您重新變更它們為止。
可修改的佈置設定如下:
- 紙張大小
定義所產生之文件的紙張大小。
預設值為 Letter
- 目錄層次
定義報告之目錄中所列的主題層次上限。
預設值:
7
- 字型
定義輸出的字型系列、字型大小和字型樣式。預設字型設定為:
純文字
- 用在不同成品的說明和文件上。純文字的字型系列亦用在標題頁、標頭和標底上。
- 預設字型系列:Helvetica
- 預設字型大小:10
- 預設字型樣式:一般
章節標題
- 用在編號的標頭、目錄標頭和附錄標頭上
- 預設字型系列:Helvetica
- 預設字型大小:14
- 預設字型樣式:粗體
程式碼文字
- 用在程式碼(如 Java™)文件上
- 預設字型系列:Courier
- 預設字型大小:10
- 預設字型樣式:一般
標題文字
- 用在影像的標題上
- 預設字型系列:Helvetica
- 預設字型大小:10
- 預設字型樣式:粗體
定義文字
- 用在鍵值組文件上
- 預設字型系列:Helvetica
- 預設字型大小:10
- 預設字型樣式:一般
標頭文字
- 用在未編號的標頭上
- 預設字型系列:Helvetica
- 預設字型大小:11
- 預設字型樣式:粗體
目錄
- 用在目錄上
- 預設字型系列:Helvetica
- 預設字型大小:9
- 預設字型樣式:一般
用以儲存設定的主檔案
主檔案是一種資源設定檔,其中定義所產生之文件中所要包含的內容
(非字型樣式)。當您使用「產生文件」精靈時,請建立一個主檔案以儲存您的資源選項,
以便在您下次使用精靈來產生相同報告時,只需選取主檔案。
登錄新字型
文件產生器提供三種預設字型供您在文件中使用。這些字型是 Helvetica、Courier 和 Times,
其字型樣式為:一般、斜體、粗體和粗斜體。
您可以登錄字型以便新增該字型;字型可以是
True Type 字型檔 (.ttf) 或 True Type 集合檔 (.ttc)。您可以從「產生文件」精靈來登錄字型。一旦您登錄字型,
除非您移除,否則該字型可用在所有報告上。預設字型無法移除。有關如何使用「產生文件」精靈的指示,
請參閱相關作業下的「產生文件」。
註: 在「產生文件」精靈中,所登錄字型的名稱(包括雙位元組字集的字型名稱)
只會以拉丁文顯示。
追蹤檔
文件產生器可將產生文件追蹤訊息寫到追蹤檔中。附註:除非文件產生器有問題,請勿啟用這項追蹤功能,
這是因為追蹤功能會影響系統效能並佔用大量的磁碟空間。追蹤設定於「喜好設定」視窗中,其輸出會寫入 metadata 目錄 (workspace-name\.metadata\.plugins\com.ibm.wbit.reporting.infrastructure\trace\) 下的文字檔中。日誌項目是累加的且絕不會被消除。