webservice接口说明文档

webservice接口说明文档 webservice 1、 组织结构 – 部门原始资料增加 （一般用在初始化数据时） ..................................... 2 2、 组织结构 – 部门原始资料更新（紧跟 DptAdd 函数执行） .................................. 2 3、 组织结构 – 部门删除 ....................................................................................................... 2 4、 组织结构 – 部门更新 ....................................................................................................... 3 5、 组织结构 –单个部门增加 ................................................................................................. 3 6、 组织结构 – 员工原始资料更新（将服务器临时里的员工原始资料导入到使用的数 据表里）........................................................................................................................................... 4 7、 组织结构 –员工原始资料添加 ......................................................................................... 4 8、 组织结构 – 人员删除 ....................................................................................................... 5 9、 组织结构 – 人员增加（直接更新到后台数据库） ....................................................... 5 10、 组织结构 – 人员更新 ................................................................................................... 6 11、 OA调用发消息 ...................................................................................................................... 7 12、 组织结构 –增加企业 ..................................................................................................... 8 13、 组织结构 –编辑企业 ..................................................................................................... 8 14、 删除企业 ........................................................................................................................... 9 15、 企业、部门、员工查询 ................................................................................................... 9 16、 角色权限增加 ................................................................................................................. 10 17、 角色权限编辑 ................................................................................................................. 10 18、 角色权限删除 ................................................................................................................. 11 所有函数的CRC值默认 为calling 1 方法名称DptAdd (String DepartID, String DepartName, String ParentID,, String EID,String CRC) 参数说明： 参数名称 取值类型 允许为空 说明 备注 DepartID String 否 部门id 部门编号 DepartName String 否 部门名称 部门名称 ParentID String 是 上级部门编号 父部门编号，没有父部门则 为空 EID String 否 所在企业 企业唯一标识 CRC String 否 扩展参数 返回类型: Integer 返回值说明 ： -1 缺少必填参数，0 增加成功，1 增加数据发生未知错误，2 企业不 存在 -2 数据库连接错误 2 DptAdd 方法名称 DptAddExe (String EID，String CRC，) 参数说明： 参数名称 取值类型 允许为空 说明 备注 EID String 否 企业ID 企业ID CRC String 否 扩展参数 返回类型: Integer 返回值说明 ： -1 缺少必填参数，0 操作成功，1 更新数据时发生错误，2 企业不存在 －2 数据库连接错误 3 方法名称 DptDelete (String DepartID) 参数说明： 参数名称 取值类型 允许为空 说明 备注 DepartID String 否 部门id 部门编号 EID String 否 企业ID 企业ID CRC String 否 扩展参数 返回类型: Integer 返回值说明 ： -1 缺少必填参数，0 删除成功，1 删除数据发生未知错误，2 部门不存在，3企业不存在 －2 数据库连接错误 4 方法名称: DptEdit (String DepartID,String DepartName,String ParentID, String EID, String CRC) 参数说明： 参数名称 取值类型 允许为空 说明 备注 DepartID String 否 部门ID 部门id DepartName String 是 部门名称 部门名称 ParentID String 是 父部门ID 父部门编号，没有父部门 则为空 EID String 否 所在企业ID CRC String 否 扩展参数 返回类型: Integer 返回值说明 ： -1 缺少必填参数，0 编辑成功，1 删除数据发生未知错误，2部门不存在，3父部门不存在 ，4 没有要修改的项目 ，5 企业不存在 －2 数据库连接错误 5 方法名称: DptAddOne (String DepartID,String DepartName,String ParentID,, String EID, String CRC) 参数说明： 参数名称 取值类允许为空 说明 备注 型 DepartID String 否 部门ID 部门id DepartName String 否 部门名称 部门名称 ParentID String 是 父部门ID 父部门编号，没有父部门 则为空 EID String 否 所在企业ID CRC String 否 扩展参数 返回类型: Integer 返回值说明 ： -1 缺少必填参数，0 增加成功，1 增加数据发生未知错误，2父部门不存在 ，3 企业不存在 4 部门已经存在 －2 数据库连接错误 6、 （将服务器临时表里的员工原始资料导入到使用的数 据表里） 方法名称EmpAddExe (String EID，String CRC) 参数说明： 参数名称 取值类型 允许为空 说明 备注 EID String 否 企业ID 企业ID CRC String 否 扩展参数 返回类型: Integer 返回值说明 ： -1 缺少必填参数，0 操作成功，1 更新数据时发生错误，2 企业不存在 －2 数据库连接错误 7 （将人员资料插入一条到服务器上的临时表里，一般用在起初数据初始化的时候，将记录先循环 插入到临时表里，然后使用 DptAddExe 函数更新临时表，将原始人员资料导入到使用的数据表里） 方法名称 (String ID, String CorporationId, String DepartmentId, String duty, String email, String mobile, String realName , String sex, String workCode, String password, String telphone, String String Fax, String CodeType, String CRC) 参数说明： 参数名称 取值类型 允许为空 说明 备注 ID String 否 用户ID EID String 否 企业ID DepartID String 否 部门ID duty String 是 职务 email String 是 电子邮件 mobile String 是 手机 排序字段如果为空，会 自动从数据库中取最大 的值加１ realName String 否 真实姓名 企业唯一标识,为空,当 前企业 sex String 否 性别 0 为女，1为男，2为未 知 workCode String 否 登陆名称 客户端的登陆名称，一 般为工号 password String 否 登陆密码 telphone String 是 办公室电话 Fax String 是 办公室传真 CodeType String 是 密码加密 如果为1 的话password 使用MD5 加密 CRC String 否 扩展字段 返回类型: Integer 返回值说明 ： -1 缺少必填参数，0 增加成功，1 增加数据发生未知错误，－2 数据库连接错误 2 部门不存在 3 员工已存在 4 企业不存在 8 方法名称 (String ID, String EID,String CRC) 参数说明： 参数名称 取值类型 允许为空 说明 备注 ID String 否 员工ID EID String 否 企业ID CRC String 否 扩展字段 返回类型: Integer 返回值说明 ： -1 缺少必填参数，0 删除成功，1 删除数据发生未知错误，2 员工不存在 3 企业不存在 －2 数据库连接错误 9 方法名称 (String ID, String CorporationId, String DepartmentId, String duty, String email, String mobile, String realName , String sex, String workCode, String password, String telphone, String String Fax, String CodeType, String CRC) 参数说明： 参数名称 取值类型 允许为空 说明 备注 ID String 否 用户ID EID String 否 企业ID DepartID String 否 部门ID duty String 是 职务 email String 是 电子邮件 mobile String 是 手机号码 realName String 否 真实姓名 sex String 否 性别 0 为女，1为男，2为未 知 workCode String 否 登陆名称 客户端的登陆名称，一 般为工号 password String 否 登陆密码 telphone String 是 办公室电话 Fax String 是 办公室传真 CodeType String 是 密码加密 如果为1 的话password 使用MD5 加密 CRC String 否 扩展字段 返回类型: Integer 返回值说明 ： -1 缺少必填参数，0 增加成功，1 增加数据发生未知错误，2部门不存在，3员工已经存在，4 企业不存在 －2 数据库连接错误 10 方法名称 (String ID, String EID, String DepartID, String duty, String email, String mobile, String realName , String sex, String workCode, String password, String telphone, String String Fax,String CodeType, String CRC，String State) 参数说明： 参数名称 取值类型 允许为空 说明 备注 ID String 否 用户ID EID String 否 企业ID DepartID String 否 部门ID duty String 是 职务 email String 是 电子邮件 mobile String 是 手机 realName String 是 真实姓名 sex String 是 性别 0 为女，1为男，2为未 知 workCode String 是 登陆名称 客户端的登陆名称，一 般为工号 password String 是 登陆密码 telphone String 是 办公室电话 Fax String 是 办公室传真 CodeType String 是 密码加密 如果为1 的话password 使用MD5 加密 CRC String 否 扩展字段 RoleName String 是 角色名称 返回类型: Integer 返回值说明 ： -1 缺少必填参数，0 增加成功，1 增加数据发生未知错误，2部门不存在 3 员工不存在 4 企业不存在 －2 数据库连接错误 ５ 没有需要修改的项目 6 角色不存在 注释：如果许可为空的字段想变化为空的话，以空格为参数值，password，workCode，realName，sex 的修改不能 以空格表示为空，因为这２个字段不许可为空，如果参数为空则不会修改 11 方法名称：SendOAMessage(String Sender, String Receiver,String BContent, String Title, String MessageType ,String MessageImport, String EID, String CRC) 参数名称 取值类型 允许为空 说明 备注 Sender String 否 发送者用户名称 发送者ID Receiver String 否 接收者用户名称 接收者ID，多个接受者用”,”分 隔 ，如果为空则表示全体人员接受 BContent String 否 消息 Title String 否 消息标 MessageType String 否 消息类型 0 代表系统消息 １ 代表系统广 播消息 2-20代表OA 消息 21~100 是其它消息 ERP/CRM等 MessageImport String 否 消息重要性 1 表示最重要 2 表示中级重要 3 表示次重要 EID String 否 企业ID CRC String 否 扩展参数 返回类型: integer 返回结果： 0 成功，1 失败 ，-1 缺少必填参数，2 企业不存在，3发送者不存在，4接受者有不存在， 5 网络错误 －2 数据库连接错误 12 方法名称： CorpAdd（String EID,String brief， String address, String email, String fax, String fullName,String CRC） 参数说明： 参数名称 取值类型 允许为空 说明 备注 EID String 否 企业ID brief String 否 公司名称 address String 是 公司地址 email String 是 公司电子邮件 fax String 是 公司传真 fullName String 是 公司全称 CRC String 否 扩展参数 返回类型: Integer 返回值说明 ： -1 缺少必填参数，0 增加成功，1 增加数据发生未知错误，2 输入的公司人数超过了系统的许可， 3 企业ＩＤ已经存在 －2 数据库连接错误 13 方法名称： CorpEdit（String EID, String brief,String address, String email, String fax, String fullName,String CRC） 参数说明： 参数名称 取值类型 允许为空 说明 备注 EID String 否 企业ID 企业ID brief String 是 公司名称 address String 是 公司地址 email String 是 公司电子邮件 fax String 是 公司传真 fullName String 是 公司全称 CRC String 否 扩展参数 默认保留为空 返回类型: Integer 返回值说明 ： -1 缺少必填参数，0 操作成功，1 删除数据时发生错误 ，2企业不存在 3 没有要编辑的项目 －2 数据库连接错误 注释：如果许可为空的字段想变化为空的话，以空格为参数值，对于brief，不修改则为空，如果为空则不修改 14 方法名称： CorpDelete (String EID,String CRC) 参数说明： 参数名称 取值类型 允许为空 说明 备注 EID String 否 企业ID 企业ID CRC String 否 扩展参数 默认保留为空 返回类型: Integer 返回值说明 ： -1 缺少必填参数，0 操作成功，1 删除数据时发生错误，2 企业不存在 －2 数据库连接错误 15 方法名称： GetIDBool (String GetType,String EID，String ID, String CRC) 参数说明： 参数名称 取值类型 允许为空 说明 备注 GetType String 否 查询类型 １为企业2为部门3为 员工 EID String 否 企业ID ID String 是 或部门 或员工ID CRC String 否 扩展参数 返回类型: Integer 返回值说明 ： -1 缺少必填参数， 1 查询数据时发生错误，－2 数据库连接错误 －3 企业不存在 3 企业存在 -4 部门不存在 4 部门存在 -5 员工不存在 5 员工存在 6 查询 类型错误 注释：GetType 为１时 ID 可为空，否则 不许可为空，在部门和员工查询时，如果企 业不存在，则报部门或者员工不存在 16 方法名称 UserRole Add (String RoleName, String Rights ,String EID，String CRC，) 参数说明： 参数名称 取值类型 允许为空 说明 备注 EID String 否 企业ID RoleName String 否 角色名称 Rights String 否 权限 CRC String 否 扩展参数 返回类型: Integer 返回值说明 ： -1 缺少必填参数， 1 查询数据时发生错误，－2 数据库连接错误 2 企业不存在 3 角色已存在 ０ 成功 17 方法名称 UserRoleedit (String RoleName, String Rights ,String EID，String CRC，) 参数说明： 参数名称 取值类型 允许为空 说明 备注 EID String 否 企业ID RoleName String 否 角色名称 NewRoleName String 否 新角色名称 Rights String 否 权限 EditType String 否 修改类型 １为修改角色名称 ２ 为修改权限 ３为角色 名称、权限都修改 CRC String 否 扩展参数 返回类型: Integer 返回值说明 ： -1 缺少必填参数， 1 查询数据时发生错误，－2 数据库连接错误，2修改类型错误，３ 新角色名称不能为空 ，４ 企业不存在，５ 角色不存在 ０ 成功 18 方法名称 UserRoleDel (String RoleName, String EID，String CRC，) 参数说明： 参数名称 取值类型 允许为空 说明 备注 EID String 否 企业ID RoleName String 否 角色名称 CRC String 否 扩展参数 返回类型: Integer 返回值说明 ： -1 缺少必填参数， 1 查询数据时发生错误，－2 数据库连接错误 2 企 业不存在 ０ 成功