Zoho crm Logo

替换全局选择列表值

目的

要将所有使用过的选择列表值替换为全局选择列表中的另一个现有选项,请在您的Zoho CRM中进行操作。

现有值将在记录、条件、工作流操作和字段依赖等使用的地方被替换。替换操作完成后,替换的值将被移至未使用的值部分。

端点

  • POST /settings/global_picklists/{global_pick_list_ID}/actions/replace_picklist_values

请求详情

请求 URL

{api-domain}/crm/{version}/settings/{global_pick_list_ID}/actions/replace_picklist_values

标题

授权: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

范围

ZohoCRM.settings.global_picklist.CREATE 
(或)
ZohoCRM.settings.global_picklist.ALL

支持的模块

潜在客户、联系人、Account、活动、案例、Invoices、交易、价格表、产品、Purchase Orders、报价、Sales Orders、解决方案、Vendors、电话、任务、事件、Users、交易历史、报价Items、Order项目、采购Items、Invoice项目、访问、服务、预约和自定义模块。

示例请求

Copiedcurl "https://www.zohoapis.com/crm/v8/settings/global_picklists/2423488000000725183/actions/replace_picklist_values"
-X POST
-d "@input.json"
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"

输入 JSON 键

  • old_valueJSON object, mandatory

    它表示您想要在所有使用的地方替换的值。

  • new_valueJSON object, mandatory

    它表示您想要用来替换旧值的新选项。

注意事项

  • 选项列表中的-None-值不能被替换。
  • old_value和new_value的ID不能相同。
  • 如果为display_value提供空字符串或null值,系统将抛出INVALID_DATA错误。
  • 不能替换已计划删除的选项列表。
  • 当您尝试替换与记录中任何字段关联的全局选项列表中的选项时,该操作会触发一个计划任务。您不会立即收到响应。相反,您将获得一个任务ID,以便使用获取全局选项列表选项的计划替换任务状态API来检查替换选项的Status。

示例输入

Copied{
    "replace_picklist_values": [
        {
            "old_value": {
                "id": "2423488000000492041",
                "display_value": "Twitter"
            },
            "new_value": {
                "id": "2423488000000725184",
                "display_value": "X"
            }
        }
    ]
}

可能的错误

  • INVALID_DATAHTTP 400
    • 全局选项列表 ID 似乎无效
    • 给定的全局选项列表中的选项 ID 似乎无效。
    • -None- 及其值无法替换

    解决方案:

    • 提供有效的全局选项列表值。
    • 提供有效的 ID 选项。使用 GET Global Picklist API 来检索全局选项列表的唯一 ID。
    • 您无法替换 -None- 选项。尝试使用不同的值。
  • AMBIGUITY_DURING_PROCESSINGHTTP 400

    display_value 及其对应的 ID 似乎无效

    解决方法:提供有效的 display_value 及其对应的 ID 以执行操作。

  • EXPECTED_FIELD_MISSINGHTTP 400
    • 在 old_value 中至少指定一个字段
    • 在 new_value 中至少指定一个字段

    解决方案:

    • 在 old_value JSON 对象中提供至少一个字段(ID 或 display_value)是强制性的,以执行该操作。使用 GET Global Picklist API 来检索全局选项列表的唯一 ID。
    • 在 new_value JSON 对象中提供至少一个字段(ID 或 display_value)是强制性的,以执行该操作。使用 GET Global Picklist API 来检索全局选项列表的唯一 ID。
  • NOT_ALLOWEDHTTP 400
    • 选项无法替换。
    • 给定的全局选项列表ID已经在删除计划中。

    解决方案:

    • 您尝试替换的选项与蓝图和ABM映射等功能相关联。
    • 您无法替换已计划删除的选项列表。
  • LIMIT_EXCEEDEDHTTP 400

    已达到使用或未使用选项的限制
    解决方案:使用的选项最多可以有1000个限制,未使用的选项最多可以有500个限制。请在输入中指定有关限制的选项。

  • INVALID_REQUEST_METHODHTTP 400

    https请求方法类型无效
    解决方案:您指定了一个无效的HTTP方法来访问API URL。
    请指定一个有效的请求方法。请参阅端点部分。

  • UNABLE_TO_PARSE_DATA_TYPEHTTP 401

    请求体或参数格式错误
    解决方法:请指定有效的输入格式。

  • OAUTH_SCOPE_MISMATCHHTTP 401

    未经授权
    解决方法:客户端没有替换全局选项列表选项的有效范围。创建具有所需范围的有效令牌。请参阅范围部分。

  • Authentication_FAILUREHTTP 401

    Authentication 失败
    解决方法: 在API调用的请求头中传递访问令牌。

  • INVALID_URL_PATTERNHTTP 404

    请检查尝试访问的URL是否正确
    解决方案: 请求的URL不正确。请指定一个有效的请求URL。请参阅请求URL部分。

  • INTERNAL_ERRORHTTP 500

    内部服务器错误
    解决方案:服务器中出现意外且未处理的异常。请联系支持团队。

示例响应

Copied{
    "replace_picklist_values": [
        {
            "code": "SCHEDULED",
            "details": {
                "job_id": "2423488000000732044"
            },
            "message": "success",
            "status": "success"
        }
    ]
}