Gateway Configuration Overview


A single gateway can be configured for one repository type, like HTTP or Lotus Notes, one Verity collection, and a specific security method (for this release). In the description for each gateway in this chapter, the security features are discussed.

Primary Document Key (VdkVgwKey) - New Format

The format for the VdkVgwKey field has changed to a URL-style syntax. There is a format for simple keys (non-compound documents) and compound keys (compound documents).

Simple Keys

The format for simple keys follows standard URL conventions, except query strings and anchors are not supported as part of the URL schema. The format for a simple key is:

protocol://schema-info

Gateway
Protocol Name
Description
File System vgwfsys
file
Solaris file system, NTFS
HTTP
vgwhttp

http
HTTP 1.0, HTTP 1.1 on NT
Exchange vgwmsxch
msx
Microsoft Exchange
Notes
vgwnotes

notes
Lotus Notes
ODBC
vgwodbc

odbc
ODBC
Documentum vgwdctm
dctm
Documentum

Gateway Field Types

There are three basic field types used by gateways:

Repository Fields-Database fields that contain the meta-data in a repository. Typically, repository fields are the actual database column names, DBMS attributes, etc. Repository fields cannot be read by Verity. Repository fields can be mapped to external fields.

External Fields-Database fields that can be read by Verity to perform some functions. External fields can be displayed in a results list or used in a document view composition via the style.dft file.

Internal Fields-Database fields that can be read by Verity without accessing the gateway to perform all field-related functions. Internal fields can be displayed in a results list or used in a document view composition via the style.dft file. Unlike external fields, internal fields can be used to perform field searches and results list sorting.

Security Method

All gateways implement the Results list filtering security method. Using this method the results list includes only those documents that match the query term and which the user has access to.

Using Separate Gateways for Indexing and Viewing

When you use either the Notes gateway or the Exchange gateway to index, you can implement the HTTP gateway for viewing.

The configuration files for both the indexing gateway and the HTTP gateway for viewing must be in the style directory used. The sample style directories for the Notes and the Exchange gateway each have these configuration files defined. All gateways defined for a particular gateway implementation are defined in DataSource sections of the style.vgw file. If a gateway happens to be defined at the top of a style.vgw file, it is treated as if it were defined in a distinct DataSource section.





Copyright © 2002, Verity, Inc. All rights reserved.