用來設計範本的 Microsoft Word 輸出參照

請檢閱這項資訊,以進一步瞭解如何使用 Rational® Publishing Engine 來產生 Microsoft Word 文件。

用途

將範本輸出成下列文件:
副檔名 所產生之文件的格式
.doc Microsoft Word 2003。
.docx Microsoft Word 2007,但無法執行巨集。
.docm Microsoft Word 2007,能夠執行巨集。

支援的內容檢視器

如需取得支援檢視這種輸出類型的產品清單,請執行下列動作:
  1. 開啟 Rational Publishing Engine 的系統需求
  2. 依類型區段中,按一下軟體
  3. 捲動至內容檢視器區段。這時會列出支援檢視 Rational Publishing Engine 輸出的產品名稱和版本。

範本元素

表 1. 可用於 Microsoft Word 輸出格式的範本元素
元素 說明 可以包含其他元素 可以包含資料
「段落」圖示 段落 用來將一群元素分組。 新增換行來括住它在輸出中的子元素。
「儲存器」圖示 儲存器 用來將一群元素分組。 無法樣式化,不會影響輸出格式。
當在其他元素內部使用時,儲存器內可用的子元素可能會受到限制。 例如:
  • 在列之內,儲存器內只能放置資料格
  • 在清單內,儲存器內只能放置清單詳細資料元素
「文字」圖示 文字 以相同的指定格式來呈現內容。
「樣式化文字」圖示 樣式化文字 這是一個文字區塊,其中的個別單字可以有其唯一格式。 請在元素內的所選單字上,使用粗體、斜體、底線、加刪除線或顏色格式。 文字是靜態的。
「超鏈結」圖示 超鏈結 在輸出中建立超鏈結。 超鏈結可以指向文件內的位置,或指向外部位置。
「影像」圖示 影像 在輸出中顯示 .gif.png.jpgemfwmf 影像。 報告設計者可以在範本中指定影像路徑,或報告產生者可以在執行時期指定路徑。
「表格」圖示 表格 在輸出中建立表格。表格可以包含列或儲存器元素。
「列」圖示 在現行表格中建立列。
「資料格」圖示 資料格 在現行表格的現行列中建立資料格。
「清單」圖示 清單 在輸出中建立項目符號清單或數值清單。
「清單詳細料」圖示 清單詳細料 在輸出的現行清單中建立清單項目。
「資料來源配置」圖示 資料來源配置 請參閱新增資料來源配置元素
「併入檔」圖示 併入檔 將指定的檔案併入輸出的 INCLUDETEXT 欄位中。
  • 併入檔的副檔名可以是 .doc.docx.txt.rtf
  • 對於 Microsoft Word 輸出,您必須利用巨集來更新所有欄位,才能看到併入檔。
  • 如果是舊式 PDF、HTML 和 XSL-FO 輸出,併入檔是文件的超鏈結。
「註腳」圖示 註腳 在現行輸出頁面中建立註腳。 註腳文字是註腳元素的內容。 只支援 Microsoft Word 輸出。
「區域」圖示 區域 區域是靜態元素,可讓您重新導向其他元素或元素群組的內容來變更輸出流程。 如果元素的 target region 內容指定了某個區域元素的名稱,它的內容會呈現在指定的區域中,而不是它在文件內的位置。
「書籤」圖示 書籤 在文件中定義書籤。 產生的書籤名稱就是書籤的內容。 當產生文件時,Rational Publishing Engine 會產生每個書籤的唯一名稱。 名稱以設計時所提供的名稱,以及執行時期產生的唯一 ID 為基礎。
「註解」圖示 註解 新增註解到輸出中。 輸出註解的形式和形狀會隨著輸出格式而不同。

支援 Microsoft Word 和 PDF。

「分頁」圖示 分頁 新增分頁到輸出中。
「分段」圖示 分段 新增分段到輸出中。
「目錄」圖示 目錄 新增目錄到輸出中。
「表格目錄」圖示 表格目錄 新增表格目錄到輸出中。您必須在文件範本中新增「表格標題」,才能在輸出中產生表格目錄。

只支援 Microsoft Word 輸出。

您必須更新 Microsoft Word 文件中的所有欄位,才能看到及更新欄位值。

「表格目錄」圖示 表格目錄 新增表格目錄到輸出中。您必須在文件範本中新增「表格標題」,才能在輸出中產生表格目錄。

只支援 Microsoft Word 輸出。

您必須更新 Microsoft Word 文件中的所有欄位,才能看到及更新欄位值。

「欄位」圖示 欄位 新增通用的 Microsoft Word 欄位元素。 您可以在欄位碼內容中,輸入任何有效的 Microsoft Word 碼。

只支援 Microsoft Word 輸出。

您必須更新 Microsoft Word 文件中的所有欄位,才能看到及更新欄位值。

「頁碼」圖示 頁碼 新增頁碼到輸出中。只支援 Microsoft Word 和 PDF 輸出。
「總頁數」圖示 總頁數 在輸出中新增總頁數。只支援 Microsoft Word 和 PDF 輸出。
「表格標題」圖示 表格標題 新增表格標題。您雖然無法在表格標題中指定動態內容,但任何後續的文字元素都會與它連結。

支援 Microsoft Word 和 PDF 輸出。

您必須更新 Microsoft Word 文件中的所有欄位,才能看到及更新欄位值。

「圖例標題」圖示 圖例標題 新增圖例標題。您雖然無法在圖例標題中指定動態內容,但任何後續的文字元素都會與它連結。

支援 Microsoft Word 和 PDF 輸出。

您必須更新 Microsoft Word 文件中的所有欄位,才能看到及更新欄位值。

元素內容

請檢閱這些附註,進一步瞭解如何為設計成產生 Microsoft Word 文件的範本指定元素內容。
表 2. 資料格內容
資料格內容 Notes®
邊框寬度 您必須指定一個 130 像素之間的邊框寬度值,以便在輸出中建立邊框。
資料格對齊方式 這個內容指定文字在資料格中的位置。這種輸出格式不支援 justify 值。
資料格寬度 輸入點或像素值。如果您輸入的是像素值,會將值轉換成點,並假設顯示畫面是 96 dpi。如果您輸入的是百分比值,則會忽略值。當您合併表格時,必須設定資料格寬度內容,以確保直欄大小是相同的。
表 3. 註解內容
註解內容 附註
內容 如果您在「註解」元素的「內文」內容中包含超鏈結,則超鏈結在 Microsoft Word 輸出中不是可點選的。
表 4. 圖例標題內容
圖例標題內容 附註
邊框寬度 請勿用於這種輸出格式。
欄位代碼 在每一個標題上循序顯示阿拉伯或羅馬數字。
表 5. 註腳內容
註腳內容 附註
樣式名稱 如果您將樣式套用至註腳、文字、樣式化文字或表格等之類的行內元素,會將該樣式套用至所有的行內元素,直到跳到下一個區塊元素(例如:段落)為止。舉例來說,如果您將樣式新增至註腳元素,且其前有一個樣式化文字,該樣式也會套用至該樣式化文字元素。
表 6. 影像內容
影像內容 附註
邊框寬度 請勿用於這種輸出格式。
內容 支援的影像格式:.bmp.emf.gif.jpg.png.wmf

Rational Publishing Engine 支援 .svg 影像,但 Microsoft Word 卻不支援。為了將文件產生為正確的 Microsoft Word 輸出,會將 .svg 影像轉換為 .png 影像。轉換程序可能導致輸出中顯示的影像失真。

表 7. 清單詳細資料內容
清單詳細資料內容 附註
邊框寬度 請勿用於這種輸出格式。
表 8. 頁碼內容
頁碼內容 附註
邊框寬度 請勿用於這種輸出格式。
表 9. 段落內容
段落內容 附註
邊框寬度 您必須指定一個 130 像素之間的邊框寬度值,以便在輸出中建立邊框。
段落對齊方式 文字橫越頁面中的空間,採用特定的對齊方式。

Leftrightcenter 對齊方式,會在段落中盡量填入更多的單字,因此段落的邊緣參差不齊。Justify 會在最後一行以外的所有字行中,於單字之間插入額外的間距,以便產生平整的段落邊緣。 Distributed 類似於 justify,不同之處在於,它也會在段落最後一行的單字之間插入間距。

段落遺留行/段落遺留字控制 當設為 true 時,會調整行距,以免出現下列的格式化結果:
  • 在新的一行用一個單字結束一個段落。
  • 在新的一頁用單行結束一個段落。

當設為 false 時,不會調整間距。

表 10. 列內容
列內容 附註
跨頁換列 當設為 true 時,則在必要時,會分割出現在頁面尾端的列內容。在頁面中放不下的內容會移到下一頁成為新的一列。

當設為 false 時,則不分割出現在頁面尾端的列內容。整列會移到下一頁。

表 11. 樣式化文字內容
樣式化文字內容 附註
樣式名稱 如果您將樣式套用至註腳、文字、樣式化文字或表格等之類的行內元素,會將該樣式套用至所有的行內元素,直到跳到下一個區塊元素(例如:段落)為止。舉例來說,如果您將樣式新增至註腳元素,且其前有一個樣式化文字,該樣式也會套用至該樣式化文字元素。
表 12. 表格內容
表格內容 附註
自動符合內容 調整表格,使其放得下每一個資料格包含的內容。當使用這個內容時,也請將調整大小以容納內容內容設為 true
邊框寬度 您必須指定一個 130 像素之間的邊框寬度值,以便在輸出中建立邊框。
邊框樣式 請使用值 single,而不使用 thickhairlineinsetoutset。這所有的值會套用相同的格式設定,且大部分和 single 預期看到的相當類似。
直欄中的資料格寬度固定 指定一個像素值,以確保直欄中所有資料格的寬度都一樣。
調整大小以容納內容 當設為 true 時,除非出現間距,否則不會折行。如果您沒有間距,就不會折行,且會將欄寬增加成文字的寬度。若有設定自動符合內容,您必須將調整大小以容納內容設為 true

當設為 false 時,則欄寬固定且會折行,並且忽略是否使用間距以及文字的長度。另外還會忽略表格自動符合內容。

樣式名稱 如果您將樣式套用至註腳、文字、樣式化文字或表格等之類的行內元素,會將該樣式套用至所有的行內元素,直到跳到下一個區塊元素(例如:段落)為止。舉例來說,如果您將樣式新增至註腳元素,且其前有一個樣式化文字,該樣式也會套用至該樣式化文字元素。
表格自動符合 當設為 true 時,會根據頁面寬度來調整表格大小。當調整大小以容納內容也設為 true 時,會忽略資料格寬度,並根據內容來調整表格大小。

您不能輸入 fixed column width 作為值。請改用 fixed cell width 內容。

寬度 必須指定一值。
表 13. 表格標題內容
表格標題內容 附註
邊框寬度 請勿用於這種輸出格式。
欄位代碼 在每一個標題上循序顯示阿拉伯或羅馬數字。
表 14. 文字內容
文字內容 附註
邊框寬度 您必須指定一個 130 像素之間的邊框寬度值,以便在輸出中建立邊框。
樣式名稱 如果您將樣式套用至註腳、文字、樣式化文字或表格等之類的行內元素,會將該樣式套用至所有的行內元素,直到跳到下一個區塊元素(例如:段落)為止。舉例來說,如果您將樣式新增至註腳元素,且其前有一個樣式化文字,該樣式也會套用至該樣式化文字元素。
表 15. 總頁數內容
總頁數內容 附註
邊框寬度 請勿用於這種輸出格式。

表格長度

在您設計要產生成 Microsoft Word 文件的範本時,表格長度可能是一個要考量的因素。

長表格可能需要放入多個頁面中。當出現這樣的需求時,請選取表格中的「列」元素,並在「內容」視圖中,將跨頁換列內容設為 true。藉由設定該內容,您的表格就可以繼續跨越多頁。

Microsoft Word 文件中的目錄、圖例目錄和表格目錄

如果要新增目錄至輸出中,請在範本或樣式表中定義目錄。如果您在範本中定義目錄,必須等您更新文件欄位之後,該目錄才會顯示在 Microsoft Word 文件中。如果要更新欄位,請使用 Microsoft Word 中的「更新欄位」或「更新表格」特性,或使用 rpe.dot 樣式表中包含的巨集。您可以在 Rational Publishing Engine 安裝架構中找到 rpe.dot 樣式表:%RPE_HOME%\utils\word\rpe.dot。相同的程序亦適用於圖例目錄和表格目錄。

Microsoft Word 文件中的標題

圖例和表格標題不會自動更新。如果要更新欄位,請使用 Microsoft Word 中的「更新欄位」特性,或使用 rpe.dot 樣式表中包含的巨集。您可以在 Rational Publishing Engine 安裝架構中找到 rpe.dot 樣式表:%RPE_HOME%\utils\word\rpe.dot

併入檔元素

您可以選擇鏈結檔案,或將檔案實際內嵌到輸出文件。不過,處理併入檔元素的方式,取決於輸出格式和檔案的擷取位置。
若為 Microsoft Word 輸出,Rational Publishing Engine 會在文件產生期間自動更新 Microsoft Word 欄位。如果產生 INCLUDE TEXT 欄位,則不會執行巨集,檔案匯入作業會委派給 Microsoft Word 來執行。必須等所有欄位皆更新之後,才會在輸出文件中看到併入檔。如果要更新欄位,請使用 Microsoft Word 中的「更新欄位」特性,或使用 %RPE_HOME%\utils\word\rpe.dot 樣式表中包含的巨集。
提示: 鏈結至其他檔案的 Microsoft Word 文件無法獨立自足。如果將文件移至其他電腦上,會導致您無法將所鏈結文件的內容視覺化。如果需要視覺化,請使用 Microsoft Word 中的「中斷鏈結」特性(在 Microsoft Office 2007 中是 Alt+E+K),來併入所鏈結檔案的內容。

標題樣式

如果要使用預先定義給 Microsoft Word 的標題樣式(標題 1、標題 2、...、標題 9),請使用樣式名稱 1、2 到 9。

Rational Publishing Engine 樣式與外部樣式

盡量使用定義在樣式表中的外部樣式。這種做法可讓您快速變更輸出文件的外觀,並在公司中施行統一的外觀。

Microsoft Word 的編號標題

當樣式表與編號標題搭配使用時,會取得以階層式清單方式編號的標頭。

輸出中的 Unicode 資料

如果使用的字型支援 Unicode,則會呈現所有 Unicode 資料。對於 Microsoft Word 輸出,如果您使用非 Unicode 字型,在產生文件之後,請變更輸出文件中的字型。

OLE 物件

您可以從資料來源中的屬性,擷取內嵌物件,例如:物件鏈結與內嵌(OLE 物件)。對於 Microsoft Word 輸出,您必須在文件規格的 meta 資料區段中設定將 OLE 當作靜態影像內容。
ref 資料夾含有 OLE 物件的 .rtf 檔。對於匯出的每一個 OLE 物件,Microsoft Word 輸出中分別有一個指向 .rtf 檔的併入欄位。由於 IBM® Rational Publishing Engine 無法更新 Microsoft Word 欄位,在開啟 Microsoft Word 文件時,將看不到併入欄位。如果要讓欄位變成可見,請執行下列其中一個動作:
表 16. 動作
動作 結果
選取整個文件內容,並使用 Microsoft Word 中的更新欄位功能。 OLE 物件會顯示在文件中。文件無法自給自足。
使用 Rational Publishing Engine 提供的 updateFields 巨集。 OLE 物件會顯示在文件中。文件無法自給自足。
使用 Rational Publishing Engine 提供的 insertOLEs 巨集。 OLE 物件會顯示在文件中。文件可自給自足。
使用 Rational Publishing Engine 提供的 rpeinsertOLEs 巨集。 OLE 物件會顯示在文件中。文件可自給自足。
註: 如果您將無法自給自足的文件移至另一部電腦中,您將無法編輯 OLE 物件。如果要避免此問題,請執行 insertOLEs 巨集。

意見