Windows SharePoint Services クエリ Web サービス
Windows SharePoint Services での検索 の検索機能は Web サービスを介して提供されます。これにより、SharePoint サイトのコンテンツ以外のクライアント アプリケーションや Web アプリケーションから 検索 の結果にアクセスできます。
クエリ Web サービスにアクセスする
検索Query Web サービスおよびそのメソッドにアクセするには、次の Web 参照を設定します。
http://<Site_Name>/_vti_bin/spsearch.asmx
注意 Microsoft Visual Studio 2005 で Web 参照を設定する手順については、「[方法] Visual Studio で Windows SharePoint Services 検索 Web サービスの Web サービス プロキシ クラスを作成する」を参照してください。
Web メソッド
次の表に、Query Web サービスで使用できる Web メソッドを示します。
名前 |
説明 |
---|---|
指定されたクエリの結果セットを XML 文字列で返します。 |
|
指定されたクエリの結果セットを Microsoft ADO.NET DataSet オブジェクトで返します。 |
|
指定されたサイトの名前を返します。 |
|
検索サービスの利用可能性を返します。 |
クエリ メソッド
Query Web サービスには、検索 の結果を取得するための Query および QueryEx という 2 つのメソッドが含まれています。
どちらのメソッドも同じ入力 (検索クエリ パラメータを指定する XML を含む文字列) を受け入れますが、返される結果の形式が異なります。QueryEx メソッドは検索結果を System.Data.DataSet オブジェクトで返し、Query メソッドは検索結果を XML.文字列で返します。詳細については、このトピックの「検索結果を返す」を参照してください。
検索クエリの XML を構築する
検索クエリの XML 形式は、Microsoft.Search.Query スキーマで定義されます。
実際の検索クエリは、QueryText 要素で指定されます。検索クエリを構築するには、SQL 構文かキーワード構文のどちらかを使用します。QueryText 要素の type 属性で、使用する構文を指定します。
次のコード例は、SQL 構文を使用して検索クエリを指定する QueryText 要素のサンプル XML です。
<QueryText language=en-us type='MSSQLFT'>
SELECT Title, Path, Description, Write, Rank, Size FROM Scope() WHERE FREETEXT(DEFAULTPROPERTIES,'SharePoint') ORDER BY Rank
</QueryText>
注意
Query メソッドで SQL 構文を使用する場合は、SQL クエリの SELECT ステートメントに、Title、Path、Description、Write、Rank、および Size の各プロパティを指定する必要があります。
次のコード例は、キーワード構文を使用して検索クエリを指定する QueryText 要素のサンプル XML です。
<QueryText language=en-us type='STRING'>
SharePoint
</QueryText>
検索結果を返す
QueryEx メソッドは、検索結果を System.Data.DataSet オブジェクトで返します。DataSet オブジェクトには、返される検索結果の種類ごとに System.DataSet.DataTable オブジェクトが格納されます。
Query メソッドは、検索結果を XML 文字列で返します。XML の形式は、Microsoft.Search.Response スキーマおよび Microsoft.Search.Response.Document スキーマで定義されます。検索結果の完全なセットは Microsoft.Search.Response スキーマの Results 要素に格納され、個々の結果は Microsoft.Search.Response.Document スキーマの Document 要素で示されます。
このセクションの内容
[方法] Visual Studio で Windows SharePoint Services 検索 Web サービスの Web サービス プロキシ クラスを作成する
[方法] クライアント アプリケーションから Windows SharePoint Services 検索にキーワード クエリを送信する
リファレンス
Windows SharePoint Services 検索クエリ サービスの Microsoft.Search スキーマ