API开发文档 - 道一云

开发说明

开发说明

功能说明：表单流程数据修改接口，不允许修改提单人，负责人。已关闭和审批通过的不能修改。
请求方式：POST（HTTPS）multipart/form-data
请求地址：https://qwif.do1.com.cn/qwcgi/api/apiForm/updateFormData.do?token=token&corpId=corpId&id=id

请求包体：

[{
	"fieldMap":
	{
		"fo日期时间字段id":"2022-02-23 18:16"
	},
	"id":"work工单明细id",
	"instanceTitle":"工单标题"
}]

请求参数说明：

参数名	释义	类型	是否必须	描述
token	用于验证	String	是	参考获取token接口
corpId	公司唯一标识	String	是
id	表单id	String	是

data参数，以json 数组格式传送

参数名	释义	类型	是否必须	描述
id	表单数据id	String	是	推送时返回的work工单明细id
instanceTitle	表单数据标题	String	否	不需要修改时不要传递
ccList	相关人（账号）列表	Array	否	[“admin1”,”admin2”] 表单不支持相关人，此参数无效不需要修改，不需要传递
fieldMap	数据json	Object	否	{ 字段id1:值, 字段id2:值, …. 子表单:[{ 子表单子段1:值, 子表单子段2:值 … }] } 对应字段为null或””，子表单为空数组时将删除，不需要修改的字段不需要传递字段。值格式参考附录2和示例

SDK调用示例：

		FormDataPushVO vo = new FormDataPushVO();
		// 提单人账号
		vo.setCreator("提单人通讯录账号");
		// 工单标题
		vo.setInstanceTitle("明细工单标题");
		// 相关人账号
		vo.setCcList(new String[]{"相关人账号"});
		// 发起时返回的工单id
		vo.setId("work工单id");

		// 字段数据(只需要传输修改的部分)
		Map<String,Object> fieldMap = new HashMap<String,Object>();
		fieldMap.put("fo日期时间字段id","2022-02-23 18:16");
		// 字段数据
		vo.setFieldMap(fieldMap);

		System.out.println(JSONUtil.objectToString(vo));
		FormApi api = QwSdkUtil.getInter(FormApi.class);
		// 调用接口
		ApiFormPushResult re = api.updateFormData(QwSdkUtil.getCacheToken(),
				"表单id", new FormDataPushVO[]{vo});
		System.out.println(JSONUtil.objectToString(re));

返回结果：

{
	"code":"0",
	"data":
	{
		"errorMsgList":
		[
			"表单数据已被删除或不存在",
			""
		]

	},
	"desc":"推送成功"
}

返回参数说明：

参数	说明
errorMsgList	该行数据修改失败的原因，空白表示修改成功。

企业微信

修改表单数据

开发说明