更新单条业务数据
功能描述
更新单条业务数据,通过传递不同参数可以实现仅更新主表数据,仅更新子表数据,同时更新主表和子表数据。
请求方式
POST(HTTPS)
请求地址
https://www.h3yun.com/OpenApi/Invoke
参数说明
| 参数 | 参数类型 | 必须 | 说明 |
|---|---|---|---|
ActionName |
String | 是 | 调用的方法名。 |
SchemaCode |
String | 是 | 表单编码。 |
BizObjectId |
String | 是 | 表单 ObjectId 值。 |
BizObject |
Object | 是 | BizObject 对象的 json 字符串。 |
参数示例:
{
"ActionName": "UpdateBizObject",
"SchemaCode": "D00018smb9a4dbd53baf4950a6dafd6a92dff4b2",
"BizObjectId": "77cdda8f-a824-4399-88bd-91d88db07ab2",
//字段D000183a4c62c0fe1b446d8b00f84533a8b06a为子表
"BizObject": "{\"CreatedBy\":\"3588404f-1136-402a-a712-09889a86e4a2\",\"OwnerId\":\"3588404f-1136-402a-a712-09889a86e4a2\",\"F0000001\":\"文本内容-修改\",\"F0000002\":\"多行文本内容-修改\",\"F0000003\":\"2025-08-20 08:13:10\",\"F0000004\":123.456,\"F0000005\":\"\",\"F0000006\":\"\",\"F0000007\":\"\",\"F0000008\":false,\"F0000011\":\"{\\\"adcode\\\":\\\"440305\\\",\\\"adname\\\":\\\"广东省 深圳市 南山区\\\",\\\"Detail\\\":\\\"详细地址\\\"}\",\"F0000012\":\"{\\\"Address\\\":\\\"广东省深圳市福田区莲花街道益田路市民广场\\\",\\\"Point\\\":{\\\"lat\\\":22.540862,\\\"lng\\\":114.05644},\\\"CSType\\\":2,\\\"WGS84Point\\\":{\\\"lng\\\":114.05132789740453,\\\"lat\\\":22.54358194824299}}\",\"F0000013\":\"c8529fb9-6470-461c-82f2-5e77e3a39ab6\",\"F0000014\":[\"c8529fb9-6470-461c-82f2-5e77e3a39ab6\"],\"F0000015\":\"845ff2df-327e-4332-b935-0e7358a938bf\",\"F0000016\":[\"845ff2df-327e-4332-b935-0e7358a938bf\"],\"F0000023\":\"07743e68-46bc-4c3a-b261-92496fea3e69\",\"F0000024\":\"8651b84b-31b5-4728-b91e-1f2f6d4c2763;0a5d1b29-15b5-4fbf-b296-196c70cc5d94\",\"D000183a4c62c0fe1b446d8b00f84533a8b06a\":[{\"F0000017\":\"子表单行文本-1-1\",\"F0000018\":\"2025-11-28\",\"F0000019\":\"123.456\",\"F0000020\":\"选项3\"},{\"ObjectId\":\"d1f3f3b3-5f4b-4e2b- ninth- 9c4f-2c3e5d6f7a8b\",\"F0000017\":\"子表单行文本-2-1\",\"F0000018\":\"2025-11-28\",\"F0000019\":\"234.46\",\"F0000020\":\"选项2\"}]}"
}
请求示例(C#)
using System.Collections.Generic;
using System.IO;
using System.Net;
using System.Text;
string apiAddress = @"https://www.h3yun.com/OpenApi/Invoke";
HttpWebRequest request = (System.Net.HttpWebRequest)WebRequest.Create(apiAddress);
request.Method = "POST";
request.ContentType = "application/json";
//身份认证参数
request.Headers.Add("EngineCode", "");
request.Headers.Add("EngineSecret", "");
//参数
Dictionary<string, object> dicParams = new Dictionary<string, object>();
dicParams.Add("ActionName", "UpdateBizObject");
dicParams.Add("SchemaCode", "D000024chuangjian");
dicParams.Add("BizObject", Newtonsoft.Json.JsonConvert.SerializeObject(bizObjectData));
dicParams.Add("BizObjectId", "60561b8e-2296-419a-a647-842ea587941b");
string jsonData = JsonConvert.SerializeObject(dicParams);
byte[] bytes;
bytes = System.Text.Encoding.UTF8.GetBytes(jsonData);
request.ContentLength = bytes.Length;
using (Stream writer = request.GetRequestStream())
{
writer.Write(bytes, 0, bytes.Length);
writer.Close();
}
string strValue = string.Empty;
using (System.Net.HttpWebResponse response = (System.Net.HttpWebResponse)request.GetResponse())
{
using (System.IO.Stream s = response.GetResponseStream())
{
string StrDate = string.Empty;
using (StreamReader Reader = new StreamReader(s, Encoding.UTF8))
{
while ((StrDate = Reader.ReadLine()) != null)
{
strValue += StrDate + "\r\n";
}
}
}
}
private static Dictionary<string, object> BuildBizData()
{
// 构造业务数据
Dictionary<string, object> bizObjectData = new Dictionary<string, object>();
//系统数据
bizObjectData.Add("CreatedBy", "3588404f-1136-402a-a712-09889a86e4a2");
bizObjectData.Add("OwnerId", "3588404f-1136-402a-a712-09889a86e4a2");
//单行文本
bizObjectData.Add("F0000001", "文本内容-修改");
//多行文本
bizObjectData.Add("F0000002", "多行文本内容-修改");
//日期
bizObjectData.Add("F0000003", "2025-08-20 08:13:10");
//数字
bizObjectData.Add("F0000004", 123.456m);
//单选框
bizObjectData.Add("F0000005", "");
//复选框
bizObjectData.Add("F0000006", "");
//下拉框
bizObjectData.Add("F0000007", "");
//是否
bizObjectData.Add("F0000008", false);
//地址
bizObjectData.Add("F0000011", "{\"adcode\":\"440305\",\"adname\":\"广东省 深圳市 南山区\",\"Detail\":\"详细地址\"}");
//位置
bizObjectData.Add("F0000012", "{\"Address\":\"广东省深圳市福田区莲花街道益田路市民广场\",\"Point\":{\"lat\":22.540862,\"lng\":114.05644},\"CSType\":2,\"WGS84Point\":{\"lng\":114.05132789740453,\"lat\":22.54358194824299}}");
//人员单选
bizObjectData.Add("F0000013", OpenAPIConfig.UserId);
//人员多选
bizObjectData.Add("F0000014", new string[] { OpenAPIConfig.UserId });
//部门单选
bizObjectData.Add("F0000015", OpenAPIConfig.DepartmentId);
//部门多选
bizObjectData.Add("F0000016", new string[] { OpenAPIConfig.DepartmentId });
//关联表单
bizObjectData.Add("F0000023", "07743e68-46bc-4c3a-b261-92496fea3e69");
//关联多选
bizObjectData.Add("F0000024", string.Join(";", new string[] { "8651b84b-31b5-4728-b91e-1f2f6d4c2763", "0a5d1b29-15b5-4fbf-b296-196c70cc5d94" }));
//子表
Dictionary<string, object> childBoData1 = new Dictionary<string, object>();
//子表行Id
//第一行的数据ID如果原来已经存在会检查每一行的数据ID是否存在,存在则更新,不存在就新增
childBoData2.Add("ObjectId", "d1f3f3b3-5f4b-4e2b-ninth-9c4f-2c3e5d4");
//子表单行文本
childBoData1.Add("F0000017", "子表单行文本-1-1");
//子表日期
childBoData1.Add("F0000018", "2025-11-28");
//子表数字
childBoData1.Add("F0000019", "123.456");
//子表单选框
childBoData1.Add("F0000020", "选项3");
Dictionary<string, object> childBoData2 = new Dictionary<string, object>();
//子表行Id
childBoData2.Add("ObjectId", "d1f3f3b3-5f4b-4e2b-ninth-9c4f-2c3e5d6");
//子表单行文本
childBoData2.Add("F0000017", "子表单行文本-2-1");
//子表日期
childBoData2.Add("F0000018", "2025-11-28");
//子表数字
childBoData2.Add("F0000019", "234.46");
//子表单选框
childBoData2.Add("F0000020", "选项2");
List<Dictionary<string, object>> childBoList = new List<Dictionary<string, object>>();
childBoList.Add(childBoData1);
childBoList.Add(childBoData2);
bizObjectData.Add(OpenAPIConfig.ChildSchemaCode, childBoList);
return bizObjectData;
}
请求示例(JAVA)
Map<String, String> paramMap = new HashMap();
paramMap.put("ActionName", "UpdateBizObject");
paramMap.put("SchemaCode", "D000024chuangjian");
paramMap.put("BizObject", "{\"CreatedBy\":\"3588404f-1136-402a-a712-09889a86e4a2\",\"OwnerId\":\"3588404f-1136-402a-a712-09889a86e4a2\",\"F0000001\":\"文本内容-修改\",\"F0000002\":\"多行文本内容-修改\",\"F0000003\":\"2025-08-20 08:13:10\",\"F0000004\":123.456,\"F0000005\":\"\",\"F0000006\":\"\",\"F0000007\":\"\",\"F0000008\":false,\"F0000011\":\"{\\\"adcode\\\":\\\"440305\\\",\\\"adname\\\":\\\"广东省 深圳市 南山区\\\",\\\"Detail\\\":\\\"详细地址\\\"}\",\"F0000012\":\"{\\\"Address\\\":\\\"广东省深圳市福田区莲花街道益田路市民广场\\\",\\\"Point\\\":{\\\"lat\\\":22.540862,\\\"lng\\\":114.05644},\\\"CSType\\\":2,\\\"WGS84Point\\\":{\\\"lng\\\":114.05132789740453,\\\"lat\\\":22.54358194824299}}\",\"F0000013\":\"c8529fb9-6470-461c-82f2-5e77e3a39ab6\",\"F0000014\":[\"c8529fb9-6470-461c-82f2-5e77e3a39ab6\"],\"F0000015\":\"845ff2df-327e-4332-b935-0e7358a938bf\",\"F0000016\":[\"845ff2df-327e-4332-b935-0e7358a938bf\"],\"F0000023\":\"07743e68-46bc-4c3a-b261-92496fea3e69\",\"F0000024\":\"8651b84b-31b5-4728-b91e-1f2f6d4c2763;0a5d1b29-15b5-4fbf-b296-196c70cc5d94\",\"D000183a4c62c0fe1b446d8b00f84533a8b06a\":[{\"F0000017\":\"子表单行文本-1-1\",\"F0000018\":\"2025-11-28\",\"F0000019\":\"123.456\",\"F0000020\":\"选项3\"},{\"ObjectId\":\"d1f3f3b3-5f4b-4e2b- ninth- 9c4f-2c3e5d6f7a8b\",\"F0000017\":\"子表单行文本-2-1\",\"F0000018\":\"2025-11-28\",\"F0000019\":\"234.46\",\"F0000020\":\"选项2\"}]}");
paramMap.put("BizObjectId", "60561b8e-2296-419a-a647-842ea587941b");
//身份认证参数
Map headers = new HashMap();
headers.put("EngineCode", "");
headers.put("EngineSecret", "");
Gson gson = new Gson();
String result = HttpRequestUtil.sendPost(url, gson.toJson(paramMap), headers);
返回结果
| 参数 | 说明 |
|---|---|
Successful |
返回结果是否成功 true/false。 |
ErrorMessage |
错误信息。 |
Logined |
未使用,忽略。 |
ReturnData |
返回的数据。 |
DataType |
返回的数据类型,默认 0。 |
{
"Successful": true,
"ErrorMessage": null,
"Logined": false,
"ReturnData": {},
"DataType": 0
}