通達(dá)OA二次開發(fā)手冊(cè)

1、Office Anywhere 網(wǎng)絡(luò)智能辦公系統(tǒng)二次開發(fā)手冊(cè)V8.1.150425（2015版）通達(dá)信科中國(guó)兵器工業(yè)信息中心 HYPERLINK 目 錄 TOC o 1-3 h z u HYPERLINK l _Toc422217878 目 錄 PAGEREF _Toc422217878 h 1 HYPERLINK l _Toc422217879 前 言 PAGEREF _Toc422217879 h 1 HYPERLINK l _Toc422217880 第一章 軟件開發(fā)環(huán)境簡(jiǎn)介 PAGEREF _Toc422217880 h 2 HYPERLINK l _Toc422217881 1.1

2、編程環(huán)境 PAGEREF _Toc422217881 h 2 HYPERLINK l _Toc422217882 1.3參數(shù)配置 PAGEREF _Toc422217882 h 4 HYPERLINK l _Toc422217883 1.3.1 OfficeFPM配置 PAGEREF _Toc422217883 h 4 HYPERLINK l _Toc422217884 1.3.2 OfficWeb配置 PAGEREF _Toc422217884 h 4 HYPERLINK l _Toc422217885 1.3.3 PHP配置 PAGEREF _Toc422217885 h 4 HYPERL

3、INK l _Toc422217886 1.3.4 MySQL配置 PAGEREF _Toc422217886 h 4 HYPERLINK l _Toc422217887 1.3.5 OfficWeb、OfficeFPM和PHP的關(guān)系 PAGEREF _Toc422217887 h 4 HYPERLINK l _Toc422217888 1.4核心文件 PAGEREF _Toc422217888 h 5 HYPERLINK l _Toc422217889 1.4.1 auth.inc.php (MYOAwebrootinc) PAGEREF _Toc422217889 h 5 HYPERLIN

4、K l _Toc422217890 1.4.2 header.inc.php (MYOAwebrootinc) PAGEREF _Toc422217890 h 5 HYPERLINK l _Toc422217891 1.4.3 common.inc.php (MYOAwebrootinc) PAGEREF _Toc422217891 h 5 HYPERLINK l _Toc422217892 1.4.4 conn.php (MYOAwebrootinc) PAGEREF _Toc422217892 h 6 HYPERLINK l _Toc422217893 第二章 數(shù)據(jù)庫(kù)管理 PAGEREF

5、_Toc422217893 h 7 HYPERLINK l _Toc422217894 2.1 phpMyAdmin的安裝 PAGEREF _Toc422217894 h 7 HYPERLINK l _Toc422217895 2.2 phpMyAdmin的使用 PAGEREF _Toc422217895 h 7 HYPERLINK l _Toc422217896 第三章 如何創(chuàng)建一個(gè)模塊 PAGEREF _Toc422217896 h 10 HYPERLINK l _Toc422217897 3.1建立模塊目錄 PAGEREF _Toc422217897 h 10 HYPERLINK l _

6、Toc422217898 3.2 創(chuàng)建菜單 PAGEREF _Toc422217898 h 10 HYPERLINK l _Toc422217899 3.3 分配菜單權(quán)限 PAGEREF _Toc422217899 h 11 HYPERLINK l _Toc422217900 3.4 編碼和測(cè)試 PAGEREF _Toc422217900 h 11 HYPERLINK l _Toc422217901 3.4.1 系統(tǒng)變量 PAGEREF _Toc422217901 h 12 HYPERLINK l _Toc422217902 3.4.2 PHP代碼樣例 PAGEREF _Toc42221790

7、2 h 12 HYPERLINK l _Toc422217903 3.4.3 連接數(shù)據(jù)庫(kù)代碼 PAGEREF _Toc422217903 h 13 HYPERLINK l _Toc422217904 第四章 內(nèi)置類庫(kù)參考 PAGEREF _Toc422217904 h 14 HYPERLINK l _Toc422217905 4.1 TD類 PAGEREF _Toc422217905 h 14 HYPERLINK l _Toc422217906 4.1.1 成員函數(shù) PAGEREF _Toc422217906 h 14 HYPERLINK l _Toc422217907 4.2 PortalD

8、ata類 PAGEREF _Toc422217907 h 15 HYPERLINK l _Toc422217908 4.2.1 成員函數(shù) PAGEREF _Toc422217908 h 15 HYPERLINK l _Toc422217909 4.3 ExcelReader類 PAGEREF _Toc422217909 h 18 HYPERLINK l _Toc422217910 4.3.1 成員函數(shù) PAGEREF _Toc422217910 h 18 HYPERLINK l _Toc422217911 4.4 Workflow相關(guān)類 PAGEREF _Toc422217911 h 19 H

9、YPERLINK l _Toc422217912 4.4.1 TworkForm類的成員函數(shù) PAGEREF _Toc422217912 h 19 HYPERLINK l _Toc422217913 4.4.2 TworkRun類的成員函數(shù) PAGEREF _Toc422217913 h 20 HYPERLINK l _Toc422217914 第五章 內(nèi)置函數(shù)參考 PAGEREF _Toc422217914 h 25 HYPERLINK l _Toc422217915 5.1 utility.php PAGEREF _Toc422217915 h 25 HYPERLINK l _Toc422

10、217916 5.1.1 Message PAGEREF _Toc422217916 h 25 HYPERLINK l _Toc422217917 5.1.2 Button_Back PAGEREF _Toc422217917 h 25 HYPERLINK l _Toc422217918 5.1.3 find_id PAGEREF _Toc422217918 h 26 HYPERLINK l _Toc422217919 5.1.4 get_client_ip PAGEREF _Toc422217919 h 26 HYPERLINK l _Toc422217920 5.2 utility_all

11、.php PAGEREF _Toc422217920 h 26 HYPERLINK l _Toc422217921 5.2.1 csubstr PAGEREF _Toc422217921 h 26 HYPERLINK l _Toc422217922 5.2.2 is_ip PAGEREF _Toc422217922 h 27 HYPERLINK l _Toc422217923 5.2.3 add_log PAGEREF _Toc422217923 h 27 HYPERLINK l _Toc422217924 5.2.4 get_code_name PAGEREF _Toc422217924 h

12、 28 HYPERLINK l _Toc422217925 5.2.5 dept_long_name PAGEREF _Toc422217925 h 28 HYPERLINK l _Toc422217926 5.2.6 get_sys_para PAGEREF _Toc422217926 h 28 HYPERLINK l _Toc422217927 5.2.7 set_sys_para PAGEREF _Toc422217927 h 29 HYPERLINK l _Toc422217928 5.3 utility_org.php PAGEREF _Toc422217928 h 29 HYPER

13、LINK l _Toc422217929 5.3.1 is_dept_parent PAGEREF _Toc422217929 h 29 HYPERLINK l _Toc422217930 5.3.2 top_dept PAGEREF _Toc422217930 h 30 HYPERLINK l _Toc422217931 5.3.3 GetDeptNameById PAGEREF _Toc422217931 h 30 HYPERLINK l _Toc422217932 5.3.4 GetPrivNameById PAGEREF _Toc422217932 h 30 HYPERLINK l _

14、Toc422217933 5.3.5 GetUserNameById PAGEREF _Toc422217933 h 31 HYPERLINK l _Toc422217934 5.3.6 GetUserNameByUid PAGEREF _Toc422217934 h 31 HYPERLINK l _Toc422217935 5.3.7 my_exclude_uid PAGEREF _Toc422217935 h 31 HYPERLINK l _Toc422217936 5.3.8 GetUnionSetOfChildDeptId PAGEREF _Toc422217936 h 32 HYPE

15、RLINK l _Toc422217937 5.3.9 GetfunmenuByuserID PAGEREF _Toc422217937 h 32 HYPERLINK l _Toc422217938 5.3.10 is_module_manager PAGEREF _Toc422217938 h 32 HYPERLINK l _Toc422217939 5.3.11 set_priv_menu_priv PAGEREF _Toc422217939 h 33 HYPERLINK l _Toc422217940 5.3.12 set_uid_menu_priv PAGEREF _Toc422217

16、940 h 33 HYPERLINK l _Toc422217941 5.3.12 del_user_menu_priv PAGEREF _Toc422217941 h 34 HYPERLINK l _Toc422217942 5.3.13 GetUidByOther PAGEREF _Toc422217942 h 34 HYPERLINK l _Toc422217943 5.4 utility_sms1.php PAGEREF _Toc422217943 h 34 HYPERLINK l _Toc422217944 5.4.1 send_sms PAGEREF _Toc422217944 h

17、 34 HYPERLINK l _Toc422217945 5.4.2 delete_sms PAGEREF _Toc422217945 h 35 HYPERLINK l _Toc422217946 5.5 utility_sms2.php PAGEREF _Toc422217946 h 35 HYPERLINK l _Toc422217947 5.5.1 send_mobile_sms_user PAGEREF _Toc422217947 h 35 HYPERLINK l _Toc422217948 5.5.2 send_mobile_sms PAGEREF _Toc422217948 h

18、36 HYPERLINK l _Toc422217949 5.6 utility_file.php PAGEREF _Toc422217949 h 36 HYPERLINK l _Toc422217950 5.6.1 upload PAGEREF _Toc422217950 h 36 HYPERLINK l _Toc422217951 5.6.2 delete_attach PAGEREF _Toc422217951 h 37 HYPERLINK l _Toc422217952 5.6.3 attach_size PAGEREF _Toc422217952 h 37 HYPERLINK l _

19、Toc422217953 5.6.4 copy_attach PAGEREF _Toc422217953 h 37 HYPERLINK l _Toc422217954 5.6.5 is_uploadable PAGEREF _Toc422217954 h 38 HYPERLINK l _Toc422217955 5.6.6 is_text PAGEREF _Toc422217955 h 38 HYPERLINK l _Toc422217956 5.6.7 is_office PAGEREF _Toc422217956 h 39 HYPERLINK l _Toc422217957 5.6.8 i

20、s_image PAGEREF _Toc422217957 h 39 HYPERLINK l _Toc422217958 5.6.9 is_viewable PAGEREF _Toc422217958 h 39 HYPERLINK l _Toc422217959 5.6.10 is_media PAGEREF _Toc422217959 h 40 HYPERLINK l _Toc422217960 5.6.11 dir_size PAGEREF _Toc422217960 h 40 HYPERLINK l _Toc422217961 5.6.12 delete_dir PAGEREF _Toc

21、422217961 h 40 HYPERLINK l _Toc422217962 5.6.13 attach_sub_dir PAGEREF _Toc422217962 h 41 HYPERLINK l _Toc422217963 5.6.14 attach_real_path PAGEREF _Toc422217963 h 41 HYPERLINK l _Toc422217964 5.6.15 attach_id_encode PAGEREF _Toc422217964 h 42 HYPERLINK l _Toc422217965 5.6.16 attach_id_decode PAGERE

22、F _Toc422217965 h 42 HYPERLINK l _Toc422217966 5.6.17 td_copy PAGEREF _Toc422217966 h 42 HYPERLINK l _Toc422217967 5.6.18 td_rename PAGEREF _Toc422217967 h 43 HYPERLINK l _Toc422217968 5.6.19 td_move_uploaded_file PAGEREF _Toc422217968 h 43 HYPERLINK l _Toc422217969 5.6.20 td_file_put_contents PAGER

23、EF _Toc422217969 h 43 HYPERLINK l _Toc422217970 5.6.21 add_attach_module PAGEREF _Toc422217970 h 44 HYPERLINK l _Toc422217971 5.6.22 attach_module_id PAGEREF _Toc422217971 h 44 HYPERLINK l _Toc422217972 5.6.23 attach_sign_key PAGEREF _Toc422217972 h 44 HYPERLINK l _Toc422217973 5.6.24 attach_sign_ke

24、y_netdisk PAGEREF _Toc422217973 h 45 HYPERLINK l _Toc422217974 5.6.25 attach_real_path_netdisk PAGEREF _Toc422217974 h 45 HYPERLINK l _Toc422217975 5.6.26 cache_attach_para PAGEREF _Toc422217975 h 46 HYPERLINK l _Toc422217976 5.6.27 attach_url PAGEREF _Toc422217976 h 46 HYPERLINK l _Toc422217977 5.6

25、.28 attach_url_pda PAGEREF _Toc422217977 h 47 HYPERLINK l _Toc422217978 5.6.29 attach_link PAGEREF _Toc422217978 h 47 HYPERLINK l _Toc422217979 5.6. 30 attach_link_pda PAGEREF _Toc422217979 h 48 HYPERLINK l _Toc422217980 5.6.31 attach_url_old PAGEREF _Toc422217980 h 48 HYPERLINK l _Toc422217981 5.6.

26、32 upload_old PAGEREF _Toc422217981 h 49 HYPERLINK l _Toc422217982 5.6.33 add_attach_old PAGEREF _Toc422217982 h 49 HYPERLINK l _Toc422217983 5.6.34 delete_attach_old PAGEREF _Toc422217983 h 50 HYPERLINK l _Toc422217984 5.6.35 add_attach PAGEREF _Toc422217984 h 50 HYPERLINK l _Toc422217985 5.6.36 co

27、py_attach_netdisk PAGEREF _Toc422217985 h 50 HYPERLINK l _Toc422217986 5.6.37 copy_sel_attach PAGEREF _Toc422217986 h 51 HYPERLINK l _Toc422217987 5.6.38 office_attach PAGEREF _Toc422217987 h 51 HYPERLINK l _Toc422217988 5.6.39 create_attach PAGEREF _Toc422217988 h 52 HYPERLINK l _Toc422217989 5.6.4

28、0 is_editable PAGEREF _Toc422217989 h 52 HYPERLINK l _Toc422217990 5.6.41 is_wps PAGEREF _Toc422217990 h 52 HYPERLINK l _Toc422217991 5.6.42 is_ppt_xls PAGEREF _Toc422217991 h 53 HYPERLINK l _Toc422217992 5.6.43 is_thumbable PAGEREF _Toc422217992 h 53 HYPERLINK l _Toc422217993 5.6.44 image_mimetype

29、PAGEREF _Toc422217993 h 53 HYPERLINK l _Toc422217994 5.6.45 Is_SysFile PAGEREF _Toc422217994 h 54 HYPERLINK l _Toc422217995 5.6.46 file_type PAGEREF _Toc422217995 h 54 HYPERLINK l _Toc422217996 5.6.47 mime_type PAGEREF _Toc422217996 h 54 HYPERLINK l _Toc422217997 5.6.48 trim_office_attach PAGEREF _T

30、oc422217997 h 55 HYPERLINK l _Toc422217998 5.6.49 dir_file_nums PAGEREF _Toc422217998 h 55 HYPERLINK l _Toc422217999 5.6.50 CreateThumb PAGEREF _Toc422217999 h 55 HYPERLINK l _Toc422218000 5.6.51 ReplaceImageSrc PAGEREF _Toc422218000 h 56 HYPERLINK l _Toc422218001 5.6.52 trim_inserted_image PAGEREF

31、_Toc422218001 h 56 HYPERLINK l _Toc422218002 5.6.53 backup_file PAGEREF _Toc422218002 h 56 HYPERLINK l _Toc422218003 5.6.54 oc_log PAGEREF _Toc422218003 h 57 HYPERLINK l _Toc422218004 5.6.55 attach_id_explode PAGEREF _Toc422218004 h 57 HYPERLINK l _Toc422218005 5.6.56 attach_id_implode PAGEREF _Toc4

32、22218005 h 57 HYPERLINK l _Toc422218006 5.7 utility_email.php PAGEREF _Toc422218006 h 58 HYPERLINK l _Toc422218007 5.7.1 GetWebMailNumByUid PAGEREF _Toc422218007 h 58 HYPERLINK l _Toc422218008 5.7.2 GetSentMailNum PAGEREF _Toc422218008 h 58 HYPERLINK l _Toc422218009 5.7.3 trim_notlogin PAGEREF _Toc4

33、22218009 h 59 HYPERLINK l _Toc422218010 5.7.4 insert_to_address PAGEREF _Toc422218010 h 59 HYPERLINK l _Toc422218011 5.7.5 get_email_data PAGEREF _Toc422218011 h 59 HYPERLINK l _Toc422218012 5.7.6 remove_email PAGEREF _Toc422218012 h 60 HYPERLINK l _Toc422218013 5.7.7 get_sentbox_data PAGEREF _Toc42

34、2218013 h 60 HYPERLINK l _Toc422218014 5.7.8 delete_email PAGEREF _Toc422218014 h 61 HYPERLINK l _Toc422218015 5.7.9 destroy_email PAGEREF _Toc422218015 h 61 HYPERLINK l _Toc422218016 5.7.10 get_time PAGEREF _Toc422218016 h 61 HYPERLINK l _Toc422218017 5.7.11 email_count PAGEREF _Toc422218017 h 62 H

35、YPERLINK l _Toc422218018 5.7.12 get_outbox_data PAGEREF _Toc422218018 h 62 HYPERLINK l _Toc422218019 5.7.13 delete_outbox_email PAGEREF _Toc422218019 h 62 HYPERLINK l _Toc422218020 5.8 utility_calendar.php PAGEREF _Toc422218020 h 63 HYPERLINK l _Toc422218021 5.8.1 insert_taskcenter PAGEREF _Toc42221

36、8021 h 63 HYPERLINK l _Toc422218022 5.8.2 add_calendar PAGEREF _Toc422218022 h 63 HYPERLINK l _Toc422218023 5.8.3 update_calendar PAGEREF _Toc422218023 h 63 HYPERLINK l _Toc422218024 5.8.4 get_list_data PAGEREF _Toc422218024 h 64 HYPERLINK l _Toc422218025 5.8.5 delete_calendar PAGEREF _Toc422218025

37、h 64 HYPERLINK l _Toc422218026 第六章 公用組件參考 PAGEREF _Toc422218026 h 65 HYPERLINK l _Toc422218027 6.1 人員多選 PAGEREF _Toc422218027 h 65 HYPERLINK l _Toc422218028 6.2 人員單選 PAGEREF _Toc422218028 h 65 HYPERLINK l _Toc422218029 6.3 部門多選 PAGEREF _Toc422218029 h 66 HYPERLINK l _Toc422218030 6.4 部門單選 PAGEREF _T

38、oc422218030 h 67 HYPERLINK l _Toc422218031 6.5 角色多選 PAGEREF _Toc422218031 h 68 HYPERLINK l _Toc422218032 第七章 典型功能簡(jiǎn)析 PAGEREF _Toc422218032 h 68 HYPERLINK l _Toc422218033 7.1 用戶名相關(guān) PAGEREF _Toc422218033 h 69 HYPERLINK l _Toc422218034 7.2 登錄密碼加密 PAGEREF _Toc422218034 h 69 HYPERLINK l _Toc422218035 7.3

39、系統(tǒng)緩存機(jī)制 PAGEREF _Toc422218035 h 69 HYPERLINK l _Toc422218036 7.4 OA升級(jí)產(chǎn)生的變化 PAGEREF _Toc422218036 h 70 HYPERLINK l _Toc422218037 7.4.1 2013版升級(jí)到2013增強(qiáng)版 PAGEREF _Toc422218037 h 70 HYPERLINK l _Toc422218038 7.4.2 2013增強(qiáng)版升級(jí)到2015版 PAGEREF _Toc422218038 h 71前 言O(shè)ffice Anywhere網(wǎng)絡(luò)智能辦公系統(tǒng)（以下簡(jiǎn)稱通達(dá)OA），不僅是一套成熟的網(wǎng)絡(luò)辦公系

40、統(tǒng)，同時(shí)也是一個(gè)完整、精巧的軟件開發(fā)平臺(tái)，不僅集成了Web開發(fā)的全套環(huán)境，并提供了管理架構(gòu)、系統(tǒng)資源的開放性支持，是開發(fā)中小型管理應(yīng)用系統(tǒng)的理想平臺(tái)。本文將從不同的技術(shù)層面向您揭示通達(dá)OA的二次開發(fā)細(xì)節(jié)，是主要針對(duì)專職程序設(shè)計(jì)人員、編程愛好者、軟件產(chǎn)品技術(shù)支持人員編寫的OA二次開發(fā)入門教程。通過閱讀本文，您將不僅可以了解通達(dá)OA的設(shè)計(jì)奧秘，也將能夠運(yùn)用本文所介紹的知識(shí)和技巧，輕松構(gòu)建屬于自己的應(yīng)用系統(tǒng)或模塊，文中將結(jié)合具體實(shí)例加以說明。第一章 軟件開發(fā)環(huán)境簡(jiǎn)介1.1 編程環(huán)境通達(dá)OA主要采用PHP語言開發(fā)，系統(tǒng)使用MySQL數(shù)據(jù)庫(kù)。在Windows平臺(tái)下，通達(dá)OA主要注冊(cè)了9個(gè)系統(tǒng)服務(wù)，可以通

41、過控制面板-管理工具-服務(wù)，查看這9項(xiàng)服務(wù)，服務(wù)名分別是Office_Web、MySQL5_OA、Office_Redis、OfficeDaemon、OfficeIm、OfficeIndex、OfficeMail、OfficePOP3、OfficeTask，Office_Web是管理ngnix進(jìn)程的服務(wù)，Office_Web是通達(dá)OA所使用的Web Server，通達(dá)OA也可以支持IIS作為Web Server，具體配置方法參見通達(dá)網(wǎng)站OA知識(shí)庫(kù)相關(guān)文檔。關(guān)于PHP語言的使用，可參閱 HYPERLINK ，下載PHP手冊(cè)，作為開發(fā)指導(dǎo)，PHP版本已升級(jí)至5.3，該版本中許多函數(shù)或方法有調(diào)整，使

42、用時(shí)需要注意；關(guān)于MySQL數(shù)據(jù)庫(kù)的管理與使用，將在第二章進(jìn)行詳細(xì)介紹。1.2目錄層次結(jié)構(gòu)通達(dá)OA的目錄層次結(jié)構(gòu)清晰，體現(xiàn)出對(duì)服務(wù)程序、應(yīng)用程序、WEB頁面的巧妙整合與組織，便于理解和擴(kuò)充，下面對(duì)目錄結(jié)構(gòu)加以說明：MYOAattachOA附件文件存放目錄binPHP、Zend等主程序及配置文件，服務(wù)配置程序等data5MySQL數(shù)據(jù)庫(kù)文件目錄 BUS公交線路查詢數(shù)據(jù)庫(kù) TD_OA通達(dá)OA主數(shù)據(jù)庫(kù) crscell 報(bào)表數(shù)據(jù)庫(kù) MySQLMySQL系統(tǒng)數(shù)據(jù)庫(kù) TD_OA_ARCHIVE通達(dá)OA歸檔數(shù)據(jù)庫(kù) ib_logfile0InnoDB引擎使用的日志文件 ib_logfile1InnoDB引擎使

43、用的日志文件 ibdata1InnoDB引擎存儲(chǔ)數(shù)據(jù)與索引的數(shù)據(jù)文件logsOA服務(wù)等的日志文件目錄MyAdmin通達(dá)OA的MySQL管理工具mysql5MySQL主程序文件nginx高性能的通達(dá)Nginx Web應(yīng)用服務(wù)tmp臨時(shí)文件目錄webroot通達(dá)OA的WEB根目錄（PHP程序目錄）attachment部分OA附件文件存放目錄 hrms_pic人事檔案照片目錄 product_pic銷售管理產(chǎn)品照片存放目錄 new_sms新短消息提醒狀態(tài)文件 部分附件目錄（略） rss今日資訊信息緩存文件 update系統(tǒng)升級(jí)，該文件夾下如存在1.php會(huì)被自動(dòng)執(zhí)行并刪除 weather天氣預(yù)報(bào)緩存

44、文件 wm外部郵件存儲(chǔ)目錄 general主要模塊目錄 一般模塊目錄（略） ipanel主控面板，集成了菜單、短信箱等應(yīng)用控制界面 mytable桌面模塊程序 system系統(tǒng)功能模塊，下級(jí)目錄略 inc系統(tǒng)通用程序及函數(shù)目錄ispiritOA精靈頁面 mobileOA移動(dòng)界面 module系統(tǒng)組件 dept_select部門選擇組件 editor簡(jiǎn)易HTML編輯器組件 OCOffice 文檔在線編輯與閱讀 OC_NETDISK文檔在線編輯與閱讀-僅適用于網(wǎng)絡(luò)硬盤 save_file文件轉(zhuǎn)存組件 user_select用戶多選組件 user_select_single用戶單選組件portal門

45、戶界面static系統(tǒng)通用程序及靜態(tài)文件目錄 common通用css文件及其引用的圖片文件 images所有代碼中的標(biāo)簽src引用的圖片文件templates登錄界面模版theme界面主題wav微訊提醒聲音js界面主題templates登錄界面模版modules所有模塊非通用的css文件及其引用的圖片文件等的目錄address通訊簿非通用css文件及其引用的圖片文件 部分模塊目錄（略）workflow工作流非通用css文件及其引用的圖片文件注：上表中紅色顏色標(biāo)示的目錄是備份數(shù)據(jù)時(shí)需要備份的，是OA的所有數(shù)據(jù)所存放的目錄。1.3參數(shù)配置1.3.1 OfficeFPM配置（MYOAbinservi

46、ce.ini）Listen = 8266/監(jiān)聽端口ProcessNumber = 10/fastcgi進(jìn)程數(shù)1.3.2 OfficWeb配置（MYOAbinservice.ini）Listen = 2367/監(jiān)聽端口MemoryWarning= 100/ 非工作時(shí)間OfficeNginx.exe占用內(nèi)存的最大值，單位為兆字節(jié)（MB）MemoryMax= 200 / 工作時(shí)間OfficeNginx.exe占用內(nèi)存的最大值，單位為兆字節(jié)（MB）1.3.3 PHP配置（MYOAbinphp.ini）display_errors = Off/是否顯示PHP程序錯(cuò)誤log_errors = Off/是否

47、記錄錯(cuò)誤日志error_log = filename/錯(cuò)誤日志記錄文件max_execution_time = 1200/程序最大執(zhí)行時(shí)間，單位秒memory_limit = 256M/單個(gè)程序占用內(nèi)存上限post_max_size = 1000M/表單提交最大數(shù)據(jù)量，單位MBupload_max_filesize = 200M/上傳單個(gè)附件大小，單位MB1.3.4 MySQL配置（MYOAmysql5my.ini）basedir=D:/MYOA/mysql5/MySQL主程序路徑datadir=D:/MYOA/data5/MySQL數(shù)據(jù)庫(kù)路徑tmpdir=D:/MYOA/tmp/緩存路徑ch

48、aracter-set-server=gbk/MySQL數(shù)據(jù)庫(kù)字編碼port=3336/端口wait_timeout=30/SQL語句執(zhí)行結(jié)束后自動(dòng)斷開時(shí)間interactive_timeout=30/運(yùn)行SQL語句時(shí)段開時(shí)間skip-name-resolve/避免外部鎖定(默認(rèn)是ON)bind-address=/允許遠(yuǎn)程連接innodb_file_per_table=1/啟用獨(dú)立表空間模式innodb_file_format=Barracuda/InnoDB數(shù)據(jù)壓縮注：以上所有的配置選項(xiàng)修改后都需要重啟服務(wù)才會(huì)生效。1.3.5 OfficWeb、OfficeFPM和PHP的關(guān)系 Office

49、Web服務(wù)守護(hù)OfficeFPM進(jìn)程和OfficeNginx。OfficeFPM進(jìn)程啟動(dòng)多個(gè)（ProcessNumber）FastCGI進(jìn)程。OfficeWeb根據(jù)配置參數(shù)（MemoryWarning和MemoryMax）定時(shí)檢測(cè)OfficeNginx的內(nèi)存占用情況，保證OfficeNginx時(shí)刻處于正常響應(yīng)狀態(tài)。1.4核心文件1.4.1 auth.inc.php (MYOAwebrootinc)通達(dá)OA為滿足用戶數(shù)據(jù)安全，原則上所有的php頁面執(zhí)行都將包含auth.inc.php權(quán)限驗(yàn)證程序，其中包含session合法性驗(yàn)證、訪問路徑授權(quán)驗(yàn)證等；例：include_once(inc/auth

50、.inc.php);1.4.2 header.inc.php (MYOAwebrootinc)為保證通達(dá)OA功能顯示標(biāo)準(zhǔn)統(tǒng)一，需要使用標(biāo)準(zhǔn)統(tǒng)一的HTML解析模式對(duì)頁面進(jìn)行解析和渲染，在所有包含HTML代碼輸出的頁面都需要包含header.inc.php程序，其中包括采用的HTML標(biāo)準(zhǔn)、頁面字符集、頁面標(biāo)題、標(biāo)準(zhǔn)界面樣式表（style.css）等；例：$HTML_PAGE_TITLE = _(頁面標(biāo)題);include_once(inc/header.inc.php);1.4.3 common.inc.php (MYOAwebrootinc) 為了防止用戶輸入不安全數(shù)據(jù)等，通達(dá)OA為您提供了用戶

51、輸入數(shù)據(jù)（$_GET、$_POST、$_COOKIE）過濾和校驗(yàn)程序，原則上所有php頁面文件都需要包含，但如果頁面已經(jīng)包含過auth.inc.php、header.inc.php或conn.php，則無需再單獨(dú)包含。例：include_once(inc/auth.inc.php);1.4.4 conn.php (MYOAwebrootinc) 為方便用戶快速連接操作數(shù)據(jù)庫(kù)，且對(duì)SQL語句安全驗(yàn)證，原則上在進(jìn)行數(shù)據(jù)庫(kù)操作的所有php頁面都需要包含conn.php程序，但如果頁面已經(jīng)包含auth.inc.php程序，則無需再單獨(dú)包含；例：include_once(inc/conn.php);第二

52、章 數(shù)據(jù)庫(kù)管理2.1 phpMyAdmin的安裝MySQL的數(shù)據(jù)庫(kù)管理工具很多，phpMyAdmin是使用PHP編寫的免費(fèi)MySQL數(shù)據(jù)庫(kù)管理工具。由于OA的MySQL數(shù)據(jù)庫(kù)出于安全考慮，被配置為僅能從本機(jī)訪問，所以使用phpMyAdmin這樣的B/S結(jié)構(gòu)的管理工具，可實(shí)現(xiàn)數(shù)據(jù)庫(kù)的遠(yuǎn)程管理。第一步、下載程序包phpMyAdmin程序可以從其官方網(wǎng)站下載，建議下載最新的all-language版本。第二步、解壓縮在MYOAwebroot目錄下新建一個(gè)目錄，如mysql369(為了防止他人利用該工具侵入數(shù)據(jù)庫(kù)系統(tǒng)，可把目錄名設(shè)為比較復(fù)雜的，如MySQL2345，避免目錄名被猜測(cè)到。),將下載的程序

53、包解壓后拷貝至mysql369目錄下。第三步、修改配置文件用文本編輯器，如記事本，打開MySQL管理工具目錄，復(fù)制config.sample.inc.php文件并改名為confing.inc.php，打開后修改以下配置信息：$cfgblowfish_secret = ;/隨便輸入一個(gè)字符串，加密Cookie等信息$cfgServers$iauth_type = http;/http,config,cookie，建議使用http$cfgServers$ihost = localhost;/數(shù)據(jù)庫(kù)地址，默認(rèn)為localhost$cfgServers$iport = 3336;/數(shù)據(jù)庫(kù)端口，默認(rèn)為3

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

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

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

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

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

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

60、IN_USER_ID/用戶名，無意義$_SESSIONLOGIN_BYNAME/用戶名，又叫用戶別名，登錄使用$_SESSIONLOGIN_USER_NAME/用戶真實(shí)姓名$_SESSIONLOGIN_USER_PRIV/用戶角色I(xiàn)D$_SESSIONLOGIN_USER_PRIV_OTHER/用戶輔助角色I(xiàn)D$_SESSIONLOGIN_SYS_ADMIN/用戶是否有系統(tǒng)管理員權(quán)限$_SESSIONLOGIN_DEPT_ID/用戶部門ID$_SESSIONLOGIN_DEPT_ID_OTHER/用戶輔助部門ID$_SESSIONLOGIN_AVATAR/用戶頭像$_SESSIONLOGIN_