跳转至

更新单条业务数据

功能描述

更新单条业务数据,通过传递不同参数可以实现仅更新主表数据,仅更新子表数据,同时更新主表和子表数据。

请求方式

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
}