以下の記事で説明されているSOAP Web Services統合に関する手順を成功裏に完了した後:
- 記事「NetSuite の始め方 | SOAPおよびREST Web Servicesのセットアップの前提条件」に従ってSOAP統合を有効にする。
- 記事「NetSuite の始め方 | インテグレーションレコードの作成方法」と「NetSuite の始め方 | アクセストークンの作成方法:管理者向け」に従ってSOAPインテグレーションを作成する。
- 記事「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>
重要: 提供されているサンプルコードは、「現状のまま」提供されており、法の最大限の範囲で、いかなる保証もありません。Oracle + NetSuite Inc.は、開発者が自身の開発プラットフォームでサンプルコードを実装する際の成功を保証しません。また、サンプルコードの使用、結果の使用、データまたは情報の正確性、適時性、または完全性に関して、いかなる保証も行いません。
他の操作に関する記事
以下のリンクでは、さまざまな操作について詳述しています:
SuiteCloud製品エリアでSOAP Web Servicesについてさらに探求しましょう。新しい記事が公開されるたびに通知を受け取るには、NetSuite の始め方 > SuiteCloudカテゴリをフォローしてください。