批处理操作失败，如何精准定位导致失败的操作？

2024-03-03 14:13:34

在使用 Salesforce 平台进行数据迁移或更新时，批处理操作是一种高效的方式。它允许开发者将多个操作组合成一个请求，从而减少 API 调用次数并提高效率。然而，当批处理操作中包含更改集，并且更改集执行失败时，定位导致失败的具体操作可能会变得棘手。本文将探讨如何从批处理响应中识别导致更改集失败的操作，并提供一些实用技巧和代码示例。

批处理操作的响应通常以 multipart/mixed 的内容类型返回，其中每个部分对应一个操作的响应。每个部分都包含一个唯一的 Content-ID 头，用于标识该部分对应哪个操作。当更改集执行失败时，我们需要仔细检查每个部分的内容，特别是与更改集操作对应的部分，才能找到导致失败的根本原因。

首先，我们需要从批处理响应中提取每个部分的内容。可以使用各种 HTTP 客户端库来实现这一目标，例如 Apache HttpClient 或 OkHttp。提取每个部分后，我们需要检查其 Content-ID 头，并将其与批处理请求中操作的顺序进行匹配。

找到与更改集操作对应的部分后，我们需要解析其内容。更改集操作的响应通常包含一个 "result" 字段，指示操作是否成功。如果操作失败，"result" 字段将包含一个 "errors" 数组，其中列出了导致失败的具体错误信息。

例如，假设我们执行了一个批处理操作，其中包含三个操作：创建一个账户、更新一个联系人以及执行一个更改集。如果更改集执行失败，我们可以在批处理响应中找到与更改集操作对应的部分，并解析其内容。假设该部分的 Content-ID 为 "part2"，其内容如下：

{
  "result": {
    "success": false,
    "errors": [
      {
        "statusCode": "INVALID_FIELD",
        "message": "Account Name: value not of required type: String"
      }
    ]
  }
}

从上述响应中，我们可以看到更改集执行失败的原因是账户名称字段的值类型不正确。

为了更方便地识别导致更改集失败的操作，我们可以编写一些辅助代码。例如，我们可以创建一个函数，该函数接收批处理响应作为输入，并返回一个包含所有失败操作及其错误信息的列表。

以下是一个使用 Java 编写的示例函数：

public static List<OperationError> getFailedOperations(HttpResponse response) throws IOException {
  List<OperationError> failedOperations = new ArrayList<>();
  Multipart multipart = (Multipart) response.getEntity();
  for (int i = 0; i < multipart.getCount(); i++) {
    BodyPart part = multipart.getBodyPart(i);
    String contentId = part.getHeader("Content-ID").getValue();
    String content = EntityUtils.toString(part.getEntity());
    JSONObject json = new JSONObject(content);
    if (json.getJSONObject("result").getBoolean("success") == false) {
      JSONArray errors = json.getJSONObject("result").getJSONArray("errors");
      for (int j = 0; j < errors.length(); j++) {
        JSONObject error = errors.getJSONObject(j);
        failedOperations.add(new OperationError(contentId, error.getString("statusCode"), error.getString("message")));
      }
    }
  }
  return failedOperations;
}