資源的文件

除了檢視資源外,您可能需要為您要建置的應用程式產生文件。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\) 下的文字檔中。日誌項目是累加的且絕不會被消除。

相關概念
模組和程式庫
模組和程式庫的相依關係
商業整合的功能和角色
商業整合提要
相關工作
建立商業服務的模組
建立調解模組
變更預設名稱空間
啟用工具功能
在模組和程式庫中新增相依關係
建立程式庫
產生文件

相關資訊

指導教學:使用模組和程式庫

意見
(C) Copyright IBM Corporation 2005, 2006. All Rights Reserved.