获取申请列表

用于获取单个用户发起的申请列表数据；

接口说明

请求URL：http[s]://{网关地址}/casp-tdc/processInstance/search

请求方式： POST

请求内容类型： application/json

响应内容类型： application/json

请求说明

请求体

字段名	参数名	必填	类型	描述
用户工号	userId	M	String(50)	用户工号
开始时间	startTime	O	String	开始时间（yyyy-MM-dd HH:mm:ss）
结束时间	endTime	O	String	结束时间（yyyy-MM-dd HH:mm:ss）
流程状态	status	O	String	RUNNING(正常运行) COMPLETE（正常结束） ABORT（强行中止） REPLY（待重新提交） DRAFT（草稿）
申请主题	subject	O	String(300)	申请主题
每页数据量	pageSize	O	integer	每页数据量（默认10）
页码	pageNumber	O	integer	页码（默认1）
多语言 3.5.5.Beta2+	langCountry	O	String	多语言

请求示例

{
    "userId":"test-gh",
    "startTime":"2020-01-01 12:00:00",
    "endTime":"2020-01-01 12:00:00",
    "status":"RUNNING",
    "langCountry":"en"
}

响应说明

响应体

字段名	参数名	类型	描述
返回码	errcode	String	返回码
返回描述	errmsg	String	返回描述
数据集合	datas	List<ProcessInstance>	数据集合
页码	pageNumber	Long	页码
每页数据量	pageSize	Long	每页数据量
总页数	pages	Long	总页数
总记录数	total	Long	总记录数

ProcessInstance(返回)

字段名	参数名	类型	描述
应用ID	appId	String	应用ID
第三方申请ID	processInstanceId	String	申请ID，业务主键，由第三方提供
申请人工号	initiatorId	String	申请人工号
申请主题	subject	String	申请主题
待处理人的信息	processors	List<String>	待处理人的信息
当前节点名称	nodeName	String	当前节点
申请状态	processInstanceStatus	String	RUNNING(正常运行) COMPLETE（正常结束） ABORT（强行中止） REPLY（待重新提交） DRAFT（草稿）
流程图地址	processInstanceImgUrl	String	流程图地址
流程记录地址	processInstanceRecordUrl	String	流程记录地址
PC跳转地址	pcViewUrl	String	PC跳转地址
h5跳转地址	h5ViewUrl	String	h5跳转地址
创建时间	createTime	String	创建时间
服务id 3.5.2+	serviceId	String	服务id
服务名称 3.5.2+	serviceName	String	服务名称

响应示例

{
    "pageNumber": 1,
    "pageSize": 10,
    "total": 0,
    "pages": 0,
    "errcode": "0",
    "errmsg": "success",
    "traceId": null,
    "datas": []
}

错误码

错误码	描述
371002	参数异常（详细描述信息参见接口返回）
376999	系统异常，详细描述信息参见接口返回
999	统一错误码，详细描述信息参见接口返回

Demo

java

// 创建客户端
Client client = new DefaultClient(BASE_URL, APP_ID, APP_SECRET);
// 创建请求对象
ProcessInstanceSearchRequest request = new ProcessInstanceSearchRequest();
request.setUserId("xxx");
request.setStatus(ProcessInstanceStatusType.RUNNING);
request.setPageNumber(1);
request.setPageSize(10);
ProcessInstanceSearchResponse response = client.execute(request);
//调用成功，则处理业务逻辑
if (response.isSuccess()) {
    //.....
}