CFCOLLECTION |
説明 Verity 検索エンジンのコレクションを作成および管理します。
カテゴリ 拡張タグ
シンタックス
    <cfcollection
       action = "action"
       collection = "collection_name"
       path = "path_to_verity_collection"
       language = "language"
       name = "queryname"
    categories = "yes"、"no">
関連項目 cfexecute、cfindex、cfobject、cfreport、cfsearch、cfwddx
ヒストリ ColdFusion MX 7: 外部コレクションへのリファレンスが削除されました。 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 例外を返すことができます。
使用方法 このタグでは、ColdFusion または Verity アプリケーションによって作成された Verity コレクションの登録および管理を行うことができます。 次の表に、このタグの属性値の依存関係を示します。
各属性の指定要件 (必須、オプション、または不要 (空白)) | action 属性の値
--- | ---
list | create | map | optimize | repair | delete | categorylist
    collection
|  | 必須 | 必須 | 必須 | 必須 | 必須 | 必須
    path
|  | 必須 | 必須 |  |  |  |
    language
|  | オプション | オプション |  |  |  |
    name
| 必須 |  |  |  |  |  | 必須
    categories
次の例では、categorylist アクションによって返される構造体を示します。 list アクションは、1 つのコレクションにつき 1 行を含む結果セットを返します。この情報を次に示します。
列 | コンテンツ
--- | ---
CATEGORIES | yes: このコレクションではカテゴリのサポートが有効です。 no: このコレクションではカテゴリのサポートが無効です。
CHARSET | コレクションの文字セットです。
CREATED | コレクションが作成された日付と時刻です。
DOCCOUNT | このコレクション内のドキュメントの数です。
EXTERNAL | yes: コレクションは外部です。 no: コレクションは外部ではありません。 Not Found: コレクションは登録されていますが、定義されたパスで取得できません。
LANGUAGE | コレクションのロケール設定です。 この情報は K2 サーバーコレクションには使用できません。
LASTMODIFIED | コレクションが最終変更された日付と時刻です。
MAPPED | 廃止
NAME | コレクションの名前です。
ONLINE | 廃止
PATH | コレクションの絶対パスです。
REGISTERED | 廃止
SIZE | コレクションのサイズです。単位はキロバイトです。
ColdFusion MX Administrator の [Verity]-[コレクション] ページには、list 属性を使用したときに返される情報が表示されます。 list アクションの実行時に Verity サーバーが起動していない場合、タグはエラーを返します。 コレクションが存在するかどうか判断するには、次のようなコードを使用して、クエリーオブクエリーを行います。
    <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>
Verity サーバーで登録されているすべてのコレクションの値と共に結果セットを取得するには、次のようなコードを使用します。
    <cfcollection action="list" name="myCollections">
    <cfoutput query="myCollections">
       #name#<br>
    </cfoutput>
コレクションに内容を追加するには、cfindex を使用します。コレクションを検索するには、cfsearch を使用します。 このタグの language 属性は次のオプションをサポートします。
Asian 言語パック
Japanese | Korean | Chinese | Traditional Chinese
Multilanguage 言語パック
Unicode |  |  |
Western European 言語パック
Bokmal | Finnish | Italian | Spanish
Danish | French | Nynorsk | Swedish
Dutch | German | Portuguese |
Eastern European/Middle Eastern 言語パック
Arabic | Greek | Polish | Turkish
Bulgarian | Hebrew | Russian |
Czech | Hungarian | Russian2 |
Verity コレクションのデフォルトの保存場所は次のとおりです。 サーバー設定 : Windows の場合 : C:CFusionMX7veritycollections UNIX システムの場合 : /opt/coldfusionmx7/verity/collections J2EE 設定 : webapp_root/WEB-INF/cfusion/verity/collections
例
    <!-------------------------------------------------------------------------
    (coll_actn.cfm)
    サーバーのプラットフォームを調べ、そのデフォルトの Verity コレクションディレクトリを使用します。
    ColdFusion MX をデフォルトのディレクトリにインストールしていない場合、J2EE 設定を
    使用する場合、または Web ルートが C:CFusionMX7wwwroot ではない場合、この例の
    パスを変更しなければならないことがあります。たとえば、JRun4 の場合、パスは
    C:JRun4VerityCollections になることがあります。
    --------------------------------------------------------------------------->
    <cfif Find("Windows", Server.OS.Name)>
       <cfset collPath = "C:JRun4VerityCollections">
    <cfelse>
       <cfset collpath = "/opt/coldfusionmx7/verity/collections/">
    </cfif>

    <!--------------------------------------------------------------------------
    フォーム入力を処理し、要求された cfcollection オペレーションを実行します。
    --------------------------------------------------------------------------->

    <cfif IsDefined("form.CollectionName") AND IsDefined("form.CollectionAction")>
       <cfif form.CollectionName is not "">
          <cfswitch expression="#FORM.CollectionAction#">
            <cfcase value="Create">
              <cfcollection action="CREATE" collection="#FORM.CollectionName#"
                   path="#collPath#" categories="yes">
              <h3>コレクションを作成しました。<br>
             CFINDEX を使用してデータを挿入します。</h3>
            </cfcase>
            <cfcase value="Repair">
              <cfcollection action="REPAIR" collection="#FORM.CollectionName#">
              <h3>コレクションを修復しました。</h3>
            </cfcase>
            <cfcase value="Optimize">
              <cfcollection action="OPTIMIZE" collection="#FORM.CollectionName#">
              <h3>コレクションを最適化しました。</h3>
            </cfcase>
            <cfcase value="Delete">
              <cfcollection action="DELETE" collection="#FORM.CollectionName#">
             <h3>コレクションを削除しました。</h3>
            </cfcase>
          </cfswitch>
       <cfelse>
       <h3>コレクションの名前を入力してください。</h3>
       </cfif>
    </cfif>

    <!--------------------------------------------------------------------
    (coll_form.cfm)
    コレクション名とアクションを指定するためのフォーム
       coll_form.cfm
    --------------------------------------------------------------------->

    <form action="coll_actn.cfm" method="POST" >
    <select name="CollectionAction">
       <option value="Create">このコレクションを作成
       <option value="Optimize">このコレクションを最適化
       <option value="Repair">このコレクションを修復
       <option value="Delete">このコレクションを削除
    </select>

    <p><strong>操作対象のコレクション</strong><br>
    デフォルト値を使用するか、コレクション名を入力してください。<br>
    <input type="Text" name="CollectionName" value="My_coll"></p>

    <input type="Submit" name="" value="コレクションを変更または作成">
    </form>

BLUE |
| 10

GREEN |
| 3

MAGENTA |
| 3

PURPLE |
| 2

A/ |
| 10

A/B |
| 10

A/B/C |
| 10

A/B/C/SUBDIR |
| 3

ACTION |
| 必須。「使用方法」を参照
Default value: "list" categorylist: コレクションからカテゴリを取り出し、各カテゴリ内のドキュメント数を示します。構造体の構造体を返します。そこでは、各サブ構造体を表すカテゴリが一連のドキュメントに関連付けられています。カテゴリツリー内のカテゴリの場合、ドキュメントの数はそのツリー内の当該レベル以下のドキュメントの数です。 create: ColdFusion でコレクションを登録します。 コレクションが存在する場合は、コレクションのマッピングを作成します。 コレクションが存在しない場合は、コレクションを作成します。 delete: コレクションを登録解除してディレクトリから削除します。 list: ColdFusion によって登録されているコレクション群の属性のクエリー結果セットを返します (この結果セットには、name 属性値の名前が付けられます)。 map: コレクションのマッピングを作成します。アクションが create で、コレクションが既に存在している場合、Coldfusion ではコレクションのマッピングも作成されます。 optimize: 検索のため、コレクションの構造体と内容を最適化します。スペースを元に戻します。コレクションがオフラインになり、検索とインデックス作成ができないようになります。 repair: 使用禁止になりました。何も設定されません。

COLLECTION |
| 「使用方法」を参照
コレクション名です。名前にはスペースを含めることができます。

PATH |
| 「使用方法」を参照
Verity コレクションの絶対パスです。 既存のコレクションをマッピングするには、コレクションの完全修飾パスを指定します (コレクション名は含めない)。たとえば、"C:MyCollections" と指定します。

LANGUAGE |
| 「使用方法」を参照
Default value: "English" English はデフォルトの言語ですが、Englishx という English の拡張ロケールも使用できます。オプションのリストについては、「使用方法」を参照してください。 適切な Verity Locales 言語パック (European または Asian) が必要です。

NAME |
| 「使用方法」を参照
list アクションおよび categorylist アクションによって返されたクエリー結果の名前です。

CATEGORIES |
| 「使用方法」を参照
Default value: "no" コレクション作成のためにのみ使用できます。 yes: このコレクションはカテゴリをサポートします。 no: このコレクションはカテゴリをサポートしません。