OA二次开发手册

1、 可修改 欢迎下载 精品 Word 可修改 欢迎下载 精品 Word 可修改 欢迎下载 精品 Word Office Anywhere 网络智能办公系统二次开发手册V7.5.1311202021增强版通达信科中国兵器工业信息中心 HYPERLINK :/ tongda2000 :/ tongda2000 目 录 TOC o 1-3 h z u HYPERLINK l _Toc372808303 目 录 PAGEREF _Toc372808303 h 1 HYPERLINK l _Toc372808304 前 言 PAGEREF _Toc372808304 h 1 HYPERLINK l _To

2、c372808305 第一章 软件开发环境简介 PAGEREF _Toc372808305 h 2 HYPERLINK l _Toc372808306 1.1 编程环境 PAGEREF _Toc372808306 h 2 HYPERLINK l _Toc372808307 参数配置 PAGEREF _Toc372808307 h 3 HYPERLINK l _Toc372808308 1.3.1 Apache配置 PAGEREF _Toc372808308 h 3 HYPERLINK l _Toc372808309 1.3.2 PHP配置 PAGEREF _Toc372808309 h 4 H

3、YPERLINK l _Toc372808310 1.3.2 MySQL配置 PAGEREF _Toc372808310 h 4 HYPERLINK l _Toc372808311 第二章 数据库管理 PAGEREF _Toc372808311 h 5 HYPERLINK l _Toc372808312 2.1 phpMyAdmin的安装 PAGEREF _Toc372808312 h 5 HYPERLINK l _Toc372808313 2.2 phpMyAdmin的使用 PAGEREF _Toc372808313 h 5 HYPERLINK l _Toc372808314 第三章 如何创

4、立一个模块 PAGEREF _Toc372808314 h 8 HYPERLINK l _Toc372808315 建立模块目录 PAGEREF _Toc372808315 h 8 HYPERLINK l _Toc372808316 3.2 创立菜单 PAGEREF _Toc372808316 h 8 HYPERLINK l _Toc372808317 3.3 分配菜单权限 PAGEREF _Toc372808317 h 9 HYPERLINK l _Toc372808318 3.4 编码和测试 PAGEREF _Toc372808318 h 9 HYPERLINK l _Toc3728083

5、19 3.4.1 系统变量 PAGEREF _Toc372808319 h 9 HYPERLINK l _Toc372808320 3.4.2 PHP代码样例 PAGEREF _Toc372808320 h 10 HYPERLINK l _Toc372808321 3.4.3 连接数据库代码 PAGEREF _Toc372808321 h 10 HYPERLINK l _Toc372808322 第四章 内置函数参考 PAGEREF _Toc372808322 h 12 HYPERLINK l _Toc372808323 4.1 util PAGEREF _Toc372808323 h 12

6、HYPERLINK l _Toc372808324 4.1.1 Message PAGEREF _Toc372808324 h 12 HYPERLINK l _Toc372808325 4.1.2 Button_Back PAGEREF _Toc372808325 h 12 HYPERLINK l _Toc372808326 4.1.3 find_id PAGEREF _Toc372808326 h 13 HYPERLINK l _Toc372808327 4.1.4 get_client_ip PAGEREF _Toc372808327 h 13 HYPERLINK l _Toc372808

7、328 PAGEREF _Toc372808328 h 13 HYPERLINK l _Toc372808329 4.2.1 csubstr PAGEREF _Toc372808329 h 13 HYPERLINK l _Toc372808330 4.2.2 is_ip PAGEREF _Toc372808330 h 14 HYPERLINK l _Toc372808331 4.2.3 add_log PAGEREF _Toc372808331 h 14 HYPERLINK l _Toc372808332 4.2.4 get_code_name PAGEREF _Toc372808332 h

8、15 HYPERLINK l _Toc372808333 4.2.5 dept_long_name PAGEREF _Toc372808333 h 15 HYPERLINK l _Toc372808334 4.2.6 get_sys_para PAGEREF _Toc372808334 h 15 HYPERLINK l _Toc372808335 4.2.7 set_sys_para PAGEREF _Toc372808335 h 16 HYPERLINK l _Toc372808336 PAGEREF _Toc372808336 h 16 HYPERLINK l _Toc372808337

9、4.3.1 is_dept_parent PAGEREF _Toc372808337 h 16 HYPERLINK l _Toc372808338 4.3.2 top_dept PAGEREF _Toc372808338 h 17 HYPERLINK l _Toc372808339 4.3.3 GetDeptNameById PAGEREF _Toc372808339 h 17 HYPERLINK l _Toc372808340 4.3.4 GetPrivNameById PAGEREF _Toc372808340 h 17 HYPERLINK l _Toc372808341 4.3.5 Ge

10、tUserNameById PAGEREF _Toc372808341 h 18 HYPERLINK l _Toc372808342 4.3.6 GetUserNameByUid PAGEREF _Toc372808342 h 18 HYPERLINK l _Toc372808343 4.3.7 my_exclude_uid PAGEREF _Toc372808343 h 18 HYPERLINK l _Toc372808344 PAGEREF _Toc372808344 h 19 HYPERLINK l _Toc372808345 4.4.1 send_sms PAGEREF _Toc372

11、808345 h 19 HYPERLINK l _Toc372808346 4.4.2 delete_sms PAGEREF _Toc372808346 h 19 HYPERLINK l _Toc372808347 PAGEREF _Toc372808347 h 20 HYPERLINK l _Toc372808348 4.5.1 send_mobile_sms_user PAGEREF _Toc372808348 h 20 HYPERLINK l _Toc372808349 4.5.2 send_mobile_sms PAGEREF _Toc372808349 h 20 HYPERLINK

12、l _Toc372808350 PAGEREF _Toc372808350 h 21 HYPERLINK l _Toc372808351 4.6.1 upload PAGEREF _Toc372808351 h 21 HYPERLINK l _Toc372808352 4.6.2 delete_attach PAGEREF _Toc372808352 h 21 HYPERLINK l _Toc372808353 4.6.3 attach_size PAGEREF _Toc372808353 h 21 HYPERLINK l _Toc372808354 4.6.4 copy_attach PAG

13、EREF _Toc372808354 h 22 HYPERLINK l _Toc372808355 4.6.5 is_uploadable PAGEREF _Toc372808355 h 22 HYPERLINK l _Toc372808356 4.6.6 is_text PAGEREF _Toc372808356 h 23 HYPERLINK l _Toc372808357 4.6.7 is_office PAGEREF _Toc372808357 h 23 HYPERLINK l _Toc372808358 4.6.8 is_image PAGEREF _Toc372808358 h 23

14、 HYPERLINK l _Toc372808359 4.6.9 is_viewable PAGEREF _Toc372808359 h 24 HYPERLINK l _Toc372808360 4.6.10 is_media PAGEREF _Toc372808360 h 24 HYPERLINK l _Toc372808361 4.6.11 dir_size PAGEREF _Toc372808361 h 24 HYPERLINK l _Toc372808362 4.6.12 delete_dir PAGEREF _Toc372808362 h 25 HYPERLINK l _Toc372

15、808363 4.6.13 attach_sub_dir PAGEREF _Toc372808363 h 25 HYPERLINK l _Toc372808364 4.6.14 attach_real_path PAGEREF _Toc372808364 h 26 HYPERLINK l _Toc372808365 4.6.15 attach_id_encode PAGEREF _Toc372808365 h 26 HYPERLINK l _Toc372808366 4.6.16 attach_id_decode PAGEREF _Toc372808366 h 26 HYPERLINK l _

16、Toc372808367 4.6.17 td_copy PAGEREF _Toc372808367 h 27 HYPERLINK l _Toc372808368 4.6.18 td_rename PAGEREF _Toc372808368 h 27 HYPERLINK l _Toc372808369 4.6.19 td_move_uploaded_file PAGEREF _Toc372808369 h 28 HYPERLINK l _Toc372808370 4.6.20 td_file_put_contents PAGEREF _Toc372808370 h 28 HYPERLINK l

17、_Toc372808371 4.6.21 add_attach_module PAGEREF _Toc372808371 h 28 HYPERLINK l _Toc372808372 4.6.22 attach_module_id PAGEREF _Toc372808372 h 29 HYPERLINK l _Toc372808373 4.6.23 attach_sign_key PAGEREF _Toc372808373 h 29 HYPERLINK l _Toc372808374 4.6.24 attach_sign_key_netdisk PAGEREF _Toc372808374 h

18、29 HYPERLINK l _Toc372808375 4.6.25 attach_real_path_netdisk PAGEREF _Toc372808375 h 30 HYPERLINK l _Toc372808376 4.6.26 cache_attach_para PAGEREF _Toc372808376 h 30 HYPERLINK l _Toc372808377 4.6.27 attach_url PAGEREF _Toc372808377 h 30 HYPERLINK l _Toc372808378 4.6.28 attach_url_pda PAGEREF _Toc372

19、808378 h 31 HYPERLINK l _Toc372808379 4.6.29 attach_link PAGEREF _Toc372808379 h 32 HYPERLINK l _Toc372808380 4.6. 30 attach_link_pda PAGEREF _Toc372808380 h 32 HYPERLINK l _Toc372808381 4.6.31 attach_url_old PAGEREF _Toc372808381 h 33 HYPERLINK l _Toc372808382 4.6.32 upload_old PAGEREF _Toc37280838

20、2 h 33 HYPERLINK l _Toc372808383 4.6.33 add_attach_old PAGEREF _Toc372808383 h 34 HYPERLINK l _Toc372808384 4.6.34 delete_attach_old PAGEREF _Toc372808384 h 34 HYPERLINK l _Toc372808385 4.6.35 add_attach PAGEREF _Toc372808385 h 34 HYPERLINK l _Toc372808386 4.6.36 copy_attach_netdisk PAGEREF _Toc3728

21、08386 h 35 HYPERLINK l _Toc372808387 4.6.37 copy_sel_attach PAGEREF _Toc372808387 h 35 HYPERLINK l _Toc372808388 4.6.38 office_attach PAGEREF _Toc372808388 h 36 HYPERLINK l _Toc372808389 4.6.39 create_attach PAGEREF _Toc372808389 h 36 HYPERLINK l _Toc372808390 4.6.40 is_editable PAGEREF _Toc37280839

22、0 h 36 HYPERLINK l _Toc372808391 4.6.41 is_wps PAGEREF _Toc372808391 h 37 HYPERLINK l _Toc372808392 4.6.42 is_ppt_xls PAGEREF _Toc372808392 h 37 HYPERLINK l _Toc372808393 4.6.43 is_thumbable PAGEREF _Toc372808393 h 37 HYPERLINK l _Toc372808394 4.6.44 image_mimetype PAGEREF _Toc372808394 h 38 HYPERLI

23、NK l _Toc372808395 4.6.45 Is_SysFile PAGEREF _Toc372808395 h 38 HYPERLINK l _Toc372808396 4.6.46 file_type PAGEREF _Toc372808396 h 38 HYPERLINK l _Toc372808397 4.6.47 mime_type PAGEREF _Toc372808397 h 39 HYPERLINK l _Toc372808398 4.6.48 trim_office_attach PAGEREF _Toc372808398 h 39 HYPERLINK l _Toc3

24、72808399 4.6.49 dir_file_nums PAGEREF _Toc372808399 h 39 HYPERLINK l _Toc372808400 4.6.50 CreateThumb PAGEREF _Toc372808400 h 40 HYPERLINK l _Toc372808401 4.6.51 ReplaceImageSrc PAGEREF _Toc372808401 h 40 HYPERLINK l _Toc372808402 4.6.52 trim_inserted_image PAGEREF _Toc372808402 h 40 HYPERLINK l _To

25、c372808403 4.6.53 backup_file PAGEREF _Toc372808403 h 41 HYPERLINK l _Toc372808404 4.6.54 oc_log PAGEREF _Toc372808404 h 41 HYPERLINK l _Toc372808405 4.6.55 attach_id_explode PAGEREF _Toc372808405 h 42 HYPERLINK l _Toc372808406 4.6.56 attach_id_implode PAGEREF _Toc372808406 h 42 HYPERLINK l _Toc3728

26、08407 第五章 公用组件参考 PAGEREF _Toc372808407 h 43 HYPERLINK l _Toc372808408 5.1 人员多项选择 PAGEREF _Toc372808408 h 43 HYPERLINK l _Toc372808409 5.2 人员单项选择 PAGEREF _Toc372808409 h 43 HYPERLINK l _Toc372808410 5.3 部门多项选择 PAGEREF _Toc372808410 h 44 HYPERLINK l _Toc372808411 5.4 部门单项选择 PAGEREF _Toc372808411 h 45

27、HYPERLINK l _Toc372808412 5.5 角色多项选择 PAGEREF _Toc372808412 h 46前 言Office Anywhere网络智能办公系统以下简称通达OA，不仅是一套成熟的网络办公系统，同时也是一个完整、精巧的软件开发平台，不仅集成了Web开发的全套环境，并提供了管理架构、系统资源的开放性支持，是开发中小型管理应用系统的理想平台。本文将从不同的技术层面向您揭示通达OA的二次开发细节，是主要针对专职程序设计人员、编程爱好者、软件产品技术支持人员编写的OA二次开发入门教程。通过阅读本文，您将不仅可以了解通达OA的设计奥秘，也将能够运用本文所介绍的知识和技巧，

28、轻松构建属于自己的应用系统或模块，文中将结合具体实例加以说明。第一章 软件开发环境简介1.1 编程环境通达OA主要采用PHP语言开发，系统使用MySQL数据库。在Windows平台下，通达OA主要注册了9个系统效劳，可以通过控制面板-管理工具-效劳，查看这9项效劳，效劳名分别是Office_Anywhere、MySQL5_OA、memcached Server、OfficeDaemon、OfficeIm、OfficeIndex、OfficeMail、OfficePOP3、OfficeTask，Office_Anywhere效劳实际是集成了PHP模块的Apache效劳，Apache是通达OA所使

29、用的Web Server，通达OA也可以支持IIS作为Web Server，具体配置方法参见通达网站OA知识库相关文档。关于PHP语言的使用，可参阅 HYPERLINK :/ :/ ，下载PHP手册，作为开发指导；关于MySQL数据库的管理与使用，将在第二章进行详细介绍。通达OA的目录层次结构清晰，表达出对效劳程序、应用程序、WEB页面的巧妙整合与组织，便于理解和扩充，下面对目录结构加以说明：MYOAattachOA附件文件存放目录binApache、PHP、Zend等主程序及配置文件，效劳配置程序等confApache配置文件data5MySQL数据库文件目录 BUS公交线路查询数据库 TD

30、_OA通达OA主数据库 MySQLMySQL系统数据库 TD_OA_ARCHIVE通达OA归档数据库 ib_logfile0InnoDB引擎使用的日志文件 ib_logfile1InnoDB引擎使用的日志文件 ibdata1InnoDB引擎存储数据与索引的数据文件logsApache等日志文件目录modulesApache的模块文件MyAdmin通达OA的MySQL管理工具mysql5MySQL主程序文件nginx高性能的通达Nginx Web应用效劳tmp临时文件目录webroot通达OA的WEB根目录PHP程序目录attachment局部OA附件文件存放目录 hrms_pic人事档案照片目

31、录 product_pic销售管理产品照片存放目录 new_sms新短消息提醒状态文件 局部附件目录略 rss今日资讯信息缓存文件 update weather天气预报缓存文件 wm外部邮件存储目录 general主要模块目录 一般模块目录略 ipanel主控面板，集成了菜单、短信箱等应用控制界面 mytable桌面模块程序 system系统功能模块，下级目录略 inc系统通用程序及函数目录ispiritOA精灵页面 mobileOA移动界面 module系统组件 dept_select部门选择组件 editor简易HTML编辑器组件 OCOffice 文档在线编辑与阅读 OC_NETDISK

32、文档在线编辑与阅读-仅适用于网络硬盘 save_file文件转存组件 user_select用户多项选择组件 user_select_single用户单项选择组件portal门户界面static系统通用程序及静态文件目录 common通用css文件及其引用的图片文件 images所有代码中的标签src引用的图片文件templates登录界面模版theme界面主题wav微讯提醒声音js界面主题templates登录界面模版modules所有模块非通用的css文件及其引用的图片文件等的目录address通讯簿非通用css文件及其引用的图片文件 局部模块目录略workflow工作流非通用css文件及

33、其引用的图片文件注：上表中红色颜色标示的目录是备份数据时需要备份的，是OA的所有数据所存放的目录。1.3.1 Apache配置MYOAconf Timeout 300/连接超时，单位秒ServerTokens Prod/Apache信息，Full,OS,Minor,Minimal,Major,ProdErrorDocument/错误文档ErrorLog logs/error.log/错误日志CustomLog logs/access.log combined/访问日志1.3.2 PHP配置display_errors = Off/是否显示PHP程序错误log_errors = Off/是否记录

34、错误日志error_log = filename/错误日志记录文件max_execution_time = 1200/程序最大执行时间，单位秒memory_limit = 256M/单个程序占用内存上限post_max_size = 1000M/表单提交最大数据量，单位MBupload_max_filesize = 200M/上传单个附件大小，单位MB1.3.2 MySQL配置MYOAmysql5basedir=D:/MYOA/mysql5/MySQL主程序路径datadir=D:/MYOA/data5/MySQL数据库路径tmpdir=D:/MYOA/tmp/缓存路径character-se

35、t-server=gbk/MySQL数据库字编码port=3336/端口wait_timeout=30/SQL语句执行结束后自动断开时间interactive_timeout=30/运行SQL语句时段开时间skip-name-resolve/防止外部锁定(默认是ON)bind-addres/允许远程连接innodb_file_per_table=1/启用独立表空间模式innodb_file_format=Barracuda/InnoDB数据压缩注：以上所有的配置选项修改后都需要重启效劳才会生效。第二章 数据库管理2.1 phpMyAdmin的安装MySQL的数据库管理工具很多，phpMyAdm

36、in是使用PHP编写的免费MySQL数据库管理工具。由于OA的MySQL数据库出于平安考虑，被配置为仅能从本机访问，所以使用phpMyAdmin这样的B/S结构的管理工具，可实现数据库的远程管理。第一步、下载程序包phpMyAdmin程序可以从其官方网站 :/ 下载，建议下载最新的all-language版本。第二步、解压缩在MYOAwebroot目录下新建一个目录，如mysql369(为了防止他人利用该工具侵入数据库系统，可把目录名设为比拟复杂的，如MySQL2345，防止目录名被猜想到。),将下载的程序包解压后拷贝至mysql369目录下。第三步、修改配置文件用文本编辑器，如记事本，翻开M

37、ySQL管理工具目录，复制文件并改名为confing.inc.php，翻开后修改以下配置信息：$cfgblowfish_secret = ;/随便输入一个字符串，加密Cookie等信息$cfgServers$iauth_type = ;/ ,config,cookie，建议使用 $cfgServers$ihost = localhost;/数据库地址，默认为localhost$cfgServers$iport = 3336;/数据库端口，默认为3336$cfgServers$iuser = root;/数据库用户名，默认为root$cfgServers$ipassword = ;/数据库密码，

38、默认为myoa888第四步、使用phpMyAdminMySQL管理工具地址： :/OA地址/mysql，注意，进入后先选择中文界面中文-Chinese simplified 。该管理工具的使用需具有一定数据库根底，请勿进行危险操作，以免导致数据丧失。2.2 phpMyAdmin的使用phpMyAdmin主界面如下在左侧选择TD数据库，可查看OA所有的数据表，如下列图点击左侧的表名，那么右侧列出该表的结构和字段、索引、记录数等信息，如下列图phpMyAdmin的具体使用教程方法可以参考 。第三章 如何创立一个模块创立一个模块一般需要经过以下几个步骤：根据功能建立程序存放目录、创立菜单、分配菜单权

39、限、编码、测试等。3.1建立模块目录3.2 创立菜单用管理员帐号进入OA，翻开 系统管理-菜单设置，在相应的一级菜单后点击“下一级链接，在右侧的界面上点击“增加子菜单项按钮，如下列图所示：详细阅读上图界面中的说明信息，按界面上说明的要求定义好菜单：子菜单项ID：系统自动生成，无须调整上级菜单：根据自己的实际应用情况调整子菜单项代码：两位的数字或字母，作为排序之用子菜单项名称：根据自己的实际应用自行填写子菜单模块路径：该菜单对应的程序目录，应为上一个步骤创立的目录名称。如果为abc，那么该菜单对应的菜单图片名称为MYOAwebrootstaticimagesmenuabc.gif，需要自己创立或

40、拷贝abc.gif拷贝至MYOAwebrootstaticimagesmenu下.3.3 分配菜单权限用管理员帐号进入OA，翻开 系统管理-组织机构设置-角色与权限管理，给相关的角色分配刚创立的菜单的使用权限，那么相关角色的人员就可以在OA界面左侧的菜单中看到并访问该菜单。3.4 编码和测试为便于用户开发自己的模块，通达科技在用户效劳区提供了Office Anywhere部份模块源码的下载，供开发人员参考。用户自行开发OA的功能模块，需要根据OA的相关标准进行开发，这样既可以使自行开发的模块和OA的界面效果一致，又可以保证自行开发的程序在OA平安框架的保护之下，这样不仅可以保证新模块数据的平安

41、，又可以使开发人员集中精力投入到模块功能的开发上。OA的各功能模块下的每个程序都需要包含OA的平安验证程序：inc/auth.inc.php。该程序包含了对用户登录信息、是否有权限访问该路径等的检查等。具体的语法为：include_once(inc/auth.inc.php);为更好兼容更多版本的浏览器，需要使用标准统一的HTML解析模式对页面进行解析和渲染，在所有包含HTML代码输出的页面，都需要包含：inc/header.inc.php，输出统一的HTML头信息，包括采用的HTML标准、页面字符集、页面标题、标准界面样式表等。在没有HTML代码输出的页面，不需要包含该文件。OA数据库的所有

42、表名全部使用小写字母，字段名称全部使用大写字母，新模块中字段名也建议与表名统一使用小写字母，开发过程请注意。在开发自己的功能模块时可以参考现有OA模块，把功能相似的OA模块代码复制一份，然后在OA 代码的根底上修改。以下几个小节介绍OA系统变量和数据库的使用。 系统变量OA系统提供了16个通过SESSION保存的当前用户的系统变量，分别是$_SESSIONLOGIN_UID/用户数字ID$_SESSIONLOGIN_USER_ID/用户名，登录使用$_SESSIONLOGIN_BYNAME/用户别名$_SESSIONLOGIN_USER_NAME/用户真实姓名$_SESSIONLOGIN_US

43、ER_PRIV/用户角色ID$_SESSIONLOGIN_USER_PRIV_OTHER/用户辅助角色ID$_SESSIONLOGIN_SYS_ADMIN/用户是否有系统管理员权限$_SESSIONLOGIN_DEPT_ID/用户部门ID$_SESSIONLOGIN_DEPT_ID_OTHER/用户辅助部门ID$_SESSIONLOGIN_AVATAR/用户头像$_SESSIONLOGIN_THEME/用户界面主题$_SESSIONLOGIN_FUNC_STR/用户模块权限$_SESSIONLOGIN_NOT_VIEW_USER/用户禁止查看用户列表$_SESSIONLOGIN_DEPT_ID

44、_JUNIOR/用户所在部门和所属部门合集字符串$_SESSIONLOGIN_CLIENT/用户登录OA的设备类型$_SESSIONLOGIN_USER_SEX/用户性别如需使用这些系统变量，程序需要包含auth.inc.php，如下代码：.2 PHP代码样例以下是一段样例代码index.php，可放置于abc目录下，可作为开发OA应用程序的模版。/或/*/是PHP的注释语句。程序运行结果如下：.3 连接数据库代码以下程序代码为读取admin用户所属部门的例如：?$query = SELECT * from USER where USER_ID=admin;$cursor= exequery(

45、TD:conn(),$query); /*exequery 是OA系统inc/conn.php包装的SQL语句执行函数，TD:conn()n是数据库的连接标识符*/if($ROW=MySQL_fetch_array($cursor)$DEPT_ID=$ROWDEPT_ID;echo admin用户所在部门为：.dept_long_name($DEPT_ID).;?执行效果如下列图：从这段程序可以看出，使用OA系统提供的系统头文件和函数，访问数据库将是一件很轻松的事，不用操心数据库的连接参数等问题，只需简单的写下SQL语句，执行它。MySQL数据库的连接参数在 MYOA文件中配置，如果自己安装M

46、ySQL数据库，可自行修改连接参数。第四章 内置函数参考4.1.1 Message函数原型：Message($TITLE, $CONTENT, $STYLE= , $BUTTONS=array()功能描述：输出一个信息提示框的HTML代码参数：$TITLE/信息框标题$CONTENT/信息框提示信息$STYLE/信息框样式，可选的值有error、warning、stop、forbidden、help、info$BUTTONS/操作按钮数组返回值：无4.1.2 Button_Back函数原型：Button_Back($HTML_CHARSET = )功能描述：输出一个返回按钮的HTML代码参数：

47、$HTML_CHARSET/解析编码返回值：无4.1.3 find_id函数原型：find_id($STRING, $ID)功能描述：在字符串$STRING中查找子串$ID参数：$STRING/以英文逗号(,)连接的N个ID值的一个字符串，如a,b,c,d$ID/要查找的子符串，如c返回值：找到那么返回true，否那么返回false，布尔值4.1.4 get_client_ip函数原型：get_client_ip()功能描述：获取用户的客户端IP地址参数：无返回值：用户的客户端IP地址字符串4.2.1 csubstr函数原型：csubstr(&$str, $start=0, $long=0,

48、$ltor=true, $cn_len=2)功能描述：截取中文字符串参数：$str/要截取的字符串$start/截取起始位置，默认从头开始$long/要截取的长度$ltor/系统保存$cn_len/系统保存返回值：截取后的中文字符串。4.2.2 is_ip函数原型：is_ip($IP)功能描述：判断一个字符串是否是一个合法的IP地址参数：$IP/IP地址字符串返回值：如果$IP是一个IP地址那么返回true，否那么返回false。4.2.3 add_log函数原型：add_log($TYPE,$REMARK,$OPERATOR)功能描述：添加系统日志参数：$TYPE/日志类型代码，参考系统代码

49、设置下的“系统日志类型$REMARK/备注$OPERATOR/产生日志的用户的用户名，一般为当前用户返回值：无4.2.4 get_code_name函数原型：get_code_name($CODE_NO,$PARENT_NO)功能描述：获取系统代码的描述参数：$CODE_NO/系统代码的代码值，如果多个代码那么用英文逗号串起来$PARENT_NO/父类型代码值返回值：对应代码值的文字描述例如代码：echo get_code_name(0,SMS_REMIND);/输出“个人短信echo get_code_name(0,1,SMS_REMIND);/输出“个人短信，公告通知 dept_long_

50、name函数原型：dept_long_name($DEPT_ID)功能描述：获取部门ID为$DEPT_ID的多级部门名称参数：$DEPT_ID/部门ID返回值：$DEPT_ID对应的部门长名称，如“系统处/OA开发组 get_sys_para函数原型：get_sys_para($PARA_NAME_STR, $USE_CACHE = true)功能描述：获取系统参数设置的参数值并返回一个数组参数：$PARA_NAME_STR/系统参数名称字符串，多个的话用英文逗号隔开$USE_CACHE/是否从缓存中获取返回值：系统参数值的数组代码例如：$PARA_ARRAY=get_sys_para(MEN

51、U_DISPLAY,MENU_EXPAND_SINGLE);$PARA_ARRAY为array( MENU_DISPLAY = 1, MENU_EXPAND_SINGLE = 0); set_sys_para函数原型：set_sys_para($PARA_ARRAY)功能描述：批量设置系统参数参数：$PARA_ARRAY/系统参数数组，数组键值为参数名，如array(MENU_DISPLAY=1)返回值：无4.3.1 is_dept_parent函数原型：is_dept_parent($DEPT_ID,$PARENT_ID)功能描述：判断一个部门是否是另外一个部门的上级部门参数：$DEPT_I

52、D/要判断的部门ID$PARENT_ID/上级部门ID返回值：是那么返回true，否那么返回false。4.3.2 top_dept函数原型：top_dept($DEPT_ID)功能描述：获取部门ID为$DEPT_ID的部门的最上级部门的ID。参数：$DEPT_ID/部门ID返回值：最上级部门的ID。4.3.3 GetDeptNameById函数原型：GetDeptNameById($ID_STR)功能描述：获取N个部门的部门名称。参数：$ID_STR/N个部门的ID，用逗号串起来，如“1,2,返回值：N个部门名称字符串，用逗号串起来，如“系统部,OA开发组。4.3.4 GetPrivName

53、ById函数原型：GetPrivNameById($ID_STR)功能描述：获取N个角色的角色名称。参数：$ID_STR/N个角色的ID，用逗号串起来，如“1,2,返回值：N个角色名称字符串，用逗号串起来，如“OA管理员,职员。4.3.5 GetUserNameById函数原型：GetUserNameById($ID_STR)功能描述：获取N个用户的用户姓名。参数：$ID_STR/N个用户的用户名，用逗号串起来，如“admin,lqh,返回值：N个用户的真实姓名字符串，用逗号串起来，如“系统管理员,刘清华。4.3.6 GetUserNameByUid函数原型：GetUserNameByUid(

54、$ID_STR)功能描述：获取N个用户的用户姓名。参数：$ID_STR/N个用户的数字，用逗号串起来，如“1,2,返回值：N个用户的真实姓名字符串，用逗号串起来，如“系统管理员,刘清华。4.3.7 my_exclude_uid函数原型：my_exclude_uid()功能描述：获取当前用户不能与之通讯的用户的数字ID(UID)。参数：无返回值：当前用户不能与之通讯的用户的数字ID(UID)。4.4.1 send_sms函数原型：send_sms($SEND_TIME,$FROM_ID,$TO_ID,$SMS_TYPE,$CONTENT,$REMIND_URL=)功能描述：发送内部短消息。参数：

55、$SEND_TIME/发送时间字符串，如“2021-11-20 09:00:00$FROM_ID/发送人用户名，如“admin$TO_ID/接收人用户名用逗号串起来的字符串，如“lqh,lxq$SMS_TYPE/短信类型代码，参考系统代码设置下的“内部短消息类型$CONTENT/短信内容$REMIND_URL/点击短信提醒弹出窗口的“查看详情翻开的地址返回值：无4.4.2 delete_sms函数原型：delete_sms($SMS_ID_STR,$DEL_TYPE)功能描述：删除内部短消息。参数：$SMS_ID_STR/要删除的短信ID串，用逗号串起来，如“1,2,3$DEL_TYPE/DE

56、L_TYPE=1 删除收到的短信，DEL_TYPE=2 删除发送的短信返回值：无4.5.1 send_mobile_sms_user函数原型：send_mobile_sms_user($SEND_TIME,$FROM_ID,$TO_ID,$CONTENT,$TYPE)功能描述：给OA用户发送 短信。参数：$SEND_TIME/发送时间字符串，如“2021-11-20 09:00:00$FROM_ID/发送人用户名，如“admin$TO_ID/接收人用户名用逗号串起来的字符串，如“lqh,lxq$CONTENT/短信内容$TYPE/短信类型代码，参考系统代码设置下的“内部短消息类型返回值：无4.

57、5.2 send_mobile_sms函数原型：send_mobile_sms($SEND_TIME,$FROM_ID,$PHONE,$CONTENT)功能描述：向指定号码发送 短信。参数：$SEND_TIME/发送时间字符串，如“2021-11-20 09:00:00$FROM_ID/发送人用户名，如“admin$PHONE/接收 号码字符串，如“138xxxxxxxx,139xxxxxxxx$CONTENT/短信内容返回值：无4.6.1 upload函数原型：upload($PREFIX=ATTACHMENT,$MODULE= , $OUTPUT=true)功能描述：上传附件，可以一次上传

58、多个附件。参数：$PREFIX/表单File控件名称的前缀，一般为默认即可$MODULE/模块代码，如内部邮件为email，为空那么根据程序路径自动判断$OUTPUT/参数判断返回值：无4.6.2 delete_attach函数原型：delete_attach($ATTACHMENT_ID,$ATTACHMENT_NAME,$MODULE=)功能描述：删除附件，可以一次删除多个附件。参数：$ATTACHMENT_ID/附件ID，多个附件ID用逗号隔开$ATTACHMENT_NAME/附件名称，多个附件名称用*号隔开$MODULE/模块代码，如内部邮件为email，为空那么根据程序路径自动判断断

59、返回值：无4.6.3 attach_size函数原型：attach_size($ATTACHMENT_ID,$ATTACHMENT_NAME,$MODULE=)功能描述：获取附件大小。参数：$ATTACHMENT_ID/附件ID$ATTACHMENT_NAME/附件名称$MODULE/模块代码，如内部邮件为email，为空那么根据程序路径自动判断断返回值：附件大小，单位字节。4.6.4 copy_attach函数原型：copy_attach($ATTACHMENT_ID,$ATTACHMENT_NAME,$MODULE_SRC=,$MODULE_DESC=, $ID_IS_REAL = tru

60、e)功能描述：拷贝一个或多个附件。参数：$ATTACHMENT_ID/附件ID，多个附件ID用逗号隔开$ATTACHMENT_NAME/附件名称，多个附件名称用*号隔开$MODULE_SRC/原附件所属模块代码，为空那么根据程序路径自动判断断$MODULE_DESC/新附件所属模块代码，为空那么根据程序路径自动判断断$ID_IS_REAL/$ATTACHMENT_ID是文件的真实ID，还是attach_id_decode过之后的，数据库中存的一般是真实的返回值：新附件的附件ID串，多个附件的话用逗号隔开。4.6.5 is_uploadable函数原型：is_uploadable($FILE_N