第三方接口主要用来针对平台的流程信息,可以方便和第三方进行对接
工作流集成第三方接口
当有待办产生或者待办变成已办时,会触发改接口的调用。
1、在系统后台->系统管理->系统参数->第三方接口 中进行设置,如下图:
2、第三方接口示例
/// <summary>
/// 工作流集成第三方接口
/// </summary>
/// <returns></returns>
[HttpPost()]
public bool DoTheThirdFlowMessage([FromBody] TheThirdFlowRequest request)
{
if (request.Type == "add")
{
//新增待办
}
else if (request.Type == "remove")
{
//待办变已办
}
return true;
}
3、接口入参 TheThirdFlowRequest 类的定义
public class TheThirdFlowRequest
{
/// <summary>
/// 用户消息
///
/// </summary>
public UserInfo UserInfo { get; set; }
/// <summary>
/// 流程workitemId
/// </summary>
public string WorkItemId { get; set; }
/// <summary>
/// 模块code
/// </summary>
public string WorkflowCode { get; set; }
/// <summary>
/// 表名
/// </summary>
public string TableName { get; set; }
/// <summary>
/// 数据id
/// </summary>
public string DataId { get; set; }
/// <summary>
/// 待办类型
/// </summary>
public string Type { get; set; }
}
public class UserInfo
{
public string UserId { get; set; }
public string UserCode { get; set; }
public string UserName { get; set; }
public string Mobile { get; set; }
}
- UserInfo:接收待办的人员信息,如存在多个待办人,会遍历进行该接口的调用
- TableName:业务表的表名,根据 DataId 和表名可以进行业务数据的查询
- DataId:当前操作的业务数据的主键 ID
- Type:待办类型,有 add 和 remove 两个值
- add :新增待办
- remove:待办变已办
- WorkflowCode:流程 Code 和功能模块 Code 是一致的,访问功能列表,URL 最后的参数为功能模块 Code ,如下图:
当 A 提交流程到 B 审批,这时 DoTheThirdFlowMessage 接口会被调用两次: