1、Office Automation 网络智能办公系统二次开发手册北京极限通科技7月10日序言Office Automation网络智能办公系统(以下简称极限OA),不仅是一套成熟网络办公系统,同时也是一个完整、精巧软件开发平台,不仅集成了Web开发全套环境,并提供了管理架构、系统资源开放性支持,是开发中小型管理应用系统理想平台。本文将从不一样技术层面向您揭示极限OA二次开发细节,是关键针对专职程序设计人员、编程爱好者、软件产品技术支持人员编写OA二次开发入门教程。经过阅读本文,您将不仅能够了解极限OA设计奥秘,也将能够利用本文所介绍知识和技巧,轻松构建属于自己应用系统或模块,文中将结合具体实例
2、加以说明。一、软件开发环境介绍1.1 编程环境极限OA关键采取PHP语言开发,系统使用Mysql数据库。在Windows平台下,极限OA关键注册了2个系统服务,能够经过控制面板-管理工具-服务,查看这2项服务,服务名分别是OA_Service和Mysql,Office_Automation服务实际是集成了PHP模块Apache服务,Apache是极限OA所使用Web Server,极限OA也能够支持IIS作为Web Server,具体配置方法参见网站下载中心相关文档。相关PHP语言使用,可下载PHP汉字手册,作为开发指导;相关Mysql数据库管理和使用,将在第二章进行具体介绍。1.2目录层次结
3、构极限OA目录层次结构清楚,表现出对服务程序、应用程序、WEB页面巧妙整合和组织,便于了解和扩充。下面对目录结构加以说明:D:myoabinApache及PHP系统文件、PHP配置文件、Zend/MMcache加速器、服务配置程序 sapiPHPApache接口程序modulesApache模块webroot极限OAWEB根目录 attachment 极限OA附件目录,其路径可经过webrootincoa_config.php指定 wm外部邮件存放目录 hrms_pic人事档案照片目录 general关键模块目录 通常模块目录(略) ipanel主控面板,集成了菜单、短信箱等应用控制界面 bo
4、okmark收藏夹 shortcut快捷组 menu_define菜单快捷组 win_defineWindows快捷组 smsbox短信箱 mytable桌面 intel_view智能桌面显示程序 myconfig桌面自定义 status_bar状态栏 system系统功效模块,下级目录略 winexe调用Windows外部程序页面 ikernel通用管理程序,支持创建简单MIS系统 images系统图片目录 avatar头像 menu菜单图片 inc系统通用程序及函数目录 dept_list部门列表XML输出 jpgraph统计图组件 user_list用户列表XML输出 ispiritOA
5、精灵页面 module系统组件 dept_select部门选择组件 editor简易HTML编辑器组件 OCOffice文档在线编辑和阅读-适适用于文件柜、工作流等模块 OC_NETDISK文档在线编辑和阅读-仅适适用于网络硬盘 rte复杂HTML编辑器组件 save_file文件转存组件 user_select用户多选组件 user_select_single 用户单选组件 theme界面专题 update系统升级,该文件夹下如存在1.php会被自动实施并删除 wav系统声音,Flash格式tmp缓存目录,存放上传文件和登录Session文件。logsApache日志目录,关键包含了错误日志
6、error.logconfApache配置文件目录dataMysql数据库目录 TD_OA极限OA主数据库 dzbbs超级论坛数据库 mysqlMysql系统数据库mysqlMysql数据库服务程序二、数据库管理和应用2.1 数据库配置极限OA在安装完成后,会自动配置Mysql开启参数,并注册Mysql系统服务。出于特殊需要,用户也能够手动修改Mysql配置参数,方法是使用记事本打开windows目录my.ini,这是Mysql配置文件,其内容通常以下格式:mysqldbasedir=D:MYOAmysqldatadir=D:MYOAdatadefault-character-set=gbks
7、et-variable=max_connections=1000其中,basedir表示mysql服务程序路径、datadir表示数据库文件路径,可依据实际情况进行调整并保留配置文件,重新开启Mysql服务后生效。2.2 数据库管理Mysql数据库管理工具很多,常见有phpMyAdmin等,phpMyAdmin是使用PHP编写无偿Mysql数据库管理工具。因为OAMysql数据库出于安全考虑,被配置为仅能从本机访问,所以使用phpMyAdmin这么B/S结构管理工具,可实现数据库远程管理。可经过网站OA知识库/Office Automation 高级应用技巧/数据库管理工具/mysql网页方法
8、管理工具,找到该程序下载地址。将解压文件,拷贝至 OA目录webrootmysql 目录下。mysql数据库网页管理工具,使用方法 http:/主机名/mysql,注意,进入后先选择汉字界面。 该管理工具使用需含有一定数据库基础,请勿进行危险操作,以免造成数据丢失。另外,为了预防她人利用该工具侵入数据库系统,可把目录名设为比较复杂,如mysql2345,避免目录名被猜测到。phpMyAdmin主界面选择TD_OA数据库,可查看数据表结构和数据为便于说明二次开发过程,我们经过数据库管理工具,新建一个数据表。新数据表STUDENT表示学生数据表,包含3个字段,ID是自增字段,作为主键和唯一标识,N
9、AME表示姓名,SEX表示性别,值为1表示男,为2表示女。插入一条数据,并浏览,显示图数据库管理工具简明介绍到此,对于有SQL关系型数据库基础开发人员,掌握phpMyAdmin这个工具并不难。相关Mysql语法规则参见Mysql手册,连同OA数据库结构说明,均可到上面提到phpMyAdmin下载地址下载。三、使用PHP语言开发OA功效模块规范3.1 PHP代码样例以下是一段样例代码test.php,可放置于webroot目录下实施,可作为开发OA应用程序模版。/或/*/是PHP注释语句。页面标题程序运行结果3.2 数据库连接函数参考以下程序代码read.php,访问我们之前建立STUDENT表
10、程序运行结果从这段程序能够看出,使用OA系统提供系统头文件和函数,访问数据库将是一件很轻松事,不用操心数据库连接参数等问题,只需简单写下SQL语句,实施它。以下这段程序,将删除STUDENT表全部数据。Mysql数据库连接参数在 webrootincoa_config.php文件中配置,可自行修改连接参数。3.3 系统变量OA系统提供了5个经过SESSION保留系统变量,分别是$LOGIN_USER_ID用户ID$LOGIN_USER_PRIV用户角色ID$LOGIN_DEPT_ID用户部门ID$LOGIN_AVATAR用户头像$LOGIN_THEME用户界面专题先建test.php如需使用这
11、些系统变量,程序需要包含auth.php,以下代码:因为实施这个程序前,必需先登录,我们首先定义一项个人网址,方便实施这个需要登录程序。程序实施结果以下一段程序,能够分别取出用户姓名、用户角色名称、在线时间至$USER_NAME、$USER_PRIV和$ONLINE变量。3.4 系统函数3.4.1 常见函数 包含方法:include_once(inc/ utility.php);如已包含auth.php,则无需包含Message($TITLE,$CONTENT) 显示一个提醒框图标题和内容可经过参数指定Button_Back() 显示一个返回按钮,用于访回下一页面find_id($STRING
12、,$ID) 查询用逗号隔开$STRING字符串中,是否包含$ID如 find_id(abc,def,ghq,abc); 返回值是true3.4.2 通常系统函数 包含方法:include_once(inc/ utility_all.php);format_date($STRING1)返回形如 1999年2月1日get_week($STRING1)返回形如 六format_money($STR)返回金额格式,形如19.00compare_date($DATE1,$DATE2)日期比较,DATE1=DATE2 返回0,DATE1DATE2 返回1,DATE1time2 返回1,time1time2
13、 返回-1compare_date_time($DATE_TIME1,$DATE_TIME2)日期+时间比较csubstr(&$str, $start=0, $long=0, $ltor=true, $cn_len=2)汉字字符串截取函数部分汉字字符串截取函数常常有部分问题,比如在部分自动换行程序中$a=“1中2”;经两次截取后,csubstr($str,$a,0,2);csubstr($str, $a, 2,2)因为载取位置指向“中”右字节,可能会是这么结果1, 2用本函数会产生正确结果1中, 2# start 开始位置,从0开始# long = 0 则从start 一直取到字符串尾# lt
14、or = true 时从左到右取字符,false 时到右到左取字符# $cn_len 汉字字符按字节取还是字数取,假如按字数取,则一个汉字当一个字节计算is_ip($IP)检验IP是否正当is_dept_priv($DEPT_ID)查看$DEPT_ID是否属于本人管理范围my_dept_tree($DEPT_ID,$DEPT_CHOOSE,$POST_OP) 多级部门下拉菜单,支持按管理范围列出,格式为,不含标签dept_long_name($DEPT_ID)递归求解完整多级部门名称3.4.3 内部短信函数 包含方法:include_once(inc/utility_sms1.php );se
15、nd_sms($SEND_TIME,$FROM_ID,$TO_ID,$SMS_TYPE,$CONTENT)发送内部短信,参数依次为发送时间,发送人ID,接收人ID,短信类型(0为个人短信),内容。比如:send_sms(-7-4 11:12:13,admin,admin,0, 你好);3.4.4 手机短信函数 包含方法:include_once(inc/utility_sms2.php );send_mobile_sms($SEND_TIME,$FROM_ID,$PHONE,$CONTENT)直接向手机号码发送,参数依次为发送时间,发送人ID,接收人手机号码,内容。比如:send_mobile
16、_sms (-7-4 11:12:13,admin,0, 你好);send_mobile_sms_user($SEND_TIME,$FROM_ID,$TO_ID,$CONTENT,$TYPE)直接向OA用户发送,参数依次为发送时间,发送人ID,接收人ID,内容,类型(0为个人短信)。比如:send_mobile_sms_user (-7-4 11:12:13,admin,admin,你好,0);3.5 系统组件3.5.1 日期组件日期组件程序是webrootinccalendar.php,调用方法是在前台页面使用javascript,举例以下:function td_calendar(fiel
17、dname) myleft=document.body.scrollLeft+event.clientX-event.offsetX-80; mytop=document.body.scrollTop+event.clientY-event.offsetY+140; window.showModalDialog(/inc/calendar.php?FIELDNAME=+fieldname,self,edge:raised;scroll:0;status:0;help:0;resizable:1;dialogWidth:280px;dialogHeight:205px;dialogTop:+my
18、top+px;dialogLeft:+myleft+px);3.5.2 人员多选组件人员多选组件程序是webrootmoduleuser_select,调用方法是在前台页面使用javascript,举例以下:function LoadWindow() URL=/module/user_select; loc_x=document.body.scrollLeft+event.clientX-event.offsetX-100; loc_y=document.body.scrollTop+event.clientY-event.offsetY+170; window.showModalDialog
19、(URL,self,edge:raised;scroll:0;status:0;help:0;resizable:1;dialogWidth:320px;dialogHeight:265px;dialogTop:+loc_y+px;dialogLeft:+loc_x+px); 3.5.2 部门多选组件部门多选组件程序是webrootmoduledept_select,调用方法是在前台页面使用javascript,举例以下:function LoadWindow() URL=/module/dept_select; loc_x=document.body.scrollLeft+even
20、t.clientX-event.offsetX-100; loc_y=document.body.scrollTop+event.clientY-event.offsetY+170; window.showModalDialog(URL,self,edge:raised;scroll:1;status:0;help:0;resizable:1;dialogWidth:400px;dialogHeight:245px;dialogTop:+loc_y+px;dialogLeft:+loc_x+px); 3.5.2 部门单选组件部门单选组件使用举例以下,三个参数含义分别为上级部门ID,选
21、中部门ID,是否按管理范围显示:四、公布二次开发功效模块4.1准备模块目录比如,在webrootgeneral下提议一个目录student,作为自己开发模块目录,将程序放置于该目录下,默认页面是index.php或index.html或index.htm4.2 定制菜单图,按界面上说明要求定义好菜单将一个gif图片student.gif拷贝至webrootimagesmenu下在角色权限设置中,分好该模块权限。测试公布二次开发模块为便于用户开发自己模块,极限科技在用户服务区提供了Office Automation部份模块源码下载,供开发人员参考。五、JAVA应用程序扩展规范经过安装极限MYJAVA应用服务器软件,能够使得极限OA支持Java应用程序,Java程序文件根目录是webrootapp,可经过Session变量LOGIN_USER_ID获取用户登录OA系统ID。极限进销存软件内置了MYJAVA应用服务器,Java代码规范可参考极限进销存软件。
©2010-2024 宁波自信网络信息技术有限公司 版权所有
客服电话:4008-655-100 投诉/维权电话:4009-655-100