更新蓝图明细

目的

每次更新一个迁移。如果记录没有处于迁移中、transition_id错误、field_value数据类型不匹配或字段验证失败，就会抛出一个错误。

请求URL

https://www.zohoapis.com.cn/crm/v2/{module_api_name}/{id}/actions/blueprint

module_api_name - 模块的API名称

id - 记录的唯一ID

支持的模块
线索，客户，联系人，商机，市场活动，任务，服务支持，事件，通话，解决方案，产品，供货商，价格表，报价单，销售订单，采购订单，发货单，自定义模块，备注和活动

请求方法

PUT

范围

scope=ZohoCRM.modules.all
(或)
scope=ZohoCRM.modules.{module_name}.{operation_type}

可能的模块名称	可能的操作类型
线索，客户，联系人，商机，市场活动，任务，服务支持，事件，通话，解决方案，产品，供货商，价格表，报价单，销售订单，采购订单，发货单，自定义模块，备注和活动	ALL - 完全访问记录 WRITE - 编辑模块中的记录 CREATE - 在模块中创建记录

备注：

在相关列表示例中，关键的“任务”是与迁移中使用的记录相关的列表的名称。
此API的相关列表支持依赖于记录的模块，该模块用于蓝图的迁移。
如果输入的字段数量不满足所需的数量，则响应中的“消息”将“部分保存转换”。

Curl

示例请求

在这个请求中，@blueprint1.json 包含了示例输入数据。


				curl "https://www.zohoapis.com.cn/crm/v2/Leads/410888000000698006/actions/blueprint"
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"
-d "@blueprint1.json"
-X POST

示例输入：向正在迁移的记录添加备注


				{
    "blueprint": [
       {
            "transition_id": "401308000003240197",
            "data": {
                "Phone": 8940372937,
                "Notes": "Updated via blueprint"
            }
        }
    ]
}

示例输入：将附件上传到蓝图


				{
    "blueprint": [
       {
            "transition_id": "1000000031897",
            "data": {
                "Attachments": {
                    "$file_id": [
                        "59cf260313b6907ffc56957f4241bd94ba3e0b6aad53b50f8b38583a859d623a",
                        "59cf260313b6907ffc56957f4241bd94ba3e0b6aad53b50f8b38583a859d624d"
                    ]
                }
            }
        }
    ]
}

示例输入：在迁移期间处理父模块字段


				{
    "blueprint": [
       {
            "transition_id": "2000000031536",
            "data": {
                "Lookup_2": {
                    "phone": "123458939",
                    "id": "2000000048165"
                }
            }
        }
    ]
}

示例输入：更新检查表信息


				{
    "blueprint": [
       {
            "transition_id": "1000000034304",
            "data": {
                "CheckLists": [
                   {
                        "list 1": true
                    },
                   {
                        "list 2": false
                    },
                   {
                        "list 3": true
                    },
                   {
                        "list 4": true
                    }
                ]
            }
        }
    ]
}

示例输入：更新相关列表信息


				{
    "blueprint": [
       {
            "transition_id": "2000000031536",
            "data": {
                "Tasks": {
                    "Subject": "Event"
                }
            }
        }
    ]
}

示例响应


				{
    "code": "SUCCESS",
    "details": {},
    "message": "transition updated successfully",
    "status": "success"
}