nc報表開發手冊-文庫吧

【正文】 查詢引擎的低開發難度報表，其編碼量 小，操作簡單，適合于開發數據和格式比較規律的報表；另一類是基于行業報表工具的高開 發難度報表，主要工作是編寫子類代碼，自由度高，適合于開發復雜報表。2. 應用模型 數據模型與展現模型一般來說，報表是由數據和格式組成的整體。報表的數據模型通常包含以下信息： 數據結構； 待定參數描述； 取數規則描述； 數據加工算法描述； 多個數據集合之間的數據關聯描述；可作為數據載體的常用 NC 數據結構包括： ——循環訪問 VO，是由屬性和取值成對組成的 集合，提供了根據屬性獲得/設置值的方法，是單據和報表模板采用的主要結構； ——普通 VO，包含多個屬性及每個屬性的 getter 和 setter 方法，是 業務組主要數據結構的父類； ——存儲數據集，由元數據和內容數據兩部分組成， 元數據（Column[]）描述了各列的信息，內容數據描述了一個二維的數據集合，當游標 指向內容數據的某行時，可以獲得該行指定列的數據，用于查詢引擎； ——內存結果集，同樣由元數據和內容數據組成，其中元 數據（MemoryResultSetMetaData）描述各列信息，內容數據（ArrayList）描述了一個二 維數據集合，可以直接訪問其任何元素，目前被一些業務算法使用； Object[][]，Vector，ArrayList——這些都是 JDK 的常用結構，均可存儲二維數據。報表的展現模型通常包含以下信息： 控件（核心控件是表格）屬性和布局； 控件顯示內容與顯示規則（綁定數據、參數、行列格式、界面資源等）； 控件連動規則； 數據處理規則（定位、排序、過濾、統計、公式、交叉、鉆取等）； 動態擴展規則； 輸入輸出控制（待定參數設置，打印，導出等）第 3 頁 數據字典NC 數據字典提供了統一的數據建模平臺，支持對各種數據庫對象進行管理，維護這些物理 對象的邏輯屬性，并向外系統提供訪問數據庫邏輯信息的接口。以查詢引擎為例，查詢對象 的定義是基于數據字典進行的，而這份數據字典來自查詢對象所指定的數據源。由于多數報 表的列與業務數據庫的字段存在某種對應關系，因此數據字典的存在有助于提高查詢定義的 直觀性和易用性。NC 數據字典通常在安裝產品時候由系統生成，如果想自己為某些數據庫對象生成字典，可 以采用數據字典管理界面提供的導入方法。導入方式包括三種（詳細操作可參見《數據字典 導入說明》）： 解析 PDM 文件（xml 格式）； 解析 NC 標準建庫腳本； 提取數據庫元數據；如果需要給非 NC 數據庫（比如用戶采用的第三方數據庫）生成數據字典，可以利用 PowerDesigner 提供的逆向工程功能將庫里的物理表生成 PDM 文件，修改其中表和字段的 中文名稱，然后以 xml 文件格式存儲，再使用上述第一種方法導入。第 4 頁 業務系統集成對于直接使用查詢引擎開發出的報表，可以使用以下兩種方式掛接到業務組的功能節點。強 烈建議把準備掛接節點的查詢對象和格式對象的編碼設為與業務系統相關的有意義字符串， 以避免不同業務系統預置對象互相覆蓋的危險性。報表管理節點掛接法： 注冊功能節點，類名為 ； 下掛一個參數，參數名為 folderId，參數值為客戶化下查詢引擎管理中相關報表目 錄的 ID（可從數據庫表 pub_formatmodeldef 的 id 字段查出）。獨立報表節點掛接法： 注冊功能節點，類名為：： 下掛兩個參數：pkQryNode——界面模型對應的編碼（可從查詢引擎管理界面讀取），dsName——查詢定義所在數據源。對于高開發難度模式的報表，則與普通功能節點一樣掛接 ToftPanel 的子類即可。第 5 頁第二章 低開發難度報表1. 概述本手冊列舉的低開發難度報表模式統一由查詢引擎（V3 版本）提供解決方案。查詢引擎是 一個面向高級實施人員和普通開發人員的查詢建模產品，延續并完善了自定義查詢體系的技 術路線，在全面支持復雜查詢的設計和個性化的報表展現的同時，大幅度降低了報表開發人 員的編碼工作量和專業技能要求。我們再來看一下查詢引擎的適用性和不適用性。查詢引擎長期作為一個查詢工具發展，因此 尤其適用于與數據庫查詢分析或數據挖掘關系密切的報表開發，同時也支持程序員調用服務 器端代碼對數據進行業務處理。另一方面，自定義查詢體系與模板體系存在一個很大的不同， 模板體系在發布產品之前已經由程序員錄入了大量初始化數據，因此不同用戶能夠分配到不 同的查詢模板、報表模板和打印模板，而自定義查詢體系是完全自定義的實時開發，沒有模 板的預制數據，因此在一個時刻只支持一種參數控制樣式、一種報表界面樣式和一種打印樣 式（或直接打印），但這些樣式均可在設計態修改。在展現上，由于查詢引擎使用的是 SWING 的表格控件，因此對一些 EXCEL 風格的需求支持不夠，這個薄弱環節將在 V31 得到加強。 總體來說，V3 版本的查詢引擎暫不適用于以下兩類報表開發： 有多模板分配需求的報表，或對打印有高度要求的報表； 存在表體合并單元格的報表。查詢引擎的查詢模型（數據模型）設計如下：查詢模型流程如下所示（設計態/運行態）：第 6 頁界面模型（展現模型）設計如下：第 7 頁界面模型流程如下所示：本章共介紹了五大類報表的十五種開發模式。盡管這些模式之間存在相當差異，但是針對以 前我們發現的一些用例雜亂導致的培訓效果問題，本章的所有范例集中面向兩個業務應用（單位費用統計和部門人事統計），即用不同方案解決相似問題，以便于讀者從中領會和比 較這些模式的原理、特點和適用性。希望這種做法不會給讀者造成一個誤導：查詢引擎只能 解決這兩類報表的應用。2. 查詢類報表查詢類報表指通過一個或多個 SQL 查詢結果形成的二維數據展現出來的報表，由于 SQL 的 語法特點，此類報表通常具有固定的列結構和動態的行結構，但模式 也探討了一種根據 參數動態改變查詢列結構的方案。 明細報表【概述】 明細報表用于展現最基本維度上的數據，即最細粒度的數據。通常明細總是相對于匯總而言的，如果我們把某商品每個月的總銷售額列表視為匯總數據，那么該商品每天的詳細銷售情 況就可視為明細數據；如果我們把某部門當年的總薪資情況做成匯總表，那么該部門每位員 工當年的薪資情況就可以做成明細表。查詢類報表中的明細表通常是指一些不含聚合函數的 SQL 語句直接能夠查詢出的數據形成的報表。【應用場景】第 8 頁開發人員需要通過多表聯查 SQL 或者復合查詢獲得表體數據，同時為報表展現提供待定條 件設置、欄位設置、排序、過濾、定位、小計合計及輸出等功能。當明細表與匯總表一起出 現時，用戶通常還會有從匯總數據聯查明細數據的需求（又稱穿透或鉆取），此類應用將在 模式 中介紹。【適用性和不適用性】 適用于：190。 明細數據的取數規則可用 SQL 描述；不適用于：190。 通過行列條件統計單元取值的明細表。此類報表應遵循模式 解決；190。 通過程序算法構造明細數據的報表。此類報表應遵循算法類報表模式解決；【解決方案】取數由向導式 SQL 設計描述，查詢條件由參數控制機制解決，欄目在格式設計態設定，排 序、過濾、定位、小計合計、輸出等功能均內置于報表瀏覽態。【開發步驟】第一步：在查詢引擎管理中建立查詢對象 Q1，做向導式 SQL 設計（通常不含聚合函數 sum、 avg、count、max、min）。對于一個 SQL 無法描述的查詢，比如指定單位在指定期間內不同 科目的發生額，可以利用復合查詢（基于查詢對象的查詢，可參考模式 ）進行描述。Q1 中待定的信息由參數定義描述，普通參數可以在向導式設計的篩選條件處引用，替換型參數 可以在向導式和手工式設計的任意位置引用（參見 FAQ 文檔）；第二步：創建格式對象 F1，引用查詢對象 Q1 并嵌入表格，做相關的欄位、列格式和列表頭 設計。表頭表尾可放置綁定參數的控件；第三步：瀏覽 F1（或掛功能節點），設置參數，檢查數據與格式是否正確；【FAQ】如何充分發揮查詢模型中參數的功能？ 答：參見附錄提供的《查詢引擎 FAQ 之參數篇》。格式設計中的 16 種控件各有何種用途？ 答：表格、圖表是核心控件，用于綁定數據集；面板、拆分窗格（分割面板）、多頁簽作為 界面容器；標簽、文本框、下拉框（組合框）、參照、文本域、復選框、單選框是表頭表尾 控件，需要放在容器上面，用于綁定參數；下拉框、列表綁定枚舉型參數，參照綁定參照型 參數；主子表是已經不推薦使用的連動展現控件；按鈕、樹暫無實際用處。如何控制報表的輸出格式？答：打印輸出利用格式設計中的打印設置功能控制，EXCEL 輸出由界面表格的樣式控制。【范例】 單位費用明細表——各單位在指定期間范圍內的費用明細情況。報表中要求包括公司、期間、制單日期、科目、分錄摘要、發生額等信息，用戶可以根據年度和期間范圍進行查詢。第 9 頁公司期間制單日期科目摘要借發生額貸發生額 查詢引擎管理主界面創建查詢對象，編碼為 gldetail，名稱為費用明細；進行參數定義，增加三個字符型參數：年，起始期間，終止期間；進行 SQL 向導設計：從數據字典添加憑證表（gl_voucher）、憑證分錄（gl_detail）、科目 表（bd_accsubj）和公司目錄（bd_corp），指定表間連接關系、查詢字段、篩選條件（先定 義確定條件）和排序字段；第 10 頁第 11 頁在篩選條件頁簽增加待定條件，在右操作數框中按 F12 引用參數；創建格式對象，編碼為 gldetail，名稱為“費用明細表”；第 12 頁引用查詢“費用明細”；進行格式設計：添加表格和面板控件，表格停靠于中部，雙擊控件設置屬性，綁定數據 集費用明細，面板停靠于北部（作為表頭容器），采用流式布局（FlowLayout），在面板上放 三個文本框控件，分別綁定費用明細的三個參數；第 13 頁第 14 頁（可選）定義一種列格式，用于顯示兩位小數，在表格屬性框的列格式分欄中由兩個金額列引用此列格式；第 15 頁瀏覽費用明細表（先設置參數）；第 16 頁 匯總報表【概述】 匯總數據通常與明細數據相對，是指在明細數據基礎上指定若干個有分類意義的字符型列進行分組，并對另外若干個有統計意義的數值型列進行求和（或求平均、最值、計數等）獲得 的數據。展現匯總數據的報表稱為匯總報表。【應用場景】 我們再細分為兩種應用：1． 靜態匯總設置：查詢數據的 SQL 中指定了分組列和匯總列，此設置在報表瀏覽狀態不再改變。要求提 供待定條件設置、欄位設置、排序、過濾、定位、小計合計及輸出等功能。2． 動態匯總設置： 事先對數據設定某種缺省的匯總設置，此設置在瀏覽態可做更改，并重新計算匯總數據。 同時具備上述功能需求。【適用性和不適用性】 適用于：190。 匯總數據的取數規則可用 SQL 描述；不適用于：190。 通過行列條件統計單元取值的匯總表。此類報表應遵循模式 解決；190。 通過程序算法構造匯總數據的報表。此類報表應遵循算法類報表模式解決；【解決方案】取數由向導式 SQL 設計描述，查詢條件由參數控制機制解決，欄目在格式設計態設定，動 態匯總由旋轉交叉機制解決，排序、過濾、定位、小計、輸出等功能均內置于報表瀏覽態。【開發步驟】靜態匯總設置第一步：在查詢引擎管理中建立查詢對象 Q2，做向導式 SQL 設計，定義帶有聚合函數的 SQL 語句。單個 SQL 無法描述的查詢利用復合查詢描述。在 Q2 的查詢模型中創建參數和 引用參數，用來描述待定的信息；第二步：創建格式對象 F2，引用查詢對象 Q2 并嵌入表格，做相關的欄位、列格式