關於 Doclet 和變數

報表套件是由稱為 Doclet參照 Doclet參照檔案,以及補充 Doclet 的子元件所組成。此外,變數 可源自參照 Doclet 和參照檔案。

  • Doclet

    Doclet (有時稱為一般 Doclet) 包含使用 Narrative Reporting 報表套件建立之報表所需的內容。報表套件可由一個或多個 Doclet 組成。Word 格式的報表套件包含 Word 格式的 Doclet,而 PowerPoint 格式的報表套件包含 PowerPoint 格式的 Doclet。PDF 格式的報表套件包含 Word 格式和 Excel 格式的 Doclet 以及一些 PDF 檔案,不過,只可編寫 Word 和 Excel 格式的 Doclet。

    儲存在 Narrative Reporting 程式庫的資料夾中的 Word 和 PowerPoint 文件,可以作為連結一般 Doclet 新增至報表套件。連結一般 Doclet 可維持與來源程式庫文件的持續連結。更新程式庫文件時,Narrative Reporting 會自動更新連結至程式庫文件的所有 Doclet。Narrative Reporting 會繼續更新 Doclet 檔案,直到停用 Doclet 連結。

    Doclet 完全參與了報表套件的工作流程,包括所有撰寫階段、複查階段、簽核以及報表發佈。

  • 參照 Doclet

    參照 Doclet 可作為儲存內容的容器使用,例如 Excel 檔案的具名範圍,或是從 Reports 建立,在報表套件中由一或多個 Doclet 使用的圖表和圖形。

    Excel 格式參照 Doclet 為 Excel 檔案,其可作為內容 (例如 Oracle Smart View for Office 方格或表單) 的支援檔案,或者作為可直接向 Word 格式 Doclet 登錄然後內嵌的靜態 Excel 內容。您可以使用 Excel 的「名稱管理員」來指定可內嵌內容,然後在智慧型檢視中登錄具名範圍。

    Reports 格式的參照 Doclet 包含在 Narrative Reporting Web 介面中建立並登錄為可用內容的表格和圖表。

    然後您可以將內容從任一種參照 Doclet 直接內嵌至 Word 格式的 Doclet 中。使用內嵌程序,內容的配置與格式即可在目標 Doclet 中隨著來源參照 Doclet 一同維護。

    Excel 格式和 Reports 格式的參照 Doclet 均可包含在 Word 格式的報表套件中。內嵌內容會合併於組合報表中,而且可在複查階段期間附加備註。

    智慧型檢視中,Excel 格式參照 Doclet 可支援編寫階段的內容管理與工作流程功能,如下所示:

    • 參照 Doclet 可予以簽出、修改、上傳、簽入、提交以供核准,以及核准或拒絕。

    • Word 格式的 Doclet 包含可予以簽出、修改、上傳、簽入、提交以供核准,以及核准或拒絕的內嵌內容。

    • 內嵌內容可與針對參照 Doclet 中的具名範圍所做的更新同步。

    • 內嵌內容可予以重新整理。

    Reports 格式的參照 Doclet 的工作流程在 Narrative Reporting Web 介面中維護;不過,這些編寫階段的內容管理和工作流程功能是在 Smart View 中支援,如下所示:

    • Word 格式的 Doclet 包含可予以簽出、修改、上傳、簽入、提交以供核准,以及核准或拒絕的內嵌內容。

    • 內嵌內容可與針對參照 Doclet 中的具名範圍所做的更新同步。

    • 內嵌內容可予以重新整理。

    請注意,參照 Doclet 本身在複查或簽核階段中並無法 用於附加備註;不過在 Doclet 中,您可將備註附加於源自參照 Doclet 的內嵌內容,而內嵌內容是最終發佈報表的一部分。

  • 參照檔案

    參照檔案室包含報表內容的 Excel 工作簿,您可以內嵌至 Word Doclet。參照檔案未使用與Doclet、參照 Doclet 以及補充 Doclet 相同的方式列為報表套件的一部分。相反地,當您將內容從參照檔案內嵌至 Word Doclet 時,該參照檔案會成為 Doclet 的特性。當您簽出目標 Word Doclet 時,Narrative Reporting 會追蹤您對參照檔案進行的任何變更。接著,您可以重新整理已在目標 Word Doclet 中內嵌的內容。

    請注意,參照檔案本身在複查或簽核階段中並無法 用於附加備註;不過在 Word Doclet 中,您可將備註附加於源自參照檔案的內嵌內容,而內嵌內容是最終發佈報表的一部分。

  • 補充 Doclet

    補充 Doclet 為協助整體報表開發的文件,例如來源與支援檔案。補充 Doclet 可以是 Office 檔案類型 (例如 Excel、Word 或 PowerPoint),也可以是非 Office 檔案類型 (例如 PDF、TXT 或 ZIP)。補充 Doclet 的內容不會合併於組合報表中。

    任何檔案類型的補充 Doclet,都可包含在 Word 格式與 PowerPoint 格式的報表套件中。例如,Word 格式的補充 Doclet 可包含在 Word 或 PowerPoint 格式的報表套件中。

    智慧型檢視中,補充 Doclet 可支援撰寫階段的內容管理與工作流程功能,即:

    • Office 格式的補充 Doclet 可予以簽出、修改、上傳、簽入、提交以供核准,以及核准或拒絕。

    • 若為非 Office 檔案類型的補充 Doclet,智慧型檢視讓受指派的作者能夠輕鬆地存取以下載與檢視檔案。不過,和檔案進行的任何其他互動如簽出、上傳和簽入,都必須透過 Narrative Reporting Web 介面來執行。

    請注意,任何檔案類型的補充 Doclet 在複查或簽核階段都無法 用於附加備註,而且不是 最終發佈報表的一部分。

  • 變數

    報表套件變數提供整個報表套件之 Doclet 中顯示的一般文字、數字、日期和資料的集中維護。變數也可用於參照 Doclet 之間的內容,例如將 Excel 資料從參照 Doclet 插入 Word Doclet。

    變數類型有兩種可以選擇:

    • 靜態變數 使用由使用者定義的靜態輸入,例如日期標籤或集合值,其可用於整個報表套件。這些靜態變數可輕鬆地加以更新,而且變數值的所有 Doclet 例項會反映變更。靜態變數有助於在各「報表套件」文件內容之間集中維護通用的日期、數字和文字。

    • 參照變數 的建立方法是參照報表套件中的其他 Doclet 作為來源,並針對變數選取值,例如 Word 段落中的文字或 Excel 儲存格值。如果隨後更新來源文件,這些變更會自動在報表套件中插入的變數例項中更新。參照變數可用來將 Excel 儲存格值插入至 Word Doclet 的段落中,或者建立 Excel 公式以實作交叉合計規則,或者建立指向性文字作為報表敘述,例如「an increase」或「a decrease」。