cfsearch

説明

1 つ以上の Verity コレクションを検索します。

cfsearch タグによって検索結果が返されるようにするには、コレクションを作成し、これにインデックスを作成しておく必要があります。

コレクションは、次の方法で作成できます。

• cfcollection タグを使用します。
• ColdFusion MX Administrator で登録します。
• Vspider や MKVDK などのネイティブの Verity インデックス作成ツールを使用します。Vspider および MKVDK の詳細については、『ColdFusion MX の設定と管理』のVerity および Verity ツールの概要を参照してください。

ネイティブの Verity ツールを使用してコレクションを作成する場合は、コレクションを登録する必要があります。コレクションを ColdFusion で登録するには、次の方法を使用できます。

• cfcollection タグを使用します。
• ColdFusion MX Administrator で登録します。

コレクションには、次の方法でインデックスを作成できます。

• ColdFusion で、cfindex タグを使用します。
• ColdFusion MX Administrator で、cfindex タグを呼び出します。
• Vspider や MKVDK などのネイティブの Verity インデックス作成ツールを使用します。

詳細については、『ColdFusion MX 開発ガイド』の検索インターフェイスの構築を参照してください。

カテゴリ

拡張タグ

シンタックス

<cfsearch 
   name = "search_name"
   collection = "collection_name"
category = "category[,category2,...]"
categoryTree = "tree_location"
   status = ""
   type = "criteria"
   criteria = "search_expression"
   maxRows = "number"
   startRow = "row_number"
   suggestions = "suggestion_option"
   contextPassages = "number_of_passages"
   contextBytes = "number_of_bytes"
   contextHighlightBegin = "html_string"
   contextHighlightEnd = "html_string"
   previousCriteria = "criteria"
   language = "language">

関連項目

cfcollection、cfexecute、cfindex、cfobject、cfreport、cfwddx

ヒストリ

ColdFusion MX 7:

• category、categoryTree、status、suggestions、contextPassages、contextBytes、contextHighlightBegin、contextHighlightEnd、および previousCriteria の各属性が追加されました。
• author、category、categoryTree、context、rank、size、recordsSearched、および type の各結果列が追加されました。
• ステータス構造体およびその構造体に関連付けられているキーに関する情報が追加されました。
• 個々の K2 サーバーおよび "k2server.ini" ファイルへの参照が削除されました。
• 未登録のコレクションへの参照が削除されました。
• 外部コレクションへの参照が削除されました。ColdFusion MX では、Verity 検索サービスを使用してすべてのコレクションを管理します。
• cflock の推奨事項が変更されました。cfsearch タグを cflock タグで囲むことは推奨事項ではなくなりました。

ColdFusion MX:

• external 属性は使用禁止になりました。今後のリリースではこのタグは機能せずエラーを引き起こす可能性があります。各コレクションが内部コレクションか外部コレクションであるかは自動的に検出され、この情報は保管されます。このタグでは、絶対 (完全修飾) コレクションパス名およびマップ済みコレクション名がサポートされます。
• クエリー結果の動作が変更されました。cfindex タグを使用して、cfsearch オペレーションによるクエリー結果のインデックスを作成できます。
• Verity オペレーションの動作が変更されました。ColdFusion で、Acrobat PDF ファイルでの Verity オペレーションがサポートされるようになりました。
• 複数のコレクションの動作が変更されました。このタグを使用して、複数のコレクションを検索できます。複数のコレクションの検索では、K2 サーバーで登録されたコレクションと他の方法で登録されたコレクションを同時に検索することはできません。
• コレクションのネーミング規則が変更され、スペースを含むコレクション名が使用できるようになりました。
• 次のサポートが変更されました。このタグは、Verity 2.6.1、LinguistX、および ICU ロケールをサポートしています。
• 返す例外が変更されました。このタグでは SEARCHENGINE 例外を返すことができます。

属性

使用方法

cfsearch タグは、cfoutput タグ内の参照可能な列を持つクエリーオブジェクトを返します。たとえば、次のコードでは、"filming" または "filmed" に完全一致する用語の検索が指定されます。

<cfsearch 
name = "mySearch"
collection = "myCollection"
criteria = '<WILDCARD>`film{ing,ed}`'
type="explicit"
startrow=1
   maxrows = "100">
<cfdump var = "#mySearch#>

この例では、一重引用符 (') およびバックティック (`) が区切り文字として使用されています。詳細については、『ColdFusion MX 開発ガイド』のVerity 検索式の使用を参照してください。

検索のパフォーマンスを最適化するには、常に maxrows 属性を指定し、使用するアプリケーションの要件に応じた値に設定してください。値を 300 未満に設定すると、最適なパフォーマンスが得られます。

cflock タグをこのタグと共に使用しないでください。Verity にはロック機能が用意されています。cflock タグを使用すると、検索のパフォーマンスが低下します。

cfsearch タグの結果列

context

url

key

title

score

custom1、custom2、
custom3、custom4

size

rank

author

type

category

categoryTree

summary

recordCount

currentRow

columnList

recordsSearched

ステータス構造体キー

found

searched

time

suggestedQuery

keywords

keywordScore

エラーを引き起こす可能性があるアプリケーションユーザーが Verity コレクション内で、通常エラーとなる標準外の文字列、単語、または文字 ("AB23.45.67" や "--->"など) を検索できるようにするため、これらの要素をリストして Verity でのそれらの形式を定義したテキストファイルを作成できます。このファイルには style.lex と名前を付け、コピーを次のディレクトリに置きます。

• Windows の場合 :
  • cf_root¥verity¥k2¥common¥style (通常、cf_root = C:¥CFusionMX7)
  • cf_root¥verity¥Data¥stylesets¥ColdFusionK2
• UNIX の場合 :
  • cf_root//verity/k2/common/style (通常、cf_root = /opt/coldfusionmx7)
  • cf_root/verity/Data/stylesets/ColdFusionK2

マルチサーバー設定および J2EE 設定の場合は、Verity を別のディレクトリにインストールします。

メモ: 山括弧 (< または >) などの文字を検索するには、criteria 属性値として "&lt:" や "&lt:" などを使用する必要があります。括弧は Verity で予約されており、文字のエスケープにバックスラッシュ (criteria="¥<") を使用したとしても、このコンテキストでは機能しません。詳細については、『ColdFusion MX 開発ガイド』のVerity 検索式の使用を参照してください。

例

<!--- #1 (TYPE=SIMPLE) ----------------------------->
<cfsearch
   name="name"
   collection="snippets,syntax,snippets"
   criteria="example" 
   maxrows = "100">
<p>
<cfoutput>Search Result total =  #name.RecordCount# </cfoutput><br>
<cfoutput>
   url=#name.url#<br>
   key=#name.key#<br>
   title=#name.title#<br>
   score=#name.score#<br>
   custom1=#name.custom1#<br>
   custom2=#name.custom2#<br>
   summary=#name.summary#<br>
   recordcount=#name.recordcount#<br>
   currentrow=#name.currentrow#<br>
   columnlist=#name.columnlist#<br>
   recordssearched=#name.recordssearched#<br>
</cfoutput>
<cfdump var = #name#>
<br>

<!--- #2 (TYPE=EXPLICIT) ----------------------------->
<cfsearch
   name = "snippets"
   collection = "snippets"
   criteria = '<wildcard>`film{ing,ed}`'
   type="explicit"
   startrow=1
   maxrows = "100">
<cfoutput 
   query="snippets">
   url=#url#<br>
   key=#key#<br>
   title=#title#<br>
   score=#score#<br>
   custom1=#custom1#<br>
   custom2=#custom2#<br>
   summary=#summary#<br>
   recordcount=#recordcount#<br>
   currentrow=#currentrow#<br>
   columnlist=#columnlist#<br>
   recordssearched=#recordssearched#<br>
</cfoutput>
<cfdump var = #snippets#> 
<br>

<!--- #3 (CF key による検索) ----------------------------->
<cfsearch
   name = "book"
   collection = "custom_book"
   criteria = "cf_key=bookid2"
   maxrows = "100">
<cfoutput>
   url=#book.url#<br>
   key=#book.key#<br>
   title=#book.titleE#<br>
   score=#book.score#<br>
   custom1=#book.custom1#<br>
   custom2=#book.custom2#<br>
   summary=#book.summary#<br>
   recordcount=#book.recordcount#<br>
   currentrow=#book.currentrow#<br>
   columnlist=#book.columnlist#<br>
   recordssearched=#book.recordssearched#<br>
</cfoutput>
<cfdump var = #book#> 

ColdFusion MX 7 | ColdFusion MX 6.1 | ColdFusion MX* | ColdFusion 5* | フォーラム* | デベロッパーセンター | サポート情報 | バグ報告

バージョン7