人网OA二次开发手册_第1页
人网OA二次开发手册_第2页
人网OA二次开发手册_第3页
人网OA二次开发手册_第4页
人网OA二次开发手册_第5页
已阅读5页，还剩12页未读， 继续免费阅读

下载本文档

版权说明：本文档由用户提供并上传，收益归属内容提供方，若内容存在侵权，请进行举报或认领

文档简介

1、Office Automation 网络智能办公系统二次开发手册北京创人网科技有限公司2005年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数据库的

3、管理与使用，将在第二章进行详细介绍。1.2目录层次结构人网OA的目录层次结构清晰，体现出对服务程序、应用程序、WEB页面的巧妙整合与组织，便于理解和扩充。下面对目录结构加以说明：D:myoabinApache及PHP系统文件、PHP配置文件、Zend/MMcache加速器、服务配置程序 sapiPHP的Apache接口程序modulesApache的模块webroot人网OA的WEB根目录 attachment 人网OA的附件目录，其路径可通过webrootincoa_config.php指定 wm外部邮件存储目录 hrms_pic人事档案照片目录 general主要模块目录 一般模块目录（略

4、） ipanel主控面板，集成了菜单、短信箱等应用控制界面 bookmark收藏夹 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

5、统计图组件 user_list用户列表XML输出 ispiritOA精灵页面 module系统组件 dept_select部门选择组件 editor简易HTML编辑器组件 OCOffice文档在线编辑与阅读-适用于文件柜、工作流等模块 OC_NETDISK文档在线编辑与阅读-仅适用于网络硬盘 rte复杂HTML编辑器组件 save_file文件转存组件 user_select用户多选组件 user_select_single 用户单选组件 theme界面主题 update系统升级，该文件夹下如存在1.php会被自动执行并删除 wav系统声音，Flash格式tmp缓存目录，存储上传文件和登录Se

6、ssion文件。logsApache日志目录，主要包含了错误日志error.logconfApache配置文件目录dataMysql数据库目录 TD_OA人网OA主数据库 dzbbs超级论坛数据库 mysqlMysql系统数据库mysqlMysql数据库服务程序二、数据库管理与应用2.1 数据库的配置人网OA在安装完毕后，会自动配置Mysql启动参数，并注册Mysql系统服务。出于特殊需要，用户也可以手动修改Mysql的配置参数，方法是使用记事本打开windows目录my.ini，这是Mysql的配置文件，其内容一般如下格式：mysqldbasedir=D:MYOAmysqldatadir=D

7、:MYOAdatadefault-character-set=gbkset-variable=max_connections=1000其中，basedir表示mysql服务程序路径、datadir表示数据库文件路径，可根据实际情况进行调整并保存配置文件，重新启动Mysql服务后生效。2.2 数据库的管理Mysql的数据库管理工具很多，常见的有phpMyAdmin等，phpMyAdmin是使用PHP编写的免费Mysql数据库管理工具。由于OA的Mysql数据库出于安全考虑，被配置为仅能从本机访问，所以使用phpMyAdmin这样的B/S结构的管理工具，可实现数据库的远程管理。可通过网站下载中心&

8、gt;左侧->相关软件,下载数据库管理工具，mysql网页方式管理工具。将解压的文件，拷贝至 OA目录webroot 目录下。mysql数据库的网页管理工具，使用方法 http:/主机名/加目录名，注意，进入后先选择中文界面。 该管理工具的使用需具有一定数据库基础，请勿进行危险操作，以免导致数据丢失。另外，为了防止他人利用该工具侵入数据库系统，可把目录名设为比较复杂的，如mysql2345，避免目录名被猜测到。phpMyAdmin主界面选择TD_OA数据库，可查看数据表结构和数据为便于说明二次开发的过程，我们通过数据库管理工具，新建一个数据表。新数据表STUDENT表示学生数据表，包含3

9、个字段，ID是自增字段，作为主键和唯一标识，NAME表示姓名，SEX表示性别，值为1表示男，为2表示女。插入一条数据，并浏览，显示如图数据库管理工具简要介绍到此，对于有SQL关系型数据库基础的开发人员，掌握phpMyAdmin这个工具并不难。关于Mysql的语法规则参见Mysql手册，连同OA数据库结构说明，均可到上面提到的phpMyAdmin下载地址下载。三、使用PHP语言开发OA功能模块的规范3.1 PHP代码样例以下是一段样例代码test.php，可放置于webroot目录下执行，可作为开发OA应用程序的模版。/或/*/是PHP的注释语句。<?/include_once("

10、;inc/auth.php"); / 如需登录验证则包含，未登录将退出/include_once("inc/conn.php"); / 如需要连接数据库则包含/include_once("inc/utility_all.php"); / 如需要使用公用函数则包含/include_once("inc/check_type.php"); / 如需要使用类型检验函数则包含/如已包含auth.php，则无须包含conn.php?><html><head><title>页面标题</tit

11、le><meta http-equiv="Content-Type" content="text/html; charset=gb2312"></head><body class="bodycolor"><?echo "hello OA"?></body></html>程序运行结果3.2 数据库连接函数参考以下程序代码read.php，访问我们之前建立的STUDENT表<?include_once("inc/conn.ph

12、p");$query = "SELECT * from STUDENT"$cursor= exequery($connection,$query); /*exequery 是OA系统inc/conn.php包装的SQL语句执行函数，$connection是数据库的连接标识符*/if($ROW=mysql_fetch_array($cursor)$NAME=$ROW"NAME"echo $NAME;?>程序运行结果从这段程序可以看出，使用OA系统提供的系统头文件和函数，访问数据库将是一件很轻松的事，不用操心数据库的连接参数等问题，只需简单的

13、写下SQL语句，执行它。以下这段程序，将删除STUDENT表的所有数据。<?include_once("inc/conn.php");$query = "delete from STUDENT"exequery($connection,$query); ?>Mysql数据库的连接参数在 webrootincoa_config.php文件中配置，可自行修改连接参数。3.3 系统变量OA系统提供了5个通过SESSION保存的系统变量，分别是$LOGIN_USER_ID用户ID$LOGIN_USER_PRIV用户角色ID$LOGIN_DEPT_ID

14、用户部门ID$LOGIN_AVATAR用户头像$LOGIN_THEME用户界面主题先建test.php如需使用这些系统变量，程序需要包含auth.php，如下代码：<?include_once("inc/auth.php");echo "我的登录用户ID是".$LOGIN_USER_ID; /本句中的.表示字符串连接?>因为执行这个程序前，必须先登录，我们首先定义一项个人网址，以便执行这个需要登录的程序。以下一段程序，可以分别取出用户姓名、用户角色名称、在线时间至$USER_NAME、$USER_PRIV和$ONLINE变量。<?inc

15、lude_once("inc/auth.php");$query = "SELECT * from USER where USER_ID='$LOGIN_USER_ID'" $cursor= exequery($connection,$query); if($ROW=mysql_fetch_array($cursor) $USER_NAME=$ROW"USER_NAME" $USER_PRIV=$ROW"USER_PRIV" $ONLINE=$ROW"ONLINE" $query

16、1 = "SELECT * from USER_PRIV where USER_PRIV='$USER_PRIV'" $cursor1= exequery($connection,$query1); if($ROW=mysql_fetch_array($cursor1) $USER_PRIV=$ROW"PRIV_NAME" ?>3.4 系统函数3.4.1 常用函数 包含方法：include_once("inc/ utility.php");如已包含auth.php，则无需包含Message($TITLE,$CON

17、TENT) 显示一个提示框如图标题和内容可通过参数指定Button_Back() 显示一个返回按钮，用于访回下一页面find_id($STRING,$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_mon

18、ey($STR)返回金额格式，形如19.00compare_date($DATE1,$DATE2)日期比较，DATE1=DATE2 返回0,DATE1>DATE2 返回1,DATE1<DATE2 返回-1compare_time($TIME1,$TIME2)时间比较，time1=time2 返回0,time1>time2 返回1,time1<time2 返回-1compare_date_time($DATE_TIME1,$DATE_TIME2)日期+时间比较csubstr(&$str, $start=0, $long=0, $ltor=true, $cn_len

19、=2)中文字符串截取函数一些中文字符串截取函数经常有一些问题，例如在一些自动换行程序中$a=“1中2”；经两次截取后，csubstr($str,$a,0,2);csubstr($str, $a, 2,2)由于载取位置指向“中”的右字节，可能会是这样的结果1, 2用本函数会产生正确的结果1中, 2# start 开始位置，从0开始# long = 0 则从start 一直取到字符串尾# ltor = true 时从左到右取字符，false 时到右到左取字符# $cn_len 中文字符按字节取还是字数取，如果按字数取，则一个中文当一个字节计算is_ip($IP)检查IP是否合法is_dept_pr

20、iv($DEPT_ID)查看$DEPT_ID是否属于本人管理范围my_dept_tree($DEPT_ID,$DEPT_CHOOSE,$POST_OP) 多级部门下拉菜单，支持按管理范围列出，格式为<option value=>，不含<select>标签dept_long_name($DEPT_ID)递归求解完整的多级部门名称3.4.3 内部短信函数 包含方法：include_once("inc/utility_sms1.php ");send_sms($SEND_TIME,$FROM_ID,$TO_ID,$SMS_TYPE,$CONTENT)发送内

21、部短信，参数依次为发送时间，发送人ID，接收人ID，短信类型（0为个人短信），内容。例如：send_sms("2005-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，接收人手机号码，内容。例如：sen

22、d_mobile_sms ("2005-7-4 11:12:13","admin","quot;,0, "你好");send_mobile_sms_user($SEND_TIME,$FROM_ID,$TO_ID,$CONTENT,$TYPE)直接向OA用户发送，参数依次为发送时间，发送人ID，接收人ID，内容，类型（0为个人短信）。例如：send_mobile_sms_user ("2005-7-4 11:12:13","admin","admin&q

23、uot;,"你好",0);3.5 系统组件3.5.1 日期组件日期组件的程序是webrootinccalendar.php，调用方法是在前台页面使用javascript，举例如下：<script>function td_calendar(fieldname) myleft=document.body.scrollLeft+event.clientX-event.offsetX-80; mytop=document.body.scrollTop+event.clientY-event.offsetY+140; window.showModalDialog(&quo

24、t;/inc/calendar.php?FIELDNAME="+fieldname,self,"edge:raised;scroll:0;status:0;help:0;resizable:1;dialogWidth:280px;dialogHeight:205px;dialogTop:"+mytop+"px;dialogLeft:"+myleft+"px");</script><input type="text" name="BEGIN_DATE" size=&qu

25、ot;10" maxlength="10"><img src="/images/menu/calendar.gif" border="0" style="cursor:hand" onclick="td_calendar('BEGIN_DATE');">3.5.2 人员多选组件人员多选组件的程序是webrootmoduleuser_select，调用方法是在前台页面使用javascript，举例如下：<script>function Loa

26、dWindow() 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(URL,self,"edge:raised;scroll:0;status:0;help:0;resizable:1;dialogWidth:320px;dialogHeight:265px;dia

27、logTop:"+loc_y+"px;dialogLeft:"+loc_x+"px");</script><input type="hidden" name="TO_ID"><textarea cols=45 name="TO_NAME" rows="3" class="BigStatic" wrap="yes" readonly></textarea><input typ

28、e="button" value="添 加" class="SmallButton" onClick="LoadWindow()" title="添加收件人" name="button">&nbsp;<input type="button" value="清 空" class="SmallButton" onClick="clear_user()" title="清空

29、收件人" name="button">3.5.2 部门多选组件部门多选组件的程序是webrootmoduledept_select，调用方法是在前台页面使用javascript，举例如下：<script>function LoadWindow() URL="/module/dept_select" loc_x=document.body.scrollLeft+event.clientX-event.offsetX-100; loc_y=document.body.scrollTop+event.clientY-event.of

30、fsetY+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");</script><input type="hidden" name="TO_ID"><textarea cols=40 name=TO_NAME

人人文库> 全部分类> 行业资料 > 管理策划

温馨提示

  • 1. 本站所有资源如无特殊说明，都需要本地电脑安装OFFICE2007和PDF阅读器。图纸软件为CAD,CAXA,PROE,UG,SolidWorks等.压缩文件请下载最新的WinRAR软件解压。
  • 2. 本站的文档不包含任何第三方提供的附件图纸等，如果需要附件，请联系上传者。文件的所有权益归上传用户所有。
  • 3. 本站RAR压缩包中若带图纸，网页内容里面会有图纸预览，若没有图纸预览就没有图纸。
  • 4. 未经权益所有人同意不得将文件中的内容挪作商业或盈利用途。
  • 5. 人人文库网仅提供信息存储空间，仅对用户上传内容的表现方式做保护处理，对用户上传分享的文档内容本身不做任何修改或编辑，并不能对任何下载内容负责。
  • 6. 下载文件中如有侵权或不适当内容，请与我们联系，我们立即纠正。
  • 7. 本站不保证下载资源的准确性、安全性和完整性, 同时也不承担用户因使用这些下载资源对自己和他人造成任何形式的伤害或损失。

最新文档

评论

0/150

提交评论