修改单条数据接口 ​

简介 ​

通过修改单条数据接口，可以对指定的单条数据进行修改。参数中字段既可以使用原名也可以使用别名。

修改表单数据接口仅修改指定字段的值，未指定的字段将会保留原值。

开发前，请仔细阅读 开发指南。

注：使用接口修改数据时，会触发新数据校验、提醒助手、变更记录和数据量统计，也可以通过请求参数来控制是否发起流程和触发数据机器人。但是不会触发重复值校验、必填校验。

单选框组组件（radio字段）、多选框组组件（checkbox字段）、下拉选择框组件（select字段）同时支持静态数据、动态数据（表单）

另外，系统字段 和以下所列举的字段不支持添加和修改数据：

  • 分割线
  • 关联数据、关联查询
  • 流水号（提交后系统生成）

接口调用 ​

按照指定数据 ID 修改表单中的数据。

请求地址：

http
PUT /Customized/Form/{FormId}/Data
http
POST /Customized/Form/{FormId}/Data/put

请求参数：

参数类型必需说明
FormIdGuid是表单Id
SerialNoString是数据流水号
DataJSON是表单数据
TriggerRobotBoolean否是否触发数据机器人，默认不触发
ReturnFieldAliasBoolean否返回值使用字段别名

请求示例：

json
{
  "TriggerRobot": true,
  "serialNo": "编码002",
  "Data": {
    "input_1679647970951": {
      "value": "北京仓"
    },
    "input_1679974775216": {
      "value": "数码产品"
    }
  }
}

返回内容：

参数类型说明
DataJSON表单数据，格式与查询单条数据格式相同

返回示例（字段原名）：

json
{
  "data": {
    "CreatedByName": "Lily Wang",
    "ModifiedByName": "Lily Wang",
    "SubmittedByName": "Lily Wang",
    "Id": "af1ec79e-b784-4f26-9659-2a4eb7f22399",
    "FormId": "0a068b95-15ea-417e-8952-107628c3abfd",
    "CreatedBy": "09ea1b1a-4312-4d24-9102-f1d40cad161b",
    "CreatedTime": "1688786500",
    "ModifiedBy": "09ea1b1a-4312-4d24-9102-f1d40cad161b",
    "ModifiedTime": "1688787712",
    "SerialNo": "编码002",
    "Status": 2,
    "SubmitedBy": "09ea1b1a-4312-4d24-9102-f1d40cad161b",
    "SubmitedTime": "1688786500",
    "select_1679973846559": {
      "value": "ffb20f97-09ba-4a54-a1c1-ae7b91e7673b",
      "label": "Online"
    },
    "input_1679974525848": "编码",
    "input_1679647970951": "北京仓",
    "input_1679974775216": "数码产品",
    "select_1679647978290": {
      "value": "key 1",
      "color": {
        "BackgroundColor": "#577eff",
        "ForeColor": "#ffffff"
      },
      "label": "测试品牌名称"
    },
    "employeeSelect_1679647998873": {},
    "input_1679648011280": "渠道Owner"
  }
}

返回示例（字段别名）：

json
{
  "data": {
    "CreatedByName": "Lily Wang",
    "ModifiedByName": "Lily Wang",
    "SubmittedByName": "Lily Wang",
    "Id": "af1ec79e-b784-4f26-9659-2a4eb7f22399",
    "FormId": "0a068b95-15ea-417e-8952-107628c3abfd",
    "CreatedBy": "09ea1b1a-4312-4d24-9102-f1d40cad161b",
    "CreatedTime": "1688786500",
    "ModifiedBy": "09ea1b1a-4312-4d24-9102-f1d40cad161b",
    "ModifiedTime": "1688787712",
    "SerialNo": "编码002",
    "Status": 2,
    "SubmitedBy": "09ea1b1a-4312-4d24-9102-f1d40cad161b",
    "SubmitedTime": "1688786500",
    "在线状态": {
      "value": "ffb20f97-09ba-4a54-a1c1-ae7b91e7673b",
      "label": "Online"
    },
    "input_1679974525848": "编码",
    "仓库名称": "北京仓",
    "物品类型": "数码产品",
    "select_1679647978290": {
      "value": "key 1",
      "color": {
        "BackgroundColor": "#577eff",
        "ForeColor": "#ffffff"
      },
      "label": "测试品牌名称"
    },
    "employeeSelect_1679647998873": {},
    "input_1679648011280": "渠道Owner"
  }
}