通達OA二次開發(fā)手冊

1、Office Anywhere 網(wǎng)絡智能辦公系統(tǒng) 二次開發(fā)手冊Office Anywhere 網(wǎng)絡智能辦公系統(tǒng)二次開發(fā)手冊V8.1.150425（2015版）通達信科中國兵器工業(yè)信息中心/目 錄目 錄1前 言1第一章 軟件開發(fā)環(huán)境簡介21.1 編程環(huán)境21.3參數(shù)配置41.3.1 OfficeFPM配置41.3.2 OfficWeb配置41.3.3 PHP配置41.3.4 MySQL配置41.3.5 OfficWeb、OfficeFPM和PHP的關系41.4核心文件51.4.1 auth.inc.php (MYOAwebrootinc)51.4.2 header.inc.php (MYOAwe

2、brootinc)51.4.3 common.inc.php (MYOAwebrootinc)51.4.4 conn.php (MYOAwebrootinc)6第二章 數(shù)據(jù)庫管理72.1 phpMyAdmin的安裝72.2 phpMyAdmin的使用7第三章 如何創(chuàng)建一個模塊103.1建立模塊目錄103.2 創(chuàng)建菜單103.3 分配菜單權限113.4 編碼和測試113.4.1 系統(tǒng)變量123.4.2 PHP代碼樣例123.4.3 連接數(shù)據(jù)庫代碼13第四章 內(nèi)置類庫參考144.1 TD類144.1.1 成員函數(shù)144.2 PortalData類154.2.1 成員函數(shù)154.3 ExcelRea

3、der類184.3.1 成員函數(shù)184.4 Workflow相關類194.4.1 TworkForm類的成員函數(shù)194.4.2 TworkRun類的成員函數(shù)20第五章 內(nèi)置函數(shù)參考255.1 utility.php255.1.1 Message255.1.2 Button_Back255.1.3 find_id265.1.4 get_client_ip265.2 utility_all.php265.2.1 csubstr265.2.2 is_ip275.2.3 add_log275.2.4 get_code_name285.2.5 dept_long_name285.2.6 get_sys_

4、para285.2.7 set_sys_para295.3 utility_org.php295.3.1 is_dept_parent295.3.2 top_dept305.3.3 GetDeptNameById305.3.4 GetPrivNameById305.3.5 GetUserNameById315.3.6 GetUserNameByUid315.3.7 my_exclude_uid315.3.8 GetUnionSetOfChildDeptId325.3.9 GetfunmenuByuserID325.3.10 is_module_manager325.3.11 set_priv_

5、menu_priv335.3.12 set_uid_menu_priv335.3.12 del_user_menu_priv345.3.13 GetUidByOther345.4 utility_sms1.php345.4.1 send_sms345.4.2 delete_sms355.5 utility_sms2.php355.5.1 send_mobile_sms_user355.5.2 send_mobile_sms365.6 utility_file.php365.6.1 upload365.6.2 delete_attach375.6.3 attach_size375.6.4 cop

6、y_attach375.6.5 is_uploadable385.6.6 is_text385.6.7 is_office395.6.8 is_image395.6.9 is_viewable395.6.10 is_media405.6.11 dir_size405.6.12 delete_dir405.6.13 attach_sub_dir415.6.14 attach_real_path415.6.15 attach_id_encode425.6.16 attach_id_decode425.6.17 td_copy425.6.18 td_rename435.6.19 td_move_up

7、loaded_file435.6.20 td_file_put_contents435.6.21 add_attach_module445.6.22 attach_module_id445.6.23 attach_sign_key445.6.24 attach_sign_key_netdisk455.6.25 attach_real_path_netdisk455.6.26 cache_attach_para465.6.27 attach_url465.6.28 attach_url_pda475.6.29 attach_link475.6. 30 attach_link_pda485.6.3

8、1 attach_url_old485.6.32 upload_old495.6.33 add_attach_old495.6.34 delete_attach_old505.6.35 add_attach505.6.36 copy_attach_netdisk505.6.37 copy_sel_attach515.6.38 office_attach515.6.39 create_attach525.6.40 is_editable525.6.41 is_wps525.6.42 is_ppt_xls535.6.43 is_thumbable535.6.44 image_mimetype535

9、.6.45 Is_SysFile545.6.46 file_type545.6.47 mime_type545.6.48 trim_office_attach555.6.49 dir_file_nums555.6.50 CreateThumb555.6.51 ReplaceImageSrc565.6.52 trim_inserted_image565.6.53 backup_file565.6.54 oc_log575.6.55 attach_id_explode575.6.56 attach_id_implode575.7 utility_email.php585.7.1 GetWebMai

10、lNumByUid585.7.2 GetSentMailNum585.7.3 trim_notlogin595.7.4 insert_to_address595.7.5 get_email_data595.7.6 remove_email605.7.7 get_sentbox_data605.7.8 delete_email615.7.9 destroy_email615.7.10 get_time615.7.11 email_count625.7.12 get_outbox_data625.7.13 delete_outbox_email625.8 utility_calendar.php6

11、35.8.1 insert_taskcenter635.8.2 add_calendar635.8.3 update_calendar635.8.4 get_list_data645.8.5 delete_calendar64第六章 公用組件參考656.1 人員多選656.2 人員單選656.3 部門多選666.4 部門單選676.5 角色多選68第七章 典型功能簡析687.1 用戶名相關697.2 登錄密碼加密697.3 系統(tǒng)緩存機制697.4 OA升級產(chǎn)生的變化707.4.1 2013版升級到2013增強版707.4.2 2013增強版升級到2015版71Office Anywhere 網(wǎng)

12、絡智能辦公系統(tǒng) 二次開發(fā)手冊前 言Office Anywhere網(wǎng)絡智能辦公系統(tǒng)（以下簡稱通達OA），不僅是一套成熟的網(wǎng)絡辦公系統(tǒng)，同時也是一個完整、精巧的軟件開發(fā)平臺，不僅集成了Web開發(fā)的全套環(huán)境，并提供了管理架構(gòu)、系統(tǒng)資源的開放性支持，是開發(fā)中小型管理應用系統(tǒng)的理想平臺。本文將從不同的技術層面向您揭示通達OA的二次開發(fā)細節(jié)，是主要針對專職程序設計人員、編程愛好者、軟件產(chǎn)品技術支持人員編寫的OA二次開發(fā)入門教程。通過閱讀本文，您將不僅可以了解通達OA的設計奧秘，也將能夠運用本文所介紹的知識和技巧，輕松構(gòu)建屬于自己的應用系統(tǒng)或模塊，文中將結(jié)合具體實例加以說明。第一章 軟件開發(fā)環(huán)境簡介1.1

13、編程環(huán)境通達OA主要采用PHP語言開發(fā)，系統(tǒng)使用MySQL數(shù)據(jù)庫。在Windows平臺下，通達OA主要注冊了9個系統(tǒng)服務，可以通過控制面板-管理工具-服務，查看這9項服務，服務名分別是Office_Web、MySQL5_OA、Office_Redis、OfficeDaemon、OfficeIm、OfficeIndex、OfficeMail、OfficePOP3、OfficeTask，Office_Web是管理ngnix進程的服務，Office_Web是通達OA所使用的Web Server，通達OA也可以支持IIS作為Web Server，具體配置方法參見通達網(wǎng)站OA知識庫相關文檔。關于PHP語

14、言的使用，可參閱，下載PHP手冊，作為開發(fā)指導，PHP版本已升級至5.3，該版本中許多函數(shù)或方法有調(diào)整，使用時需要注意；關于MySQL數(shù)據(jù)庫的管理與使用，將在第二章進行詳細介紹。1.2目錄層次結(jié)構(gòu)通達OA的目錄層次結(jié)構(gòu)清晰，體現(xiàn)出對服務程序、應用程序、WEB頁面的巧妙整合與組織，便于理解和擴充，下面對目錄結(jié)構(gòu)加以說明：MYOAattachOA附件文件存放目錄binPHP、Zend等主程序及配置文件，服務配置程序等data5MySQL數(shù)據(jù)庫文件目錄 BUS公交線路查詢數(shù)據(jù)庫 TD_OA通達OA主數(shù)據(jù)庫 crscell 報表數(shù)據(jù)庫 MySQLMySQL系統(tǒng)數(shù)據(jù)庫 TD_OA_ARCHIVE通達OA

15、歸檔數(shù)據(jù)庫 ib_logfile0InnoDB引擎使用的日志文件 ib_logfile1InnoDB引擎使用的日志文件 ibdata1InnoDB引擎存儲數(shù)據(jù)與索引的數(shù)據(jù)文件logsOA服務等的日志文件目錄MyAdmin通達OA的MySQL管理工具mysql5MySQL主程序文件nginx高性能的通達Nginx Web應用服務tmp臨時文件目錄webroot通達OA的WEB根目錄（PHP程序目錄）attachment部分OA附件文件存放目錄 hrms_pic人事檔案照片目錄 product_pic銷售管理產(chǎn)品照片存放目錄 new_sms新短消息提醒狀態(tài)文件 部分附件目錄（略） rss今日資訊信

16、息緩存文件 update系統(tǒng)升級，該文件夾下如存在1.php會被自動執(zhí)行并刪除 weather天氣預報緩存文件 wm外部郵件存儲目錄 general主要模塊目錄 一般模塊目錄（略） ipanel主控面板，集成了菜單、短信箱等應用控制界面 mytable桌面模塊程序 system系統(tǒng)功能模塊，下級目錄略 inc系統(tǒng)通用程序及函數(shù)目錄ispiritOA精靈頁面 mobileOA移動界面 module系統(tǒng)組件 dept_select部門選擇組件 editor簡易HTML編輯器組件 OCOffice 文檔在線編輯與閱讀 OC_NETDISK文檔在線編輯與閱讀-僅適用于網(wǎng)絡硬盤 save_file文件轉(zhuǎn)

17、存組件 user_select用戶多選組件 user_select_single用戶單選組件portal門戶界面static系統(tǒng)通用程序及靜態(tài)文件目錄 common通用css文件及其引用的圖片文件 images所有代碼中的<img>標簽src引用的圖片文件templates登錄界面模版theme界面主題wav微訊提醒聲音js界面主題templates登錄界面模版modules所有模塊非通用的css文件及其引用的圖片文件等的目錄address通訊簿非通用css文件及其引用的圖片文件 部分模塊目錄（略）workflow工作流非通用css文件及其引用的圖片文件注：上表中紅色顏色標示的目錄

18、是備份數(shù)據(jù)時需要備份的，是OA的所有數(shù)據(jù)所存放的目錄。1.3參數(shù)配置1.3.1 OfficeFPM配置（MYOAbinservice.ini）Listen = 8266/監(jiān)聽端口ProcessNumber = 10/fastcgi進程數(shù)1.3.2 OfficWeb配置（MYOAbinservice.ini）Listen = 2367/監(jiān)聽端口MemoryWarning= 100/ 非工作時間OfficeNginx.exe占用內(nèi)存的最大值，單位為兆字節(jié)（MB）MemoryMax= 200 / 工作時間OfficeNginx.exe占用內(nèi)存的最大值，單位為兆字節(jié)（MB）1.3.3 PHP配置（MY

19、OAbinphp.ini）display_errors = Off/是否顯示PHP程序錯誤log_errors = Off/是否記錄錯誤日志error_log = filename/錯誤日志記錄文件max_execution_time = 1200/程序最大執(zhí)行時間，單位秒memory_limit = 256M/單個程序占用內(nèi)存上限post_max_size = 1000M/表單提交最大數(shù)據(jù)量，單位MBupload_max_filesize = 200M/上傳單個附件大小，單位MB1.3.4 MySQL配置（MYOAmysql5my.ini）basedir=D:/MYOA/mysql5/MyS

20、QL主程序路徑datadir=D:/MYOA/data5/MySQL數(shù)據(jù)庫路徑tmpdir=D:/MYOA/tmp/緩存路徑character-set-server=gbk/MySQL數(shù)據(jù)庫字編碼port=3336/端口wait_timeout=30/SQL語句執(zhí)行結(jié)束后自動斷開時間interactive_timeout=30/運行SQL語句時段開時間skip-name-resolve/避免外部鎖定(默認是ON)bind-address=/允許遠程連接innodb_file_per_table=1/啟用獨立表空間模式innodb_file_format=Barracuda/Inn

21、oDB數(shù)據(jù)壓縮注：以上所有的配置選項修改后都需要重啟服務才會生效。1.3.5 OfficWeb、OfficeFPM和PHP的關系 OfficeWeb服務守護OfficeFPM進程和OfficeNginx。OfficeFPM進程啟動多個（ProcessNumber）FastCGI進程。OfficeWeb根據(jù)配置參數(shù)（MemoryWarning和MemoryMax）定時檢測OfficeNginx的內(nèi)存占用情況，保證OfficeNginx時刻處于正常響應狀態(tài)。1.4核心文件1.4.1 auth.inc.php (MYOAwebrootinc)通達OA為滿足用戶數(shù)據(jù)安全，原則上所有的php頁面執(zhí)行都將

22、包含auth.inc.php權限驗證程序，其中包含session合法性驗證、訪問路徑授權驗證等；例：include_once("inc/auth.inc.php");1.4.2 header.inc.php (MYOAwebrootinc)為保證通達OA功能顯示標準統(tǒng)一，需要使用標準統(tǒng)一的HTML解析模式對頁面進行解析和渲染，在所有包含HTML代碼輸出的頁面都需要包含header.inc.php程序，其中包括采用的HTML標準、頁面字符集、頁面標題、標準界面樣式表（style.css）等；例：$HTML_PAGE_TITLE = _("頁面標題");in

23、clude_once("inc/header.inc.php");1.4.3 common.inc.php (MYOAwebrootinc) 為了防止用戶輸入不安全數(shù)據(jù)等，通達OA為您提供了用戶輸入數(shù)據(jù)（$_GET、$_POST、$_COOKIE）過濾和校驗程序，原則上所有php頁面文件都需要包含，但如果頁面已經(jīng)包含過auth.inc.php、header.inc.php或conn.php，則無需再單獨包含。例：include_once("inc/auth.inc.php");1.4.4 conn.php (MYOAwebrootinc) 為方便用戶快速

24、連接操作數(shù)據(jù)庫，且對SQL語句安全驗證，原則上在進行數(shù)據(jù)庫操作的所有php頁面都需要包含conn.php程序，但如果頁面已經(jīng)包含auth.inc.php程序，則無需再單獨包含；例：include_once("inc/conn.php");第二章 數(shù)據(jù)庫管理2.1 phpMyAdmin的安裝MySQL的數(shù)據(jù)庫管理工具很多，phpMyAdmin是使用PHP編寫的免費MySQL數(shù)據(jù)庫管理工具。由于OA的MySQL數(shù)據(jù)庫出于安全考慮，被配置為僅能從本機訪問，所以使用phpMyAdmin這樣的B/S結(jié)構(gòu)的管理工具，可實現(xiàn)數(shù)據(jù)庫的遠程管理。第一步、下載程序包phpMyAdmin程序可以

25、從其官方網(wǎng)站下載，建議下載最新的all-language版本。第二步、解壓縮在MYOAwebroot目錄下新建一個目錄，如mysql369(為了防止他人利用該工具侵入數(shù)據(jù)庫系統(tǒng)，可把目錄名設為比較復雜的，如MySQL2345，避免目錄名被猜測到。),將下載的程序包解壓后拷貝至mysql369目錄下。第三步、修改配置文件用文本編輯器，如記事本，打開MySQL管理工具目錄，復制config.sample.inc.php文件并改名為confing.inc.php，打開后修改以下配置信息：$cfg'blowfish_secret' = ''/隨便輸入一個字符串，加密Co

26、okie等信息$cfg'Servers'$i'auth_type' = 'http'/http,config,cookie，建議使用http$cfg'Servers'$i'host' = 'localhost'/數(shù)據(jù)庫地址，默認為localhost$cfg'Servers'$i'port' = '3336'/數(shù)據(jù)庫端口，默認為3336$cfg'Servers'$i'user' = 'root'/數(shù)據(jù)庫用戶

27、名，默認為root$cfg'Servers'$i'password' = ''/數(shù)據(jù)庫密碼，默認為myoa888第四步、使用phpMyAdminMySQL管理工具地址：http:/OA地址/mysql，注意，進入后先選擇中文界面（中文-Chinese simplified ）。該管理工具的使用需具有一定數(shù)據(jù)庫基礎，請勿進行危險操作，以免導致數(shù)據(jù)丟失。2.2 phpMyAdmin的使用phpMyAdmin主界面如下在左側(cè)選擇TD數(shù)據(jù)庫，可查看OA所有的數(shù)據(jù)表，如下圖點擊左側(cè)的表名，則右側(cè)列出該表的結(jié)構(gòu)和字段、索引、記錄數(shù)等信息，如下圖phpMyAd

28、min的具體使用教程方法可以參考 通達網(wǎng)站/OA知識庫/Office Anywhere 高級應用技巧/OA數(shù)據(jù)庫管理工具/mysql網(wǎng)頁方式管理工具/phpMyAdmin的安裝和使用.wmv 。第三章 如何創(chuàng)建一個模塊創(chuàng)建一個模塊一般需要經(jīng)過以下幾個步驟：根據(jù)功能建立程序存放目錄、創(chuàng)建菜單、分配菜單權限、編碼、測試等。3.1建立模塊目錄在MYOAwebrootgeneral下建議一個目錄new_module，作為自己開發(fā)模塊的目錄，將程序放置于該目錄下，默認頁面是index.php或index.html或index.htm3.2 創(chuàng)建菜單用管理員帳號進入OA，打開 系統(tǒng)管理->菜單設置，

29、在相應的一級菜單后點擊“下一級”鏈接，在右側(cè)的界面上點擊“增加子菜單項”按鈕，如下圖所示：詳細閱讀上圖界面中的說明信息，按界面上說明的要求定義好菜單：子菜單項ID：系統(tǒng)自動生成，無須調(diào)整上級菜單：根據(jù)自己的實際應用情況調(diào)整子菜單項代碼：兩位的數(shù)字或字母，作為排序之用子菜單項名稱：根據(jù)自己的實際應用自行填寫子菜單模塊路徑：該菜單對應的程序目錄，應為上一個步驟創(chuàng)建的目錄名稱。如果為new_module，則該菜單對應的菜單圖片名稱為MYOAwebrootstaticimagesmenunew_module.gif，需要自己創(chuàng)建或拷貝new_module.gif拷貝至MYOAwebrootstatic

30、imagesmenu下。3.3 分配菜單權限用系統(tǒng)管理員賬號，在菜單創(chuàng)建完成后跳轉(zhuǎn)界面直接可以給指定菜單分配權限（首次分配菜單權限時需要驗證超級密碼，與系統(tǒng)管理->組織機構(gòu)設置->角色與權限管理中超級密碼一致），如下圖所示：也可以使用傳統(tǒng)方式給新建菜單分配權限，用管理員帳號進入OA，打開 系統(tǒng)管理->組織機構(gòu)設置->角色與權限管理，給相關的角色分配剛創(chuàng)建的菜單的使用權限，則相關角色的人員就可以在OA界面左側(cè)的菜單中看到并訪問該菜單。3.4 編碼和測試為便于用戶開發(fā)自己的模塊，通達科技在用戶服務區(qū)提供了Office Anywhere部份模塊源碼的下載，供開發(fā)人員參考。用戶

31、自行開發(fā)OA的功能模塊，需要根據(jù)OA的相關規(guī)范進行開發(fā)，這樣既可以使自行開發(fā)的模塊和OA的界面效果一致，又可以保證自行開發(fā)的程序在OA安全框架的保護之下，這樣不僅可以保證新模塊數(shù)據(jù)的安全，又可以使開發(fā)人員集中精力投入到模塊功能的開發(fā)上。OA的各功能模塊下的每個程序都需要包含OA的安全驗證程序：inc/auth.inc.php。該程序包含了對用戶登錄信息、是否有權限訪問該路徑等的檢查等。具體的語法為：include_once("inc/auth.inc.php");為更好兼容更多版本的瀏覽器，需要使用標準統(tǒng)一的HTML解析模式對頁面進行解析和渲染，在所有包含HTML代碼輸出的

32、頁面，都需要包含：inc/header.inc.php，輸出統(tǒng)一的HTML頭信息，包括采用的HTML標準、頁面字符集、頁面標題、標準界面樣式表（style.css）等。在沒有HTML代碼輸出的頁面，不需要包含該文件。OA數(shù)據(jù)庫的所有表名全部使用小寫字母，字段名稱全部使用大寫字母，新模塊中字段名也建議與表名統(tǒng)一使用小寫字母，開發(fā)過程請注意。在開發(fā)自己的功能模塊時可以參考現(xiàn)有OA模塊，把功能相似的OA模塊代碼復制一份，然后在OA 代碼的基礎上修改。以下幾個小節(jié)介紹OA系統(tǒng)變量和數(shù)據(jù)庫的使用。3.4.1 系統(tǒng)變量OA系統(tǒng)提供了多個通過SESSION保存的當前用戶的系統(tǒng)變量，分別是$_SESSION&

33、quot;LOGIN_UID"/用戶數(shù)字ID$_SESSION"LOGIN_USER_ID"/用戶名，無意義$_SESSION"LOGIN_BYNAME"/用戶名，又叫用戶別名，登錄使用$_SESSION"LOGIN_USER_NAME"/用戶真實姓名$_SESSION"LOGIN_USER_PRIV"/用戶角色ID$_SESSION"LOGIN_USER_PRIV_OTHER"/用戶輔助角色ID$_SESSION"LOGIN_SYS_ADMIN"/用戶是否有系統(tǒng)管

34、理員權限$_SESSION"LOGIN_DEPT_ID"/用戶部門ID$_SESSION"LOGIN_DEPT_ID_OTHER"/用戶輔助部門ID$_SESSION"LOGIN_AVATAR"/用戶頭像$_SESSION"LOGIN_THEME"/用戶界面主題$_SESSION"LOGIN_FUNC_STR"/用戶模塊權限$_SESSION"LOGIN_NOT_VIEW_USER"/用戶禁止查看用戶列表$_SESSION"LOGIN_DEPT_ID_JUNIOR&

35、quot;/用戶所在部門和所屬部門合集字符串$_SESSION"LOGIN_CLIENT"/用戶登錄OA的設備類型$_SESSION"LOGIN_USER_SEX"/用戶性別如需使用這些系統(tǒng)變量，程序需要包含auth.inc.php，如下代碼：<?include_once("inc/auth.inc.php");echo "我的登錄用戶名是".$_SESSION"LOGIN_BYNAME" /本句中的.表示字符串連接?>3.4.2 PHP代碼樣例以下是一段樣例代碼index.php，

36、可放置于new_module目錄下，可作為開發(fā)OA應用程序的模版。/或/*/是PHP的注釋語句。<?include_once("inc/auth.inc.php");/ 如需登錄驗證則包含，未登錄將退出/include_once("inc/conn.php");/ 如需要連接數(shù)據(jù)庫則包含/如已包含auth.inc.php，則無須包含conn.php/include_once("inc/utility_all.php");/ 如需要使用公用函數(shù)則包含/include_once("inc/check_type.php&qu

37、ot;);/ 如需要使用類型檢驗函數(shù)則包含$HTML_PAGE_TITLE = _("功能模塊名稱");include_once("inc/header.inc.php");/ 如有HTML代碼輸出則包含?><body class="bodycolor"><?echo "當前登錄的用戶為：".$_SESSION"LOGIN_USER_NAME"."，用戶名為：".$_SESSION"LOGIN_BYNAME"?></bo

38、dy></html>程序運行結(jié)果如下：3.4.3 連接數(shù)據(jù)庫代碼以下程序代碼為讀取admin用戶所屬部門的示例：<?include_once("inc/auth.inc.php");/ 如需登錄驗證則包含，未登錄將退出include_once("inc/utility_all.php");/ 如需要使用公用函數(shù)則包含$HTML_PAGE_TITLE = _("功能模塊名稱");include_once("inc/header.inc.php");/ 如有HTML代碼輸出則包含?><

39、;body class="bodycolor"><?$query = "SELECT * from USER where USER_ID='admin'"$cursor= exequery(TD:conn(),$query); /*exequery 是OA系統(tǒng)inc/conn.php包裝的SQL語句執(zhí)行函數(shù)，TD:conn()是數(shù)據(jù)庫的連接標識符*/if($ROW=MySQL_fetch_array($cursor)$DEPT_ID=$ROW"DEPT_ID"echo "admin用戶所在部門為：

40、<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ù)在 MYOAwebrootincoa_config.php文件中配置，如果自己安裝MySQL數(shù)據(jù)庫，可自行修改連接參數(shù)。第四章 內(nèi)置類庫參考4.1 TD類4.1.1 成員函數(shù)Ø conn()函數(shù)說明：獲取數(shù)據(jù)

41、庫連接。參數(shù)：無返回值：數(shù)據(jù)庫連接Ø get_cache($id)函數(shù)說明：獲取緩存內(nèi)容。參數(shù)：$id 緩存id鍵值返回值：緩存內(nèi)容Ø set_cache($id, $data, $ttl = 60)函數(shù)說明：更新緩存內(nèi)容。參數(shù)：$id /緩存id鍵值$data /緩存內(nèi)容$ttl /更新時間返回值：無Ø delete_cache($id)函數(shù)說明：刪除指定緩存。參數(shù)：$id /緩存id鍵值返回值：無4.2 PortalData類4.2.1 成員函數(shù)Ø get_portal_info()函數(shù)說明：獲取門戶的基本信息。參數(shù)：無 返回值：門戶的基本信息數(shù)組&

42、#216; get_nav_list()函數(shù)說明：獲取門戶導航欄的基本信息。參數(shù)：無 返回值：導航欄的基本信息數(shù)組，二維數(shù)組，$column_id為一級數(shù)組鍵值Ø get_columns_info($column_id_str)函數(shù)說明：獲取指定欄目的基本信息。參數(shù)：$column_id_str /欄目ID串返回值：欄目的基本信息，二維數(shù)組，$column_id為一級數(shù)組鍵值Ø get_column_page($column_id)函數(shù)說明：獲取指定欄目的頁面信息。參數(shù)：$column_id /欄目ID返回值：欄目的頁面信息，數(shù)組Ø get_child_colum

43、ns($column_id)函數(shù)說明：獲取指定欄目的子欄目。參數(shù)：$column_id /欄目ID返回值：子欄目數(shù)組Ø get_contents_list($column_id, $start = 0, $limit = 10, $order_by = '')函數(shù)說明：獲取指定欄目的內(nèi)容列表。參數(shù)：$column_id /欄目ID$start /開始條數(shù)$limit /返回內(nèi)容條數(shù)$order_by /內(nèi)容列表排序返回值：內(nèi)容列表，二維數(shù)組Ø get_contents_info($content_id_str)函數(shù)說明：根據(jù)內(nèi)容ID串獲取多條內(nèi)容的詳細信息。

44、參數(shù)：$content_id_str /內(nèi)容ID串返回值：內(nèi)容的詳細信息二維數(shù)組，鍵值為content_idØ get_unit_name()函數(shù)說明：獲取單位名稱。參數(shù)：無返回值：單位名稱Ø get_miitbeian_no()函數(shù)說明：獲取網(wǎng)站備案號。參數(shù)：無返回值：網(wǎng)站備案號4.3 ExcelReader類4.3.1 成員函數(shù)Ø getHead()函數(shù)說明：獲取Excel內(nèi)容頭數(shù)據(jù)信息。參數(shù)：無 返回值：頭數(shù)據(jù)信息數(shù)組Ø getFirstRow()函數(shù)說明：獲取Excel內(nèi)容第一行數(shù)據(jù)信息。參數(shù)：無 返回值：Excel內(nèi)容第一行數(shù)據(jù)信息數(shù)組

45、6; getFirstRow()函數(shù)說明：獲取Excel內(nèi)容第一行數(shù)據(jù)信息。參數(shù)：無 返回值：Excel內(nèi)容第一行數(shù)據(jù)信息數(shù)組4.4 Workflow相關類4.4.1 TworkForm類的成員函數(shù)Ø get_all_supported_ctrls()函數(shù)說明：public，獲取所有支持的控件信息數(shù)組。參數(shù)：無 返回值：數(shù)組，表單支持的控件類型數(shù)組Array(1 => Array(/系統(tǒng)內(nèi)置控件Text => array(control_name => 單行輸入框control_type => 0/系統(tǒng)保留diag_width => 260/對話框?qū)挾萪

46、iag_height => 300/對話框高度)0 => Array(/用戶自定義控件)Ø get_form_info()函數(shù)說明：獲取表單ID、名稱等基本信息。參數(shù)：無 返回值：表單基本信息數(shù)組Ø get_all_fields()函數(shù)說明：獲取表單所有的字段數(shù)組。參數(shù)：無 返回值：表單所有字段數(shù)組4.4.2 TworkRun類的成員函數(shù)Ø get_form_html()函數(shù)說明：獲取當前工作的表單HTML代碼。參數(shù)：無 返回值：字符串，表單HTML代碼Ø get_public_attach_html()函數(shù)說明：獲取公共附件區(qū)HTML代碼。

47、參數(shù)：無 返回值：公共附件區(qū)HTML代碼Ø get_flow_graph_html()函數(shù)說明：獲取流程圖區(qū)的HTML代碼。參數(shù)：無 返回值：流程圖區(qū)的HTML代碼Ø get_view_user_html()函數(shù)說明：獲得查閱信息的HTML代碼。參數(shù)：無 返回值：查閱信息的HTML代碼Ø get_flow_id()函數(shù)說明：獲取當前工作的FLOW_ID。參數(shù)：無 返回值：當前工作的FLOW_IDØ get_run_id()函數(shù)說明：獲取當前工作的RUN_ID。參數(shù)：無 返回值：當前工作的RUN_IDØ get_prcs_id()函數(shù)說明：獲取當

48、前工作的步驟ID。參數(shù)：無 返回值：當前工作的步驟IDØ get_flow_info()函數(shù)說明：獲取當前流程的基本信息，F(xiàn)LOW_TYPE中的數(shù)據(jù)。參數(shù)：無 返回值：當前流程的基本信息數(shù)組Ø get_flow_process_info()函數(shù)說明：獲取流程當前步驟對應設計步驟的基本信息，F(xiàn)LOW_PROCESS中的數(shù)據(jù)。參數(shù)：無 返回值：流程步驟的基本信息數(shù)組Ø get_run_info()函數(shù)說明：獲取當前工作的基本信息，F(xiàn)LOW_RUN中的數(shù)據(jù)。參數(shù)：無 返回值：當前工作的基本信息數(shù)組Ø get_run_data()函數(shù)說明：獲取當前工作的表單數(shù)據(jù)

49、，F(xiàn)LOW_DATA_xxx中的數(shù)據(jù)。參數(shù)：無 返回值：表單數(shù)據(jù)數(shù)組Ø get_cur_prcs_info()函數(shù)說明：獲取當前步驟的基本信息（FLOW_RUN_PRCS表中對應$run_id和$prcs_id的記錄）。參數(shù)：無 返回值：當前步驟的基本信息數(shù)組Ø get_public_attach()函數(shù)說明：獲取當前工作的公共附件。參數(shù)：無 返回值：當前工作的公共附件信息Ø get_run_feedback()函數(shù)說明：獲取當前工作的會簽意見信息。參數(shù)：無 返回值：當前工作的會簽意見信息數(shù)組Ø get_writable_fields()函數(shù)說明：獲取當

50、前工作的表單可寫字段。參數(shù)：無 返回值：可寫字段title字符串，逗號分隔Ø get_secret_fields()函數(shù)說明：獲取當前工作的表單保密字段。參數(shù)：無 返回值：保密字段title字符串，逗號分隔第五章 內(nèi)置函數(shù)參考5.1 utility.php5.1.1 Message函數(shù)原型：Message($TITLE, $CONTENT, $STYLE="" , $BUTTONS=array()功能描述：輸出一個信息提示框的HTML代碼參數(shù)：$TITLE/信息框標題$CONTENT/信息框提示信息$STYLE/信息框樣式，可選的值有error、warning、s

51、top、forbidden、help、info$BUTTONS/操作按鈕數(shù)組返回值：無5.1.2 Button_Back函數(shù)原型：Button_Back($HTML_CHARSET = '')功能描述：輸出一個返回按鈕的HTML代碼參數(shù)：$HTML_CHARSET/解析編碼返回值：無5.1.3 find_id函數(shù)原型：find_id($STRING, $ID)功能描述：在字符串$STRING中查找子串$ID參數(shù)：$STRING/以英文逗號(,)連接的N個ID值的一個字符串，如a,b,c,d$ID/要查找的子符串，如c返回值：找到則返回true，否則返回false，布爾值5.1.

52、4 get_client_ip函數(shù)原型：get_client_ip()功能描述：獲取用戶的客戶端IP地址參數(shù)：無返回值：用戶的客戶端IP地址字符串5.2 utility_all.php5.2.1 csubstr函數(shù)原型：csubstr(&$str, $start=0, $long=0, $ltor=true, $cn_len=2)功能描述：截取中文字符串參數(shù)：$str/要截取的字符串$start/截取起始位置，默認從頭開始$long/要截取的長度$ltor/系統(tǒng)保留$cn_len/系統(tǒng)保留返回值：截取后的中文字符串。5.2.2 is_ip函數(shù)原型：is_ip($IP)功能描述：判斷一個

53、字符串是否是一個合法的IP地址參數(shù)：$IP/IP地址字符串返回值：如果$IP是一個IP地址則返回true，否則返回false。5.2.3 add_log函數(shù)原型：add_log($TYPE,$REMARK,$OPERATOR)功能描述：添加系統(tǒng)日志參數(shù)：$TYPE/日志類型代碼，參考系統(tǒng)代碼設置下的“系統(tǒng)日志類型”$REMARK/備注$OPERATOR/產(chǎn)生日志的用戶的用戶名，一般為當前用戶返回值：無5.2.4 get_code_name函數(shù)原型：get_code_name($CODE_NO,$PARENT_NO)功能描述：獲取系統(tǒng)代碼的描述參數(shù)：$CODE_NO/系統(tǒng)代碼的代碼值，如果多個代碼則用英文逗號串起來$PARENT_NO/父類型代碼值返回值