前のトピック: ナレッジ マネジメント 汎用メソッド次のトピック: 検索


faq

faqメソッドでは以下のパラメータを使用します。

パラメータ

説明

SID

Integer

ログインにより取得したセッションを指定します。

categoryIds

String

faqの実行に使用するカテゴリIDを指定します。 「ルート」カテゴリには1を使用します。

注: 「1, 2, 3」のように複数の ID を指定できます。

resultSize

Integer

詳細情報を取得するドキュメントの数を指定します。 残りのドキュメントについてはIDのみが返されます。 これらのドキュメントの詳細情報には、後からgetDocumentsByIDs()メソッドを使用してアクセスすることができます。 初期設定は10です。

propertyList

String

情報を取得するデータベース フィールドをカンマ区切りリストで指定します。 propertyListパラメータに関わらず、常に以下のフィールドが返されます。

  • ID
  • DOC_TYPE_ID
  • BU_RESULT

sortBy

String

結果の並べ替えに使用するデータベース フィールドを指定します。 複数の並べ替えフィールドを指定することはできません。 初期設定はBU_RESULTで、FAQ評価による並べ替えが実行されます。 指定したフィールドで並べ替えられてから、常に ID での並べ替えが実行されます。

descending

Boolean

結果を降順で並べ替えるかどうかを指定します。

whereClause

String

このパラメータを使用して、「SQLのWhere節」を追加し、検索結果をフィルタリングします。

maxDocIds

Integer

返されるドキュメントIDの最大数を指定します(初期設定は100)。

たとえば、resultSizeに10、maxDocIdsに50を指定し、一致するドキュメントがデータベースに100個あった場合、そのうちの10個については詳細情報が取得され、40個についてはIDのみが返されます。 残りの50ドキュメントについては何も返されません。

説明

FAQ 検索の実行に使用します。 ドキュメントは、渡したカテゴリIDに基づいて取得されます。 そのカテゴリ、またはサブカテゴリにあるドキュメントが返されます。 パフォーマンスを向上するため、これらのメソッドはresultSizeパラメータで指定したユーザ定義のドキュメント セットの詳細情報のみを取得します。 残りのドキュメントについてはIDのみが返されます。 このメソッドを使用すると、たとえば、[先頭]、[戻る]、[次へ]、[最後]といったリンクをクリックしてページ間を移動できるようにセットアップできます。 次のドキュメント セットを取得する場合は、getDocumentsByIDs()メソッドを使用できます。 最大100個のIDが返されます。

戻り値

<UDSObjectList>ノード。ノード内に以下のセクションが返されます。

本章の<UDSObject>ノードの説明セクションで説明されている<UDSObject>ノード。 n が resultSize パラメータに指定した値に等しい場合、このメソッドで検出される最初の n 個のドキュメントについて、<UDSObject> ノードとそのすべてのプロパティが返されます。

たとえば、resultSizeパラメータに10、maxDocIDsパラメータに50を指定し、メソッドが100個のドキュメントを見つけた場合、10個の<UDSObject>ノードがpropertyListパラメータで指定した属性の詳細情報を含む<Attributes>セクションと共に返され、40個の<UDSObject>がIDプロパティのみを含む<Attributes>セクションと共に返されます。 11~20番目のドキュメントID <AttrName>の詳細情報を取得する場合は、getDocumentsByIDs()メソッドをコールして、<AttrValue>のIDを渡す必要があります。