中文報表工具用戶手冊 - 1 - 中文報表工具 用 戶 手 冊 南京國電南自凌伊電力自動化有限公司南京國電南自凌伊電力自動化有限公司 2005 年年 2 月月 *本說明書可能會被修改，請注意最新版本資料 中文報表工具用戶手冊 - 2 - 目目 錄錄 第一部分第一部分 前言前言4 4 1.1 閱讀對象 4 1.2 文檔不涉及的內容 4 1.3 敬告事項 4 第二部分第二部分 術語術語5 5 第三部分第三部分 系統需求系統需求6 6 3.1 硬件需求：6 3.2 軟件需求：6 第四部分第四部分 程序功能與組織結構程序功能與組織結構7 7 4.1 功能需求與程序的關系 7 4.1.1 報表系統設置.7 4.1.2 報表管理.7 4.1.3 幫助.8 4.2 功能模塊 8 4.2.1 數據服務.9 4.2.2 數據連接.9 4.2.34.2.3 報表管理器9 4.2.44.2.4 報表設計器.10 4.2.5 自動打印與維護.10 4.3 文件的組織 .11 4.3.1 程序文件11 4.3.2 用戶報表模板.11 4.3.3 報表歷史打印記錄11 第五部分第五部分 報表的設計報表的設計1313 5.1 報表的設計過程 .13 5.2 報表管理器 .13 5.3 新建報表 .16 5.4 報表數據、格式的設置 .17 5.5 報表查看 .19 第六部分第六部分 報表的打印報表的打印2222 6.1 任務打印的建立與維護.22 6.1.16.1.1 建立一個任務23 6.1.2 任務的維護.24 第七部分第七部分 報表的維護報表的維護2525 7.1 報表的更改與刪除.25 7.1.1 報表的更改.25 7.1.2 報表的刪除.26 中文報表工具用戶手冊 - 3 - 7.2 歷史報表的維護.26 7.2.17.2.1 超期歷史報表的刪除.26 7.2.2 備份與恢復.27 第八部分第八部分 結束語結束語2828 中文報表工具用戶手冊 - 4 - 第一部分第一部分 前言前言 此文檔作為我公司lypro 系統軟件用戶手冊的一部分提供給用戶。 它涵蓋了“中文報表工具”軟件使用和維護的基本信息。從“系統功能” 、 “程序組織” 、 “報表定義和設計” 、 “報表的打印” 、 “日常維護”等方面進行 了闡述，這些信息也是用戶能夠正確、高效地使用該工具軟件進行工作所必 須了解和掌握的。 1.1閱讀對象閱讀對象 一般用戶：報表設計和維護者。 此類用戶應已掌握了 windows 和 excel 的基本操作方法。 高級用戶：二次開發者。 （一般由我公司程序員擔任） 此類用戶應已掌握了 windows 和 excel 的基本操作方法，以 及基于 vba、delphi、odbc、rdo、ado 的開發技術和數據庫、 sql 的相關知識。 1.2 文檔不涉及的內容文檔不涉及的內容 無論“一般用戶”或“高級用戶” ，我們都假設他已掌握了 windows 和 excel 的基本操作方法。因此，此文檔并不涉及 windows、excel 的 使用，用戶如需要可參考相關書籍。 針對特定用戶之特殊需求而開發的功能，其使用方法不包括在此文 檔中，用戶參考具體操作手冊。 1.3 敬告事項敬告事項 如您發現此文檔內容與“中文報表工具”軟件相異，以“中文報表工 具”軟件為準。 中文報表工具用戶手冊 - 5 - 第二部分第二部分 術語術語 scada 監控與數據采集。 odbc 開放式數據庫連接（open database connectivity） 。微軟公司提 供的“通用數據庫接口”解決方案。 rdo 遠程數據對象（remote data object） 。對 odbc 進行了“面向對象” 的封裝。 ole 對象連接和嵌入（object linking and embedding） 。 ole db 基于 ole 技術的“通用數據庫接口” 。 ado活動數據對象（activex data object） 。對 ole db 進行了“面向對 象”的封裝。 vbavisual basic for appliction 微軟 office 軟件內建的程序語言， 用于對應用程序進行功能擴展。它可從微軟公司獲得，單獨安裝 使用。 bde寶蘭數據庫引擎（borland database engine） 。寶蘭國際（現更名 為 inprise）公司提供的“通用數據庫接口”解決方案。 oracle甲骨文公司開發的關系數據庫系統。 sql結構化查詢語言（structured query language） 。 中文報表工具用戶手冊 - 6 - 第三部分第三部分 系統需求系統需求 3.1 硬件需求：硬件需求： ibm pc 及其兼容機。 cpu： inter pentium 族系 amd k6,k7族系、cyrix mii。 （程序已在pii、piii、k6-ii、k7-dulon上通過測試） ram：64m（更多的內存有助于提高程序性能） 。 硬盤：100m（包括“報表工具”及其支持軟件） 。 用戶如需保留已生成的報表，則需額外的磁盤空間：356m。 （一張報表約占 100k 磁盤空間，假設每天出 10 張報表，所有報表需保 存 1 年，則需磁盤空間100k10 張365 天1 年=356m） 3.2 軟件需求：軟件需求： windows2000；（程序已在 windows nt 4.0 server、windows2000 上 通過測試） ；ms excel 2000；sql server 或 oracle 客戶端程序（7.3.4 及以上版本） 。 中文報表工具用戶手冊 - 7 - 第四部分第四部分 程序功能與組織結構程序功能與組織結構 “中文報表工具”是 scada 系統的一個功能模塊。用以從“歷史數據庫” 中析取相關數據，并依據用戶需求對數據進行組織與處理，將其結果按指定 格式，以報表形式輸出。 下面從“功能模塊”和“文件組織” ，兩個方面加以闡述。 4.1 功能需求與程序的關系功能需求與程序的關系 4.1.1 報表系統設置 功能名稱功能名稱實現模塊實現模塊 啟動工程manager.dpr 主界面unmyform、myform.dfm 啟動畫面unface.pas、face.dfm 數據庫連接undm.pas、dm1.dfm 用戶管理缺省 密碼更改缺省 4.1.2 報表管理 功能名稱功能名稱實現模塊實現模塊 新建報表newrpt.pas.pas、newrptform.dfm 報表屬性設置editrpt.pas、editrptform.dfm 報表設計無單獨對應模塊，啟動 excel 編輯當前報表 刪除報表無單獨對應模塊，一個過程即可實現 清除全部過期報表清除全部過期報表無單獨對應模塊，一個函數即可實現無單獨對應模塊，一個函數即可實現 清除當前過期報表清除當前過期報表無單獨對應模塊，一個函數即可實現無單獨對應模塊，一個函數即可實現 編輯歷史報表編輯歷史報表無單獨對應模塊，一個函數即可實現無單獨對應模塊，一個函數即可實現 新建任務unfrmcasereport.pas、frmcasereport.dfm 編輯任務從 tfrmcasereportdfm 派生出 tmpfrm.dfm 窗體 刪除任務無單獨對應模塊，一個過程即可實現 清除全部過期報表清除全部過期報表無單獨對應模塊，一個函數即可實現無單獨對應模塊，一個函數即可實現 清除當前過期報表清除當前過期報表無單獨對應模塊，一個函數即可實現無單獨對應模塊，一個函數即可實現 編輯歷史報表編輯歷史報表無單獨對應模塊，一個函數即可實現無單獨對應模塊，一個函數即可實現 報表模板設置報表模板設置loadtemplete.pas、loadtempleteform.dfm 報表打印等待報表打印等待frmwait.pas、printwait.dfm 文件定義文件定義include.pas 機組查詢機組查詢machinesearch.pas、machinesearchfrm.dfm 中文報表工具用戶手冊 - 8 - 季節查詢季節查詢search.pas、searchfrm.dfm 4.1.3 幫助 功能名稱功能名稱實現模塊實現模塊 關于about.pas、aboutform.dfm 幫助缺省 4.2 功能模塊功能模塊 “中文報表工具”主要由“數據服務” 、 “數據連接” 、 “報表管理器” 、 “報表設計器” 、 “自動打印及維護”模塊構成。各部分的關系如下圖所示 中文報表工具用戶手冊 - 9 - 4.2.1 數據服務 “數據服務”的主要功能是為其他應用程序提供數據。它做為 scada 系統的一 個功能模塊歷史數據子系統，運行在主服務器結點上。它可定時將遙測、遙 信數據寫入數據庫中，并能對這些數據進行運算（最大值、最小值、平均值、 自定義公式） ，保存運算結果。在本系統中，數據庫采用的是sql server， 這也是在“關鍵數據服務”應用中，廣泛采用的數據庫平臺。嚴格的說， “數據 服務”不屬于“報表工具”系統中的功能模塊。在此將其納入的目的只是保持 文檔的“連續性” ，便于用戶的理解。 提示：提示：在“報表工具”運行的過程中，如果出現“數據庫連接錯誤” ， “連接超 時”等錯誤消息框時，用戶應首先檢查“報表工作站”到主服務器結點的網絡 路徑是否正常；如無異常，再檢查主服務器結點上 sql server 是否運行正常。 一般，問題都可以得到解決。 4.2.2 數據連接 “數據連接”的主要功能是： . 將應用程序傳來的“數據查詢”轉換為 sql server 識別的查詢語 言后，傳遞給 sql server，獲取符合條件的歷史數據。 .將獲取的數據進行“本地”化（時區轉化、時間格式轉化、數據格式 轉化） 。 .將“本地”化后的數據進行“用戶”化（即根據用戶預先定義的報表 模板設置向 excel 傳送數據） 。 該模塊對于一般用戶來說是透明的，您可以完全忽略它的存在。也 可以把它理解為用戶和系統之間交互的“代理人” 。 4.2.34.2.3 報表管理器 “報表管理器”是用戶使用最頻繁的模塊。它的主要功能是： 定義報表屬性（報表類型、數據時間、是否保存） 。 創建、管理用戶報表模板。 中文報表工具用戶手冊 - 10 - 維護歷史打印報表（調閱、打印、刪除） 。 設置自動打印任務。 召喚打印。 4.2.44.2.4 報表設計器 “報表設計器”是個嵌入到 excel 中的“寄生”程序，使用 vba 開 發。它的“人機界面”采用 excel 的界面。用戶在此處將進行報表的詳細 設計（依據系統報表模板）： 指定需要哪些遙測或遙信值。 對這些值進行運算、統計，生成相應的圖（表） 。 定義報表打印的格式。 程序將“分析”用戶的這些設置（設計） ，并將“分析”的結果保 存為此報表的模板文件（用戶報表模板） ，成為以后生成該報表的母板。 提示：提示：出于方便用戶對報表模板進行功能擴充的需要，我沒有對模板中的程 序代碼加入“數字簽名” 。這樣做的好處是用戶可自由的編輯、添加代碼，但 同時會導致新安裝的 execl 在第一次運行時，誤報此程序“可能包含病毒” 。 此時，用戶可以在 execl 中選擇菜單“工具宏安全” ，在彈出的對話框中， 將“安全級”設為“無” ，此后運行就不會出現該錯誤信息。 4.2.5 自動打印與維護 該模塊是以單獨的應用程序實現的。用戶可用它完成報表的定時自動 打?。ㄖС置摍C打?。┮约俺^保存周期的歷史報表的刪除。也可暫時停 止“自動打印”或“維護”的執行。 中文報表工具用戶手冊 - 11 - 4.3 文件的組織文件的組織 這里只從“一般用戶”的角度闡述“中文報表工具”程序的文件組織。 程序安裝完畢后（假設安裝在 d 盤） ，會生成如下目錄結構： d: 報表程序manager.exe runattime.exe report_sys 用戶報表 報表歷史打印記錄 4.3.1 程序文件 報表管理器 d:報表程序manager.exe 自動打印與維護 d:報表程序runattime.exe 4.3.2 用戶報表模板 所有的用戶自定義的報表模板都存放在目錄“d:用戶報表”下。 如用戶建立了報表“報表 01” 、 “報表 02” 、 “報表 03” ，則目錄如下： d:用戶報表報表 01.xls 報表 02.xls 報表 03.xls 4.3.3 報表歷史打印記錄 所有的歷史報表打印存放在目錄“d:報表歷史打印記錄”下。且 每個報表生成一個子目錄。 在上例中，當用戶創建三個報表的同時，程序會在目錄“d: 報表歷史 打印記錄”下自動生成如下的子目錄： d: 報表歷史打印記錄報表 01 中文報表工具用戶手冊 - 12 - 報表 02 報表 03 以后當生成歷史打印報表時候，會將其做為歷史報表存入對應的子目 錄中。 中文報表工具用戶手冊 - 13 - 第五部分第五部分 報表的設計報表的設計 本章將介紹設計報表的過程，同時說明軟件的操作方法。 5.1 報表的設計過程報表的設計過程 一張報表的設計過程可分為：新建報表、設置報表屬性、報表的詳細 設計、測試、保存（如圖 5.1 所示） 。 中文報表工具用戶手冊 - 14 - 5.2 報表管理器報表管理器 圖 5.2：“報表管理器”的主窗口： 說明：圖 5.2 顯示了三個區域：報表分類、用戶報表、報表歷史打印記錄。 1. 報表分類 該區域列出按報表時間段頻率的分類：日報表、周報表、月報表、年報 表、報表任意時段查詢、季節查詢、機組運行狀況查詢。 當用戶選擇一個分類時， “用戶報表模板”區域將只列出該類型的報表。 2. 用戶報表 該區域用于顯示所有用戶已定義的報表模板，并包含了“報表名稱” 、 “類型” 、 “數據時間范圍” 、 “報表文件名稱” 、 “報表歷史打印存放位置” 、 “歷史報表保存周期”信息。如果用戶選擇了一個報表打印，則與之對應的 歷史打印報表將在“歷史報表打印記錄” 區域顯示出來。 用戶報表 區域 報表歷史打印記錄 顯示區域 報表 分類 中文報表工具用戶手冊 - 15 - 3.報表歷史打印記錄 該區域用于顯示當前報表的所有歷史報表信息，包括“歷史報表打印文 件名” 、 “數據時間” 、 “更新時間” 、 “該歷史打印報表保存的天數” 、 “該歷史打 印記錄報表刪除的日期” 。如果，一張歷史報表超過了它的“保存周期”且仍未 刪除，它將以灰色顯示。 圖 5.3：“報表管理器”的打印任務窗口： 說明：圖 5.3 是“任務打印管理”頁面。它分為“打印任務” 、 “任務報表”二 個區域。 1. 打印任務區域 該區域顯示了所有用戶定義的任務（任務名稱、執行時間） 。 “任務”是 能夠自動打印執行的最小單位，一個“任務”可包括一張或多張報表。當用 任務中的任務中的 報表報表 打印打印 任務任務 中文報表工具用戶手冊 - 16 - 戶在該區域選擇一個打印任務時，在“任務報表” 區域顯示了該“任務”所 包含的報表。 2. 任務報表區域 該區域顯示了一個“任務”所包含的報表的名稱、類型、自動打印狀態。 5.3 新建報表新建報表 在“報表管理器”的主菜單上選擇“報表管理新建報表” ，或在工具 菜單上選擇“新建報表” ，此時就會出現的“新建報表”對話框窗口（如圖 5.4 所示） 。 圖 5.4： 5.4 新建報表 中文報表工具用戶手冊 - 17 - 說明： 報表的名稱在所有的報表中必須唯一。 報表類型包括：日報表、周報表、月報表、年報表、報表時間段查 詢、報表季節查詢，機組運行查詢等。 報表的排列屬性取決與模板具有的特性，有橫向和縱向屬性。 查詢方式：分廠站和設備的類型進行選擇。 點擊“設備”列框中的設備，在“測點”列表框中顯示該設備所有 的測點，選中需要建立的測點進行報表組建。 對“選擇變量”的列表框中所選擇的內容可以進行“刪除” 、 “清空” 、 “上移” 、 “下移”操作。 選擇“保存歷史報表打印記錄”框，在脫機打印狀態下，將打印輸 出保存到文件中，其后的輸入框中輸入歷史報表打印記錄欲保存的天數 （最長可保存 99999 天） 。 如果選擇了“啟動 excel”選擇框，則按“確定”后，將自動載入 excel，轉入“報表格式”設計階段。當然，也可以后加載 excel 進行 設計。 5.4 報表數據、格式的設置報表數據、格式的設置 這部分工作在 excel 中進行。如果 excel 尚未加載，用戶可在“用戶報 表”區域先選擇待設計的報表，在窗口主菜單中選擇“報表管理設計報 表”或在“用戶報表”區域單擊鼠標右鍵，在彈出的菜單中選擇“設計報 表” ，之后，程序將加載 excel，并調入相應的報表。 1、報表頁面：（如圖 5.5 圖） 中文報表工具用戶手冊 - 18 - 5.5 數據顯示頁面 2、數據頁面：（如圖 5.6 所示） 打印輸打印輸 出區域出區域 引用引用“數據數據” 頁面的頁面的 “g10”單單 元元 中文報表工具用戶手冊 - 19 - 5.6 數據設計頁面 “報表設計器”分為二個部分：數據頁面、報表頁面。 、數據頁面（圖 5.5） 該頁面主要分為三個區域：點名輸入、數據返回、命令 “點名輸入”區域是用戶輸入點名的地方，此區域從“c3”單元開始至 “p3”單元結束。每個點名占一個單元(cell)，從左至右依次輸入。程序 將依照這些點名從歷史數據庫取得相應的數據，因此用戶應保證輸入的點 名已在歷史數據庫中定義。否則。返回的數據將為空值。 “數據返回”區域是用來存放歷史數據庫返回數據的地方。數據由程序 自動填寫，無須用戶干預。 “命令”區域有二個命令按鍵： 按鍵“生成 sql 語句”主要提供給程序員進行二次開發使用，一般用 戶無須了解。 按鍵“刷新數據”用來依據報表當前設置，從歷史數據庫提取數據， 并填寫到報表中。用戶可使用該命令來測試報表的設計。 2、報表頁面（圖 5.6） 命令命令 區域區域 點名輸入點名輸入 區域區域 數據返數據返 回區域回區域 中文報表工具用戶手冊 - 20 - 此頁面用來打印輸出的。用戶在此完成“打印格式”的設計。其使用方 法完全與 excel 一致。所要注意的是，此處的數據引用自“數據頁面”的 相關單元（關于在 excel 中進行“數據引用”的方法，請參考 excel 的相 關書籍） 。用戶也可以在此定義公式，進行計算統計。 用戶在完成了報表屬性、格式設計后，可選擇“刷新數據”命令進行測試。 如果用戶覺得滿意后，就可以保存退出 excel。注意，存盤時請不要更改文件 的路徑和名稱。 5.5 報表查看報表查看 1、日報表、周報表、月報表、年報表查詢 選擇查看日期，默認為當天，如圖 5.51 所示： 5.51 日期選擇圖 2、時段報表查詢 選擇查看日期，如圖 5.52 所示： 5.52 日期選擇圖 3、季節查詢 選擇查看對象，雙擊鼠標后，彈出季節查詢日期參數對話框，如圖 5.53 所示： 中文報表工具用戶手冊 - 21 - 5.53 日期選擇圖 4、機組運行時間查詢 選擇查看對象，雙擊鼠標后，彈出機組查詢參數對話框，如圖 5.54 所示： 5.54 參數選擇圖 5、模板加載 點擊模板按鈕，彈出如下對話框，填寫好已經建立的模板名稱等信息。 中文報表工具用戶手冊 - 22 - 增加增加：添加模板的設置，點擊后在文本框和下拉框中填寫或選擇需要的內容。 刪除刪除：選中添加的模板記錄，點擊該按鈕及可完成刪除操作。 取消取消：結束其次的操作。 保存保存：將添加的模板記錄添加到數據庫中。 修改修改：選中需要修改的模板，在框中做相應的處理。 關閉關閉：退出模板的加載窗口。 上一條上一條：移動光標到當前記錄的上一條。 下一條下一條：移動光標到當前記錄的下一條。 第一條第一條：移動光標到第一條記錄 最后一條最后一條：移動光標到最后一條記錄。 中文報表工具用戶手冊 - 23 - 第六部分第六部分 報表的打印報表的打印 報表工具的打印功能可分為三大類： ）按一次出報表的數量可分為：單一（一次出張報表）與任務（一次 可出張或多張報表）打印。 ）按打印的方式可分為：召喚與自動打印。 ）按打印的輸出形式可分為：脫機與連機打印。 它們之間的聯系如圖 6.1 所示。 從圖 6.1 我們可以看出：） “召喚打印”在“打印管理器”中進行，而 “自動打印”則由“自動打印進程”操作；） “召喚打印”可進行單一或任 務打印，而“自動打印”只能進行任務打??；）無論單一或任務打印都可 選擇輸出至打印機（連機打印）或磁盤（脫機打?。?。兩者的切換可在“報表 管理器”菜單“打印”“脫機打印”進行。缺省的選項是“脫機打印” 。 6.1 任務打印的建立與維護任務打印的建立與維護 “任務打印”是指一個打印命令可制一張或多張報表。 “任務打印”的 核心是“任務” ，它是“任務打印”的最小執行單元。建立“任務”的概 念主要是方便用戶對報表進行分類管理（如，按自動打印的時間段，按報 表中數據的性質電壓、功率等分類建立“任務” ） ，以及提高“自動打印” 進程的執行效率（可靠的多線程執行） 。 “任務”的建立和管理工作是在 “報表管理器”的“任務管理”頁面進行的（參見圖 5.3） 。 圖 6.1 中文報表工具用戶手冊 - 24 - 6.1.1 建立一個任務 選擇“報表管理器”菜單“任務設置”“新建任務” ，出現如圖 6.2 的窗 口。 中文報表工具用戶手冊 - 25 - 圖 6.2 說明： (1) 每個“任務”都有一個唯一的名稱。 (2) “報表侯選區”是當前尚未加入“任務”中的報表。用戶向加入某張 報表時，可以用鼠標選中它后，單擊“”按鍵，該報表就移入“報表 選中”區內。也可以一次移入多張報表，方法是在“報表侯選區”選 中多張，單擊“”按鍵。如果想從“任務”中去掉某（幾）張報表， 可在“報表選中”區內選中某（幾）張報表后，單擊“編輯任務”后，將出 現“編輯任務”窗口，它的使用方法與“新建任務”類似，這里不再累述。 若想刪除一個任務，則先選擇它，選擇菜單“任務設置”“刪除任務” 即可。 第七部分第七部分 報表的維護報表的維護 這章主要討論報表日常維護。包括“報表的更改與刪除” 、 “歷史報表的維護” 。 7.1 報表的更改與刪除報表的更改與刪除 7.1.1 報表的更改 “報表的更改”指的是用戶報表模板屬性和打印格式的更改。 屬性的更改 i）在“用戶報表模板”區域選擇欲更改的報表； ii）選擇菜單“報表管理”“報表屬性設置” ，出現“報表屬性設 中文報表工具用戶手冊 - 27 - 置”窗口（如圖 7.1 所示） ，也可在選擇報表同時，單擊鼠標右鍵，在彈出的 菜單選擇“報表設置” 。 圖 7.1 此窗口除了“報表類型”不能更改外，其余與“新建報表”窗 口使用方法完全一樣，用戶可參見“5.3 定義報表的屬性” 。 打印格式的更改 這部分工作是在 excel 中進行的。 i）