cfcollection では次のスクリプトスタイルシンタックスをサポートしています。 new collection().CREATE(collection=“<コレクション名>”, engine=“solr”, path=“<solr ディレクトリのパス>”); <cfcollection action = “アクション” categories = “yes|no” collection = “コレクション名” engine = “solr language = “言語” name = “クエリ名” path = “c”>
メモ：このタグの属性は attributeCollection 属性で指定でき、その値は構造体になります。attributeCollection 属性で構造体の名前を指定し、タグの属性名を構造体のキーとして使用します。 |
関連項目
cfexecute、cfindex、cfobject、cfreport、cfsearch、cfwddx
履歴
ColdFusion（2016 リリース）：path 属性は無視されます。
ColdFusion 9：engine 属性が追加されました（Solr のサポートのため）。ColdFusion MX 7：
- ColdFusion MX 7 以降では、cfcollection タグを使用して既存のコレクションのエイリアス名を作成できません。Verity はすべてのコレクション情報を保持するので、2 つの名前が同じコレクションをポイントすることはできません。
- 外部コレクションへの参照が削除されました。
- action 属性の map オプションと repair オプションは非推奨になりました。これらの属性は今後のリリースでは機能せず、エラーが発生する可能性があります。
- categories 属性と categorylist アクションが追加されました。
- CATEGORIES、SIZE、DOCCOUNT および LASTMODIFIED が、list アクションによって返される変数のリストに追加されました。
- list アクションによって返される MAPPED、ONLINE および REGISTERED 変数は廃止になりました。
ColdFusion MX： - action 属性の必要条件が変更され、指定が必須になりました。
- action 属性の list 値が追加されました。この値がデフォルト値です。
- action 属性の値 map の必要条件が変更され、action 属性の値 map を指定する必要がなくなりました。ColdFusion により、コレクションが検出され、必要に応じてコレクションがマッピングされます。
- コレクションのネーミング規則が変更され、スペースを含むコレクション名が使用できるようになりました。
- Verity オペレーションの動作が変更されました。ColdFusion で、Acrobat PDF ファイルに対する Verity オペレーションがサポートされるようになりました。
- 返す例外が変更されました。このタグでは SEARCHENGINE 例外を返すことができます。
属性
属性 |
必須／オプション |
デフォルト |
説明 |
|---|---|---|---|
action |
必須。「使用方法」を参照 |
list |
|
categories |
「使用方法」を参照 |
no |
コレクション作成のためにのみ使用できます。
|
collection |
「使用方法」を参照 |
|
|
engine |
オプション |
Solr |
コレクションの検索エンジンです。
|
language |
「使用方法」を参照 |
English |
オプションのリストについては、「使用方法」を参照してください。 |
name |
「使用方法」を参照 |
|
list アクションおよび categorylist アクションによって返されるクエリ結果の名前です。 |
path |
オプション |
|
コレクションの絶対パスです。既存のコレクションをマッピングするには、コレクションの完全修飾パスを指定します（コレクション名は含めない）。例えば、"C:¥MyCollections¥" と指定します。 すべてのコレクションは、ColdFusion Administorator ページの「Solr ホーム」フィールドで指定された場所に作成されます。 注意：ColdFusion 2016 以降、path 属性は無視されます。すべてのコレクションは、ColdFusion Administrator ページの Solr_Home フィールドで指定された場所にある collections ディレクトリに作成されます。 |
このタグを使用すると、次の操作を実行できます。
- Solr コレクションの作成
- このタグまたは ColdFusion Administrator によって作成された Solr コレクションの管理
このタグの属性値の依存関係を次の表に示します。
各属性の指定要件（必須、オプション、または不要（空白）） |
action 属性の値 |
||||||
|---|---|---|---|---|---|---|---|
|
list |
create |
map |
optimize |
repair |
delete |
category list |
collection |
|
必須 |
必須 |
必須 |
必須 |
必須 |
必須 |
path（非推奨） |
|
|
|
|
|
|
|
language |
|
オプション |
オプション |
|
|
|
|
name |
必須 |
|
|
|
|
|
必須 |
categories |
|
|
|
|
|
|
|
次の例では、categorylist アクションによって返される構造体を示します。
CATEGORIES |
|
|---|---|
blue |
10 |
green |
3 |
magenta |
3 |
purple |
2 |
CATEGORYTREES |
|
a/ |
10 |
a/b |
10 |
a/b/c |
10 |
a/b/c/subdir |
3 |
list アクションは、1 つのコレクションにつき 1 行を含む結果セットを返します。この情報を次に示します。
列 |
内容 |
|---|---|
CATEGORIES |
|
CHARSET |
コレクションの文字セットです。 |
CREATED |
コレクションが作成された日付と時刻です。 |
DOCCOUNT |
このコレクション内のドキュメントの数です。 |
EXTERNAL |
|
LANGUAGE |
コレクションのロケール設定です。この情報は K2 サーバーコレクションには使用できません。 |
LASTMODIFIED |
コレクションが最終変更された日付と時刻です。 |
MAPPED |
廃止 |
NAME |
コレクションの名前 |
ONLINE |
廃止 |
PATH |
コレクションの絶対パスです。 |
REGISTERED |
廃止 |
SIZE |
コレクションのサイズです。単位はキロバイトです。 |
uni を指定して複数の言語のサポートを有効にすることもできます。
コレクションが存在するかどうかを判断するには、次のようなコードを使用して、クエリオブクエリを実行します。
<cfcollection action=“list” name=“myCollections” > <cfquery name=“qoq” dbtype=“query”> SELECT * from myCollections WHERE myCollections.name = 'myCollectionName' </cfquery> <cfif qoq.recordcount GT 0> <! --- コレクションが存在する場合 ---> <cfdump var = #qoq#> </cfif>
Solr コレクションが存在するかどうかを確認するには、engine 属性を追加し、その値として solr を指定する必要があります。例：{{<cfcollection action=“list” name=“myCollections” engine="solr">}}検索サーバーに登録されているすべてのコレクションの値とともに結果セットを取得するには、次のようなコードを使用します。
<cfcollection action=“list” name=“myCollections”> <cfoutput query=“myCollections”> #name#<br> </cfoutput>
