ContactC
ContactCopy


PURPOSE
ContactC brings data from Contacts to your documents in a fully customisable
fashion.
It was designed as a tool for addressing Word documents such as letters and
faxes.

SETUP
ContactC runs under Macro5,  Pascal Nicolas.
Install SYSTINFO.SIS and CNTOPX.SIS; copy ContactC.opo to the Macros folder;
create a folder for storage of field code databases and copy the "All
fields", "Fax fields", "Private" and "Business" databases to this folder.
At first startup you will be prompted to select one of these fields databases.
A directory C:\System\Apps\ContactC\ will be created, including files
ContactC.dat and ContactC.ini. This concludes the initialisation.

USAGE
Usage is evident:
 Run ContactC;
 Enter any text referring to first name, last name or company name of the
recipient and hit OK, or alternatively enter a text string and choose Ctrl+A
for search in all fields (in this option use * to separate text that may
appear in different fields);
 Matching contacts will be shown; pick the one you are looking for or refine
the search (use Ctrl+V to paste the search string, e.g. as search input for
ContactX);
 For switching fields database or changing field settings press Fields
(Ctrl+F).
If you choose Copy (Ctrl+C) from the last dialog, field labels and contact
data will be written to the clipboard; use Ctrl+V to paste.
Hitting OK will directly paste contact data in the foreground document,
provided that direct pasting has not been disabled for the target application.

COPY/PASTE
By default, direct pasting has been disabled with the applications Bombs,
Calc, Record, Spell, System and Macro5. Pressing either Copy or OK will write
field labels and contact data to the clipboard in these cases.
For changing the default settings an add-on macro is available. To obtain
this macro please send a request to the author, indicating your machine type
and language version.

ADDRESSING
ContactC was designed for addressing Word documents, such as letters and
faxes:
 Create a Word template using field codes as set in the "All fields"
database (templates "ContactC.tpl" and "Fax.tpl" supplied), or adapt the
codes in the database to suit existing templates;
 Create a new document based on this template;
 Run ContactC, find the recipient and press OK.
If the foreground document is a non-empty Word document and the addressing
flag is set (see below), the field codes in the document will be replaced
with the corresponding address data of the recipient. Here Ctrl+V pastes the
recipients first + last name or company name. The document is saved before
addressing; revert to saved if you don't like the result (Ctrl+R).
The code replacement works by sending keys to Word, using Macro5 commands. In
order to allow Word to keep up with this process it is slowed down. The time
required for addressing can be significantly reduced by deleting unused codes
from the fields database.

FIELD DATABASES
You can create separate field databases for different tasks (such as "Fax
fields") and customise the pasting behaviour for each task using settings.
Field names in the databases may be changed freely. Do not modify the ID
numbers, which identify the fields to be called from the Contacts database.
The ID sequence is Contacts default; nr 33 (birthday) is left out since the
Contact.opx does not support the date format.
Settings may be specified from the View option (Ctrl+V) in the Fields dialog.
Keep the Settings record (ID=0) in top of the database for convenient
updating. If it is in another position you may manually paste modified
settings from the clipboard.
Flags
a=0	addressing disabled
a=1	addressing enabled
f=0	no field labels pasted
f=1	field labels from contacts store
f=2	field labels from fields database
y=0	year in four digits
y=1	year in two digits
s=0	time without seconds
s=1	time with seconds
Numeric
n=###	maximum paste length of name data strings (field ID's 1 thru 5)
l=###	maximum paste length of other data strings (field ID's 6 thru 34)
	 valid string lengths are 0 thru 250; default is 50
r=#	number of tabs before field labels
t=#	number of tabs between field labels and data
	 valid nrs of tabs are 0 thru 4; default is 1
Text
i=?	index; this single-digit string is internally appended to all field codes
specified in the fields dbase (space is ignored)
Syntax
 default values for flags and text are zero c.q. null
 if a flag or text is expected, only the single digit directly behind the =
is read
 if a numeric is expected, only the first 3 figures directly behind the =
are read
 for flags, any reading other than zero, space, or 1 is interpreted as 2

HISTORY
Version	Bytes	Date	Modifications
1.85	14669	07 feb 2001		fixed minor flaw on search skipping
1.80	14642	01 feb 2001		selected contact added to final fields dialog
1.75	14591	28 jan 2001		displays ContactX contacts book name
1.70	14295	22 jan 2001		fixed bug with fields after database switching
1.65	14308	18 jan 2001		save settings confirmation dialog changed
1.60	14305	15 jan 2001		credit lines removed from 'About'			final
amendments			unlocks read-only field databases
1.55	14388	14 jan 2001		settings accessible from program
1.45	12660	08 jan 2001		layout of final dialog changed
1.40	12650	06 jan 2001		flaw fixed: Word foregrounded after pasting
1.35	12652	01 jan 2001		operational for add-on
1.25	12562	31 dec 2000		prepared for add-on
1.20	12368	01 nov 2000		name search with * blocked
1.15	12294	21 oct 2000		fields dbases not allowed in ContactC.ini folder
1.10	12191	20 oct 2000		allows fields dbases in System folder if
visible			checks active contacts store (C or D disk)
1.00	11853	10 may 2000		first release

COPYRIGHT
All rights reserved by the author.

DISCLAIMER
The author waives responsibility for any adverse consequence of using this
program;
running it is allowed under the condition that the user accepts the full risk
of use.

CREDITS
To Pascal Nicolas for Macro5 and support on clipboard functions, to Huub
Linthorst for date and time routines, to Richard Smedley for SafeOPL and to
Joachim Maier for support with the German 5mx.

KNOWN ISSUES
ContactC was written on the UK 5mx, and tested on the UK and German 5mx.
All known issues originate from the Contact.opx library, version 1.00. It is
yet unknown when EPOC will have the opx debugged.
 The contents of the "Job title" field are ignored in searches.
 Fields in contacts that were imported from other vCard applications may not
be recognised. These will be pasted as " failed ", where the  has
character code 150. Known failures involve address fields, following
synchronisation with MS Outlook and MS Schedule.

FEEDBACK
Please mail your findings to:		Frans Franken
				ContactC@franken.demon.nl
Latest version and more at:		http://www.franken.demon.nl
