首页 > 解决方案 > NetSuite SuiteTalk API 中 searchMoreWithId 操作的结果为空页

问题描述

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

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

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

带有空白页面的此类响应示例:

    <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 服务中,在您翻阅搜索结果后,返回的记录数可能比最初符合搜索条件的记录数多或少。

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

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


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

标签: apisoapnetsuitesuitetalk

解决方案


这是可能发生的事情。查看此讨论以获取更多信息。

您引用的文档中的关键段落是:

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

这是页面中的实际记录可能与您期望的不同的主要情况。例如,假设您运行了一个筛选条件的搜索lastModified。如果搜索需要一个小时才能完全运行,则在您循环浏览搜索结果期间可能会修改某些记录,导致在您到达那些记录将包含在其中的页面时,它们会从搜索结果中删除搜索结果。


推荐阅读