使用文件產生精靈來預覽文件

如果文件含有大量資料,您可以從 Launcher 和 Document Studio 應用程式,僅使用一部分的資料來產生文件,以縮短產生時間。

開始之前

依預設,每一個範本都與一項空白的文件規格相關聯。在您從 Document Studio 應用程式預覽或發佈範本時,可以自訂這項空白的文件規格,或者不自訂而直接用來產生輸出。在您開啟或儲存範本時,Document Studio 會讓範本與預設文件規格保持同步。
註: 這些指示適用於大部分的資料來源,但並非全部。如需資料來源特定指示,請參閱適合您資料來源的整合說明文件。

關於這項作業

依預設,預覽所包含的一部分資料是前 10 筆資料項目。您可以在「引擎喜好設定」中變更這個數目:
  1. 按一下視窗 > 喜好設定 > RPE > 引擎喜好設定
  2. 預覽查詢結果限制中,輸入預覽中要包含的資料項目數目。

從 Launcher 應用程式或是從 Document Studio 應用程式來產生預覽並無不同。當您使用精靈來產生文件時,這兩個應用程式中提供的選項是相同的。不過,在 Launcher 應用程式中,您不需使用精靈,就能夠在「文件規格」視圖和「內容」視圖中配置文件預覽的詳細資料。

程序

  1. 在 Launcher 或 Document Studio 中,按一下文件規格 > 預覽 > 配置和預覽文件

    您也可以按一下工具列中的 「配置和預覽」圖示 配置和預覽文件圖示。

    這時會開啟配置精靈,讓您先選取其他的預覽選項,再產生預覽。
  2. 在「資料來源」區段中,配置每一個資料來源。
    註:
    • 如果資料來源已有預設值,或者已輸入預設 URI 值,在輸出中,就會依照配置來顯示資料來源,且除非選取了另一值,否則會使用預設值。
    • 如果您跳過「資料來源」區段,然後按上一步,對資料來源進行其他變更,當開啟區段時,一律會顯示清單中的第一個資料來源。
    1. 從下列其中一個位置選取資料來源:
      • 手動配置:如果因為這個資料來源沒有其他配置資訊存在於配置層或「中央管理」元件中,而要選取本端或遠端資料來源
      • 使用中央程式庫中的資料來源值:如果要選取儲存在「中央管理」元件中的資料來源
      • 從配置層載入:如果要從您在範本中針對資料來源所輸入的配置 meta 資料選取一值
    2. 視您在上一步驟中所做的選擇而定,您可以為資料來源選取一值,作法是輸入 URL、按一下瀏覽來選取一值,或是從配置層中選取一值。
    3. 輸入用來接受資料來源應用程式鑑別的使用者名稱與密碼。
    4. 選取鑑別類型。 如果您沒有選取類型,則會測試每一種類型,直到找到正確的類型,但這可能增加文件產生時間。
      • Auto
      • Basic
      • Form
      • OAuth
      • OAuth-OSLC
    5. 選擇性的: 輸入接受標頭。 預設值是 application/xml, */*
    6. 選擇性的: 如果您想將所輸入的認證套用至每一個資料來源,請選取將這些使用者名稱與密碼值套用至每一個已配置和未配置的資料來源選項。
    7. 下一步
  3. 在「變數」區段中,配置每一個變數。
    註:
    • 如果變數已有預設值,在輸出中,就會依照配置來顯示變數,且除非選取了另一值,否則會使用預設值。
    • 如果您跳過「變數」區段,然後按上一步,對變數進行其他變更,當開啟區段時,一律會顯示清單中的第一個變數。
    1. 從下拉功能表中,選取下列其中一個選項:
      • 手動配置:如果因為這個變數沒有其他配置資訊存在於配置層或「中央管理」元件中,而要為變數輸入任何值
      • 從配置層:如果要從您在範本中針對變數所輸入的配置 meta 資料選取一值
      • 使用中央程式庫中的變數值:如果要選取儲存在「中央管理」元件中的變數
    2. 輸入或選取配置值。
    3. 下一步
  4. 在「輸出」區段中,選取要產生的輸出類型:
    • Microsoft Word
    • PDF
    • HTML
    • XSL-FO
    • 舊式 PDF
    1. 選擇性的: 針對儲存位置,按一下瀏覽,針對每一種輸出類型,選取用來儲存檔案的路徑。 如果沒有指定輸出的儲存位置,會將檔案產生於暫時位置中。
    2. 選擇性的: 針對樣式表,按一下瀏覽,針對每一種輸出類型,選取產生輸出期間要使用的樣式表。
    3. 選擇性的: 僅適用於 Microsoft Word 輸出:針對巨集,輸入樣式表內所包含的巨集名稱。
    4. 選擇性的: 如果要輸入其他的 meta 資料,或配置精靈中未包含的其他文件內容,請按一下編輯 meta 資料內容
    5. 下一步
  5. 在摘要視窗中,驗證範本和輸出資訊是正確的。
  6. 選取當您按一下完成時,要採取的動作。
    • 執行文件產生作業:產生您指定的輸出類型。
    • 執行文件產生作業並關閉 RPE:產生您指定的輸出類型,並在您結束「結果」精靈之後,關閉 Rational Publishing Engine 應用程式。
    • 關閉這個精靈並開啟 RPE 用戶端:在 Launcher 應用程式中開啟文件規格和您所輸入的詳細資料。
  7. 按一下完成
    提示: 如果您是在遠端產生文件,您可以在文件產生作業完成之前,關閉 Document Studio 或 Launcher 應用程式,而不會中斷產生程序。如果您是在本端產生文件,在文件產生作業完成之前,請勿關閉 Document Studio 或 Launcher 應用程式。

意見