webservice接口说明文档.doc

webservice接口说明文档1、组织结构 部门原始资料增加 （一般用在初始化数据时）22、组织结构 部门原始资料更新（紧跟DptAdd函数执行）23、组织结构 部门删除24、组织结构 部门更新35、组织结构 单个部门增加36、组织结构 员工原始资料更新（将服务器临时表里的员工原始资料导入到使用的数据表里）47、组织结构 员工原始资料添加48、组织结构 人员删除59、组织结构 人员增加（直接更新到后台数据库）510、组织结构 人员更新611、OA调用发消息712、组织结构 增加企业813、组织结构 编辑企业814、删除企业915、企业、部门、员工查询916、角色权限增加1017、角色权限编辑1018、角色权限删除11注明：所有函数的CRC值默认为calling1、 组织结构 部门原始资料增加 （一般用在初始化数据时）方法名称DptAdd (String DepartID, String DepartName, String ParentID, String EID,String CRC)参数说明：参数名称取值类型允许为空说明备注DepartIDString否部门id部门编号DepartNameString否部门名称部门名称ParentIDString是上级部门编号父部门编号，没有父部门则为空EIDString否所在企业企业唯一标识CRCString否扩展参数返回类型: Integer返回值说明 ： -1 缺少必填参数，0 增加成功，1 增加数据发生未知错误，2 企业不存在 -2 数据库连接错误2、 组织结构 部门原始资料更新（紧跟DptAdd函数执行）方法名称DptAddExe (String EID，String CRC，)参数说明：参数名称取值类型允许为空说明备注EIDString否企业ID企业IDCRCString否扩展参数返回类型: Integer返回值说明 ： -1 缺少必填参数，0 操作成功，1 更新数据时发生错误，2 企业不存在2数据库连接错误3、 组织结构 部门删除方法名称 DptDelete (String DepartID)参数说明：参数名称取值类型允许为空说明备注DepartIDString否部门id部门编号EIDString否企业ID企业IDCRCString否扩展参数返回类型: Integer返回值说明 ： -1 缺少必填参数，0 删除成功，1 删除数据发生未知错误，2 部门不存在，3企业不存在2数据库连接错误4、 组织结构 部门更新方法名称: DptEdit (String DepartID,String DepartName,String ParentID, String EID, String CRC)参数说明：参数名称取值类型允许为空说明备注DepartIDString否部门ID部门idDepartNameString是部门名称部门名称ParentIDString是父部门ID父部门编号，没有父部门则为空EIDString否所在企业IDCRCString否扩展参数返回类型: Integer返回值说明 ： -1 缺少必填参数，0 编辑成功，1 删除数据发生未知错误，2部门不存在，3父部门不存在 ，4 没有要修改的项目 ，5企业不存在2数据库连接错误5、 组织结构 单个部门增加方法名称: DptAddOne (String DepartID,String DepartName,String ParentID, String EID, String CRC)参数说明：参数名称取值类型允许为空说明备注DepartIDString否部门ID部门idDepartNameString否部门名称部门名称ParentIDString是父部门ID父部门编号，没有父部门则为空EIDString否所在企业IDCRCString否扩展参数返回类型: Integer返回值说明 ： -1 缺少必填参数，0 增加成功，1 增加数据发生未知错误，2父部门不存在 ，3 企业不存在 4 部门已经存在2数据库连接错误6、 组织结构 员工原始资料更新（将服务器临时表里的员工原始资料导入到使用的数据表里）方法名称EmpAddExe (String EID，String CRC)参数说明：参数名称取值类型允许为空说明备注EIDString否企业ID企业IDCRCString否扩展参数返回类型: Integer返回值说明 ： -1 缺少必填参数，0 操作成功，1 更新数据时发生错误，2企业不存在2数据库连接错误7、 组织结构 员工原始资料添加 （将人员资料插入一条到服务器上的临时表里，一般用在起初数据初始化的时候，将记录先循环插入到临时表里，然后使用 DptAddExe 函数更新临时表，将原始人员资料导入到使用的数据表里）方法名称 EmpAdd(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)参数说明：参数名称取值类型允许为空说明备注IDString否用户IDEIDString否企业IDDepartIDString否部门IDdutyString 是职务emailString是电子邮件mobileString是手机排序字段如果为空，会自动从数据库中取最大的值加realNameString否真实姓名企业唯一标识,为空,当前企业sexString否性别0 为女，1为男，2为未知workCodeString否登陆名称客户端的登陆名称，一般为工号passwordString否登陆密码telphoneString是办公室电话FaxString是办公室传真CodeTypeString是密码加密如果为1 的话password使用MD5 加密CRCString否扩展字段返回类型: Integer返回值说明 ： -1 缺少必填参数，0 增加成功，1 增加数据发生未知错误，2数据库连接错误2 部门不存在 3 员工已存在 4 企业不存在8、 组织结构 人员删除方法名称 EmpDelete (String ID, String EID,String CRC)参数说明：参数名称取值类型允许为空说明备注IDString否员工IDEIDString否企业IDCRCString否扩展字段返回类型: Integer返回值说明 ： -1 缺少必填参数，0 删除成功，1 删除数据发生未知错误，2 员工不存在 3 企业不存在 2数据库连接错误9、 组织结构 人员增加（直接更新到后台数据库）方法名称 EmpAddOne (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)参数说明：参数名称取值类型允许为空说明备注IDString否用户IDEIDString否企业IDDepartIDString否部门IDdutyString 是职务emailString是电子邮件mobileString是手机号码realNameString否真实姓名sexString否性别0 为女，1为男，2为未知workCodeString否登陆名称客户端的登陆名称，一般为工号passwordString否登陆密码telphoneString是办公室电话FaxString是办公室传真CodeTypeString是密码加密如果为1 的话password 使用MD5 加密CRCString否扩展字段返回类型: Integer返回值说明 ： -1 缺少必填参数，0 增加成功，1 增加数据发生未知错误，2部门不存在，3员工已经存在，4 企业不存在 2数据库连接错误10、 组织结构 人员更新方法名称 EmpEdit (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)参数说明：参数名称取值类型允许为空说明备注IDString否用户IDEIDString否企业IDDepartIDString否部门IDdutyString 是职务emailString是电子邮件mobileString是手机realNameString是真实姓名sexString是性别0 为女，1为男，2为未知workCodeString是登陆名称客户端的登陆名称，一般为工号passwordString是登陆密码telphoneString是办公室电话FaxString是办公室传真CodeTypeString是密码加密如果为1 的话password使用MD5 加密CRCString否扩展字段RoleNameString是角色名称返回类型: Integer返回值说明 ： -1 缺少必填参数，0 增加成功，1 增加数据发生未知错误，2部门不存在 3 员工不存在 4 企业不存在2数据库连接错误没有需要修改的项目 6 角色不存在注释：如果许可为空的字段想变化为空的话，以空格为参数值，password，workCode，realName，sex的修改不能以空格表示为空，因为这个字段不许可为空，如果参数为空则不会修改11、 OA调用发消息方法名称：SendOAMessage(String Sender, String Receiver,String BContent,String Title, String MessageType ,String MessageImport, String EID, String CRC)参数名称取值类型允许为空说明备注SenderString否发送者用户名称发送者IDReceiverString否接收者用户名称接收者ID，多个接受者用”,”分隔 ，如果为空则表示全体人员接受BContentString否消息内容TitleString否消息标题MessageTypeString否消息类型0 代表系统消息 代表系统广播消息2-20代表OA 消息 21100 是其它消息ERP/CRM等MessageImportString否消息重要性1 表示最重要 2表示中级重要 3 表示次重要EIDString否企业IDCRCString否扩展参数返回类型: 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）参数说明：参数名称取值类型允许为空说明备注EIDString否企业IDbriefString否公司名称addressString是公司地址emailString是公司电子邮件faxString是公司传真fullNameString是公司全称CRCString否扩展参数返回类型: Integer返回值说明 ： -1 缺少必填参数，0 增加成功，1 增加数据发生未知错误，2 输入的公司人数超过了系统的许可， 3 企业已经存在2数据库连接错误13、 组织结构 编辑企业方法名称： CorpEdit（String EID, String brief,String address, String email, String fax, String fullName,String CRC）参数说明：参数名称取值类型允许为空说明备注EIDString否企业ID企业IDbriefString是公司名称addressString是公司地址emailString是公司电子邮件faxString是公司传真fullNameString是公司全称CRCString否扩展参数默认保留为空返回类型: Integer返回值说明 ： -1 缺少必填参数，0 操作成功，1 删除数据时发生错误，2企业不存在3 没有要编辑的项目2数据库连接错误注释：如果许可为空的字段想变化为空的话，以空格为参数值，对于brief，不修改则为空，如果为空则不修改14、 删除企业方法名称： CorpDelete (String EID,String CRC)参数说明：参数名称取值类型允许为空说明备注EIDString否企业ID企业IDCRCString否扩展参数默认保留为空返回类型: Integer返回值说明 ： -1 缺少必填参数，0 操作成功，1 删除数据时发生错误，2 企业不存在2数据库连接错误15、 企业、部门、员工查询方法名称： GetIDBool (String GetType,String EID，String ID, String CRC)参数说明：参数名称取值类型允许为空说明备注GetTypeString否查询类型为企业2为部门3为员工EIDString否企业IDIDString是或部门 或员工IDCRCString否扩展参数返回类型: Integer返回值说明 ： -1 缺少必填参数， 1 查询数据时发生错误，2 数据库连接错误3 企业不存在 3 企业存在 -4 部门不存在 4 部门存在 -5 员工不存在 5 员工存在6 查询类型错误注释：GetType为时ID可为空，否则不许可为空，在部门和员工查询时，如果企业不存在，则报部门或者员工不存在16、 角色权限增加 方法名称UserRole Add (String RoleName, String Rights ,String EID，Strin