nc報表開發手冊(專業版)

　　

【正文】 (new Object[] { ds })。 算法參數：參數名：待獲得參數的編碼。加工算法統一 采用 JAVA 語法的代碼片段，需要通過數據加工才能開發出來的報表通稱為算法類報表。 獨立查詢數據與獨立錄入數據相結合的報表；190。 表單元數據由固定 SQL 結合行列對應的 WHERE 條件唯一決定；190。【應用場景】 在描述清楚交叉規則（指定交叉行、交叉列、交叉值字段）之后，報表要求全動態地實現數據交叉。 THEN 1 ELSE 0 END) AS male,(CASE sex WHEN 39。【開發步驟】第 31 頁第一步：分析交叉報表的結構，找出交叉行字段、交叉列字段和交叉值字段。用戶可以根據年度和期間范圍進行查詢。 //獲得篩選條件表達式void setExpression0(String)。 //獲得排序字段定義 以及相應 setter（設置）方法。比如我們需要按照公司、期間重新匯總，則把公司和 期間移至交叉行列表，發生額移至交叉值列表，確定即可；第 21 頁如果我們把科目移至交叉行，期間移至交叉列，發生額移至交叉值，那么就實現了帶有數據旋轉的動態匯總，即展現各科目在不同期間下匯總出來的發生額。 同時具備上述功能需求。此類報表應遵循模式 解決；190。查詢引擎長期作為一個查詢工具發展，因此 尤其適用于與數據庫查詢分析或數據挖掘關系密切的報表開發，同時也支持程序員調用服務 器端代碼對數據進行業務處理。本手冊介紹了兩大類 NC 報表開發模式，一類是基于查詢引擎的低開發難度報表，其編碼量 小，操作簡單，適合于開發數據和格式比較規律的報表；另一類是基于行業報表工具的高開 發難度報表，主要工作是編寫子類代碼，自由度高，適合于開發復雜報表。本文檔作為集團平臺技 術部對外發布的開發手冊，主要針對對象為技術型報表。由于多數報 表的列與業務數據庫的字段存在某種對應關系，因此數據字典的存在有助于提高查詢定義的 直觀性和易用性。盡管這些模式之間存在相當差異，但是針對以 前我們發現的一些用例雜亂導致的培訓效果問題，本章的所有范例集中面向兩個業務應用（單位費用統計和部門人事統計），即用不同方案解決相似問題，以便于讀者從中領會和比 較這些模式的原理、特點和適用性。Q1 中待定的信息由參數定義描述，普通參數可以在向導式設計的篩選條件處引用，替換型參數 可以在向導式和手工式設計的任意位置引用（參見 FAQ 文檔）；第二步：創建格式對象 F1，引用查詢對象 Q1 并嵌入表格，做相關的欄位、列格式和列表頭 設計。 通過程序算法構造匯總數據的報表。由于本模式采用的技術 方案需要通過代碼片段來描述查詢 SQL 究竟被如何矯正，因此本模式僅建議熟悉 JAVA 編 程的報表開發人員使用。 //設置表物理名void setTabledisname(String)。 //獲得升序標志void setExpression(String)。在上述過程中，我們根據交叉規則把原始數據中的列分成了三種，第一種稱為交叉行（其數 據交叉后出現在行上），第二種稱為交叉列（其數據交叉后出現在列頭上），第三種稱為交叉 值（交叉前行、列、值的數據出現在一行上，交叉后值的數據出現在行、列的交叉點上）。部門編碼部門名稱人數漢族滿族蒙古族 創建查詢對象，編碼為 han，名稱為漢族，在篩選條件頁簽設置確定條件“民族=’漢族’”，用于查詢各部門的漢族員工人數；第 32 頁 復制查詢對象 han，修改編碼為 man，名稱為滿族，修改確定條件為“民族=’滿族’”，用于查詢各部門的滿族員工人數；第 33 頁 復制查詢對象 han，修改編碼為 menggu，名稱為蒙古族，修改確定條件為“民族=’蒙古族’”，用于查詢各部門的蒙古族員工人數； 創建查詢對象，編碼為 nationalityA，名稱為部門員工民族統計 A，選擇表為部門檔案和 上述三個查詢對象對應的臨時表，利用部門主鍵字段連接。女39。 對交叉值對應列有界面統計功能（如小計、圖表等）預設置要求的報表；【解決方案】設計態使用查詢模型 SQL 向導設計中的旋轉交叉設置功能來描述初始交叉規則，運行態使 用表格表頭右鍵菜單中的交叉功能實現再次交叉。在查詢對象的 SQL 向導設計當中， 前五個頁簽用于描述 SQL 主體，因為每個單元格只能放一個值，所以主體部分通常只有一 個查詢字段表達式，雖然這部分可能查了很多張表，但這些表大多不服務于那個孤獨的查詢 字段，而是服務于行列條件，最后一個頁簽（交叉屬性）的投影交叉設置可以添加任意多的 行列篩選條件，每個條件用不帶 where 的 SQL 片段描述，比如“性別=’女’”或者“1=1”。 同一列數據存在不同數據類型；【解決方案】 利用查詢引擎提供的合并查詢方案，可以自由增行（提供行名稱）和增列（提供列名稱和列數據類型），可以在任意單元格錄入文字，可以在任意位置嵌入其它查詢（提供此查詢的占位情況，即左上角和右下角坐標），嵌入查詢的定義與本方案無關。代碼向導用于輔助 編碼，雙擊向導樹節點將彈出算法參數設置框，根據參數提示設定參數值后將生成加工代碼 片段，專業開發人員可以對生成的代碼做進一步的修改，但向導生成代碼的動作是單向的。 生成代碼示例：StorageDataSet ds = (Q1, getHashParam(), “nc0717”)。 保留字段（逗號分隔）：連接后結果集的保留字段。int[] iDataTypes = new int[] { , }。雖然查詢引擎能夠展現任意動態結構的數據集，但仍然希望開發人員在設計帶有數據加工的 查詢對象時盡量遵循“列結構穩定”原則，這樣做可以保證在格式設計態進行更多有效工作。交叉設置中刪除財務部和行政部兩行；創建查詢對象，編碼為 nationalityE，名稱為部門員工民族統計 E。仿照模式 （旋轉交叉）進行 SQL 設計，查詢字段只保留人員計數表達式一項，交叉屬性進行投影交叉設置， 根據表樣指定行列 WHERE 條件；第 47 頁創建格式對象，編碼為 nationalityD，名稱為“部門員工民族統計表 D”。所謂投影是指其每個單元格內部存 放的內容與該單元的坐標（行列位置）存在直接的關系。 是否有辦法提高 SUM(CASE WHEN)的執行效率？ 答：可考慮在 CASEWHEN 中選擇性高的字段上添加索引。 能夠預先確定交叉后列結構的報表；190。用戶表樣明確規定了這些列標題及其順序，因此交叉后的列結構是事先能夠確定的，無論這些列是否包含有效的統計數據，它們都將在報表 中存在，因此我們稱之為動態行固定列報表。整理界面的向導樹內置了常用的整理代碼向導，可以輔助開 發人員快速完成編碼；第三步：創建格式對象 F3，引用查詢對象 Q3 并嵌入表格，做相關的欄位、列格式和列表頭 設計。 //設置字段表達式 void setFldname (String)。 //獲得查詢字段定義 SelectFldVO[] getSelectFlds()。 行 SQL 手工設計時為何 order by 字段無效？ 答：需要顯式指定排序字段的排序方式（升序——asc，降序——desc）。第 9 頁公司期間制單日期科目摘要借發生額貸發生額 查詢引擎管理主界面創建查詢對象，編碼為 gldetail，名稱為費用明細；進行參數定義，增加三個字符型參數：年，起始期間，終止期間；進行 SQL 向導設計：從數據字典添加憑證表（gl_voucher）、憑證分錄（gl_detail）、科目 表（bd_accsubj）和公司目錄（bd_corp），指定表間連接關系、查詢字段、篩選條件（先定 義確定條件）和排序字段；第 10 頁第 11 頁在篩選條件頁簽增加待定條件，在右操作數框中按 F12 引用參數；創建格式對象，編碼為 gldetail，名稱為“費用明細表”；第 12 頁引用查詢“費用明細”；進行格式設計：添加表格和面板控件，表格停靠于中部，雙擊控件設置屬性，綁定數據 集費用明細，面板停靠于北部（作為表頭容器），采用流式布局（FlowLayout），在面板上放 三個文本框控件，分別綁定費用明細的三個參數；第 13 頁第 14 頁（可選）定義一種列格式，用于顯示兩位小數，在表格屬性框的列格式分欄中由兩個金額列引用此列格式；第 15 頁瀏覽費用明細表（先設置參數）；第 16 頁 匯總報表【概述】 匯總數據通常與明細數據相對，是指在明細數據基礎上指定若干個有分類意義的字符型列進行分組，并對另外若干個有統計意義的數值型列進行求和（或求平均、最值、計數等）獲得 的數據。【應用場景】第 8 頁開發人員需要通過多表聯查 SQL 或者復合查詢獲得表體數據，同時為報表展現提供待定條 件設置、欄位設置、排序、過濾、定位、小計合計及輸出等功能。獨立報表節點掛接法： 注冊功能節點，類名為：： 下掛兩個參數：pkQryNode——界面模型對應的編碼（可從查詢引擎管理界面讀取），dsName——查詢定義所在數據源。很多二次開發人員雖然不是專門搞技術的，但通常具有 一定的開發基礎，而目前的二次開發平臺限制了他們發揮應有的作用。開發人員投入巨大努力完成第一批報表后，發現第二批報表依然 要從頭做起，或者另一名開發人員遇到類似于第一批報表的需求，無法借鑒（甚至根本 不知道）前人的開發成果； 報表開發對專業技能要求偏高。報表管理節點掛接法： 注冊功能節點，類名為 ； 下掛一個參數，參數名為 folderId，參數值為客戶化下查詢引擎管理中相關報表目 錄的 ID（可從數據庫表 pub_formatmodeldef 的 id 字段查出）。查詢類報表中的明細表通常是指一些不含聚合函數的 SQL 語句直接能夠查詢出的數據形成的報表。報表中要求包括公司、期間、制單日期、科目、分錄摘要、發生額等信息，用戶可以根據年度和期間范圍進行查詢。表頭表尾可放置綁定參數的控件；第三步：瀏覽 F2（或掛功能節點），設置參數，檢查數據與格式是否正確；動態匯總設置 第一步：同上述第一步（但也可以不設置聚合函數，而是在旋轉交叉設置中把缺省的分組列 放到行列表中，把缺省的匯總列放到值列表中）；第二步：同上述第二步，因交叉表的列結構不能在設計態確定，因此只能指定非匯總列的列 格式等信息；第 17 頁第三步：同上述第三步，需要改變匯總設置的時候，利用表頭右鍵菜單的交叉功能把新的匯總列移到交叉行列表，確定即可；（關于交叉的詳細說明參見下一節）【FAQ】 行 SQL 向導設計時如何指定 group by 字段？ 答：無需指定，系統自動把不含聚合函數的查詢字段作為 group by 字段。SQL 整理中的常用數據結構和接口方法如下所述： 查詢基本定義類 QueryBaseDef，所提供方法包括： FromTableVO[] getFromTables()。 //獲得字段別名void setExpression (String)。在 Q3 的查詢模型中創建參數和引用參數，用來描述待定的信息；第二步：在查詢模型中編寫 SQL 整理代碼，這段代碼采用純 JAVA 語法，目的是根據用戶 的參數設置取值調整靜態的查詢基本定義 QueryBaseDef，并把調整后的 QueryBaseDef 所生 成的 SQL 發到數據庫去執行。【應用場景】 開發人員需要從某個具有分類意義的列中提取若干不同的取值，將它們旋轉成為列標題，再對另外一些有統計意義的數值列進行匯總。【適用性和不適用性】 適用于：190。表頭表尾可放置綁定參數的控件；第四步：瀏覽 F5（或掛功能節點），設置參數，檢查數據與格式是否正確；【FAQ】 CASE WHEN 語法的條件判斷表達式能否使用非等值的表達式？答：在 SQLSERVER 下沒有問題，在 ORACLE 下