文件範本

文件範本是用來產生文件的藍圖。範本定義要從資料來源擷取什麼資料,以及在輸出中如何將這個資料格式化。

文件範本是獨立自足的保存檔,副檔名是 .dta(文件範本保存檔)。 Rational® Publishing Engine 範本與其他產品提供的範本略有不同。 在其他產品中,範本是預先移入資訊,供您學習及自訂的範例構件。 在 Rational Publishing Engine 中,範本是用來建立您的報告輸出結構的基本檔案。 如果您以他人的範本檔為基礎,範本可能已預先移入資訊,但新範本會空白。

舊版 IBM® Rational Publishing Engine 所建立的文件範本會搭配最新版本來運作。 不過,如果您的資料提供者不支援最新版本的 Rational Publishing Engine 範本結構,您可以設定範本版本,以使用來自舊版 Rational Publishing Engine 的範本結構。

您可以同時新增靜態和動態內容到文件範本中。靜態內容含有設計範本時提供的文字和影像。 動態內容用產生文件時取自資料來源的資料來呈現。 範本也會定義格式化資訊,不過,有些資料可能會保留資料來源內嵌在其中的格式化資訊。

文件範本可能含有:

範本中的資料來源綱目

當您定義範本時,請使用資料結構的定義(稱為綱目),而不是靜態資料。 綱目使範本能夠套用於其結構符合定義的資料來源結構的任何資料來源。 範本可以包含任意數量的資料來源綱目。

如果資料來源沒有確切符合資料來源綱目,Rational Publishing Engine 會處理符合綱目的元素,並忽略不嚴重的錯誤。比方說,如果在範本中使用 Rational DOORS®status 屬性,且實際資料來源(Rational DOORS 模組)沒有這個屬性,依預設,會繼續進行文件產生作業。

Rational Publishing Engine 提供用來建立或取得各種資料來源類型(例如 IBM Rational DOORSIBM Rational Tau 和 Rational REST 資料來源)之綱目的機制。如需標準綱目定義的相關資訊,請參閱 http://www.w3.org/XML/Schema。您可以使用協力廠商應用程式,從 XML 資料產生綱目。

範本的重複使用

您可以重複使用儲存於本端、遠端或「中央管理」元件之範本中的範本結構。 在建立新的範本之後,當您所匯入的範本沒有參照其他範本時,您可以將整個範本匯入至您正在處理的主要範本。請針對您經常重複使用的文件區段建立 Snippet,例如:標頭和標底。

在您匯入範本時,您可以動態參照它們,或實際內嵌它們。當您動態參照範本或併入檔時,視範本要產生的輸出類型而定,會在產生輸出時,新增該範本或檔案的鏈結,或是載入所匯入範本的內容。當您實際內嵌範本或檔案時,會立即將其內容匯入至主要範本,而不是在執行時期才匯入。

只要主要範本和您所參照或內嵌的範本之間有衝突,便會提示您解決衝突。舉例來說,衝突可能包括不同的資料來源綱目。當資料來源綱目不同時,可將所匯入範本的綱目新增至主要範本,來解決衝突。

預設文件規格

依預設,每一個範本都與一項空白的文件規格相關聯。在您從 Document Studio 應用程式預覽或發佈範本時,可以自訂這項空白的文件規格,或者不自訂而直接用來產生輸出。在您開啟或儲存範本時,Document Studio 會讓範本與預設文件規格保持同步。

意見