Office Anywhere网络智能办公系统二次开发手册

OA二次开发手册

OfficeAnywhere网络智能办公系统

二次开发手册

V7.5.131120（2021增强版）

通达信科

中国兵器工业信息中心

://tongda2000

目录

目录1

前言1

第一章软件开发环境简介2

1.1编程环境2

1.3参数酉己置4

1.3.1Apache酉已置4

1.3.2PHP配置4

1.3.2MySQL配置4

第二章数据库治理5

2.1phpMyAdmin的安装5

2.2phpMyAdmin的使用5

第三章如何创建一个模块8

3.1建立模块名目8

3.2创建菜单8

3.3分配菜单权限9

3.4编码和测试9

3.4.1系统变量9

3.4.2PHP代码样例10

3.4.3连接数据库代码11

第四章内置函数参考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网络智能办公系统（以下简称通达0A）,不仅是一套成熟的网络办公

系统，同时也是一个完整、精巧的软件开发平台，不仅集成了Web开发的全套环境，并提供

了治理架构、系统资源的开放性支持，是开发中小型治理应用系统的理想平台。

本文将从不同的技术层面向您揭示通达0A的二次开发细节，是要紧针对专职程序设计

人员、编程爱好者、软件产品技术支持人员编写的0A二次开发入门教程.

通过阅读本文，您将不仅能够了解通达0A的设计隐秘，也将能够运用本文所介绍的知

识和技巧，轻松构建属于自己的应用系统或模块，文中将结合具体实例加以说明。

第一章软件开发环境简介

1.1编程环境

通达0A要紧采纳PHP语言开发，系统使用MySQL数据库。

在Windows平台下，通达0A要紧注册了9个系统服务，能够通过操纵面板-〉治理工具

-）服务，查看这9项服务，服务名分别是Office_Anywhere、MySQL5_OA、memcachedServer、

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

Office_Anywhere服务实际是集成了PHP模块的Apache服务，Apache是通达OA所使用的

WebServer,通达OA也能够支持IIS作为WebServer,具体配置方法参见通达网站0A知

识库相关文档。

关于PHP语言的使用，可参阅：〃php.net,下载PHP手册，作为开发指导；关

于MySQL数据库的治理与使用，将在第二章进行详细介绍。

1.2名目层次结构

通达0A的名目层次结构清晰，表达出对服务程序、应用程序、WEB页面的巧妙整合与

组织，便于明白得和扩充，下面对名目结构加以说明：

MYOA

|attachOA附件文件存放名目

|binApache、PHP、Zend等主程序及配置文件，服务配置程序等

|confApache配置文件

|data5MySQL数据库文件名目

||—BUS公交线路查询数据库

||-TD_OA通达0A主数据库

II-MySQLMySQL系统数据库

||-TD_OA_ARCHIVE通达0A归档数据库

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

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

|1ibdatalInnoDB引擎储备数据与索引的数据文件

1logsApache等日志文件名目

|modulesApache的模块文件

|MyAdmin通达0A的MySQL治理工具

|mysql5MySQL主程序文件

|nginx高性能的通达NginxWeb应用服务

■tmp临时文件名目

■webroot通达0A的WEB根名目（PHP程序名目）

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

|hrmspic人事档案照片名目

|product_pic销售治理产品照片存放名目

|new_sms新短消息提醒状态文件

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

1|—rss今日资讯信息缓存文件

|update系统升级，该文件夹下如存在1.php会被自动执行并删除

|weather天气预报缓存文件

1wm外部邮件储备名目

|—general要紧模块名目

11一样模块名目（略）

i|ipanel主控面板，集成了菜单、短信箱等应用操纵界面

I|mytable桌面模块程序

1system系统功能模块，下级名目略

|inc系统通用程序及函数名目

|ispirit0A精灵页面

|mobile0A移动界面

|module系统组件

|dept_select部门选择组件

1|—editor简易HTML编辑器组件

11—ocOffice文档在线编辑与阅读

||-OJNETDISK文档在线编辑与阅读-仅适用于网络硬盘

|save_file文件转存组件

1|—user_select用户多项选择组件

!1userselect_single用户单项选择组件

|—portal门户界面

1—static系统通用程序及静态文件名目

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

|images所有代码中的＜img＞标签src引用的图片文件

|—templates登录界面模版

|theme界面主题

|wav微讯提醒声音

1js界面主题

|—templates登录界面模版

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

|address通讯簿非通用css文件及其引用的图片文件

卜部分模块名目（略）

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

注：上表中红色颜色标示的名目是备份数据时需要备份的，是0A的所有数据所存放的名目。

1.3参数配置

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

Timeout300〃连接超时，单位秒

ServerTokensProd//Apache信息，Full,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〃程序最大执行时刻，单位秒

memory_limit=256M〃单个程序占用内存上限

post_max_size=1000M〃表单提交最大数据量，单位MB

upload_max_filesize=200M//上传单个附件大小，单位MB

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

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

datadir=D:/MYOA/data5///MySQL数据库路径

tmpdir=D:/MYOA/tmp/〃缓存路径

character-set-server=gbk//MySQL数据库字编码

port=3336//端口

wait_timeout=30//SQL语句执行终止后自动断开时刻

interactive_timeout=30〃运行SQL语句时段开时刻

skip-name-resolve//幸免外部锁定（默认是ON）

bind-address=0.0.0.0//承诺远程连接

innodb_file_per_table=1//启用独立表空间模式

innodb_file_format=Barracuda//InnoDB数据压缩

注：以上所有的配置选项修改后都需要重启服务才会生效。

第二章数据库治理

2.1phpMyAdmin的安装

MySQL的数据库治理工具专门多，phpMyAdmin是使用PHP编写的免费MySQL数据库治理

工具。由于0A的MySQL数据库出于安全考虑，被配置为仅能从本机访问，因此使用

phpMyAdmin如此的B/S结构的治理工具，可实现数据库的远程治理。

第一步、下载程序包

phpMyAdmin程序能够从其官方网站://phpmyadmin.net下载，建议下载最新的

all-language版本。

第二步、解压缩

在MYOA\webroot名目下新建一个名目，如mysql369（为了防止他人利用该工具侵入数

据库系统，可把名目名设为比较复杂的，如MySQL2345,幸免名目名被推测到。），将下载的

程序包解压后拷贝至mysql369名目下。

第三步、修改配置文件

用文本编辑器，如记事本，打开MySQL治理工具名目，复制config.sample.inc.php文件

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

$cfg['blowfish_secret']=〃随便输入一个字符串，加密Cookie等信息

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

ScfgfServers'][$i]['host']='localhost';〃数据库地址，默认为localhost

ScfgfServers'JISiJfporf]=3336;〃数据库端口,默认为3336

Scfgt'ServersItSilfuser1]='roof;〃数据库用户名，默认为root

Scfgf'Servers'][$i]['password']=//数据库密码，默认为myoa888

第四步、使用phpMyAdmin

MySQL治理工具地址：:〃0A地址工ysql,注意，进入后先选择中文界面（中文

-Chinesesimplified该治理工具的使用需具有一定数据库基础，请勿进行危险操作，

以免导致数据丢失。

2.2phpMyAdmin的使用

phpMyAdmin主界面如下

«-JK娄2S:localhost:3336

后1盘他库与SQL◎状毒0用户&导出龄导入燹谖at黛》图费。网字后第阂引掌

diffl国目口。

(f»近使用的表)*常规设置数据库股务器

*修改定码•服务器：localhostviaTCP/IP

围服务25连接排序抠则⑦：utf8_g©n«fai_ci•展外35黑型：MySQL

.•：—i^crscell3•服务S?版本：5.5.25-enterprise-coimercial-

；.inforaation_sche*a外观设苴advanced-log-

・协议版本：10

•用户：root«12?.0.0.1

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

2・般务辑字苻算：UTF-8Unicode(utf8)

J主陋：Originalv]

网站服务器

•字号：82%*

♦Apache

X更多设氐・数据库客户磁版本：libnysql-5.0.51a

•PHP犷联：aysql®

phplyAdain

・版本信JS：4.0.9《已更软)

・文档

・维热

・官方主页

・贡献

・我取支符

・更新列袭phpMyAdmfn

在左侧选择TD数据库，可查看0A所有的数据表，如以下图

-K>B:localhost:3336序：TD_OA

密结料nSQL粮索出望的曲导出船导入攵振作G权限：gfr、事件&发25

弼

>作

行数ft®第序姐则大小多

0余

搜

索

插入

嘉

浏

览

结

恂

空

国

□管Vx

address-2InnoDBgbk_chinese_ci64KB-

昌

插

清

结

搜

索

入

洞

览

构

空

甫«x

addiass.czoupFInnoDB{bk_chinese_ci64KB-

酉

结

插

皆

楼

索

入

利

览

构

宫

a空x

,□□〜364KB-

affair二InnoDBgbk_chinese_ci

潴

结

播

棚

索

入

溯

览

府

国

V9空x

□app.loe><2InnoDBgbk_chinese_ci32KB-

结

索

总入

览

楔

若

澜

构

博

><空x

二-

□archive_tablexPInnoDBgbk_chinese_Ci32KB-

结

索

入

览

旗

椅

越

洲x

境K

0<VX空

二

「attachaentxFlInnoDBgbk_clunese_ci48n-

结

索

入

蒲

奥

图

恂

插

楼

浦

?空

口attachaent.editxInnoDBjbk.chinese.ci16KB-

结

索

入