人网oa二次开发手册.doc

Office Automation 网络智能办公系统二次开发手册北京创人网科技有限公司2005 年 7 月 10 日Office Automation 二次开发手册 北京创人网科技有限公司2前言Office Automation 网络智能办公系统（以下简称人网 OA） ，不仅是一套成熟的网络办公系统，同时也是一个完整、精巧的软件开发平台，不仅集成了Web 开发的全套环境，并提供了管理架构、系统资源的开放性支持，是开发中小型管理应用系统的理想平台本文将从不同的技术层面向您揭示人网 OA 的二次开发细节，是主要针对专职程序设计人员、编程爱好者、软件产品技术支持人员编写的 OA 二次开发入门教程通过阅读本文，您将不仅可以了解人网 OA 的设计奥秘，也将能够运用本文所介绍的知识和技巧，轻松构建属于自己的应用系统或模块，文中将结合具体实例加以说明Office Automation 二次开发手册 北京创人网科技有限公司3一、软件开发环境简介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 目录层次结构人网 OA 的目录层次结构清晰，体现出对服务程序、应用程序、WEB 页面的巧妙整合与组织，便于理解和扩充下面对目录结构加以说明：D:\myoa├─bin Apache 及 PHP 系统文件、PHP 配置文件、Zend/MMcache 加速器、服务配置程序│ └─sapi PHP 的 Apache 接口程序├─modules Apache 的模块├─webroot 人网 OA 的 WEB 根目录│ ├─attachment 人网 OA 的附件目录，其路径可通过 webroot\inc\oa_config.php 指定│ │ ├─wm 外部邮件存储目录│ │ └─hrms_pic 人事档案照片目录│ ├─general 主要模块目录│ │ ├─ …… 一般模块目录（略）│ │ ├─ipanel 主控面板，集成了菜单、短信箱等应用控制界面│ │ │ ├─bookmark 收藏夹│ │ │ ├─shortcut 快捷组│ │ │ │ ├─menu_define 菜单快捷组│ │ │ │ └─win_define Windows 快捷组│ │ │ └─smsbox 短信箱│ │ ├─mytable 桌面│ │ │ ├─intel_view 智能桌面显示程序│ │ │ └─myconfig 桌面自定义│ │ ├─status_bar 状态栏│ │ ├─system 系统功能模块，下级目录略│ │ └─winexe 调用 Windows 外部程序的页面│ ├─ikernel 通用管理程序，支持创建简单的 MIS 系统│ ├─images 系统图片目录│ │ ├─avatar 头像│ │ └─menu 菜单图片│ ├─inc 系统通用程序及函数目录│ │ ├─dept_list 部门列表 XML 输出Office Automation 二次开发手册 北京创人网科技有限公司4│ │ ├─jpgraph 统计图组件│ │ └─user_list 用户列表 XML 输出│ ├─ispirit OA 精灵页面│ ├─module 系统组件│ │ ├─dept_select 部门选择组件│ │ ├─editor 简易 HTML 编辑器组件│ │ ├─OC Office 文档编辑与阅读-适用于文件柜、工作流等模块│ │ ├─OC_NETDISK 文档编辑与阅读-仅适用于网络硬盘│ │ ├─rte 复杂 HTML 编辑器组件│ │ ├─save_file 文件转存组件│ │ ├─user_select 用户多选组件│ │ └─user_select_single 用户单选组件│ ├─theme 界面主题│ ├─update 系统升级，该文件夹下如存在 1.php 会被自动执行并删除│ └─wav 系统声音，Flash 格式├─tmp 缓存目录，存储上传文件和登录 Session 文件。

├─logs Apache 日志目录，主要包含了错误日志 error.log├─conf Apache 配置文件目录├─data Mysql 数据库目录│ ├─TD_OA 人网 OA 主数据库│ ├─dzbbs 超级论坛数据库│ └─mysql Mysql 系统数据库└─mysql Mysql 数据库服务程序Office Automation 二次开发手册 北京创人网科技有限公司5二、数据库管理与应用2.1 数据库的配置人网 OA 在安装完毕后，会自动配置 Mysql 启动参数，并注册 Mysql 系统服务出于特殊需要，用户也可以手动修改 Mysql 的配置参数，方法是使用记事本打开 windows 目录\my.ini，这是 Mysql 的配置文件，其内容一般如下格式：[mysqld]basedir=D:\MYOA\mysql\datadir=D:\MYOA\data\default-character-set=gbkset-variable=max_connections=1000其中，basedir 表示 mysql 服务程序路径、datadir 表示数据库文件路径，可根据实际情况进行调整并保存配置文件，重新启动 Mysql 服务后生效。

2.2 数据库的管理Mysql 的数据库管理工具很多，常见的有 phpMyAdmin 等，phpMyAdmin 是使用 PHP 编写的免费 Mysql 数据库管理工具由于 OA 的 Mysql 数据库出于安全考虑，被配置为仅能从本机访问，所以使用 phpMyAdmin 这样的 B/S 结构的管理工具，可实现数据库的远程管理可通过网站 下载中心—>左侧->相关软件,下载数据库管理工具，mysql 网页方式管理工具将解压的文件，拷贝至 OA 目录\webroot 目录下mysql 数据库的网页管理工具，使用方法 http://主机名/加目录名，注意，进入后先选择中文界面 该管理工具的使用需具有一定数据库基础，请勿进行危险操作，以免导致数据丢失另外，为了防止他人利用该工具侵入数据库系统，可把目录名设为比较复杂的，如 mysql2345，避免目录名被猜测到phpMyAdmin 主界面Office Automation 二次开发手册 北京创人网科技有限公司6选择 TD_OA 数据库，可查看数据表结构和数据为便于说明二次开发的过程，我们通过数据库管理工具，新建一个数据表。

新数据表 STUDENT 表示学生数据表，包含 3 个字段，ID 是自增字段，作为主键Office Automation 二次开发手册 北京创人网科技有限公司7和唯一标识，NAME 表示姓名，SEX 表示性别，值为 1 表示男，为 2 表示女插入一条数据，并浏览，显示如图数据库管理工具简要介绍到此，对于有 SQL 关系型数据库基础的开发人员，掌握 phpMyAdmin 这个工具并不难关于 Mysql 的语法规则参见 Mysql 手册，连同 OA 数据库结构说明，均可到上面提到的 phpMyAdmin 下载地址下载Office Automation 二次开发手册 北京创人网科技有限公司8三、使用 PHP 语言开发 OA 功能模块的规范3.1 PHP 代码样例以下是一段样例代码 test.php，可放置于 webroot 目录下执行，可作为开发 OA应用程序的模版//或/*…*/是 PHP 的注释语句页面标题程序运行结果3.2 数据库连接函数Office Automation 二次开发手册 北京创人网科技有限公司9参考以下程序代码 read.php，访问我们之前建立的 STUDENT 表程序运行结果从这段程序可以看出，使用 OA 系统提供的系统头文件和函数，访问数据库将是一件很轻松的事，不用操心数据库的连接参数等问题，只需简单的写下SQL 语句，执行它。

以下这段程序，将删除 STUDENT 表的所有数据Mysql 数据库的连接参数在 webroot\inc\oa_config.php 文件中配置，可自行修改连接参数3.3 系统变量Office Automation 二次开发手册 北京创人网科技有限公司10OA 系统提供了 5 个通过 SESSION 保存的系统变量，分别是$LOGIN_USER_ID 用户 ID$LOGIN_USER_PRIV 用户角色 ID$LOGIN_DEPT_ID 用户部门 ID$LOGIN_AVATAR 用户头像$LOGIN_THEME 用户界面主题先建 test.php 如需使用这些系统变量，程序需要包含 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,$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,DATE1>DATE2 返回 1,DATE1time2 返回 1,time1，不含标签dept。