=================================================================
JHelioDB v0.5 beta
Read Me Notes                              Updated: April 2, 2002
=================================================================
Table of Contents

This document contains the following sections:

1) What is JHelioDB?
2) License
3) Setup
4) Usage
5) System Requirements
6) Available Help and Documentation
7) Technical Support

=================================================================
Overview

1) What is JHelioDB?

JHelioDB will allow the user to easily export or import data
to or from the Helio Desktop v2.0 PIM (Personal Information
Manager).

JHelioDB can import or export data from or to the Helio Desktop in
the following file formats:

- Eudora Nickname format
- LDIF formatted data (Netscape)
- Opera Contact data
- Lotus Organizer data in Comma-Separated-Values format
- Outlook data in Comma-Separated-Values format
- Palm data in Comma-Separated-Values format
- Raw data in Comma-Separated-Values format
- XML formatted data (Based on Capitalware's Customer Information DTD/Schema)

Comma-Separated-Values (CSV):
----------------------------
For any of the Comma-Separated-Values file, the data can be used in
your favorite PIM

LDIF formatted data:
-------------------
For LDIF formatted data, the data can be imported direcly into Netscape
or any other PIM that supports LDIF data.

Opera Contact data:
------------------
For Opera Contact data, the data can be copied directly to the "Contacts.Adr"
file, in the directory: C:\Program Files\Opera

Note:  If you already have data in your C:\Program Files\Opera\Contacts.adr
file then you will need to merge the 2 files.  Or copy the data to your
Helio Desktop program then you can safely overwrite it. Helio PhoneBook
categories are created as Opera AddressBook folders and the Phonebook entries
are transferred to their respective Opera Folder.

XML formatted data:
------------------
For XML formatted data, it can be imported into any PIM that supports XML data.
The DTD (ContactCardXML.dtd) for the generated XML data can be downloaded from
Capitalware's web site ( http://www.geocities.com/capitalware/ ).

Eudora Nickname format:
----------------------
For the Eudora Nickname format, the data is formatted correctly and
you just need to copy the file(s) directly to the Eudora Nickname directory.
If your eudora is located in C:\Eudora this path would normally be
C:\Eudora\Nickname.

Each Helio PhoneBook category is created as a separate Eudora Nickname file.
The Helio PhoneBook category name is used as the Eudora Nickname file name.
The entries are transferred from each Helio PhoneBook category to their
respective Eudora Nickname file.

Make sure you name the file with a txt extension (i.e.  Helio.txt ).
Then copy it to the Eudora Nickname directory.  The next time you
start Eudora it will make a file called Helio.toc (based on the file Helio.txt)
in the same directory.

Each time you use JHelioDB to export data in the Eudora Nickname format,
make sure you delete both of the old files (i.e. Helio.txt & Helio.toc)
in the directory: C:\Eudora\Nickname


Summary of Export Features:
--------------------------
                           PhoneBook      Memo      ToDo
                           ---------      ----      ----
   CSV for Lotus Organizer   Yes          Yes       Yes
   CSV for OutLook           Yes          Yes       Yes
   CSV for Palm              Yes          Yes       Yes
   CSV for Raw               Yes          Yes       Yes
   Eudora                    Yes          No        No
   LDIF                      Yes          No        No
   Opera                     Yes          No        No
   XML                       Yes          No        No


Testing:
-------
I have tested JHelioDB on:
- Windows 2000 with JDK 1.3.1
- Windows 98 with JRE 1.3.1.

JHelioDB uses JDBC-ODBC drivers to access the Helio Desktop database.
This database is just a MS Access database.  Before you run JHelioDB,
make sure you run SetupODBC4JHelioDB.exe (see instructions below).


=================================================================
2) License

I make this program available for use by people under the terms
of freeware.  I still retain the copyright for JHelioDB.
To register JHelioDB, just send me a postcard or even easier,
just email at capitalware@rogers.com


=================================================================
3) Setup

- Unzip the file JHelioDB.zip into any subdirectory.
  A good place is probably C:\Capitalware\JHelioDB

  JHelioDB.zip contains 5 files:
   - JHelioDB.jar,
   - JHelioDB.bat,
   - SetupODBC4JHelioDB.exe
   - ReadMe.txt
   - ReadMe.htm

- To setup the JDBC-ODBC System DSNs for JHelioDB to use, you must run
  SetupODBC4JHelioDB.exe

  Select the user directory (i.e.  \1 or \2 or \3 etc...) that
  corresponds to the user data that you want to export/import.

  Note: If you have multiple UserIds that you wish to export or import
  data to or from  then just re-run SetupODBC4JHelioDB.exe and select
  a new user.

- JHelioDB requires Java.  You can install either the JDK or the JRE.
  To get the current version of JDK or JRE, go to
  http://java.sun.com/j2se/1.4/

  Then follow the instructions for either JDK or JRE package to install it.


=================================================================
4) Usage

- On any of the following platforms: Windows 98/ME/NT/2000

  Just run JHelioDB.bat from the current directory.
  i.e.
     JHelioDB


=================================================================
5) System Requirements

To install and run JHelioDB, you must have:

- Windows 98/ME/NT/2000
- Helio Desktop v2.0
- Java JDK or JRE
- ODBC32 (installed by default on Windows 98/ME/NT/2000)


=================================================================
6) Available Help and Documentation

What your reading is what you get.


=================================================================
7) Technical Support

I (Roger Lacroix) can be reached by email at capitalware@rogers.com

For more VTech Helio related downloads, go to:

http://www.geocities.com/capitalware/


Copyright 1996 - 2002 Capitalware Inc., All rights reserved

