发布时间 : 星期日 文章用友NC-OA平台API参考手册更新完毕开始阅读22fb1ffb04a1b0717fd5dd18
用友NC-OA平台API参考手册
? 2006 UFida Co., Ltd. All rights reserved.
This document contains information that is proprietary and confidential to UFida., which shall not be disclosed outside the recipient's company or duplicated, used or disclosed in whole or in part by the recipient for any
purpose other than to evaluate this file. Any other use or disclosure in whole or in part of this information without the express written permission of Ufida. is prohibited.
Date: 2009-02-26 Author: Version:
王文友 V1.0
用友NC-OA平台API参考手册 ..................................................................1 修改记录 .................................................................................................6 1. 服务参考 ............................................................................................7
1.1 概述 ........................................................................................... 7
1.1.1 配置开发环境 .................................................................................................. 7 1.1.2 开始编码（Java）............................................................................................ 7
1.1.2.1
1.1.2.2
生成ADB Client Stub........................................................................... 7 编写客户端代码 .................................................................................... 7
1.1.3 开始编码（C#）.............................................................................................. 8
1.1.3.1 添加服务引用....................................................................................... 8 1.1.3.2 编写客户端代码 .................................................................................. 11 1.1.4 服务列表 ..................................................................................................... 11 1.1.5 服务公共实体 ................................................................................................ 12
1.1.5.1 服务响应实体（ServiceResponse） ....................................................... 12
1.1.5.2
服务异常（ServiceException）............................................................. 13
1.2 验证服务................................................................................ …..13
1.2.1 登录验证 ..................................................................................................... 13
1.2.1.1
1.2.1.2
身份验证令牌实体（UserToken） ........................................................... 13 身份验证 .......................................................................................... 13
1.3 组织模型管理 .............................................................................. 14
1.3.1 单位管理 ..................................................................................................... 14
1.3.1.1
取得单位ID ...................................................................................... 14
1.3.2 人员管理 ..................................................................................................... 15
1.3.2.1 人员实体（PersonInfoParam_All） ....................................................... 15 1.3.2.2 方法列表 .......................................................................................... 16 1.3.2.3 创建人员 .......................................................................................... 16
1.3.2.4 1.3.2.5 1.3.2.6 1.3.2.7 1.3.2.8 1.3.2.9 1.3.2.10
修改人员信息（按人员ID） ................................................................... 17 修改人员信息（按人员登录名） .............................................................. 18 删除人员(按人员ID) ........................................................................... 19 删除人员（按登录名） ......................................................................... 20 启用/停用人员(按人员ID) .................................................................... 21 启用/停用人员(按人员登录名)................................................................ 21 修改人员密码(按人员ID) ...................................................................... 22
1.3.2.11 修改人员密码(按人员登录名) ................................................................. 23
1.3.3 部门管理 ..................................................................................................... 23
1.3.3.1
1.3.3.2 1.3.3.3 1.3.3.4 1.3.3.5 1.3.3.6 1.3.3.7 1.3.3.8 1.3.3.9 1.3.3.10 1.3.3.11
部门实体 （DepartmentInfoParam_All） ................................................... 24 方法列表 .......................................................................................... 24 创建部门 .......................................................................................... 24 更新部门（按部门ID）......................................................................... 25 更新部门（按部门路径名称） ................................................................. 26 删除部门（按部门ID）......................................................................... 27 删除部门（按部门名称）....................................................................... 28 删除部门（按部门名称及父部门名称） ...................................................... 28 删除部门（按部门路径名称） ................................................................. 28 启用/禁用部门（按部门ID）.................................................................. 29 启用/禁用部门（按部门名称）................................................................ 30
1.3.3.12 1.3.3.13 1.3.3.14 1.3.3.15
启用/禁用部门（按部门名称及父部门名称） ............................................... 30 启用/禁用部门（按部门路径名称） .......................................................... 31 移动部门（按部门ID）......................................................................... 32 移动部门（按部门名称）....................................................................... 32
1.3.4 岗位管理 ..................................................................................................... 33
1.3.4.1 岗位实体 （OcupationInfoParam_A8_All） ................................................ 33
1.3.4.2 1.3.4.3 1.3.4.4 1.3.4.5 1.3.4.6 1.3.4.7
方法列表 .......................................................................................... 33 创建岗位 .......................................................................................... 33 更新岗位（按岗位ID）......................................................................... 34 更新岗位（按岗位名称）....................................................................... 35 删除岗位（按岗位ID）......................................................................... 36 删除岗位（按岗位名称）....................................................................... 36
1.3.4.8 启用/禁用岗位（按岗位ID）.................................................................. 37
1.3.4.9 启用/禁用岗位（按岗位名称）................................................................ 38 1.3.5 职务级别管理 ................................................................................................ 39
1.3.5.1
1.3.5.2 1.3.5.3 1.3.5.4 1.3.5.5 1.3.5.6 1.3.5.7 1.3.5.8 1.3.5.9
职务级别实体 （OtypeInfoParam_A8_All） ................................................ 39 方法列表 .......................................................................................... 39 创建职务级别..................................................................................... 39 更新职务级别（按职务级别ID） ............................................................. 40 更新职务级别（按职务级别名称） ........................................................... 41 删除职务级别（按职务级别ID） ............................................................. 42 删除职务级别（按职务级别名称） ........................................................... 43 启用/禁用职务级别（按职务级别ID） ...................................................... 43 启用/禁用职务级别（按职务级别名称） .................................................... 44
1.4 组织模型数据管理 ........................................................................ 45
1.4.1 方法列表 ..................................................................................................... 45
1.4.2 1.4.3 1.4.4 1.4.5 1.4.6 1.4.7
导出人员信息 ................................................................................................ 45 导出部门信息 ................................................................................................ 47 导出岗位信息 ................................................................................................ 49 导出职务级别信息 .................................................................... 错误！未定义书签。 导出组织模型信息 .................................................................... 错误！未定义书签。 导入组织模型信息 .................................................................... 错误！未定义书签。
1.5 文档导出.................................................................................... 54
1.5.1 方法列表 ..................................................................................................... 55 1.5.2 文档导出公共实体 .......................................................................................... 55
1.5.2.1
1.5.2.2 1.5.2.3 1.5.2.4 1.5.2.5 1.5.2.6
人员实体（PersonExport） .................................................................. 55 部门实体（DepartmentExport）........................................................... 55 岗位实体（OcupationExport） ............................................................. 55 职务级别实体（OTypeExport） ............................................................. 55 附件实体（AttachmentExport） ........................................................... 56 正文实体（TextExport）...................................................................... 56
1.5.2.7 HTML正文实体（TextHtmlExport） ...................................................... 56
1.5.2.8 附件正文实体（TextAttachmentExport）................................................ 56 1.5.3 协同导出 ..................................................................................................... 57
1.5.3.1
1.5.3.2
协同实体（FlowExport） ..................................................................... 57 协同正文补充实体（AdminicularExport）.................................................. 58
1.5.3.3 1.5.3.4 1.5.3.5 1.5.3.6 1.5.3.7 1.5.3.8 1.5.3.9
协同预归档实体（FolderExport） .......................................................... 58 协同节点实体（FlowNodeExport） ........................................................ 59 协同人员实体（NodeMemberExport） ................................................... 59 协同节点策略实体（NodeTacticsExport） ................................................ 60 协同回复信息实体（DocBbsExport） ...................................................... 60 协同关联协同实体（RelFlowExport）...................................................... 60 协同关联项目实体（ProjectExport） ...................................................... 60
1.5.4 公文导出 ..................................................................................................... 61
1.5.4.1 公文实体（DocumentExport） ............................................................. 61 1.5.4.2 公文单实体（DocumentFormExport） ................................................... 62 1.5.4.3 导出可离线查看的公文单....................................................................... 63 1.5.5 公文导入 ..................................................................................................... 65 1.5.6 回写公文状态 ................................................................................................ 66 1.5.7 新闻导出 ..................................................................................................... 67
1.5.7.1 新闻实体（NewsExport） .................................................................... 67 1.5.7.2 新闻类型实体（NewsTypeExport） ........................................................ 68 1.5.8 公告导出 ..................................................................................................... 68
1.5.8.1
1.5.8.2
公告实体（BulletinExport） ................................................................. 69 公告类型实体（BulletinTypeExport） ..................................................... 69
1.5.8.3 公告接收者实体（BulletinReceiverExport）............................................. 69
1.5.9 调查导出 ..................................................................................................... 70
1.5.9.1 1.5.9.2
1.5.9.3 1.5.9.4 1.5.9.5
调查实体（ResearchExport）............................................................... 70 调查题目实体（ResearchSubjectExport） .............................................. 71 调查评论实体（ResearchCommentExport） ........................................... 71 调查类型实体（ResearchTypeExport）................................................... 72 调查发布范围实体（ResearchTargetExport）........................................... 72
1.5.9.6 调查答案实体（AnswerExport）............................................................ 72
1.5.10 讨论导出 ................................................................................................ 72
1.5.10.1 讨论实体（BbsExport） ...................................................................... 73 1.5.10.2 讨论回复实体（BbsReplyExport） ......................................................... 74
1.5.10.3 1.5.10.4
讨论类型实体（BbsTypeExport） .......................................................... 74 讨论发布范围实体（BbsTargetExport） .................................................. 74
1.6 新闻和公告发布 ........................................................................... 75
1.6.1 方法列表 ..................................................................................................... 75 1.6.2 新闻发布 ..................................................................................................... 75
1.6.3
公告发布 ..................................................................................................... 76
1.7 表单管理.................................................................................... 77
1.7.1 方法列表 ..................................................................................................... 77
1.7.2 表单导出 ..................................................................................................... 77
1.7.2.1 表单实体（FormExport） .................................................................... 78
1.7.2.2 1.7.2.3 1.7.2.4 1.7.2.5
表单字段定义实体（DefinitionExport） .............................................. 78 表单从表信息实体（SubordinateFormExport） ............................................ 79 表单数据值实体（ValueExport） ............................................................. 79 表单从表记录实体（RecordExport）......................................................... 79
1.8 BPM集成................................................................................... 79
BPM集成开发流程..................................................................................80