XX集团OA软件需求

XX集团文档WebService接口说明文档

1.XX集团OA软件需求

门户需要取到我们的某一目录下文档的数量，需要判断：文档状态（正常、临时、审批等）

2.泛普OA配置

在web.xml检查是否有如下内容，否则应加入：

       <servlet>
           <servlet-name>XFireServlet</servlet-name>
              <display-name>XFire Servlet</display-name>
              <servlet-class>org.codehaus.xfire.transport.http.XFireConfigurableServlet</servlet-class>
</servlet>
<servlet-mapping>
              <servlet-name>XFireServlet</servlet-name>
              <url-pattern>/services/*</url-pattern>
</servlet-mapping>

3.泛普OA办公自动化调用方法

3.1.wsdl

http://[泛普OA系统服务器ip:端口号]/services/DocService?wsdl

3.2.新增方法

3.2.1.获取指定目录指定文档状态的文档数量

public int getDocCountBySeccategory(int seccategoryid,String docstatus,String sessioncode) throws Exception;

参数说明：

参数	数据类型	说明
seccategoryid	int	文档子目录id
docstatus	String	文档状态 "":全部 0:草稿 1:生效/正常(不需要审批，归档重新打开) 2:生效/正常(审批后,发布后) 3:审批 4:退回(草稿) 5:归档 6:待发布 7:失效 8:作废 9:流程草稿
sessioncode	String	登陆Session码

返回值：

数据类型	说明
int	记录数

3.2.2.泛普企业OA获取指定目录指定文档状态的文档列表

public DocInfo[] getDocListBySeccategory(int seccategoryid,String docstatus,String sessioncode,int page,int size) throws Exception

参数说明：

参数	数据类型	说明
seccategoryid	int	文档子目录id
docstatus	String	文档状态 "":全部 0:草稿 1:生效/正常(不需要审批，归档重新打开) 2:生效/正常(审批后,发布后) 3:审批 4:退回(草稿) 5:归档 6:待发布 7:失效 8:作废 9:流程草稿
sessioncode	String	登陆Session码
page	int	页数
size	int	每页记录数

返回值：

数据类型	说明
DocInfo[]	文档数组

3.2.3.泛普办公自动化软件获取指定文档子目录下未阅读（有权限的）文档记录数

public int getDocNoReadCountBySeccategory(int seccategoryid,String startdate,String enddate,String sessioncode) throws Exception

参数说明：

参数	数据类型	说明
seccategoryid	int	文档子目录id
startdate	String	开始日期，可为空字符串
enddate	String	结束日期，可为空字符串
sessioncode	String	登陆Session码

返回值：

数据类型	说明
int	未阅读记录数 >=0:未阅读文档数量 -1:目录id异常 -2:日期格式异常

3.2.4.获取指定多个OA知识模块文档子目录指定多个文档状态的文档数量

public int getDocCountByMultiSeccategory (String seccategoryids,String docstatuses,String sessioncode) throws Exception;

参数说明：

参数	数据类型	说明
seccategoryids	String	文档子目录id串，子目录id间以,号分隔，如：81,82,83
docstatuses	String	文档状态 "":全部 0:草稿 1:生效/正常(不需要审批，归档重新打开) 2:生效/正常(审批后,发布后) 3:审批 4:退回(草稿) 5:归档 6:待发布 7:失效 8:作废 9:流程草稿多个文档状态时，文档状态以,号分隔，如：1,2
sessioncode	String	登陆Session码

返回值：

数据类型	说明
int	记录数

3.2.5.获取指定多个文档子目录指定多个文档状态的文档列表

public DocInfo[]getDocListByMultiSeccategory (String seccategoryids,String docstatuses,String sessioncode,int page,int size) throws Exception

参数说明：

参数	数据类型	说明
seccategoryids	String	文档子目录id串，子目录id间以,号分隔，如：81,82,83
docstatuses	String	文档状态 "":全部 0:草稿 1:生效/正常(不需要审批，归档重新打开) 2:生效/正常(审批后,发布后) 3:审批 4:退回(草稿) 5:归档 6:待发布 7:失效 8:作废 9:流程草稿多个文档状态时，文档状态以,号分隔，如：1,2
sessioncode	String	登陆Session码
page	int	页数，从1开始计数。0表示查询所有的记录。
size	int	每页记录数

返回值：

数据类型	说明
DocInfo[]	文档数组

3.2.6.获取指定多个文档子目录下未阅读（有权限的）文档记录数

public int getDocNoReadCountByMultiSeccategory (String seccategoryids,String startdate,String enddate,String sessioncode) throws Exception

参数说明：

参数	数据类型	说明
seccategoryids	String	文档子目录id串，子目录id间以,号分隔，如：81,82,83
startdate	String	开始日期，可为空字符串，日期格式如：2013-01-01
enddate	String	结束日期，可为空字符串，日期格式如：2013-12-31
sessioncode	String	登陆Session码