//////////////////////////////////////////////////////////////////////
//
// INFORMATION ABOUT THE FULL TEXT SEARCH FUNCTION IN THE WebKB
//
//
// (C) COPYRIGHT 2004 BY ALASKA SOFTWARE INC
// ALL RIGHT RESERVED.
//
//////////////////////////////////////////////////////////////////////

What is the WebKB ( Web Knowledge Base ) ?
------------------------------------------

Alaska Software internally uses a Defect Tracking System (DTS) which
- in the meantime - has been migrated and changed to a huge
collection of known issues, defects, anomalies and, last but not
least, knowledge (informational purpose) all around the Alaska
Softwares Xbase++ products.

The WebKB is actually a web interface to that Knowledge Base. So
it is possible to give Alaska Software's customers access to the
WebKB.

NOTE: The complete WebKB and Full Text Search is entirely
written in Xbase++ and is powered by Alaska Software's
Web Application Adapter (WAA).


What is the Full Text Search ?
---------------------------------

The biggest issue - and thus the most requested feature - for the
WebKB has been, that a user should be able to find the appropriate
information without haveing to know a PDR ID (reference ID for the
article). It was designed to enter keywords and let the WebKB search
the entire database.

Now, listening to the customer demand, this new feature has been
added and implemented by Alaska Software. It now allows to query the
entire database for one or more keywords in any combination in a
very comfortabe way.


How to use the Full Text Search:
-----------------------------------

On Alaska Software's homepage click on the "DTS Full Text
Search"-Button to access the query page.

The upper input field will take the keyword(s) (one or more keywords
can be entered) and the operators (how the keywords should be
combined for the search) to describe your search best.

The complete Knowledge Base will be searched for the entered
keywords and a result list will be displayed, which contains:

the PDR number, the symptom and the open/close state.

The search is NOT CaSe SeNsItIvE.

This list is sorted by PDR ID DESCENDING. The most current one is
displayed first and the most ancient is the last one.

The search string including its operators are displayed for your
convenience in Xbase++ syntax. Please verify if this meets what you
were looking for.

Check the time elapsed to complete the search. It is displayed
for informational purpose and of course to show how quick this task
can be fulfilled.

By clicking on the PDR number, a new brwoser window will pop up and
this windows will display all information on that issue.


Limitations of the Full Text Search:
---------------------------------------


A limitation of the search is, that we limited the amount of hits
to a maximum of 200. This reduces Internet traffic. So the search
should be specified.

To specify the search, operators can be used!

You cannot use braces to specify and to describe the search.


Operators in the Full Text Search:
-------------------------------------

A search request in the Knowledge Base will search the fields PDR
ID, build ID (on which Xbase++ version the PDR has been
opened), symptom line, description and workaround.

The keywords to be searched in the Full Text Search can be
combined using operators.

All operators have to be enclosed within blanks, except for "+",
"-", "!" and "&". These operators may be located directly in front
of a keyword (see samples below).

The following operators can be used!


The AND - operator: +, AND, .AND.
---------------------------------

The AND - operator links keyword1 AND keyword2 to a logical
condition and the search has to match this condition.

For example:
"XPP .AND. TOOLS"

This search just returns those articles, which contain "XPP" and
"TOOLS" within the above listed fields.

You can use equivalent:

"XPP +TOOL" or
"XPP + TOOL" or
"XPP AND TOOL" or
"XPP .AND. TOOL"


The OR - operator: &, OR, .OR.
---------------------------------

The OR - operator links keyword1 and keyword2 to a logical
condition and the search has to match this condition.

For example:
"XPP .OR. TOOLS"

This search returns all the articles, where "XPP" OR "TOOLS" are
found within the fields listed above.

You can use equivalent:

"XPP &TOOLS" or
"XPP & TOOLS" or
"XPP OR TOOLS" or
"XPP .OR. TOOLS"


The NOT - operator: -, NOT, .NOT., !
------------------------------------

The NOT - operator negates the search and excludes the follwoing
search string from the leaft hand search keyword.

For example:
"XPP .NOT. TOOLS"

This search returns all articles, which include "XPP" but NOT
"TOOLS".

You can use equivalent:

"XPP -TOOLS" or
"XPP - TOOLS" or
"XPP !TOOLS" or
"XPP ! TOOLS" or
"XPP NOT TOOLS" or
"XPP .NOT. TOOLS"


More options in the Full Text Search:
---------------------------------------

There are two more search criterias:
- search for ALL / OPEN / CLOSED PDRs.
- search for a specific operating system.


Hints for Full Text Search usage:
-----------------------------------

It is possible so search directly for an PDR number.
The user can just enter the PDR ID and the searched PDR will be
displayed in the result list. Then all PDRs which are referring to
this PDR number will be displayed, too.

It is also possible to search for the BUILD number.
Just enter the BUILD number and all PDRs opened on this BUILD number
are displayed.

Of course, it is possible to combine any search pattern with
operators to get a more specialized result. The search will be
re-worked from left to right and each single intermediate result
will be passed to the next outstanding operator and search string.

************************************************************************

(C) Copyright Alaska Software Inc. 2004, All rights reserved!

Disclaimer, Limitation of Liability, no Warranty: THE INFORMATION,
DOCUMENTS, FILES AND MATERIALS CONTAINED IN THIS SITE ARE PROVIDED "AS
IS". ALASKA SOFTWARE DOES NOT WARRANT THE ACCURACY, ADEQUACY
OR COMPLETENESS OF THIS INFORMATION AND MATERIALS; THUS EXPRESSLY
DISCLAIMS LIABILITY FOR ERRORS OR OMISSIONS IN THIS INFORMATION AND
MATERIALS. WARRANTIES OF ANY KIND, IMPLIED, EXPRESSED OR STATUTORY,
INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF NON-INFRINGEMENT OF
THIRD PARTY RIGHTS, TITLE, MERCHANTABILITY, FITNESS FOR A PARTICULAR
PURPOSE OR RESOLVEMENT-CLAIMS, ARE DISCLAIMED.