描述

. 创建和管理对Verity搜索引擎的连接。

类别

可扩展性标签

语法

<cfcollection 
    action = "action"
    categories = "yes|no"
    collection = "collection name"
    language = "language"
    name = "query name"
    path = "c">

cfexecute, cfindex, cfobject, cfreport, cfsearch, cfwddx

历史

ColdFusion MX 7:

• ColdFusion MX 7创建起始就存在这个标签,你不能用cfcollection标签在已经存在的收藏里创建别名。（ you cannot use the cfcollection tag to create alias names for already existing collections. ）因为Verity包含了所有收藏的信息，同一个收藏不能有两个指向它的名字。（Because Verity maintains all the collection information, you cannot have two names point to the same collection.）
• （Removed reference to external collections.）给外部的收藏变更参考。
• （Deprecated the map and repair options of the action attribute. They might not work, and might cause an error, in later releases.）action属性的已废弃的类别属性和修复选项。他们也许不能运行，还会导致一个错误。
• （Added categories attribute and categorylist action.）添加了类别属性和categorylistaction
• （Added CATEGORIES, SIZE, DOCCOUNT, and LASTMODIFIED to list of variables returned by the list action.）通过list action给变量的清单添加了类别，型号，DOCCOUNT和 LASTMODIFIED 。
• （Marked as obsolete the MAPPED, ONLINE, and REGISTERED variables returned by the list action.）标记已经过时的由list action返回的 MAPPED, ONLINE, 和 REGISTERED 变量。

ColdFusion MX:

• （Changed the requirements for the action attribute: it is now required. ）action属性的要求已经改变： 它现有有要求。
• （Added the action attribute list value. It is the default）.添加了action属性的清单值。现在它是默认值
• Changed the requirements for the action attribute value map: it is not necessary to specify the action attribute value map. (ColdFusion detects collections and creates maps collections as required.)改变了action属性值map的要求：现在它不需要指定action属性的值map。（ColdFusion侦测到了收藏，并按照要求创建了map收藏。）
• （Changed acceptable collection naming: this tag accepts collection names that include spaces.）改变了可接受的收藏的名字：这个标签接受包含有空格的收藏名。
• （Changed Verity operations behavior: ColdFusion supports Verity operations on Acrobat PDF files）.改变了Verity的运行方式：ColdFusion支持Verity在Acrobat PDF 文件上得到运行方式。
• （Changed thrown exceptions: this tag can throw the SEARCHENGINE exception.）改变了thrown exceptions：这个标签可以throw SEARCHENGINE exception，

Attributes

使用方法

用这个标签你可以创建，登记和管理一个Verity收藏，而这个Verity收藏是用ColdFusion或者一个Verity应用程序创建的。（With this tag you can create, register, and administer a Verity collection that was created by ColdFusion or by a Verity application.）

The following table shows the dependence relationships among this tag's attribute values:下面的表格显示了这个标签值之间的依赖关系：

The following examples show the structures returned by the categorylist action:下面的例子显示了被 categorylist action返回的结构：

The list action returns the following information in a result set that contains one row per collection: 这个清单返回了按照要求每行列出一个收藏的结果里面的信息：

（You can also specify uni to enable support for multiple languages）.你也可以指定uni来支持multiple语言。

（The ColdFusion Administrator Verity > Collections page displays the information that is returned when you use the list attribute.） ColdFusion Administrator Verity > Collections 页面显示了当你使用清单属性的时候返回的信息。

If the Verity Server is not running when the list action is executed, the tag throws an error.如果当清单action运行的时候，Verity Server没有运行， 这个标签就会提示错误。

（To determine whether a collection exists, use code, such as the following, to execute a query of queries:）为了确定一个收藏是否存在，你可以使用代码，来运行一个queries的query：

<cfcollection action="list" name="myCollections" > 
<cfquery name="qoq" dbtype="query">
    SELECT * from myCollections 
    WHERE myCollections.name = 'myCollectionName'
    </cfquery> 
<cfif qoq.recordcount GT 0>
    <!--- Collection exists --->
    <cfdump var = #qoq#>
</cfif>

（To get a result set with values for all the collections that are registered with the Verity server, use code such as the following:）通过Verity server登记的所有收藏的值有个结果，为了得到这个结果，你可以使用以下的代码：

<cfcollection action="list" name="myCollections">
<cfoutput query="myCollections">
    #name#<br>
</cfoutput>

（To add content to a collection, use cfindex. To search a collection, use cfsearch.）给一个收藏添加内容，可以使用 cfindex.搜索一个收藏，可以使用cfsearch.

You cannot delete Verity collections on Windows if they are created outside of the ColdFusion collections directory or on a drive other than C:, D: or E:. To use a different drive letter, edit the cf_dir/verity/common/verity.cfg file and replace an entry with the directory you wish to use as follows:如果Verity收藏是在ColdFusion收藏目录外创建的，或者是在c盘，d盘或者e盘外创建的， 你不能在Windows上删除Verity收藏。要使用一个不同的 drive letter,需要编辑 cf_dir/verity/common/verity.cfg文件，并且替换一个带有你想用的目录的entry。

alias11=path6
mapping11=F:\
dirmode11=rw

Restart the ColdFusion Search Service for this change to take affect.重新启动ColdFusion Search Service让所做的改变开始运行。

The language attribute of this tag supports the following options: 这个表亲的语言属性支持以下的选择：

The default location of Verity collections is as follows:Verity收藏默认的位置如下：

• Server 配置:
  • Windows: C:\CFusionMX7\verity\collections
  • UNIX system: /opt/coldfusionmx7/verity/collections
• J2EE 配置: webapp_root/WEB-INF/cfusion/verity/collections

例子

<!-------------------------------------------------------------------------
(coll_actn.cfm)
Check for server platform and use its default Verity Collection directory.
If you did not install ColdFusion in the default directory, or if you use
the J2EE configuration, or if your webroot is not C:\CFusionMX7\wwwroot, you
might need to change the path in this example. For example, for JRun4 the path
might be C:\JRun4\Verity\Collections\
--------------------------------------------------------------------------->
<cfif Find("Windows", Server.OS.Name)>
    <cfset collPath = "C:\JRun4\Verity\Collections\">
<cfelse>
    <cfset collpath = "/opt/coldfusionmx7/verity/collections/">
</cfif>

<!--------------------------------------------------------------------------
Process form input and do the requested cfcollection operation. 
--------------------------------------------------------------------------->

<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>Collection created.<br>
            Use CFINDEX to populate it.</h3>
        </cfcase>
        <cfcase value="Repair">
        <cfcollection action="REPAIR" collection="#FORM.CollectionName#">
        <h3>Collection repaired.</h3>
        </cfcase>
        <cfcase value="Optimize">
        <cfcollection action="OPTIMIZE" collection="#FORM.CollectionName#">
        <h3>Collection optimized.</h3>
        </cfcase>
        <cfcase value="Delete">
        <cfcollection action="DELETE" collection="#FORM.CollectionName#">
         <h3>Collection deleted.</h3>
        </cfcase>
        </cfswitch>
    <cfelse>
    <h3>Please enter a name for your collection</h3>    
    </cfif>
</cfif>

<!--------------------------------------------------------------------
(coll_form.cfm)
Form to specify the collection name and action
    coll_form.cfm
--------------------------------------------------------------------->

<form action="coll_actn.cfm" method="POST" >
<select name="CollectionAction">
    <option value="Create">Create this collection
    <option value="Optimize">Optimize this collection
    <option value="Repair">Repair this collection
    <option value="Delete">Delete this collection
</select>

<p><strong>Collection on which to act</strong><br>
Use the default value or enter your own Collection name<br>
<input type="Text" name="CollectionName" value="My_coll"></p>

<input type="Submit" name="" value="alter or create my collection">
</form>