OA協(xié)同外部XML報(bào)表接口

外部XML報(bào)表接口

將非本OA系統(tǒng)的報(bào)表按照本文規(guī)定的格式存成XML文件，系統(tǒng)去讀取這些xml格式文件并在泛普OA系統(tǒng)系統(tǒng)展現(xiàn)出來，并可以在系統(tǒng)中通過權(quán)限設(shè)置為人員分配報(bào)表查看權(quán)限。

1 功能配置

配置WEB-INF/prop/xmlreport.properties
a.         配置OA報(bào)表存放地址
#文件存放地址，最后必須加“/”
report.url=ftp://泛普OA系統(tǒng):1@192.168.0.205/
#report.url=http://127.0.0.1/filesystem/test/
FTP：需要提供完整的URL地址及用戶名密碼
HTTP：提供完整的URL地址
b.         配置報(bào)表名稱及參數(shù)
#報(bào)表名稱，以“,”號分隔
report.names=生產(chǎn)日報(bào)表，開發(fā)周報(bào)表，綜合年報(bào)
#報(bào)表文件前綴
report.files=DD_,MM_,YY_
#D:按日期；M:按月份；Y:按年份
report.gettime=D,M,Y
names,files,gettime三個配置項(xiàng)必須同時使用，且三個參數(shù)的值必須同樣多。
如：生產(chǎn)日報(bào)表對應(yīng)的XML文件前綴為“DD_”，并且該報(bào)表是以每日顯示gettime的方式是“D”，按日期。
gettime的說明：
D：報(bào)表以files中的前綴加YYYY-MM-DD形式的格式命名，如DD_2008-12-31.xml
M：報(bào)表以files中的前綴加YYYY-MM形式的格式命名，如MM_2008-12.xml
Y：報(bào)表以files中的前綴加YYYY形式的格式命名，如YY_2008.xml
c.         查詢報(bào)表的年數(shù)
#顯示報(bào)表年數(shù)
report.years=10
該參數(shù)表示查詢時顯示的年數(shù)。即報(bào)表?xiàng)l件中的報(bào)表年份，如（圖1-1）所示。

（圖1-1）
泛普OA系統(tǒng)完整的配置示例如下：
#設(shè)置是否啟用此功能 0:不啟用 1:啟用
report.status=1
#文件存放地址,最后必須加"/"
report.url=ftp://泛普OA系統(tǒng):1@192.168.0.205/
#report.url=http://127.0.0.1/filesystem/test/
#文件前輟,以","號分隔，以":"號后數(shù)字指定報(bào)表類型
report.names=生產(chǎn)日報(bào)表,開發(fā)周報(bào)表,工作月報(bào),生產(chǎn)季報(bào),工作總結(jié)半年報(bào),綜合年報(bào)
#報(bào)表前綴
report.files=DD_,YYYY-MM_,YYYY-MM_,YYYY-S_,YYYY-Y_,YYYY_
#D:按日期;M:按月份;Y:按年份
report.gettime=D,M,M,Y,Y,Y
#顯示報(bào)表年數(shù)
report.years=10

2 泛普協(xié)同軟件報(bào)表文件格式

XML格式體定義如下：

名稱	必須	屬性值	類型	描述
ResultSet	Y	VALUE	String	報(bào)表體，屬性VALUE存報(bào)表編號或日期
Record[]	Y			報(bào)表內(nèi)容，第一個體定義報(bào)表的名稱及報(bào)表列等屬性
TableName	Y	VALUE	String	報(bào)表的名稱
List	Y	VALUE	String	報(bào)表列定義，以“,”分隔
ListName	Y	VALUE	String	報(bào)表列名稱，以“,”分隔

XML報(bào)表格式如下：
<?xml version="1.0" encoding="GBK" ?>
<!—ResultSet中VALUE放置的是報(bào)表的日期或編號-->
<ResultSet VALUE="SC_2009-01-04">
           <Record>
           
                 <TableName VALUE="XX有限公司生產(chǎn)日報(bào)表" />

                 <List VALUE="V1,V2,V3,V4" />

                 <ListName VALUE="項(xiàng)目,單位,本月計(jì)劃,本日計(jì)劃" />
         </Record>

<Record>
                 <V1 VALUE="工業(yè)總產(chǎn)值 " />
                 <V2 VALUE="萬元" />
                 <V3 VALUE="7985.60" />
                 <V4 VALUE="601.06" />
</Record>
…
</ResultSet>

3 泛普OA辦公報(bào)表配置權(quán)限

每個報(bào)表都需要設(shè)置共享權(quán)限，共享的設(shè)置權(quán)限由角色中配置。
角色設(shè)置：
1．選擇【設(shè)置中心】→【權(quán)限管理】→【角色設(shè)置】菜單，進(jìn)入（圖3-1）所示頁面；

（圖3-1）
2．此時，可以右鍵菜單中點(diǎn)擊“新建”新建角色，也可以點(diǎn)擊已有角色名稱編輯角色。在（圖3-1）所示頁面中點(diǎn)擊“功能權(quán)限”鏈接，打開（圖3-2）所示頁面，點(diǎn)擊“加入”按鈕，在如（圖3-3）所示頁面中勾選“外部XML報(bào)表權(quán)限”，右鍵菜單中點(diǎn)擊“保存”；

（圖3-2）

（圖3-3）
3．在（圖3-1）所示頁面中點(diǎn)擊“成員”對應(yīng)的數(shù)字鏈接，打開（圖3-4）所示頁面，點(diǎn)擊“加入”按鈕，在如（圖3-5）所示頁面中選擇人員，右鍵菜單中點(diǎn)擊“保存”；

（圖3-4）

（圖3-5）