Verity Collections

The Verity Development Kit (VDK) provides indexing and searching technology to create, populate, and manage collections of indexed data that are optimized for fast and efficient site searches. It is available on the Verity Collections page.

A collection is a logical group of documents and metadata about the documents. The metadata includes word indexes, an internal documents table of document field information, and logical pointers to the document files.

To use Verity searching in ColdFusion applications, you must:

  1. Create a Verity collection.
  2. Populate a collection with data.
  3. Build searching and indexing capability, using the cfindex and cfsearch tags into your ColdFusion application.

To create a collection:

  1. On the Verity Collection page, in the Name Field, enter a name for your collection. The name can consist of multiple words and spaces.
  2. In the Path field, specify a path for the collection files.
  3. From the drop-down Language list box, select a language for the collection.
  4. Click an option
    Option
    Description
    Create New Collection
    Generates a new collection
    Map Existing Collection
    Connects a new mapping to a collection that was created outside ColdFusion Server or copied from another ColdFusion Server. After the collection is referenced on this page, ColdFusion searching and indexing tags can reference it.
    :
  5. Click Submit Changes.

When you add the first Verity collection, buttons for managing Verity collections will display along the bottom of the table. For instructions about using these buttons, see "Managing collections".


Note

Mapped collections are sometimes confused with external collections. An external collection is one that was created with a tool other than ColdFusion Server, such as the Verity command line tool mkvdk. External collections are then associated with ColdFusion Server so that ColdFusion Server can identify the collection and its directory structure.


To populate a collection:

  1. On the Verity Collections page, in the Connected Verity Collections table, select a collection to populate.
  2. Click Index. The ColdFusion Administrator page displays with the selected collection name at the top.
  3. Review the extensions in the File Extensions field. If necessary, add, edit, or remove extensions for files in the collection.
  4. In the Directory Path field, enter the path to the directory to index.
  5. To include subdirectories of the specified directory, select Recursively Index Sub Directories.
  6. In the Return URL field, enter a URL to which to return documents found in the search of this collection, such as http://localhost/cfdocs.
  7. From the Language drop-down list, select the language of the documents.

    Note

    By default, the Verity English Language Pack installs with ColdFusion Server. To select another language, install the corresponding Verity Language Pack. The Verity Language Packs are included on the ColdFusion Server CD-ROM.


  8. Click Submit Changes.

ColdFusion Server populates the collection with data from the specified directory.

Building searching and indexing capabilities

For more information about building search interfaces, see the chapters about the cfindex, cfsearch, cfcollection tags in the Developing ColdFusion Applicationsbook.

For faster searching, establish a Verity Server link in the Administrator to take advantage of the Verity K2 Server. This server caches collection information so that data is retrieved more quickly when searches are run with the cfsearch tag. The K2 Server delivers rapid search results in a highly efficient and scalable architecture.

For more information on using the VDK and K2 Server with ColdFusion Server, see the Advanced ColdFusion Administration book.

Managing collections

You can repair, optimize, purge, or delete Verity collections that are connected to the ColdFusion Server. To manage collections, use the buttons along the bottom of the Connected Verity Collections table.


Note

Before performing management operations, ensure that the K2 Server is not using the collections. For more information, see the K2 Server documentation in Advanced ColdFusion Administration book.


The following table describes the options:
Option
Description
Repair
Re-indexes a collection to fix broken links and update indexes
Optimize
Reclaims space left by deleted and changed files by consolidating collection indexes for faster searching. Optimize your collections regularly
Purge
Deletes all documents in the collection, but not the collection itself. Leaves the collection directory structure intact
Delete
Deletes a collection

To repair a collection:

  1. On the Verity Collections page, select a collection from the Connected Verity Collections table.
  2. Click Repair. A message warns you not to work on the collection during the repair process, which can occur over several minutes.
  3. Click OK.

When you repair a collection, a confirmation statement displays above the table.

To optimize a collection:

  1. On the Verity Collections page, select a collection from the Connected Verity Collections table.
  2. Click Optimize. A message prompts you to verify the process, which can occur over several minutes.
  3. Click OK.

When the optimization is complete, a confirmation statement displays above the table.

To purge a collection:

  1. On the Verity Collections page, select a collection from the Connected Verity Collections table.
  2. Click Purge. A verification message warns you that purging of data cannot be undone.
  3. Click OK.

When the purge is complete, a confirmation statement displays above the table.

To delete a collection:

  1. On the Verity Collections page, select a collection from the Connected Verity Collections table.
  2. Click Delete. A verification message displays warns you that deleting a collection cannot be undone.
  3. Click OK.

When the delete is complete, a confirmation statement displays above the table.

Verity supported file types

The ColdFusion VDK implementation supports the document types listed below
Document Type
Format or Program
Version
Text
HTML, CFML, DBM, SGML, XML, ANSI, ASCII, Plain Text
Not applicable
Word processing
Adobe Acrobat (PDF)*
All
Applix Words
4.2
Lotus AMI Pro
2.3
Lotus AMI Pro Write Plus
All
Lotus Word Pro
96, 97
Microsoft Rich Text Format (RTF)
1.x, 2.0
Microsoft Word for Windows
2, 6, 95, 97, 2000
Microsoft Word for DOS
4, 5, 6
Microsoft Word for Macintosh
4, 5, 6
Microsoft Works
All
Microsoft Write
All
WordPerfect
5.x, 6, 7, 8
WordPerfect for Macintosh
2, 3
XYWrite
4.12
Unicode
Not Applicable
Spreadsheet
Applix Spreadsheets
4.2, 4.4
Corel QuattroPro
7, 8
Lotus 1-2-3
2, 3, 4, 5, 96, 97
Microsoft Excel
3, 4, 5, 96, 97, 2000
Microsoft Works
All
Presentation
Corel Presentations
7.0, 8.0
Lotus Freelance
96, 97
Microsoft PowerPoint
4.0, 95, 97, 2000
* Not Supported in Linux.
:



Banner.Novgorod.Ru