設計文件範本

文件範本定義報告的結構、佈置和內容。 建立成功的範本需要規劃、開發、測試及儲存範本。

程序

如果您要提供整合應用程式中所用的範本,請參閱建立整合應用程式中所用的報告實務。

支援概念
如果要建立文件範本,請完成下列步驟:

1: 收集需求

不同的需求必須有不同的設計。 開始設計範本之前,請先判斷文件的商業需求和實際需求。

資料元素
有多種範本元素會顯示不同類型的資訊。 檢視文件的人將會需要哪些資訊? 知道這一點之後,您就可以開始決定資料元素:
  • 哪些範本元素會顯示這個資料?在最終文件中,它的外觀會如何?
  • 有多種顯示資訊的方式嗎?若是如此,哪種顯示方式最適合文件的檢視環境?
  • 有多少必要的資料?您也許可以過濾掉不必要的資料,以便在產生報告輸出時節省時間。
輸出類型
請考量哪個輸出類型最符合檢視文件人員的需求。當您設計的範本產生成不同的輸出類型時,看起來可能會不同。有些元素進行了最佳化,適合以特定格式來顯示,有些不支援某些格式。請讓自己熟悉範本元素在不同輸出格式中的顯示方式。這樣,您就可以選取互相搭配得最好的元素和輸出類型。
單一範本與許多範本
這是單一用途的範本,或您有可能在其他範本中重複使用某些片段?
  • 單一範本:您可以利用單一範本來包含文件設計中所有不同的部分。 這表示所有項目集中在單一位置,不需要進行合併。
  • 許多範本:您可以使用模組化方式,建立多重範本,再將它們合併起來,建立完整文件。 例如,您可以有目錄範本、封面範本、資料範本、索引範本以及封底範本。這些範本可以在產生不同文件時重複使用。
決定提供這些需求所需的範本數。 您可以在 meta 資料屬性中命名並說明每一個範本區塊。 名稱內容會顯示在範本中,而說明內容則會顯示在範本元素提示欄位中。
檢視環境定義
某個人會如何檢視這份文件?
  • 將它印出來?在畫面上檢視?兩者兼而有之?
  • 會在整合產品中執行它嗎?
支援概念

2:設計範本

當設計範本時,下列策略可協助您有效利用時間。
  • 範本可設計來提供特定的頁面佈置內容,例如,頁面大小、方向、邊距、欄數,以及文件中最可能使用之段落類型的樣式。
  • 範本可以包含:
    • 文件結構元素,例如:段落、表格、清單和內容目錄。
    • 文件佈置區塊,例如:主要頁面、樣式表、標頭和標底。
    • 內部與外部使用者定義的樣式,例如:文字或段落格式化。文字格式化包括粗體、斜體、底線、字型大小和字型顏色。段落格式包括邊距、邊框、縮排,以及 JavaScript 形式的 Scripting 參數。
    • 內嵌範本內容,例如:影像、靜態文字,以及靜態檔案和樣式表的參照。
    • 資料元素,例如:屬性、條件和動態資料元素。
    • 查詢和過濾器格式的資料擷取。
    • 用來在執行時期接收值的外部變數,以及用於計算的內部變數。建議您建立外部變數,而非將範本中的資料來源 URL 寫在程式中。如果您將 URL 寫在程式中,當伺服器名稱變更時,您就必須更新每一個範本中的 URL。利用外部變數,您可以在執行時期置換 URL。如果範本內嵌在其他產品中,當其參照資料時,請使用這些產品可辨識的特殊變數。
  1. 啟動 Document Studio。
  2. 建立新範本,從頭開始,或以現有的範本為基礎。
  3. 新增資料來源綱目
  4. 新增元素
  5. 新增格式到元素中
  6. 定義動態內容
  7. 選用:利用過濾器、排序或條件來精簡資料

3: 測試範本

  1. 執行驗證工具。
  2. 產生預覽。
支援作業:

4: 儲存範本

下一步

建立及測試範本之後:

意見