通達OA二次開發(fā)手冊

OfficeAnywhere網(wǎng)絡(luò)智能辦公系統(tǒng)

二次開發(fā)手冊

V8.1.150425（2015版）

通達信科

中國兵器工業(yè)信息中心

目錄

目錄

刖百

第一章軟件開發(fā)環(huán)境簡介

1.1編程環(huán)境

L3參數(shù)配置

1.3.1OfficeFPM配置

1.3.2OfficWeb配置

1.3.3PHP配置

1.3.4MySQL配置

1.3.5OfficWeb、OfficeFPM和PHP的關(guān)系

L4核心文件

1.4.4conn.php(MYOA\webroot\inc\)

第二章數(shù)據(jù)庫管理

2.1phpMyAdmin的安裝

2.2phpMyAdmin的使用

第三章如何創(chuàng)建一個模塊

3.1建立模塊目錄

3.2創(chuàng)建菜單

3.3分配菜單權(quán)限

3.4編碼和測試

3.4.1系統(tǒng)變量

3.4.2PHP代碼樣例

3.4.3連接數(shù)據(jù)庫代碼

第四章內(nèi)置類庫參考

4.1TD類

4.1.1成員函數(shù)

4.2PortalData類

4.2」成員函數(shù)

4.3ExcelReader類

4.3.1成員函數(shù)

4.4Workflow相關(guān)類

4.4.1TworkFomi類的成員函數(shù)

4.4.2TworkRun類的成員函數(shù)

第五章內(nèi)置函數(shù)參考

5.1utility.php

5.1.1Message

5.1.2ButtonBack

5.1.3findid

5.1.4getclientip

5.2utilityall.php

5.2.1csubstr

5.2.2isip

5.2.3addlog

5.2.4getcodename

5.2.5deptlongname

5.2.6getsyspara

5.2.7setsyspara

5.3utilityorg.php

5.3.1isdeptparent

5.3.2topdept

5.3.3GetDeptNameByld

5.3.4GetPrivNameByld

5.3.5GetUserNameByld

5.3.6GetUserNameByUid

5.3.7myexcludeuid

5.3.8GetUnionSetOfChildDeptld

5.3.9GetfunmenuByuserlD

5.4utilitysmsl.php

5.4.1sendsms

5.4.2deletesms

5.5utilitysms2.php

5.5.1sendmobilesmsuser

5.5.2sendmobilesms

5.6utilityfile.php

5.6.1upload

5.6.2deleteattach

5.6.3attachsize

5.6.4copyattach

5.6.5isuploadable

5.6.6istext

5.6.7isoffice

5.6.8isimage

5.6.9isviewable

5.6.30attachlinkpda

5.7utilityemail.php

5.7.1GetWebMailNumByUid

5.7.2GetSentMailNum

5.7.3trimnotlogin

5.7.4inserttoaddress

5.7.5getemaildata

5.7.6removeemail

5.7.7getsentboxdata

5.7.8deleteemail

5.7.9destroyemail

5.8utilitycalendar.php

5.8.1inserttaskcenter

5.8.2addcalendar

5.8.3updatecalendar

5.8.4getlistdata

5.8.5deletecalendar

第六章公用組件參考

6.1人員多選

6.2人員單選

6.3部門多選

6.4部門單選

6.5角色多選

第七章典型功能簡析

7」用戶名相關(guān)

7.2登錄密碼加密

7.3系統(tǒng)緩存機制

7.4OA升級產(chǎn)生的變化

7.4」2013版升級至I]2013增強版

7.4.22013增強版升級到2015版

前B

OfficeAnywhere網(wǎng)絡(luò)智能辦公系統(tǒng)（以下簡稱通達0A）,不僅是一套成熟的網(wǎng)絡(luò)辦公系

統(tǒng)，同時也是一個完整、精巧的軟件開發(fā)平臺，不僅集成了Web開發(fā)的全套環(huán)境，并提供了管

理架構(gòu)、系統(tǒng)資源的開放性支持，是開發(fā)中小型管理應(yīng)用系統(tǒng)的理想平臺。

本文將從不同的技術(shù)層面向您揭示通達0A的二次開發(fā)細(xì)節(jié)，是主要針對專職程序設(shè)計人

員、編程愛好者、軟件產(chǎn)品技術(shù)支持人員編寫的0A二次開發(fā)入門教程。

通過閱讀本文，您將不僅可以了解通達0A的設(shè)計奧秘，也將能夠運用本文所介紹的知識和

技巧，輕松構(gòu)建屬于自己的應(yīng)用系統(tǒng)或模塊，文中將結(jié)合具體實例加以說明。

第一章軟件開發(fā)環(huán)境簡介

1.1編程環(huán)境

通達0A主要采用PHP語言開發(fā)，系統(tǒng)使用MySQL數(shù)據(jù)庫。

在Windows平臺下，通達0A主要注冊了9個系統(tǒng)服務(wù)，可以通過控制面板-〉管理工具-〉

服務(wù)，查看這9項服務(wù)，服務(wù)名分別是Office_Web、MySQL5_OA>Office_Redis、

OfficeDaemon,Officelm>Officeindex,OfficeMaiROfficePOP3>OfficeTask,OfficeWeb

是管理ngnix進程的服務(wù)，Office_Web是通達OA所使用的WebServer,通達OA也可以支持HS

作為WebServer,具體配置方法參見通達網(wǎng)站OA知識庫相關(guān)文檔。

關(guān)于PHP語言的使用，可參閱，下載PHP手冊，作為開發(fā)指導(dǎo)，PHP版本已升級至5.3,該

版本中許多函數(shù)或方法有調(diào)整，使用時需要注意；關(guān)于MySQL數(shù)據(jù)庫的管理與使用，將在第二

章進行詳細(xì)介紹。

1.2目錄層次結(jié)構(gòu)

通達0A的目錄層次結(jié)構(gòu)清晰，體現(xiàn)出對服務(wù)程序、應(yīng)用程序、WEB頁面的巧妙整合與組

織，便于理解和擴充，下面對目錄結(jié)構(gòu)加以說明：

MYOA

|--attach0A附件文件存放目錄

|--binPHP、Zend等主程序及配置文件，服務(wù)配置程序等

|--data5MySQL數(shù)據(jù)庫文件目錄

|—BUS公交線路查詢數(shù)據(jù)庫

|-TD_OA通達0A主數(shù)據(jù)庫

|--crscell報表數(shù)據(jù)庫

|—MySQLMySQL系統(tǒng)數(shù)據(jù)庫

|-TD_OA_ARCHIVE通達0A歸檔數(shù)據(jù)庫

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

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

I1--ibdatalInnoDB引擎存儲數(shù)據(jù)與索引的數(shù)據(jù)文件

I--logsOA服務(wù)等的日志文件目錄

|--MyAdmin通達0A的MySQL管理工具

|--mysql5MySQL主程序文件

|--nginx高性能的通達NginxWeb應(yīng)用服務(wù)

|tmp臨時文件目錄

1webroot通達0A的WEB根目錄（PHP程序目錄）

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

||hrms_pic人事檔案照片目錄

||product_pic銷售管理產(chǎn)品照片存放目錄

■newsms新短消息提醒狀態(tài)文件

部分附件目錄（略）

|rss今日資訊信息緩存文件

|update系統(tǒng)升級，該文件夾下如存在Lphp會被自動執(zhí)行并刪除

|weather天氣預(yù)報緩存文件

|1wm外部郵件存儲目錄

|general主要模塊目錄

一般模塊目錄（略）

||ipanel主控面板，集成了菜單、短信箱等應(yīng)用控制界面

||mytable桌面模塊程序

|1system系統(tǒng)功能模塊，下級目錄略

|inc系統(tǒng)通用程序及函數(shù)目錄

|ispirit0A精靈頁面

|mobile0A移動界面

|module系統(tǒng)組件

I|-dept_select部門選擇組件

||editor簡易HTML編輯器組件

||—OCOffice文檔在線編輯與閱讀

||-OC_NETDISK文檔在線編輯與閱讀-僅適用于網(wǎng)絡(luò)硬盤

I|-savefile文件轉(zhuǎn)存組件

IIuserselect用戶多選組件

■user_select_single用戶單選組件

|portal門戶界面

1static系統(tǒng)通用程序及靜態(tài)文件目錄

|common通用css文件及其引用的圖片文件

|images所有代碼中的＜img＞標(biāo)簽src引用的圖片文件

|templates登錄界面模版

|theme界面主題

|wav微訊提醒聲音

I~js界面主題

|templates登錄界面模版

1modules所有模塊非通用的CSS文件及其引用的圖片文件等的目錄

|address通訊簿非通用CSS文件及其引用的圖片文件

部分模塊目錄（略）

匚■workflow工作流非通用css文件及其引用的圖片文件

注：上表中紅色顏色標(biāo)示的目錄是備份數(shù)據(jù)時需要備份的，是0A的所有數(shù)據(jù)所存放的目錄。

1.3參數(shù)配置

1.3.1OfficeFPM配置(MYOA\bin\service.ini)

Listen=8266〃監(jiān)聽端口

ProcessNumber=10//fastcgi進程數(shù)

1.3.2OfficWeb配置(MYOA\bin\service.ini)

Listen=2367〃監(jiān)聽端口

MemoryWarning=100//非工作時間OfficeNginx.exe占用內(nèi)存的最大值，

單位為兆字節(jié)(MB)

MemoryMax=200//工作時間OfficeNginx.exe占用內(nèi)存的最大值，單

位為兆字節(jié)(MB)

1.3.3PHP配置(MYOA\bin\php.ini)

display_errors=Off〃是否顯示PHP程序錯誤

log_errors=Off//是否記錄錯誤日志

error_log=filename//錯誤日志記錄文件

max_execution_time=1200//程序最大執(zhí)行時間，單位秒

memory_limit=256M〃單個程序占用內(nèi)存上限

post_max_size=1000M〃表單提交最大數(shù)據(jù)量，單位MB

upload_max_filesize=200M//上傳單個附件大小，單位MB

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

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

datadir=D:/MYOA/data5///MySQL數(shù)據(jù)庫路徑

tmpdir=D:/MYOA/tmp/〃緩存路徑

character-set-server=gbk//MySQL數(shù)據(jù)庫字編碼

port=3336//端口

wait_timeout=30//SQL語句執(zhí)行結(jié)束后自動斷開時間

interact!ve_timeout=30//運行SQL語句時段開時間

skip-name-resolve//避免外部鎖定(默認(rèn)是ON)

//允許遠(yuǎn)程連接

innodb_file_per_table=1//啟用獨立表空間模式

innodb_file_fbrmat=Barracuda//InnoDB數(shù)據(jù)壓縮

注：以上所有的配置選項修改后都需要重啟服務(wù)才會生效。

1.3.5OfficWeb>OfficeFPM和PHP的關(guān)系

OfficeWeb服務(wù)守護O笛ceFPM進程和OfficeNginx。OfficeFPM進程啟動多個

(ProcessNumber)FastCGI進程。OfficeWeb根據(jù)配置參數(shù)(MemoryWarning和MemoryMax)

定時檢測OfficeNginx的內(nèi)存占用情況，保證OfficeNginx時刻處于正常響應(yīng)狀態(tài)。

1.4核心文件

1.4.1MYOA\webroot\inc\)

例：

1.4.2(MYOA\webroot\inc\)

例：$HTML_PAGE_TITLE=_("頁面標(biāo)題)

1.4.3MYOA\webroot\inc\)

為了防止用戶輸入不安全數(shù)據(jù)等，通達0A為您提供了用戶輸入數(shù)據(jù)($_GET、$_POST、

S^COOKIE)過濾和校驗程序，原則上所有php頁面文件都需要包含，但如果頁面已經(jīng)包含過。

例：

1.4.4conn.php(MYOA\webroot\inc\)

例：include_once("inc/conn.phpn);

第二章數(shù)據(jù)庫管理

2.1phpMyAdmin的安裝

MySQL的數(shù)據(jù)庫管理工具很多，phpMyAdmin是使用PHP編寫的免費MySQL數(shù)據(jù)庫管理工具。

由于0A的MySQL數(shù)據(jù)庫出于安全考慮，被配置為僅能從本機訪問，所以使用phpMyAdmin這樣的

B/S結(jié)構(gòu)的管理工具，可實現(xiàn)數(shù)據(jù)庫的遠(yuǎn)程管理。

第一步、下載程序包

第二步、解壓縮

在MYOA\webroot目錄下新建一個目錄，如mysql369（為了防止他人利用該工具侵入數(shù)據(jù)庫

系統(tǒng)，可把目錄名設(shè)為比較復(fù)雜的，如MySQL2345,避免目錄名被猜測到。），將下載的程序包

解壓后拷貝至mysql369目錄下。

第三步、修改配置文件

用文本編輯器，如記事本，打開MySQL管理工具目錄，復(fù)制

$cfg['blowfish_secret,]=〃隨便輸入一個字符串，加密Cookie等信息

$cfg['Serversr|[$i]['auth_type']='http';//http,config,cookie,建議使用http

ScfgfServers*][$i]['host1]=localhost';〃數(shù)據(jù)庫地址，默認(rèn)為localhost

$cfg『Serversr][$i][por門=3336;〃數(shù)據(jù)庫端口，默認(rèn)為3336

$cfg['Servers'][$i]fuser*]=Wf;〃數(shù)據(jù)庫用戶名，默認(rèn)為root

ScfgfServers^tSi]['password']=〃數(shù)據(jù)庫密碼，默認(rèn)為myoa888

第四步、使用phpMyAdmin

MySQL管理工具地址：0A地址/mysql,注意，進入后先選擇中文界面（中文-Chinese

simplified）。該管理工具的使用需具有一定數(shù)據(jù)庫基礎(chǔ)，請勿進行危險操作，以免導(dǎo)致數(shù)據(jù)

丟失。

2.2phpMyAdmin的使用

phpMyAdmin主界面如下

在左側(cè)選擇TD數(shù)據(jù)庫，可查看0A所有的數(shù)據(jù)表，如下圖

點擊左側(cè)的表名，則右側(cè)列出該表的結(jié)構(gòu)和字段、索引、記錄數(shù)等信息，如下圖

phpMyAdmin的具體使用教程方法可以參考通達網(wǎng)站/0A知識庫/OfficeAnywhere局級應(yīng)

用技巧/0A數(shù)據(jù)庫管理工具/mysql網(wǎng)頁方式管理工具/phpMyAdmin的安裝和使用.wmv。

第三章如何創(chuàng)建一個模塊

創(chuàng)建一個模塊一般需要經(jīng)過以下幾個步驟：根據(jù)功能建立程序存放目錄、創(chuàng)建菜單、分配

菜單權(quán)限、編碼、測試等。

3.1建立模塊目錄

在MYOA\webroot\general下建議一個目錄new_module,作為自己開發(fā)模塊的目錄，將程序

放置于該目錄下，默認(rèn)頁面是index,php或index,html或index,htm

3.2創(chuàng)建菜單

用管理員帳號進入0A,打開系統(tǒng)管理-＞菜單設(shè)置，在相應(yīng)的一級菜單后點擊“下一級”

鏈接，在右側(cè)的界面上點擊“增加子菜單項”按鈕，如下圖所示：

詳細(xì)閱讀上圖界面中的說明信息，按界面上說明的要求定義好菜單：

子菜單項ID：系統(tǒng)自動生成，無須調(diào)整

上級菜單：根據(jù)自己的實際應(yīng)用情況調(diào)整

子菜單項代碼：兩位的數(shù)字或字母，作為排序之用

子菜單項名稱：根據(jù)自己的實際應(yīng)用自行填寫

子菜單模塊路徑：該菜單對應(yīng)的程序目錄，應(yīng)為上一個步驟創(chuàng)建的目錄名稱。如果為

new_module,則該菜單對應(yīng)的菜單圖片名稱為MYOA\webroot\static\images\menu\new_mod

ule.gif,需要自己創(chuàng)建或拷貝new_module.gif拷貝至MYOA\webroot\static\images\menu下。

3.3分配菜單權(quán)限

用系統(tǒng)管理員賬號，在菜單創(chuàng)建完成后跳轉(zhuǎn)界面直接可以給指定菜單分配權(quán)限（首次分配

菜單權(quán)限時需要驗證超級密碼，與系統(tǒng)管理-〉組織機構(gòu)設(shè)置-＞角色與權(quán)限管理中超級密碼一

致），如下圖所示：

也可以使用傳統(tǒng)方式給新建菜單分配權(quán)限，用管理員帳號進入0A,打開系統(tǒng)管理-〉組織

機構(gòu)設(shè)置-〉角色與權(quán)限管理，給相關(guān)的角色分配剛創(chuàng)建的菜單的使用權(quán)限，則相關(guān)角色的人員

就可以在0A界面左側(cè)的菜單中看到并訪問該菜單。

3.4編碼和測試

為便于用戶開發(fā)自己的模塊，通達科技在用戶服務(wù)區(qū)提供了OfficeAnywhere部份模塊源

碼的下載，供開發(fā)人員參考。

用戶自行開發(fā)0A的功能模塊，需要根據(jù)0A的相關(guān)規(guī)范進行開發(fā)，這樣既可以使自行開發(fā)

的模塊和0A的界面效果一致，又可以保證自行開發(fā)的程序在0A安全框架的保護之下，這樣不僅

可以保證新模塊數(shù)據(jù)的安全，又可以使開發(fā)人員集中精力投入到模塊功能的開發(fā)上。

0A的各功能模塊下的每個程序都需要包含0A的安全驗證程序：inc/auth.inc.php。該程序

包含了對用戶登錄信息、是否有權(quán)限訪問該路徑等的檢查等。具體的語法為：

include_once("inc/auth.inc

在開發(fā)自己的功能模塊時可以參考現(xiàn)有0A模塊，把功能相似的0A模塊代碼復(fù)制一份，然

后在0A代碼的基礎(chǔ)上修改。以下幾個小節(jié)介紹0A系統(tǒng)變量和數(shù)據(jù)庫的使用。

3.4.1系統(tǒng)變量

0A系統(tǒng)提供了多個通過SESSION保存的當(dāng)前用戶的系統(tǒng)變量，分別是

$_SESSION[，/LOGIN_UID，/]〃用戶數(shù)字ID

$_SESSION[，/LOGIN_USER_ID//]〃用戶名，無意義

$_SESSION["LOGIN_BYNAME"]〃用戶名，又叫用戶別名，登錄使用

$_SESSION["LOGIN_USER_NAME”]〃用戶真實姓名

$_SESSION["LOGIN_USER_PRIV//]〃用戶角色ID

$_SESSION[，ZLOGIN_USER_PRIV_OTHER]〃用戶輔助角色ID

$_SESSION[，，LOGIN_SYS_ADMIN，/]〃用戶是否有系統(tǒng)管理員權(quán)限

$_SESSION[，，LOGIN_DEPT_ID，，1〃用戶部門ID

$_SESSION[，/LOGIN_DEPT_ID_OTHER，/]〃用戶輔助部門ID

$_SESSION["LOGIN_AVATAR”]〃用戶頭像

$_SESSION["LOGIN_THEME，/]〃用戶界面主題

$_SESSION["LOGIN_FUNC_STR']〃用戶模塊權(quán)限

$_SESSION["LOGIN_NOT_VIEW_USER"]〃用戶禁止查看用戶列表

$_SESSION[?，LOGIN_DEPT_IDJUNIORZ，]〃用戶所在部門和所屬部門合集字符串

$_SESSION[z/LOGIN_CLIENTn〃用戶登錄0A的設(shè)備類型

$_SESSION[Z，LOGIN_USER_SEXZ，]〃用戶性別

如需使用這些系統(tǒng)變量，程序需要包含auth.inc.php,如下代碼:

<?

include_once(z，inc/auth.inc.php〃);

echo〃我的登錄用戶名是〃.$_SESSION[〃LOGIN_BYNAME〃];〃本句中的.表示字符串連接

?>

3.4.2PHP代碼樣例

以下是一段樣例代碼index.php,可放置于newjnodule目錄下，可作為開發(fā)0A應(yīng)用程序的

模版?！ɑ?*…*/是PHP的注釋語句。

<?

include_once(z，inc/auth.inc.phpz，);//如需登錄驗證則包含，未登錄將退出

//include_once(z，inc/conn.phpz，);//如需要連接數(shù)據(jù)庫則包含

〃如已包含auth.inc.php,則無須包含conn,php

//include_once(z，inc/utility_all.php，z);//如需要使用公用函數(shù)則包含

//include_once(''inc/check_type.phpz，);//如需要使用類型檢驗函數(shù)則包含

$HTML_PAGE_TITLE=_(〃功能模塊名稱〃)；

//如有HTML代碼輸出則包含

?>

<bodyclass=〃bodycolor〃>

<?

echo〃當(dāng)前登錄的用戶為：”.$_SESSION[〃LOGIN_USER_NAME〃].〃，用戶名為：

”.$_SESSION[〃LOGIN_BYNAME〃];

?>

</body>

</html>

程序運行結(jié)果如下：

3.4.3連接數(shù)據(jù)庫代碼

以下程序代碼為讀取admin用戶所屬部門的示例：

<?

include_once(z，inc/auth.inc.php，z);//如需登錄驗證則包含，未登錄將退出

include_once(，zinc/uti1ity_al1.phpz，);//如需要使用公用函數(shù)則包含

$HTML_PAGE_TITLE=_(〃功能模塊名稱〃)；

//如有HTML代碼輸出則包含

?>

<bodyclass=〃bodycolor〃>

<?

$query="SELECT*fromUSERwhereUSER_ID=，admin'〃;

$cursor=exequery(TD::conn(),$query);

exequery是OA系統(tǒng)inc/conn.php包裝的SQL語句執(zhí)行函數(shù)，TD::conn()是數(shù)據(jù)庫的連接標(biāo)識

符

*/

if($ROW=MySQL_fetch_array($cursor))

$DEPT_ID=$ROW[，ZDEPT_ID"];

echo，zadmin用戶所在部門為：<u>〃.dept_long_name($DEPT_ID).，z</u>，z;

?>

</body>

</html>

執(zhí)行效果如下圖：

從這段程序可以看出，使用0A系統(tǒng)提供的系統(tǒng)頭文件和函數(shù)，訪問數(shù)據(jù)庫將是一件很輕松

的事，不用操心數(shù)據(jù)庫的連接參數(shù)等問題，只需簡單的寫下SQL語句，執(zhí)行它。

MySQL數(shù)據(jù)庫的連接參數(shù)在MYOA\webroot\inc\oa_config.php文件中配置，如果自己安裝

MySQL數(shù)據(jù)庫，可自行修改連接參數(shù)。

第四章內(nèi)置類庫參考

4.1TD類

4.1.1成員函數(shù)

>conn()

函數(shù)說明：

獲取數(shù)據(jù)庫連接。

參數(shù)：

無

返回值：

數(shù)據(jù)庫連接

>get_cache($id)

函數(shù)說明：

獲取緩存內(nèi)容。

參數(shù):

$id緩存id鍵值

返回值:

緩存內(nèi)容

>set_cache($id,$data,$ttl=60)

函數(shù)說明:

更新緩存內(nèi)容。

參數(shù):

$id〃緩存id鍵值

$data〃緩存內(nèi)容

$ttl〃更新時間

返回值:

無

>delete_cache($id)

函數(shù)說明:

刪除指定緩存。

參數(shù):

$id〃緩存id鍵值

返回值:

無

4.2PortalData類

4.2.1成員函數(shù)

>get_portal_info()

函數(shù)說明:

獲取門戶的基本信息。

參數(shù):

無

返回值:

門戶的基本信息數(shù)組

get_nav_list()

函數(shù)說明：

獲取門戶導(dǎo)航欄的基本信息。

參數(shù)：

無

返回值：

導(dǎo)航欄的基本信息數(shù)組，二維數(shù)組，$column_id為一級數(shù)組鍵值

get_columns_info($columnid_str)

函數(shù)說明：

獲取指定欄目的基本信息。

參數(shù)：

$column_id_str〃欄目ID串

返回值：

欄目的基本信息，二維數(shù)組，$column_id為一級數(shù)組鍵值

get_columnpage($column_id)

函數(shù)說明：

獲取指定欄目的頁面信息。

參數(shù)：

$column_id〃欄目ID

返回值：

欄目的頁面信息，數(shù)組

get_child_columns($column_id)

函數(shù)說明：

獲取指定欄目的子欄目。

參數(shù)：

$column_id〃欄目ID

返回值：

子欄目數(shù)組

get_contents_list($column_id,$start=0,=10,$order_by

函數(shù)說明：

獲取指定欄目的內(nèi)容列表。

參數(shù)：

$column_id〃欄目ID

〃開始條數(shù)

〃返回內(nèi)容條數(shù)

$order_by〃內(nèi)容列表排序

返回值：

內(nèi)容列表，二維數(shù)組

get_contents_info($content_id_str)

函數(shù)說明：

根據(jù)內(nèi)容ID串獲取多條內(nèi)容的詳細(xì)信息。

參數(shù):

$content_id_str〃內(nèi)容ID串

返回值：

內(nèi)容的詳細(xì)信息二維數(shù)組，鍵值為contentid

get_unit_name()

函數(shù)說明：

獲取單位名稱。

參數(shù)：

無

返回值：

單位名稱

get_miitbeian_no()

函數(shù)說明：

獲取網(wǎng)站備案號。

參數(shù):

無

返回值：

網(wǎng)站備案號

4.3ExcelReader類

4.3.1成員函數(shù)

>getHeadO

函數(shù)說明：

獲取Excel內(nèi)容頭數(shù)據(jù)信息。

參數(shù)：

無

返回值：

頭數(shù)據(jù)信息數(shù)組

>getFirstRowO

函數(shù)說明：

獲取Excel內(nèi)容第一行數(shù)據(jù)信息。

參數(shù)：

無

返回值：

Excel內(nèi)容第一行數(shù)據(jù)信息數(shù)組

>getFirstRowO

函數(shù)說明：

獲取Excel內(nèi)容第一行數(shù)據(jù)信息。

參數(shù)：

無

返回值：

Excel內(nèi)容第一行數(shù)據(jù)信息數(shù)組

4.4Workflow相關(guān)類

4.4.1TworkForm類的成員函數(shù)

Aget_all_supported_ctrls()

函數(shù)說明：

public,獲取所有支持的控件信息數(shù)組。

參數(shù)：

無

返回值：

數(shù)組，表單支持的控件類型數(shù)組

Array(

1=>Array(〃系統(tǒng)內(nèi)置控件

‘Text'=>array(

fcontrol_nameJ=>，單行輸入框，

fcontrol_type,=>C0J//系統(tǒng)保留

rdiag_width,=>e260J//對話框?qū)挾?/p>

fdiag_heightJ=>f300J//對話框高度)

)

0=>Array(//用戶自定義控件

)

>get_form_info()

函數(shù)說明：

獲取表單ID、名稱等基本信息。

參數(shù)：

無

返回值：

表單基本信息數(shù)組

>getall_fields()

函數(shù)說明：

獲取表單所有的字段數(shù)組。

參數(shù)：

無

返回值：

表單所有字段數(shù)組

4.4.2TworkRun類的成員函數(shù)

>get_formhtml()

函數(shù)說明：

獲取當(dāng)前工作的表單HTML代碼。

參數(shù)：

無

返回值：

字符串，表單HTML代碼

>get_public_attach_html()

函數(shù)說明：

獲取公共附件區(qū)HTML代碼。

參數(shù)：

無

返回值：

公共附件區(qū)HTML代碼

>get_flow_graph_html()

函數(shù)說明:

獲取流程圖區(qū)的HTML代碼。

參數(shù)：

無

返回值：

流程圖區(qū)的HTML代碼

get_view_user_html()

函數(shù)說明：

獲得查閱信息的HTML代碼。

參數(shù)：

無

返回值：

查閱信息的HTML代碼

get_flow_id()

函數(shù)說明：

獲取當(dāng)前工作的FLOWJD。

參數(shù)：

無

返回值：

當(dāng)前工作的FLOW_ID

get_run_id()

函數(shù)說明：

獲取當(dāng)前工作的RUN_ID。

參數(shù)：

無

返回值：

當(dāng)前工作的RUN_ID

get_prcs_id()

函數(shù)說明：

獲取當(dāng)前工作的步驟ID。

參數(shù)：

無

返回值：

當(dāng)前工作的步驟ID

get_flow_info()

函數(shù)說明：

獲取當(dāng)前流程的基本信息，F(xiàn)LOWJYPE中的數(shù)據(jù)。

參數(shù)：

無

返回值：

當(dāng)前流程的基本信息數(shù)組

get_flow_process_info()

函數(shù)說明：

獲取流程當(dāng)前步驟對應(yīng)設(shè)計步驟的基本信息，F(xiàn)LOW_PROCESS中的數(shù)據(jù)。

參數(shù)：

無

返回值：

流程步驟的基本信息數(shù)組

get_run_info()

函數(shù)說明：

獲取當(dāng)前工作的基本信息，F(xiàn)LOW_RUN中的數(shù)據(jù)。

參數(shù)：

無

返回值：

當(dāng)前工作的基本信息數(shù)組

get_run_data()

函數(shù)說明：

獲取當(dāng)前工作的表單數(shù)據(jù)，F(xiàn)LOW_DATA_xxx中的數(shù)據(jù)。

參數(shù)：

無

返回值：

表單數(shù)據(jù)數(shù)組

get_cur_prcs_info()

函數(shù)說明：

獲取當(dāng)前步驟的基本信息(FLOW_RUN_PRCS表中對應(yīng)$run_id^n$prcs_id的記錄)。

參數(shù)：

無

返回值：

當(dāng)前步驟的基本信息數(shù)組

get_pub1ic_attach()

函數(shù)說明：

獲取當(dāng)前工作的公共附件。

參數(shù)：

無

返回值：

當(dāng)前工作的公共附件信息

get_run_feedback()

函數(shù)說明：

獲取當(dāng)前工作的會簽意見信息。

參數(shù)：

無

返回值：

當(dāng)前工作的會簽意見信息數(shù)組

get_writable_fields()

函數(shù)說明：

獲取當(dāng)前工作的表單可寫字段。

參數(shù)：

無

返回值：

可寫字段title字符串，逗號分隔

get_secret_fields()

函數(shù)說明：

獲取當(dāng)前工作的表單保密字段。

參數(shù):

無

返回值：

保密字段title字符串，逗號分隔

第五章內(nèi)置函數(shù)參考

5.1utility.php

5.1.1Message

函數(shù)原型：

Message($TITLE,$CONTENT,$STYLE=""，$BUTTONS=array())

功能描述：

輸出一個信息提示框的HTML代碼

參數(shù)：

STITLE〃信息框標(biāo)題

SCONTENT〃信息框提示信息

$STYLE〃信息框樣式，可選的值有error、warning、stop、forbidden>help>

info

SBUTTONS〃操作按鈕數(shù)組

返回值：

無

5.1.2Button_Back

函數(shù)原型：

Button_Back($HTML_CHARSET='')

功能描述：

輸出一個返回按鈕的HTML代碼

參數(shù)：

$HTML_CHARSET〃解析編碼

返回值：

無

5.1.3find_id

函數(shù)原型：

find_id($STRING,$ID)

功能描述：

在字符串$$丁改四中查找子串$ID

參數(shù)：

SSTRING〃以英文逗號(,)連接的N個ID值的一個字符串，如a,b,c,d

$ID〃要查找的子符串，如c

返回值：

找到則返回true,否則返回false,布爾值

5.1.4get_client_ip

函數(shù)原型：

get_client_ip()

功能描述：

獲取用戶的客戶端IP地址

參數(shù)：

無

返回值：

用戶的客戶端IP地址字符串

5.2utility_all.php

5.2.1csubstr

函數(shù)原型：

csubstr(&$str,$start=O,$long=0,$ltor=true,$cn_len=2)

功能描述：

截取中文字符串

參數(shù):

$str〃要截取的字符串

$start〃截取起始位置，默認(rèn)從頭開始

$long〃要截取的長度

$ltor〃系統(tǒng)保留

$cn_len〃系統(tǒng)保留

返回值：

截取后的中文字符串。

5.2.2is_ip

函數(shù)原型：

isip($IP)

功能描述：

判斷一個字符串是否是一個合法的IP地址

參數(shù)：

$IP〃:EP地址字符串

返回值：

如果$IP是一個IP地址則返回true,否則返回falseo

5.2.3add_log

函數(shù)原型：

add_log($TYPE,$REMARK,$0PERAT0R)

功能描述：

添加系統(tǒng)日志

參數(shù)：

STYPE〃日志類型代碼，參考系統(tǒng)代碼設(shè)置下的“系統(tǒng)日志類型”

$REMARK〃備注

S0PERAT0R//產(chǎn)生日志的用戶的用戶名，一般為當(dāng)前用戶

返回值：

無

5.2.4get_code_name

函數(shù)原型：

get_code_name($CODE_NO,$PARENT_NO)

功能描述：

獲取系統(tǒng)代碼的描述

參數(shù)：

$CODE_NO〃系統(tǒng)代碼的代碼值，如果多個代碼則用英文逗號串起來

$PARENT_NO〃父類型代碼值

返回值：

對應(yīng)代碼值的文字描述

示例代碼：

echoget_code_name('0','SMS_REMIND');〃輸出“個人短信”

echoget_code_name('0,1'/SMS^REMIND');〃輸出“個人短信，公告通知

5.2.5dept_long_name

函數(shù)原型：

deptlongname($DEPT_ID)

功能描述：

獲取部門ID為$DEPT」D的多級部門名稱

參數(shù)：

$DEPT」D〃部門ID

返回值：

$DEPT」D對應(yīng)的部門長名稱，如“系統(tǒng)處/0A開發(fā)組”

5.2.6get_sys_para

函數(shù)原型：

get_sys_para($PARA_NAME_STR,$USE_CACHE=true)

功能描述：

獲取系統(tǒng)參數(shù)設(shè)置的參數(shù)值并返回一個數(shù)組

參數(shù)：

$PARA_NAME_STR〃系統(tǒng)參數(shù)名稱字符串，多個的話用英文逗號隔開

$USE_CACHE〃是否從緩存中獲取

返回值：

系統(tǒng)參數(shù)值的數(shù)組

代碼示例：

$PARA_ARRAY=get_sys_paraCMENU_DISPLAY,MENU_EXPAND_SINGLE");

$PARA_ARRAYarray("MENU_DISPLAY"=>T,"MENU_EXPAND_SINGLE"=>"0");

5.2.7set_sys_para

函數(shù)原型：

setsyspara($PARA_ARRAY)

功能描述：

批量設(shè)置系統(tǒng)參數(shù)

參數(shù)：

$PARA_ARRAY//系統(tǒng)參數(shù)數(shù)組，數(shù)組鍵值為參數(shù)名，如array("MENU_DISPLAY"=>"1")

返回值：

無

5.3utility_org.php

5.3.1is_dept_parent

函數(shù)原型：

isdeptparent($DEPT_ID,$PARENT_ID)

功能描述：

判斷一個部門是否是另外一個部門的上級部門

參數(shù)：

$DEPT」D〃要判斷的部門ID

$PARENT_ID〃上級部門ID

返回值:

是則返回true,否則返回falseo

5.3.2top_dept

函數(shù)原型：

top_dept($DEPT_ID)

功能描述：

獲取部門ID為$DEPT」D的部門的最上級部門的IDo

參數(shù)：

$DEPT_ID〃部門ID

返回值：

最上級部門的ID。

5.3.3GetDeptNameByld

函數(shù)原型：

GetDeptNameByld($ID_STR)

功能描述：

獲取N個部門的部門名稱。

參數(shù)：

$ID_STR&N個部門的ID,用逗號串起來，如“1,2,”

返回值：

N個部門名稱字符串，用逗號串起來，如“系統(tǒng)部,0A開發(fā)組”。

5.3.4GetPrivNameByld

函數(shù)原型：

GetPrivNameByld($ID_STR)

功能描述：

獲取N個角色的角色名稱。

參數(shù)：

$ID_STR//N個角色的ID,用逗號串起來，如“1,2,”

返回值：

N個角色名稱字符串，用逗號串起來，如“0A管理員，職員”。

5.3.5GetUserNameByld

函數(shù)原型：

GetUserNameByld($ID_STR)

功能描述：

獲取N個用戶的用戶姓名。

參數(shù)：

$ID_STR〃N個用戶的用戶名，用逗號串起來，如“admin,Iqh,”

返回值：

N個用戶的真實姓名字符串，用逗號串起來，如“系統(tǒng)管理員，劉清華”。

5.3.6GetUserNameByUid

函數(shù)原型：

GetUserNameByUid($ID_STR)

功能描述：

獲取N個用戶的用戶姓名。

參數(shù)：

$ID_STR〃Nj用戶的數(shù)字，用逗號串起來，如“1,2,”

返回值：

N個用戶的真實姓名字符串，用逗號串起來，如“系統(tǒng)管理員，劉清華”。

5.3.7my_exclude_uid

函數(shù)原型：

myexcludeuid()

功能描述：

獲取當(dāng)前用戶不能與之通訊的用戶的數(shù)字ID(UID)?

參數(shù):

無

返回值：

當(dāng)前用戶不能與之通訊的用戶的數(shù)字ID(UID)O

5.3.8GetUnionSetOfChildDeptld

函數(shù)原型：

GetUnionSetOfChildDeptld($DEPT_ID_STR)

功能描述：

獲得下級部門的并集。

參數(shù)：

$DEPT_ID_STR〃部門ID的字符串

返回值：

查詢部門的下級部門ID的并集

5.3.9GetfunmenuByuserlD

函數(shù)原型：

GetfunmenuByuserlD($USER_ID)

功能描述：

獲取用戶擁有的菜單權(quán)限。

參數(shù)：

$USER_ID〃用戶的USER_ID

返回值：

有權(quán)限的菜單ID的集合

5.3.10is_module_manager

函數(shù)原型：

is_module_manager($module_id)

功能描述：

判斷當(dāng)前用戶是否有指定模塊的管理員角色。

參數(shù):

$module_id〃指定功能模塊代號

1-email,2-diary,3-notify,4-knowledge,5-hr,6-workflow

返回值：

True或false

5.3.11set_priv_menu_priv

函數(shù)原型：

set_priv_menu_priv($priv_id_str,$user_id_str="")

功能描述：

菜單權(quán)限設(shè)置，設(shè)置角色菜單權(quán)限時更新usejfunction表中菜單權(quán)限信息，批量修改用

戶輔助角色時也更新。

參數(shù)：

$priv_id_str〃設(shè)置菜單的角色id串

$user_id_str〃設(shè)置菜單的用戶名串

返回值：

無

5.3.12set_uid_menu_priv

函數(shù)原型：

set_uid_menu_priv($uid,$user_id,$priv_id_str)

功能描述：

新建/修改用戶時角色變動時更新菜單權(quán)限設(shè)置user_function

參數(shù)：

$uid〃用戶uid

$user_id//用戶user_id

$priv_id_str〃用戶角色id與輔助角色id合集串

返回值：

無

5.3.12del_user_menu_priv

函數(shù)原型：

del_user_menu_priv($user_id_str)

功能描述：

刪除用戶時刪除菜單權(quán)限設(shè)置usejfunction表中對應(yīng)數(shù)據(jù)

參數(shù)：

$user_id_str〃刪除的用戶名串

返回值：

無

5.3.13GetUidByOther

函數(shù)原型：

GetUidByOther($user_id_str=，，/z,$priv_id_str=",$dept_id_str=")

功能描述：

根據(jù)用戶名串/角色ID串/部門ID串獲取對應(yīng)UID

參數(shù):

$user_id_str〃用戶user_id串

$priv_id_str〃用戶角色id與輔助角色id合集串

$dept_id_str〃用戶部門id與輔助部門id合集串

返回值：

對應(yīng)的用戶uid串

5.4utility_sms1.php

5.4.1send_sms

函數(shù)原型:

send_sms($SEND_TIME,$FR0M_ID,$T0」D,$SMS_TYPE,$C0NTENT,$REMIND_URL=")

功能描述:

發(fā)送內(nèi)部短消息。

參數(shù):

$SEND_TIME〃發(fā)送時間字符串，如“2013T1-2009:00:00”

$FR0M_ID〃發(fā)送人用戶名，如“admin”

$T0_ID〃接收人用戶名用逗號串起來的字符串，如“Iqh,Ixq”

$SMS_TYPE〃短信類型代碼，參考系統(tǒng)代碼設(shè)置下的“內(nèi)部短消息類型”

$C0NTENT〃短信內(nèi)容

$REMINDJRL〃點擊短信提醒彈出窗口的“查看詳情”打開的地址

返回值：

無

5.4.2delete_sms

函數(shù)原型：

delete_sms($SMS_ID_STR,$DEL_TYPE)

功能描述：

刪除內(nèi)部短消息。

參數(shù)：

$SMS_ID_STR〃要刪除的短信ID串，用逗號串起來，如“1,2,3”

$DEL_TYPE//DEL_TYPE=1刪除收到的短信，DEL_TYPE=2刪除發(fā)送的短信

返回值：

無

5.5utility_sms2.php

5.5.1send_mobile_sms_user

函數(shù)原型：

send_mobile_sms_user($SEND_TIME,$FROM_ID,$TO_ID,$CONTENT,$TYPE)

功能描述：

給OA用戶發(fā)送手機短信。

參數(shù)：

$SEND_TIME〃發(fā)送時間字符串，如“2013T1-2009:00:00”

$FROM_ID〃發(fā)送人用戶名，如“admin”

$TO_ID〃接收人用戶名用逗號串起來的字符串，如“Iqh,Ixq”

SCONTENT〃短信內(nèi)容

STYPE〃短信類型代碼，參考系統(tǒng)代碼設(shè)置下的“內(nèi)部短消息類型”

返回值：

無

5.5.2send_mobile_sms

函數(shù)原型：

send_mobile_sms($SEND_TIME,$FROM_ID,$PHONE,$CONTENT)

功能描述：

向指定號碼發(fā)送手機短信。

參數(shù)：

$SEND_TIME〃發(fā)送時間字符串，如“2013T1-2009:00:00”

$FR0M_ID〃發(fā)送人用戶名，如“admin”

$PH0NE〃接收手機號碼字符串，如"138xxxxxxxx,139xxxxxxxx”

SCONTENT〃短信內(nèi)容

返回值：

無

5.6utility_file.php

5.6.1upload

函數(shù)原型：

upload($PREFIX=Z/ATTACHMENT',$MODULE=",$OUTPUT=true)

功能描述：

上傳附件，可以一次上傳多個附件。

參數(shù)：

$PREFIX〃表單File控件名稱的前綴，一般為默認(rèn)即可

SMODULE〃模塊代碼，如內(nèi)部郵件為email,為空則根據(jù)程序路徑自動判斷

$OUTPUT〃參數(shù)判斷

返回值：

無

5.6.2delete_attach

函數(shù)原型：

delete_attach($ATTACHMENT_ID,$ATTACHMENT_NAME,$MODULE=”")

功能描述：

刪除附件，可以一次刪除多個附件。

參數(shù)：

$ATTACHMENT_ID〃附件ID,多個附件ID用逗號隔開

$ATTACHMENT_NAME〃附件名稱，多個附件名稱用*號隔開

SMODULE〃模塊代碼，如內(nèi)部郵件為email,為空則根據(jù)程序路徑自動判斷斷

返回值：

無

5.6.3attach_size

函數(shù)原型：

attach_size($ATTACHMENT_ID,$ATTACHMENT_NAME,$MODULE=")

功能描述：

獲取附件大小。

參數(shù)：

$ATTACHMENT_ID〃附件ID

$ATTACHMENT_NAME〃附件名稱

SMODULE〃模塊代碼，如內(nèi)部郵件為email,為空則根據(jù)程序路徑自動判斷斷

返回值：

附件大小，單位字節(jié)。

5.6.4copy_attach

函數(shù)原型：

copy_attach($ATTACHMENT_ID,$ATTACHMENT_NAME,$MODULE_SRC=，Z，/,$MODULE_DESC=/，Z，,

$ID_IS_REAL=true)

功能描述：

拷貝一個或多個附件。

參數(shù)：

$ATTACHMENT_ID〃附件ID,多個附件ID用逗號隔開

$ATTACHMENT_NAME〃附件名稱，多個附件名稱用*號隔開

$MODULE_SRC〃原附件所屬模塊代碼，為空則根據(jù)程序路徑自動判斷斷

$MODULE_DESC〃新附件所屬模塊代碼，為空則根據(jù)程序路徑自動判斷斷

$ID_IS_REAL//$ATTACHMENT_ID是文件的真實ID,還是attach_id_decode過之后

的，數(shù)據(jù)庫中存的一般是真實的

返回值：

新附件的附件ID串，多個附件的話用逗號隔開。

5.6.5is_uploadable

函數(shù)原型：

isuploadable($FILE_NAME)

功能描述：

根據(jù)附件名稱判斷該類型的文件是否允許上傳。

參數(shù)：

$FILE_NAME〃要判斷的文件名

返回值：

允許上傳則返回true,否則返回false。

5.6.6is_text

函數(shù)原型：

is_text($FILE_NAME)

功能描述：

根據(jù)附件名稱判斷該類型的文件是否是文本文件。

參數(shù)：

$FILE_NAME〃要判斷的文件名

返回值：

是文本文件則返回true,否則返回falseo

5.6.7is_office

函數(shù)原型：

is_office($FILE_NAME)

功能描述：

根據(jù)附件名稱判斷該類型的文件是否是Office文檔。

參數(shù)：

$FILE_NAME〃要判斷的文件名

返回值：

是Office文檔則返回true,否則返回false。

5.6.8is_imag