NetSuite の始め方｜SOAP: getSavedSearch

以下の記事で説明されているSOAP Web Services統合に関する手順を成功裏に完了した後： 

1. 記事「NetSuite の始め方 | SOAPおよびREST Web Servicesのセットアップの前提条件」に従ってSOAP統合を有効にする。 
2. 記事「NetSuite の始め方 | インテグレーションレコードの作成方法」と「NetSuite の始め方 | アクセストークンの作成方法：管理者向け」に従ってSOAPインテグレーションを作成する。 
3. 記事「NetSuite の始め方 | SOAP Web ServicesでTBAを使用してヘッダーを作成する方法」を参照してSOAP Web Servicesにヘッダータグを含める。 

これで NetSuite 内でレコードを操作する準備が整いました。SOAP Web サービスで利用可能な主要操作の 1 つに getSavedSearch 操作があり、これは特定のレコードタイプに対して保存検索 ID のリストを取得します。 

興味のあるレコードタイプを指定することで、APIはそのレコードタイプに関連する保存検索のリストを返します。各保存検索について、レスポンスには以下の詳細が含まれる： 

• internalId： 保存検索に NetSuite が割り当てる一意の識別子。 
• scriptId： スクリプトで保存検索を参照するために使用できるユーザー定義の ID。 
• name: NetSuite で定義されている保存検索の名前。 

SOAP リクエスト 

以下は、特定のレコードタイプ (この場合はトランザクション) の保存検索 ID を取得するための SOAP リクエストの構成例です。 

 <soapenv:Body> 
        <getSavedSearch xsi:type='platformMsgs:GetSavedSearchRequest'> 
            <record searchType='transaction' xsi:type='platformCore:GetSavedSearchRecord'/> 
        </getSavedSearch> 
    </soapenv:Body> 

SOAP レスポンス 

正常に応答すると、internalId、scriptId、および名前を含む、保存検索参照のリストが返されます。レスポンスの例を以下に示します： 

    <soapenv:Body> 
        <getSavedSearchResponse 
            xmlns=""> 
            <platformCore:getSavedSearchResult 
                xmlns:platformCore="urn:core_2021_1.platform.webservices.netsuite.com"> 
                <platformCore:status isSuccess="true"/> 
                <platformCore:totalRecords>2</platformCore:totalRecords> 
                <platformCore:recordRefList> 
                    <platformCore:recordRef scriptId="customsearch42" internalId="42" xsi:type="platformCore:CustomizationRef"> 
                        <platformCore:name>Custom Transaction Search 11</platformCore:name> 
                    </platformCore:recordRef> 
                    <platformCore:recordRef scriptId="customsearch_me_rp_target_search_tmpl" internalId="49" xsi:type="platformCore:CustomizationRef"> 
                        <platformCore:name>MerchantE Recurring Payment Target Search Template</platformCore:name> 
                    </platformCore:recordRef> 
                </platformCore:recordRefList> 
            </platformCore:getSavedSearchResult> 
        </getSavedSearchResponse> 
    </soapenv:Body>