roadflow与第三方系统集成时(iframe或api方式),组织架构和人员采用第三方系统的数据时需要实现roadflow的方法。根据第三方系统的数据返回roadflow的组织架构实体。
只需要实现RoadFlow.Integrate下的Organize类下的方法即可(roadflow系统中需要调用组织架构的地方都会调用到这里的方法,如果组织架构不经常变动,可以考虑读取后缓存的方式提高性能):
得到系统所有用户,即返回系统所有人员。返回类型为:List<Model.User>,实体类中:Id,Name,Account,Password,Sex字段不能为空。
Id:如果您的用户ID是数字ID,则这里要转换为GUID。方法为:1.ToGuid(),转换为即为:00000000-0000-0000-0000-000000000001。如果要从GUID转换为数字,则调用方法: Guid.ToInteger();
Name:人员姓名。
Account:人员登录帐号。
Password:密码,系统中加密的密码原样返回。在处理流程需要签章时需要验证密码,所以要修改RoadFlow.WebApi项目中Areas/RoadFlowApi/Controllers/FlowRunController.cs下的ValidPass方法,根据自己的密码规则验证:
Sex:性别。
得到所有组织架构:即返回系统中的单位,岗位,部门。返回List<Model.Organize>实体类,Id,ParentId,Name,Type字段不能为空。
Id:如果您的系统是数字ID也需要转换为GUID。数字.ToGuid()
ParentId:上级ID,根的parentid为空guid。
Name:单位,部门,岗位名称。
Type:类型,1 单位 2 部门 3 岗位
组织架构与人员的关系表,返回类型:List<Model.OrganizeUser>,字段:Id,OrganizeId,UserId,IsMain,Sort。
Id:随机生成Guid。
OrganizeId:组织架构ID,单位,部门或岗位ID。
UserId:人员id。
IsMain:是否是主要架构(一个人员可以对应多个单位,部门,岗位,1表示主要架构,0表示兼任)。
Sort:排序。
得到所有工作组(其他系统也可能叫角色):返回List<Model.WorkGroup>,字段:Id,Name,Members,Note,Sort
Id:工作组ID。
Name:工作组名称。
Members:包含的成员(guid(单位,部门,岗位id),u_userid(u_人员ID))。
Note:备注。
Sort:排序。
如果第三方系统中组织架构更新了,要实时刷新RoadFlow中的组织架构,要通过第三方系统组织架构更新后调用RoadFlow提供的API来刷新组织架构数据。
以下所有API均为HttpGet方式。
得到token api:系统地址 + "/RoadFlowOpenApi/Token/GetRefreshOrgToken?code=自定设定的验证code
返回:{"success":true|false,"msg":"出错时的错误提示","token":"成功时返回的token","expire":"过期时间"}
刷新所有组织架构数据(包括单位部门,人员,工作组):系统地址 + "/RoadFlowOpenApi/Organize/ClearAllOrganize?token=前面一步得到的token&code=自定设定的验证code"
返回:{"success":true|false,"msg":"出错时的错误提示,成功时为:OK"}
刷新组织架构(单位部门):系统地址 + "/RoadFlowOpenApi/Organize/ClearOrganize?token=前面一步得到的token&code=自定设定的验证code"
返回:{"success":true|false,"msg":"出错时的错误提示,成功时为:OK"}
刷新人员:系统地址 + "/RoadFlowOpenApi/Organize/ClearUser?token=前面一步得到的token&code=自定设定的验证code"
返回:{"success":true|false,"msg":"出错时的错误提示,成功时为:OK"}
刷新工作组:系统地址 + "/RoadFlowOpenApi/Organize/ClearWorkgroup?token=前面一步得到的token&code=自定设定的验证code"
返回:{"success":true|false,"msg":"出错时的错误提示,成功时为:OK"}
示例代码:
联系QQ:493501010电话:136 0832 5512(微信同号)邮箱:road@roadflow.net
Copyright 2014 - 2024 重庆天知软件技术有限公司 版权所有
|