Office Anywhere網(wǎng)絡(luò)智能辦公系統(tǒng)二次開發(fā)手冊

OA二次開發(fā)手冊

OfficeAnywhere網(wǎng)絡(luò)智能辦公系統(tǒng)

二次開發(fā)手冊

V7.5.131120（2021增強版）

通達(dá)信科

中國兵器工業(yè)信息中心

://tongda2000

目錄

目錄1

前言1

第一章軟件開發(fā)環(huán)境簡介2

1.1編程環(huán)境2

1.3參數(shù)酉己置4

1.3.1Apache酉已置4

1.3.2PHP配置4

1.3.2MySQL配置4

第二章數(shù)據(jù)庫治理5

2.1phpMyAdmin的安裝5

2.2phpMyAdmin的使用5

第三章如何創(chuàng)建一個模塊8

3.1建立模塊名目8

3.2創(chuàng)建菜單8

3.3分配菜單權(quán)限9

3.4編碼和測試9

3.4.1系統(tǒng)變量9

3.4.2PHP代碼樣例10

3.4.3連接數(shù)據(jù)庫代碼11

第四章內(nèi)置函數(shù)參考12

4.1utility.php12

4.1.1Message12

4.1.2Button_Back12

4.1.3findjd13

4.1.4get_client_ip13

4.2utility_all.php13

4.2.1csubstr13

4.2.2is_ip14

4.2.3addJog14

4.2.4get_code_name15

4.2.5dept_long_name15

4.2.6get_sys_para15

4.2.7set_sys_para16

4.3utility_org.php16

4.3.1is_dept_parent16

4.3.2top_dept17

4.3.3GetDeptNameByld17

4.3.4GetPrivNameById17

4.3.5GetUserNameByld18

4.3.6GetUserNameByUid18

4.3.7my_exclude_uid18

4.4utility_smsl.php19

4.4.1send_sms19

4.4.2delete_sms19

4.5utility_sms2.php20

4.5.1send_mobile_sms_user20

4.5.2send_mobile_sms20

4.6utility_file.php21

4.6.1upload21

4.6.2delete_attach21

4.6.3attach_size21

4.6.4copy_attach22

4.6.5is_uploadable22

4.6.6is_text23

4.6.7is_office23

4.6.8is_image23

4.6.9is_viewable24

4.6.10is_media24

4.6.11dir_size25

4.6.12delete_dir25

4.6.13attach_sub_dir25

4.6.14attach_real_path26

4.6.15attach_id_encode26

4.6.16attach_id_decode27

4.6.17td_copy27

4.6.18td_rename27

4.6.19td_move_uploaded_file28

4.6.20td_file_put_contents28

4.6.21add_attach_module28

4.6.22attach_module_id29

4.6.23attach_sign_key29

4.6.24attach_sign_key_netdisk29

4.6.25attach_real_path_netdisk30

4.6.26cache_attach_para30

4.6.27attach_url31

4.6.28attach_url_pda31

4.6.29attach_link32

4.6.30attach_link_pda32

4.6.31attach_url_old33

4.6.32upload_old33

4.6.33add_attach_old34

4.6.34delete_attach_old34

4.6.35add_attach35

4.6.36copy_attach_netdisk35

4.6.37copy_sel_attach35

4.6.38office_attach36

4.6.39create_attach36

4.6.40is_editable37

4.6.41is_wps37

4.6.42is_ppt_xls37

4.6.43is_thumbable38

4.6.44image_mimetype38

4.6.45Is.SysFile38

4.6.46file_type39

4.6.47mime_type39

4.6.48trim_office_attach39

4.6.49dir_file_nums40

4.6.50CreateThumb40

4.6.51ReplacelmageSrc40

4.6.52trim_inserted_image41

4.6.53backup_file41

4.6.54oc_log41

4.6.55attach_id_explode42

4.6.56attach_id_implode42

第五章公用組件參考43

5.1人員多項選擇43

5.2人員單項選擇43

5.3部門多項選擇44

5.4部門單項選擇45

5.5角色多項選擇46

前百

OfficeAnywhere網(wǎng)絡(luò)智能辦公系統(tǒng)（以下簡稱通達(dá)0A）,不僅是一套成熟的網(wǎng)絡(luò)辦公

系統(tǒng)，同時也是一個完整、精巧的軟件開發(fā)平臺，不僅集成了Web開發(fā)的全套環(huán)境，并提供

了治理架構(gòu)、系統(tǒng)資源的開放性支持，是開發(fā)中小型治理應(yīng)用系統(tǒng)的理想平臺。

本文將從不同的技術(shù)層面向您揭示通達(dá)0A的二次開發(fā)細(xì)節(jié)，是要緊針對專職程序設(shè)計

人員、編程愛好者、軟件產(chǎn)品技術(shù)支持人員編寫的0A二次開發(fā)入門教程.

通過閱讀本文，您將不僅能夠了解通達(dá)0A的設(shè)計隱秘，也將能夠運用本文所介紹的知

識和技巧，輕松構(gòu)建屬于自己的應(yīng)用系統(tǒng)或模塊，文中將結(jié)合具體實例加以說明。

第一章軟件開發(fā)環(huán)境簡介

1.1編程環(huán)境

通達(dá)0A要緊采納PHP語言開發(fā)，系統(tǒng)使用MySQL數(shù)據(jù)庫。

在Windows平臺下，通達(dá)0A要緊注冊了9個系統(tǒng)服務(wù)，能夠通過操縱面板-〉治理工具

-）服務(wù)，查看這9項服務(wù)，服務(wù)名分別是Office_Anywhere、MySQL5_OA、memcachedServer、

OfficeDaemon、Officelm、Officeindex、OfficeMail、OfficePOP3、OfficeTask,

Office_Anywhere服務(wù)實際是集成了PHP模塊的Apache服務(wù)，Apache是通達(dá)OA所使用的

WebServer,通達(dá)OA也能夠支持IIS作為WebServer,具體配置方法參見通達(dá)網(wǎng)站0A知

識庫相關(guān)文檔。

關(guān)于PHP語言的使用，可參閱：〃php.net,下載PHP手冊，作為開發(fā)指導(dǎo)；關(guān)

于MySQL數(shù)據(jù)庫的治理與使用，將在第二章進(jìn)行詳細(xì)介紹。

1.2名目層次結(jié)構(gòu)

通達(dá)0A的名目層次結(jié)構(gòu)清晰，表達(dá)出對服務(wù)程序、應(yīng)用程序、WEB頁面的巧妙整合與

組織，便于明白得和擴(kuò)充，下面對名目結(jié)構(gòu)加以說明：

MYOA

|attachOA附件文件存放名目

|binApache、PHP、Zend等主程序及配置文件，服務(wù)配置程序等

|confApache配置文件

|data5MySQL數(shù)據(jù)庫文件名目

||—BUS公交線路查詢數(shù)據(jù)庫

||-TD_OA通達(dá)0A主數(shù)據(jù)庫

II-MySQLMySQL系統(tǒng)數(shù)據(jù)庫

||-TD_OA_ARCHIVE通達(dá)0A歸檔數(shù)據(jù)庫

||ib_logfileOInnoDB引擎使用的日志文件

||-ib_logfilelInnoDB引擎使用的日志文件

|1ibdatalInnoDB引擎儲備數(shù)據(jù)與索引的數(shù)據(jù)文件

1logsApache等日志文件名目

|modulesApache的模塊文件

|MyAdmin通達(dá)0A的MySQL治理工具

|mysql5MySQL主程序文件

|nginx高性能的通達(dá)NginxWeb應(yīng)用服務(wù)

■tmp臨時文件名目

■webroot通達(dá)0A的WEB根名目（PHP程序名目）

|attachment部分0A附件文件存放名目

|hrmspic人事檔案照片名目

|product_pic銷售治理產(chǎn)品照片存放名目

|new_sms新短消息提醒狀態(tài)文件

1F—……部分附件名目（略）

1|—rss今日資訊信息緩存文件

|update系統(tǒng)升級，該文件夾下如存在1.php會被自動執(zhí)行并刪除

|weather天氣預(yù)報緩存文件

1wm外部郵件儲備名目

|—general要緊模塊名目

11一樣模塊名目（略）

i|ipanel主控面板，集成了菜單、短信箱等應(yīng)用操縱界面

I|mytable桌面模塊程序

1system系統(tǒng)功能模塊，下級名目略

|inc系統(tǒng)通用程序及函數(shù)名目

|ispirit0A精靈頁面

|mobile0A移動界面

|module系統(tǒng)組件

|dept_select部門選擇組件

1|—editor簡易HTML編輯器組件

11—ocOffice文檔在線編輯與閱讀

||-OJNETDISK文檔在線編輯與閱讀-僅適用于網(wǎng)絡(luò)硬盤

|save_file文件轉(zhuǎn)存組件

1|—user_select用戶多項選擇組件

!1userselect_single用戶單項選擇組件

|—portal門戶界面

1—static系統(tǒng)通用程序及靜態(tài)文件名目

1common通用CSS文件及其引用的圖片文件

|images所有代碼中的＜img＞標(biāo)簽src引用的圖片文件

|—templates登錄界面模版

|theme界面主題

|wav微訊提醒聲音

1js界面主題

|—templates登錄界面模版

1modules所有模塊非通用的css文件及其引用的圖片文件等的名目

|address通訊簿非通用css文件及其引用的圖片文件

卜部分模塊名目（略）

1workflow工作流非通用css文件及其引用的圖片文件

注：上表中紅色顏色標(biāo)示的名目是備份數(shù)據(jù)時需要備份的，是0A的所有數(shù)據(jù)所存放的名目。

1.3參數(shù)配置

1.3.1Apache配置(MYOA\conf\d.conf)

Timeout300〃連接超時，單位秒

ServerTokensProd//Apache信息，F(xiàn)ull,OS,Minor,Minimal,Major,Prod

ErrorDocument〃錯誤文檔

ErrorLoglogs/error.log//錯誤日志

CustomLoglogs/access.logcombined〃訪問日志

1.3.2PHP配置(MYOA\bin\php.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ù)量，單位MB

upload_max_filesize=200M//上傳單個附件大小，單位MB

1.3.2MySQL配置(MYOA\mysql5\my.ini)

basedir=D:/MYOA/mysql5///MySQL主程序路徑

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í)行終止后自動斷開時刻

interactive_timeout=30〃運行SQL語句時段開時刻

skip-name-resolve//幸免外部鎖定（默認(rèn)是ON）

bind-address=0.0.0.0//承諾遠(yuǎn)程連接

innodb_file_per_table=1//啟用獨立表空間模式

innodb_file_format=Barracuda//InnoDB數(shù)據(jù)壓縮

注：以上所有的配置選項修改后都需要重啟服務(wù)才會生效。

第二章數(shù)據(jù)庫治理

2.1phpMyAdmin的安裝

MySQL的數(shù)據(jù)庫治理工具專門多，phpMyAdmin是使用PHP編寫的免費MySQL數(shù)據(jù)庫治理

工具。由于0A的MySQL數(shù)據(jù)庫出于安全考慮，被配置為僅能從本機(jī)訪問，因此使用

phpMyAdmin如此的B/S結(jié)構(gòu)的治理工具，可實現(xiàn)數(shù)據(jù)庫的遠(yuǎn)程治理。

第一步、下載程序包

phpMyAdmin程序能夠從其官方網(wǎng)站://phpmyadmin.net下載，建議下載最新的

all-language版本。

第二步、解壓縮

在MYOA\webroot名目下新建一個名目，如mysql369（為了防止他人利用該工具侵入數(shù)

據(jù)庫系統(tǒng)，可把名目名設(shè)為比較復(fù)雜的，如MySQL2345,幸免名目名被推測到。），將下載的

程序包解壓后拷貝至mysql369名目下。

第三步、修改配置文件

用文本編輯器，如記事本，打開MySQL治理工具名目，復(fù)制config.sample.inc.php文件

并改名為confing.inc.php,打開后修改以下配置信息：

$cfg['blowfish_secret']=〃隨便輸入一個字符串，加密Cookie等信息

$cfg[*Servers'][$i][^uth^ype']='，;〃,config,cookie,建議使用

ScfgfServers'][$i]['host']='localhost';〃數(shù)據(jù)庫地址，默認(rèn)為localhost

ScfgfServers'JISiJfporf]=3336;〃數(shù)據(jù)庫端口,默認(rèn)為3336

Scfgt'ServersItSilfuser1]='roof;〃數(shù)據(jù)庫用戶名，默認(rèn)為root

Scfgf'Servers'][$i]['password']=//數(shù)據(jù)庫密碼，默認(rèn)為myoa888

第四步、使用phpMyAdmin

MySQL治理工具地址：:〃0A地址工ysql,注意，進(jìn)入后先選擇中文界面（中文

-Chinesesimplified該治理工具的使用需具有一定數(shù)據(jù)庫基礎(chǔ)，請勿進(jìn)行危險操作，

以免導(dǎo)致數(shù)據(jù)丟失。

2.2phpMyAdmin的使用

phpMyAdmin主界面如下

?-JK婁2S:localhost:3336

后1盤他庫與SQL◎狀毒0用戶&導(dǎo)出齡導(dǎo)入燹諼at黛》圖費。網(wǎng)字后第閡引掌

diffl國目口。

(f?近使用的表)*常規(guī)設(shè)置數(shù)據(jù)庫股務(wù)器

*修改定碼?服務(wù)器：localhostviaTCP/IP

圍服務(wù)25連接排序摳則⑦：utf8_g?n?fai_ci?展外35黑型：MySQL

.?：—i^crscell3?服務(wù)S?版本：5.5.25-enterprise-coimercial-

；.inforaation_sche*a外觀設(shè)苴advanced-log-

?協(xié)議版本：10

?用戶：root?12?.0.0.1

-giperfornance.scheaLi守語言-Language^：中文.Chinesesimplified

2?般務(wù)輯字苻算：UTF-8Unicode(utf8)

J主陋：Originalv]

網(wǎng)站服務(wù)器

?字號：82%*

?Apache

X更多設(shè)氐?數(shù)據(jù)庫客戶磁版本：libnysql-5.0.51a

?PHP獷聯(lián)：aysql?

phplyAdain

?版本信JS：4.0.9《已更軟)

?文檔

?維熱

?官方主頁

?貢獻(xiàn)

?我取支符

?更新列襲phpMyAdmfn

在左側(cè)選擇TD數(shù)據(jù)庫，可查看0A所有的數(shù)據(jù)表，如以下圖

-K>B:localhost:3336序：TD_OA

密結(jié)料nSQL糧索出望的曲導(dǎo)出船導(dǎo)入攵振作G權(quán)限：gfr、事件&發(fā)25

弼

>作

行數(shù)ft?第序姐則大小多

0余

搜

索

插入

嘉

瀏

覽

結(jié)

恂

空

國

□管Vx

address-2InnoDBgbk_chinese_ci64KB-

昌

插

清

結(jié)

搜

索

入

洞

覽

構(gòu)

空

甫?x

addiass.czoupFInnoDB{bk_chinese_ci64KB-

酉

結(jié)

插

皆

樓

索

入

利

覽

構(gòu)

宮

a空x

,□□?364KB-

affair二InnoDBgbk_chinese_ci

潴

結(jié)

播

棚

索

入

溯

覽

府

國

V9空x

□app.loe><2InnoDBgbk_chinese_ci32KB-

結(jié)

索

總?cè)?/p>

覽

楔

若

瀾

構(gòu)

博

><空x

二-

□archive_tablexPInnoDBgbk_chinese_Ci32KB-

結(jié)

索

入

覽

旗

椅

越

洲x

境K

0<VX空

二

「attachaentxFlInnoDBgbk_clunese_ci48n-

結(jié)

索

入

蒲

奧

圖

恂

插

樓

浦

?空

口attachaent.editxInnoDBjbk.chinese.ci16KB-

結(jié)

索

入