範本除錯

您可以將文件範本進行除錯來解決在產生文件期間所發生的問題。

程序

  1. 在 Document Studio 中,開啟要除錯的範本。
  2. 定義一或多個岔斷點,方法為按一下切換岔斷點 岔斷點圖示切換條件式岔斷點 條件式圖示 工具列按鈕,或是在範本編輯器中按一下滑鼠右鍵,並選取除錯 > 切換岔斷點切換條件式岔斷點
    您可以在任何數目的元素上設定岔斷點。您可以設定一般岔斷點或條件式岔斷點。條件式岔斷點與一般岔斷點相同,但是除錯器只在符合條件時才會停止。這個條件與範本元素上所定義的任何條件分開, 且不影響範本的輸出。
    註: 除錯器不會在範本中的他處未使用的查詢屬性的條件式岔斷點上停止。比方說,如果範本正在列印物件文字和物件標題,但是條件式岔斷點是在物件 ID 上,則除錯器不會在這個點上停止。
  3. 按一下文件產生除錯 開始除錯 工具列按鈕,以啟動除錯器。 這時除錯器會選取目前正在處理的元素,以追蹤除錯階段作業的進度。
    提示: 在「發佈文件」視窗中,按一下在背景中執行按鈕, 以便此視窗不會干擾除錯處理程序。
  4. 當除錯器達到設有岔斷點的元素時,除錯器即停止。您可以在「RPE 除錯」視圖中檢查元素和資料環境定義。 元素環境定義提供元素 ID、元素類型,現行遞迴層次,以及是否通過元素上的條件。資料環境定義是由範本變數以及位於該位置的資料元素所組成。
    RPE 除錯視圖
  5. 利用下列 3 個選項之一來回復除錯階段作業:
    • 步進到下一個:將除錯器前進到範本中的下一個元素。除錯器必須已在某岔斷點上停止,此指令才能為作用中
    • 回復除錯:回復除錯器。 除錯器在下一個岔斷點上停止或是當文件產生完成時。
    • 回復正常執行:回復執行並停用所有岔斷點。
  6. 若要移除所有岔斷點,請按一下清除所有岔斷點清除岔斷點 工具列按鈕。

意見