新建单条数据接口 ​

简介 ​

通过新建单条数据接口，可以向指定的表单中添加单条数据。参数中字段既可以使用原名也可以使用别名。

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

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

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

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

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

接口调用 ​

在指定表单中添加一条数据。

请求地址：POST /Customized/Form/{FormId}/Data

请求参数：

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

请求示例：

json
{
  "StartWorkflow": true,
  "TriggerRobot": true,
  "Data": {
    "select_1679973846559": {
      "value": "Online"
    },
    "input_1679974525848": { 
      "value": "编码"
    },
    "input_1679647970951": { 
      "value": "测试虚拟仓"
    },
    "input_1679974775216": { 
      "value": "名称" 
    },
    "select_1679647978290": {
      "value": "测试品牌名称"
    },
    "employeeSelect_1679647998873": {
      "value": "Lily_Wang"
    },
    "input_1679648011280": { 
      "value": "渠道Owner" 
    }
  }

返回内容：

参数类型说明
DataJSON表单数据，格式与查询单条数据格式相同
返回示例（字段原名）：
json
{
    "data": {
        "CreatedByName": "Lily Wang",
        "SubmittedByName": "Lily Wang",
        "Id": "0cbfb887-aa47-430d-a174-427d7a627bba",
        "FormId": "0a068b95-15ea-417e-8952-107628c3abfd",
        "CreatedBy": "09ea1b1a-4312-4d24-9102-f1d40cad161b",
        "CreatedTime": "1688786400",
        "ModifiedTime": "-62135596800",
        "SerialNo": "编码001",
        "Status": 2,
        "SubmitedBy": "09ea1b1a-4312-4d24-9102-f1d40cad161b",
        "SubmitedTime": "1688786400",
        "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",
        "SubmittedByName": "Lily Wang",
        "Id": "0cbfb887-aa47-430d-a174-427d7a627bba",
        "FormId": "0a068b95-15ea-417e-8952-107628c3abfd",
        "CreatedBy": "09ea1b1a-4312-4d24-9102-f1d40cad161b",
        "CreatedTime": "1688786400",
        "ModifiedTime": "-62135596800",
        "SerialNo": "编码001",
        "Status": 2,
        "SubmitedBy": "09ea1b1a-4312-4d24-9102-f1d40cad161b",
        "SubmitedTime": "1688786400",
        "在线状态": {
            "value": "ffb20f97-09ba-4a54-a1c1-ae7b91e7673b",
            "label": "Online"
        },
        "编码": "编码",
        "仓库名称": "测试虚拟仓",
        "input_1679974775216": "名称",
        "品牌": {
            "value": "key 1",
            "color": {
                "BackgroundColor": "#577eff",
                "ForeColor": "#ffffff"
            },
            "label": "测试品牌名称"
        },
        "employeeSelect_1679647998873": {},
        "input_1679648011280": "渠道Owner"
    }
}