
HEY EXCHANGE USERS...... Do you know the 

		FOUR STEPS TO NIRVANA
		=====================


SUMMARY on 'Four Steps'
=======================
To extract data from the exchange server and load it into the AltaVista
Directory, you need to do the following:-


1) Install the extra software provided.

2) Export the data from the exchange server to a "comma separated file" 
using the utility provided by the Exchange Server .


3) Convert this "comma separated file" into a "tab separated file"
suitable for use with the AltaVista load applet using a application such
as Microsoft EXCEL.

4) Load this file into the AltaVista Directory using the AltaVista load
applet. 


DETAIL on 'Four Steps'
======================

1) Install the extra software
=============================

a) Copy the file exchange.csv from this kit to c:\exchsrv on 
your exchange server system  

b) Copy the following files from this kit to the 
c:\program files\AltaVista directory\library directory on your AltaVista
directory system:-

	[tkconv.tcl, conv.tcl, convproc.tcl, readme.txt, exchange.csv]



2) Export the data from the exchange server
============================================

Export the directory information from the Microsoft Exchange Server using
the Exchange administrator program via the / start / Microsoft exchange/ 
exchange administrator. Then using the directory export invoking the
Directory Export option on the tools menu.

In the Directory Export dialog, specify the following settings:
 
  - Export File: 	Enter exchange.csv
				     				
  - Export Objects:     Mailbox

  - Separators:
			Column:    ,
			Quote:     "
			Property:  %

   - Char Set:		ANSI
	    
After setting up the export dialog, select "Export" to export the data to
your file.
			
Check the data in the input file and make sure that it looks OK

Please refer to the online help provided with the Microsoft Exchange Server
for more detailed information about exporting information. 


3) Converting the exchange.csv file to an AltaVista Directory load file
=======================================================================

a) Copy the exchange.csv file containing your exported information from the
exchange system to the system running the AltaVista directory service, and
place it in the
 
"c:\program files\AltaVista directory\library" directory.   

b) Start up a "command line" window and from your C drive run the conversion
utility as follows:-

"c:\program files\AltaVista directory\system\wish41.exe" "c:\program files\AltaVista directory\library\tkconv.tcl"


Fill in the subsequent dialog as follows:-

Input file:-

	c:\program files\AltaVista Directory\library\exchange.csv

Output file:-

	c:\program files\AltaVista Directory\library\exchange.txt


d) Check the file exchange.txt for possible errors. 


4) Load the information into the AltaVista Directory
=====================================================

a) start the AltaVista directory load applet via the start menu and complete
the subsequent dialog as follows:-

	Input file name:-	c:\program files\AltaVista Directory\library\exchange.txt
	Base of operation:-	Where about in the AltaVista directory you want
				to enter the data  
	Server:-		The AltaVista directory server you want to load with the
				exchange information 
	Password:-		Password for your AltaVista Directory server



Warnings
========

If the AltaVista Directory Load File Generator detects that an attribute value
does not conform to the syntax used by the AltaVista Directory, it writes a
warning message to the input file. For example, the postal address created by
combining the Address, City, State, Postal Code and Country fields could
contain too many characters or too many lines.

The following example shows the warning message that is generated when an
address does not conform to the format expected by the AltaVista Directory:


   # PostalAddress too long - max 6 lines of no more than 30 chars, $ is newline
   Sales Office, Acme Tower, West Randolph $ Chicago $ Il $ 19131 $ USA 

A warning message provides information that you can use to solve the problem,
for example, "max 6 lines of no more than 30 chars". In this example, The
first line of the address contains over 30 characters (a dollar sign ($)
indicates a new line). To make this address valid, edit the output file and
shorten the first line of the address so that it is less that 30 characters,
for example:

   Sales, Acme Tower, W Randolph $ Chicago $ Il $ 19131 $ USA 

Alternatively, as the address contains only five lines and a maximum of six
lines is allowed, you could create a new address line, for example:

   Sales Office, $ Abacus Towers, West Randolph $ Chicago $ Il $ 19131 $ USA 

Note that spaces around dollar signs are not counted as part of the value.

You can leave warning messages in the output file, they are ignored by the
AltaVista Load Applet.

For more information about the syntax of attribute values, see the online help
for the AltaVista Load Applet.


