NetSuite SuiteTalk API 中 searchMoreWithId 操作的结果为空页

Posted 2023-02-22

技术标签:

【中文标题】NetSuite SuiteTalk API 中 searchMoreWithId 操作的结果为空页【英文标题】：Empty page in result of searchMoreWithId operation in NetSuite SuiteTalk API 【发布时间】：2019-10-01 16:54:49 【问题描述】：

我遇到了与NetSuite SuiteTalk API 集成的问题。他们提供 SOAP API 以管理 ERP 的记录/实体。我们通过search 调用和随后的searchMoreWithId 调用导入一些记录（库存项目）。

我们为search 呼叫和接收search_id 的响应提供条件。搜索结果可能很大，因此我们使用单独的searchMoreWithId 调用获取结果的每一页，同时指定searchId 和pageIndex。 NetSuite SuiteTalk API 文档 - https://docs.oracle.com/cloud/latest/netsuitecs_gs/NSTWP/NSTWP.pdf.

问题是searchMoreWithId 的一些调用返回empty 记录列表。

此类响应与空白页面的示例：

    <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
      <soapenv:Header>
        <platformMsgs:documentInfo xmlns:platformMsgs="urn:messages_2016_2.platform.webservices.netsuite.com">
          <platformMsgs:nsId>WEBSERVICES...</platformMsgs:nsId>
        </platformMsgs:documentInfo>
      </soapenv:Header>
      <soapenv:Body>
        <searchMoreWithIdResponse xmlns="urn:messages_2016_2.platform.webservices.netsuite.com">
          <platformCore:searchResult xmlns:platformCore="urn:core_2016_2.platform.webservices.netsuite.com">
            <platformCore:status isSuccess="true"/>
            <platformCore:totalRecords>98852</platformCore:totalRecords>
            <platformCore:pageSize>10</platformCore:pageSize>
            <platformCore:totalPages>9886</platformCore:totalPages>
            <platformCore:pageIndex>66</platformCore:pageIndex>
            <platformCore:searchId>WEBSERVICES_...</platformCore:searchId>
            <platformCore:recordList/>
          </platformCore:searchResult>
        </searchMoreWithIdResponse>
      </soapenv:Body>
    </soapenv:Envelope>

请注意响应文档中的platformCore:recordList XML 标签为空。

我注意到一个不变的模式 - 在空页面之前没有完整的页面。例如。我们设置页面大小 = 10 并收到以下记录数作为响应：

page 1496 - 10
page 1497 - 5
page 1498 - 0
page 1499 - 0
page 1500 - 0
page 1501 - 10

我发现只有在官方文档中提到减小页面大小（在上面提供的同一个 PDF 文档中）：

在执行搜索时请考虑以下可能的问题返回大型数据集的 Web 服务或 SuiteScript。

如果最初符合搜索条件的记录已更新且不再符合条件，则搜索将跳过该记录。在这个情况下，最初包含在搜索中的一些记录结果可能不返回，返回的总数记录可能小于原始结果总数。

如果创建了符合搜索条件的新记录，它们也会被返回。返回的记录总数可能更高你翻页后的结果比原来的总数多了结果，可能会返回重复的结果。

结果可能丢失。例如，如果第一个结果页面中的记录已更新并且不再符合条件，则另一个记录现在适合第一页。但是，因为较早的页面是在浏览搜索结果的后续页面时跳过，这记录不返回。

在 Web 服务中，您翻阅搜索结果后返回的记录数可能大于或小于最初符合搜索条件的记录。

结果集的第二页和后续页面可能包含的记录少于指定的页面大小。

但不确定是否与我们的案例有关。

所以问题：这是正常情况吗？它不需要一些额外的处理或重试吗？

【问题讨论】：

【参考方案1】：

这是可能发生的事情。请查看at this discussion 了解更多信息。

你引用的关键段落in the documentation是：