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

您可以從 Launcher 和 Document Studio 來產生文件。

開始之前

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

關於這項作業

有各種不同的方法來產生文件:

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

程序

如果要從 Launcher 或 Document Studio 應用程式產生文件,請執行下列動作:

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

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

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

結果

文件規格會載入到 Launcher 中,視您所做的選擇而定,會產生或儲存文件。

下一步

在「主控台」或「問題」視圖中,檢閱文件產生作業的資訊,以識別問題。修正問題之後,重新產生輸出。

配置一次文件產生之後,在後續產生文件時,您可以按一下文件規格 > 產生 > 產生文件,無需完成配置精靈,便可以產生文件。


意見