REST による CAFedSearch サーブレットの呼び出し

統合検索による複数の検索エンジンの統合 › REST による CAFedSearch サーブレットの呼び出し

REST による CAFedSearch サーブレットの呼び出し

CAFedSearch サーブレットは RESTful インターフェースを提供し、これによってカスタム検索クライアント、プログラム、およびユーザインターフェース（UI）が検索リクエストを送信できます。

この RESTful インターフェースは、OpenSearch 仕様に準拠する HTTP Collection GET リクエストのみを受け入れます。また、JSON および XML 応答をサポートします。各リクエストには、CA SDM RESTful または SOAP Web サービスから取得できる Service Desk BOPSID トークンが含まれている必要があります。

次の手順に従ってください：

CA SDM RESTful Web サービスを使用して BOPSID トークンを取得します。
ログイン認証情報と共に rest_access リソースに対する HTTP POST リクエストを送信することによって、REST アクセスキーを取得します。
bopsid リソースに対する HTTP POST リクエストを送信することによって、REST アクセスキーを使用して BOPSID トークンを取得することもできます。
CA SDM RESTful Web サービスへのリクエストの送信の詳細については、以下の CA SDM ディレクトリにあるサンプルファイルを参照してください。
```
NX_ROOT¥samples¥sdk¥rest¥java
```
統合検索 API を使用して検索するには、検索リソースに対して HTTP GET リクエストを送信し、CA SDM URL を介して検索条件と BOPSID トークンを渡します。
```
GET 
```
```
http://<sdmhostname>:<FS_TOMCAT_PORT>/cafedsearch/sdm/search?q=<searchTerms>&source=<adapterName>&BOPSID=<bopsidToken>&userid=<userId>
```
searchTerms

キーワードのスペース区切りリストを指定します。エンコードされた URL である必要があります。

adapterName

アダプタ設定ユーティリティを使用して、［検索ソース］レコードの［コード］フィールドで指定されている検索エンジン名を指定します。

サポートされるその他の引数は、以下のとおりです。

index

検索結果に求められる最初のインデックスを指定します。1 以上の整数である必要があります。

page

検索結果に求められる最初のページを指定します。1 以上の整数である必要があります。

size

検索クライアントが要求するページ当たりの結果数を指定します。

type

有効な値は「JSON」または「XML」です。