【文章內(nèi)容簡介】 ng_query_time=5 //長 SQL 語句查詢時間 setvariable=logslowqueries= //超時的查詢則會被記錄在該日志文件里 注：以上所有的配置選項修改后都需要重啟服務(wù)才會生效。 Office Anywhere 網(wǎng)絡(luò)智能辦公系統(tǒng) 二次開發(fā)手冊 5 第二章 數(shù)據(jù)庫管理 phpMyAdmin的安裝 MySQL的數(shù)據(jù)庫管理工具很多， phpMyAdmin是使用 PHP編寫的免費 MySQL數(shù)據(jù)庫管理工具。由于 OA的 MySQL數(shù)據(jù)庫出于安全考慮，被配置為僅能 從本機訪問，所以使用 phpMyAdmin這樣的 B/S結(jié)構(gòu)的管理工具，可實現(xiàn)數(shù)據(jù)庫的遠程管理。 第一步、下載程序包 phpMyAdmin 程序可以從其官方網(wǎng)站 下載，建議下載 系列包含所有語言的非 UTF8版。 第二步、解壓縮 在 MYOA\webroot 目錄下新建一個目錄，如 mysql369(為了防止 他人 利用該工具侵入數(shù)據(jù)庫系統(tǒng)，可把目錄名設(shè)為比較復(fù)雜的，如 MySQL2345，避免目錄名被猜測到。 ),將下載的程序包解壓后 拷貝至 mysql369目錄下。 第三步 、修改配置文件 用文本編輯器，如記事本，打開 MySQL管理工具目錄下的 ，修改以下配置信息： $cfg[39。blowfish_secret39。] = 39。39。 //隨便輸入一個字符串，加密 Cookie 等信息 $cfg[39。Servers39。][$i][39。auth_type39。] = 39。39。 //,config,cookie，建議使用 $cfg[39。Servers39。][$i][39。host39。] = 39。localhost39。 //數(shù)據(jù)庫地址，默認為 localhost $cfg[39。Servers39。][$i][39。port39。] = 39。330639。 //數(shù)據(jù)庫端口，默認為 3306 $cfg[39。Servers39。][$i][39。user39。] = 39。root39。 //數(shù)據(jù)庫用戶名，默認為 root $cfg[39。Servers39。][$i][39。password39。] = 39。39。 //數(shù)據(jù)庫密碼，默認為 myoa888 第四步、使用 phpMyAdmin MySQL管理工具 地址： /mysql， 注意，進入后先選擇中文界面 （ Chinese simplified (zhgb2312)） 。該管理工具的使用需具有一定數(shù)據(jù)庫基礎(chǔ)，請勿進行危險操作，以免導(dǎo)致數(shù)據(jù)丟失。 phpMyAdmin的使用 phpMyAdmin 主界面如下 Office Anywhere 網(wǎng)絡(luò)智能辦公系統(tǒng) 二次開發(fā)手冊 6 在左側(cè)選擇 TD_OA數(shù)據(jù)庫，可查看 OA所有的數(shù)據(jù)表，如下圖 點擊左側(cè)的表名，則右側(cè)列出該表的結(jié)構(gòu)和字段、索引、記錄數(shù)等信息，如下圖 Office Anywhere 網(wǎng)絡(luò)智能辦公系統(tǒng) 二次開發(fā)手冊 7 phpMyAdmin的具體使用教程方法可以參考 通達網(wǎng)站 /OA知識庫 /Office Anywhere 高級應(yīng)用技巧 /OA數(shù)據(jù)庫管理工具 /mysql網(wǎng)頁方式管理工具 /phpMyAdmin的安裝和使用 .wmv 。 Office Anywhere 網(wǎng)絡(luò)智能辦公系統(tǒng) 二次開發(fā)手冊 8 第三章 如何創(chuàng)建一個模塊 創(chuàng)建一個模塊一般需要經(jīng)過以下幾個步驟：根據(jù)功能建立程序存放目錄、創(chuàng)建菜單、分配菜單權(quán)限、編碼、測試等。 模塊目錄 在 MYOA\webroot\general 下建議一個目錄 abc，作為自己開發(fā)模塊的目錄，將程序放置于該目錄下，默認頁面是 創(chuàng)建菜單 用管理員帳號進入 OA，打開 系統(tǒng)管理 菜單設(shè)置，在相應(yīng)的一級菜單后點擊“下一級”鏈接，在右側(cè)的界面上點擊“新建子菜單項”按鈕，如下圖所示： 詳細閱讀上圖界面 中的說明信息，按界面上說明的要求定義好菜單： 子菜單項 ID：系統(tǒng)自動生成，無須調(diào)整 上級菜單：根據(jù)自己的實際應(yīng)用情況調(diào)整 子菜單項代碼：兩位的數(shù)字或字母，作為排序之用 子菜單項名稱：根據(jù)自己的實際應(yīng)用自行填寫 子菜單模塊路徑：該菜單對應(yīng)的程序目錄，應(yīng)為上一個步驟創(chuàng)建的目錄名稱。如果為abc，則該菜單對應(yīng)的菜單圖片名稱為 MYOA\webroot\images\menu\，需要自己創(chuàng)建或拷貝 MYOA\webroot\images\menu下 . Office Anywhere 網(wǎng)絡(luò)智能辦公系統(tǒng) 二次開發(fā)手冊 9 分配菜單權(quán)限 用管理員帳號 進入 OA，打開 系統(tǒng)管理 組織機構(gòu)設(shè)置 角色與權(quán)限管理，給相關(guān)的角色分配剛創(chuàng)建的菜單的使用權(quán)限，則相關(guān)角色的人員就可以在 OA 界面左側(cè)的菜單中看到并訪問該菜單。 編碼和測試 為便于用戶開發(fā)自己的模塊，通達科技在用戶服務(wù)區(qū)提供了 Office Anywhere部份模塊源碼的下載，供開發(fā)人員參考。 用戶自行開發(fā) OA的功能模塊，需要根據(jù) OA的相關(guān)規(guī)范進行開發(fā)，這樣既可以使自行開發(fā)的模塊和 OA的界面效果一直，又可以保證自行開發(fā)的程序在 OA安全框架的保護之下，這樣不僅可以保證新模塊數(shù)據(jù)的安全，又可以使開發(fā)人員 集中精力投入到模塊功能的開發(fā)上。 OA的各功能模塊下的每個程序都需要包含 OA的安全驗證程序： inc/。該程序包含了對用戶登錄信息、是否有權(quán)限訪問該路徑等的檢查，以及 OA界面效果的基本樣式表等。具體的語法為： include_once(inc/)。OA數(shù)據(jù)庫的所有表名和字段名稱全部使用大寫字母，開發(fā)過程請注意。 在開發(fā)自己的功能模塊時可以參考現(xiàn)有 OA模塊，把功能相似的 OA模塊代碼復(fù)制一份，然后在 OA 代碼的基礎(chǔ)上修改。以下幾個小節(jié)介紹 OA系統(tǒng)變量和數(shù)據(jù)庫的使用。 PHP、 HTML、 Javascript等開發(fā)的基礎(chǔ)知識請參考 通達網(wǎng)站 /OA知識庫 /通達科技歷屆培訓(xùn)會議資料 /2021年 9 月 通達 OA 用戶培訓(xùn)與交流研討會資料 /會議技術(shù)資料 /通達 OA 開發(fā)平臺基礎(chǔ)知識 .ppt 系統(tǒng)變量 OA系統(tǒng)提供了 5個通過 SESSION保存的當(dāng)前用戶的系統(tǒng)變量，分別是 $LOGIN_UID //用戶數(shù)字 ID $LOGIN_USER_ID //用戶名，登錄使用 $LOGIN_USER_NAME //用戶真實姓名 $LOGIN_USER_PRIV //用戶角色 ID $LOGIN_DEPT_ID //用戶部門 ID $LOGIN_AVATAR //用戶頭像 $LOGIN_THEME //用戶界面主題 Office Anywhere 網(wǎng)絡(luò)智能辦公系統(tǒng) 二次開發(fā)手冊 10 如需使用這些系統(tǒng)變量，程序需要包含 ，如下代碼： ? include_once(inc/)。 echo 我的登錄用戶 ID是 .$LOGIN_USER_ID。 //本句中的 .表示字符串連接 ? PHP 代碼樣例 以下是一段樣例代碼 ，可放置于 abc 目錄下，可作為開發(fā) OA應(yīng)用程序的模版。 //或 /*? */是 PHP的注釋語句。 ? include_once(inc/)。 // 如需登錄驗證則包含，未登錄將退出 //include_once(inc/)。 // 如需要連接數(shù)據(jù)庫則包含 //include_once(inc/)。 // 如需要使用公用函數(shù)則包含 //include_once(inc/)。 // 如需要使用類型檢驗函數(shù)則包含 //如已包含 ，則無須包含 ? html head title功能模塊名稱 /title meta equiv=ContentType content=text/html。 charset=gb2312 /head body class=bodycolor ? echo 當(dāng)前登錄的用戶為： .$LOGIN_USER_NAME.，用戶名為： .$LOGIN_USER_ID。 ? /body /html 程序運行結(jié)果如下： 連接數(shù)據(jù)庫 代碼 以下程序代碼為讀取 admin用戶所屬部門的示 例： ? include_once(inc/)。 // 如需登錄驗證則包含，未登錄將退出 include_once(inc/)。 // 如需要使用公用函數(shù)則包含 ? html Office Anywhere 網(wǎng)絡(luò)智能辦公系統(tǒng) 二次開發(fā)手冊 11 head title功能模塊名稱 /title meta equiv=ContentType content=text/html。 charset=gb2312 /head body class=bodycolor ? $query = SELECT * from USER where USER_ID=39。admin39。 $cursor= exequery($connection,$query)。 /* exequery 是 OA系統(tǒng) inc/ 包裝的 SQL 語句執(zhí)行函數(shù)， $connection是數(shù)據(jù)庫的連接標(biāo)識符 */ if($ROW=MySQL_fetch_array($cursor)) $DEPT_ID=$ROW[DEPT_ID]。 echo admin用戶所在部門為： u.dept_long_name($DEPT_ID)./u。 ? /body /html 執(zhí)行效果如下圖： 從這段程序可以看出，使用 OA 系統(tǒng)提供的系統(tǒng)頭文件和函數(shù)，訪問數(shù)據(jù)庫將是一件很輕松的事，不用操心數(shù)據(jù)庫的連接參數(shù)等問題，只需簡單的寫下 SQL語句，執(zhí)行它。 MySQL數(shù)據(jù)庫的連接參數(shù)在 MYOA\webroot\inc\，如果自己安裝 MySQL數(shù)據(jù)庫，可自行修改連接參數(shù)。 Office Anywhere 網(wǎng)絡(luò)智能辦公系統(tǒng) 二次開發(fā)手冊 12 第四章 內(nèi)置函數(shù)參考 Message 函數(shù)原型： Message($TITLE, $CONTENT, $STYLE=) 功能描述： 輸出一個信息提示框的 HTML代碼 參數(shù)： $TITLE //信息框標(biāo)題 $CONTENT //信息框提示信息 $STYLE //信息框樣式，可選的值有 error、 warning、 stop、 forbidden、 help、info 返回值： 無 Button_Back 函數(shù)原型： Button_Back() 功能描述： 輸出一個返回按鈕的 HTML代碼 參數(shù)： 無 返回值： 無 find_id 函數(shù)原型 ： Office Anywhere 網(wǎng)絡(luò)智能辦公系統(tǒng) 二次開發(fā)手冊 13 find_id($STRING, $ID) 功能描述： 在字符串 $STRING中查找子串 $ID 參數(shù)： $STRING //以英文逗號 (,)連接的 N個 ID值的一個字符串，如 a,b,c,d $ID //要查找的子符串，如 c 返回值： 找到則返回 true，否則返回 false，布爾值 csubstr 函數(shù)原型： csubstr(amp。$str, $start=0, $long=0, $ltor=true, $_len=2) 功能描述： 截取中文字符串 參數(shù)： $str //要截取的字符串 $start //截取起始位置，默認從頭開始 $long //要截取的長度 $ltor //系統(tǒng)保留 $_len //系統(tǒng)保留 返回值： 截取后的中文字符串。 is_ip 函數(shù)原型： is_ip($IP) 功能描述： 判斷一個字符串是否是一個合法的 IP地址 參數(shù)： Office Anywhere 網(wǎng)絡(luò)智能辦公系統(tǒng) 二次開發(fā)手冊 14 $IP //IP地址字符串 返回值： 如果 $IP是一個 IP地址則返