home *** CD-ROM | disk | FTP | other *** search
/ PSION CD 2 / PsionCDVol2.iso / Programs / 1110 / Readme.txt < prev    next >
Text File  |  2001-08-25  |  8KB  |  163 lines
  1. ContactC
  2. ContactCopy
  3.  
  4. UPGRADE NOTICE
  5. This applies only if you are upgrading from earlier versions.
  6. Before using ContactC version 5.00, copy UpgrC500.opo to the Macros folder
  7. and run it as a macro once; then delete UpgrC500.opo. This will upgrade the
  8. fields databases. Do not use on fields databases zipped with version 5.00.
  9.  
  10. PURPOSE
  11. ContactC brings data from Contacts to your documents in a fully customisable
  12. fashion.
  13. It was designed as a tool for addressing Word documents such as letters and
  14. faxes.
  15.  
  16. SETUP
  17. ContactC runs under Macro5, ⌐ Pascal Nicolas.
  18. Install SYSTINFO.SIS and CNTOPX.SIS; copy ContactC.opo to the Macros folder;
  19. create a folder for storage of field code databases and copy the "All
  20. fields", "Fax fields", "Private" and "Business" databases to this folder.
  21. At first startup you will be prompted to select one of these fields databases.
  22. A directory C:\System\Apps\ContactC\ will be created, including files
  23. ContactC.dat and ContactC.ini. This concludes the initialisation.
  24.  
  25. USAGE
  26. Usage is evident:
  27. ò Run ContactC;
  28. ò Enter any text referring to first name, last name or company name of the
  29. recipient and hit OK, or alternatively enter a text string and choose Ctrl+A
  30. for search in all fields (in this option use * to separate text that may
  31. appear in different fields);
  32. ò Matching contacts will be shown; pick the one you are looking for or refine
  33. the search (use Ctrl+V to paste the search string, e.g. as search input for
  34. ContactX);
  35. ò For switching fields database or changing field settings press Fields
  36. (Ctrl+F).
  37. If you choose Copy (Ctrl+C) from the last dialog, field labels and contact
  38. data will be written to the clipboard; use Ctrl+V to paste.
  39. Hitting OK will directly paste contact data in the foreground document,
  40. provided that direct pasting has not been disabled for the target application.
  41.  
  42. COPY/PASTE
  43. By default, direct pasting has been disabled with the applications Bombs,
  44. Calc, Record, Spell, System and Macro5. Pressing either Copy or OK will write
  45. field labels and contact data to the clipboard in these cases.
  46. For changing the default settings an add-on macro is available. To obtain
  47. this macro please send a request to the author, indicating your machine type
  48. and language version.
  49.  
  50. ADDRESSING
  51. ContactC was designed for addressing Word documents, such as letters and
  52. faxes:
  53. ò Create a Word template using field codes as set in the "All fields"
  54. database (templates "ContactC.tpl" and "Fax.tpl" supplied), or adapt the
  55. codes in the database to suit existing templates;
  56. ò Create a new document based on this template;
  57. ò Run ContactC, find the recipient and press OK.
  58. If the foreground document is a non-empty Word document and the addressing
  59. flag is set (see below), the field codes in the document will be replaced
  60. with the corresponding address data of the recipient. Here Ctrl+V pastes the
  61. recipients first + last name or company name. The document is saved before
  62. addressing; revert to saved if you don't like the result (Ctrl+R).
  63. The code replacement works by sending keys to Word, using Macro5 commands. In
  64. order to allow Word to keep up with this process it is slowed down. The time
  65. required for addressing can be significantly reduced by deleting unused codes
  66. from the fields database.
  67.  
  68. FIELD DATABASES
  69. You can create separate field databases for different tasks (such as "Fax
  70. fields") and customise the pasting behaviour for each task using settings.
  71. Field names in the databases may be changed freely. Do not modify the ID
  72. numbers, which identify the fields to be called from the Contacts database.
  73. The ID sequence is Contacts default; nr 33 (birthday) is left out since the
  74. Contact.opx does not support the date format.
  75. Settings may be specified from the View option (Ctrl+V) in the Fields dialog.
  76. Keep the Settings record (ID=0) in top of the database for convenient
  77. updating. If it is in another position you may manually paste modified
  78. settings from the clipboard.
  79. Flags
  80. a=0    addressing disabled
  81. a=1    addressing enabled
  82. f=0    no field labels pasted
  83. f=1    field labels from contacts store
  84. f=2    field labels from fields database
  85. b=0    forced line break after contact data (Shift+Enter)
  86. b=1    new paragraph after contact data (Enter)
  87. y=0    year in four digits
  88. y=1    year in two digits
  89. s=0    time without seconds
  90. s=1    time with seconds
  91. Numeric
  92. r=#    number of tabs before field labels
  93. t=#    number of tabs between field labels and data
  94.     ò valid nrs of tabs are 0 thru 4; default is 1
  95. n=###    maximum paste length of name data strings (field ID's 1 thru 5)
  96. l=###    maximum paste length of other data strings (field ID's 6 thru 34)
  97.     ò valid string lengths are 0 thru 250; default is 250
  98. Text
  99. i=?    index; this single-digit string is internally appended to all field codes
  100. specified in the fields dbase (space is ignored)
  101. Syntax
  102. ò default values for flags and text are zero c.q. null
  103. ò if a flag or text is expected, only the single digit directly behind the =
  104. is read
  105. ò if a numeric is expected, only the first 3 figures directly behind the =
  106. are read
  107. ò for flags, any reading other than zero, space, or 1 is interpreted as 2
  108.  
  109. HISTORY
  110. Version    Bytes    Date    Modifications
  111. 5.00    15388    25 aug 2001    ò    final        ò    uses ContactX search book if
  112. suitable        ò    line breaks flag inverted        ò    new default settings for data string
  113. lengths
  114. 2.00    14786    22 jun 2001    ò    not released        ò    code synchronised with ContactX
  115. 4.00        ò    re-arranged settings
  116. 1.90    14735    01 may 2001    ò    setting added for line breaks
  117. 1.85    14669    07 feb 2001    ò    fixed minor flaw on search skipping
  118. 1.80    14642    01 feb 2001    ò    selected contact added to final fields dialog
  119. 1.75    14591    28 jan 2001    ò    displays ContactX contacts book name
  120. 1.70    14295    22 jan 2001    ò    fixed bug with fields after database switching
  121. 1.65    14308    18 jan 2001    ò    save settings confirmation dialog changed
  122. 1.60    14305    15 jan 2001    ò    credit lines removed from 'About'        ò    final
  123. amendments        ò    unlocks read-only field databases
  124. 1.55    14388    14 jan 2001    ò    settings accessible from program
  125. 1.45    12660    08 jan 2001    ò    layout of final dialog changed
  126. 1.40    12650    06 jan 2001    ò    flaw fixed: Word foregrounded after pasting
  127. 1.35    12652    01 jan 2001    ò    operational for add-on
  128. 1.25    12562    31 dec 2000    ò    prepared for add-on
  129. 1.20    12368    01 nov 2000    ò    name search with * blocked
  130. 1.15    12294    21 oct 2000    ò    fields dbases not allowed in ContactC.ini folder
  131. 1.10    12191    20 oct 2000    ò    allows fields dbases in System folder if
  132. visible        ò    checks active contacts store (C or D disk)
  133. 1.00    11853    10 may 2000    ò    first release
  134.  
  135. COPYRIGHT
  136. All rights reserved by the author.
  137.  
  138. DISCLAIMER
  139. The author waives responsibility for any adverse consequence of using this
  140. program;
  141. running it is allowed under the condition that the user accepts the full risk
  142. of use.
  143.  
  144. CREDITS
  145. To Pascal Nicolas for Macro5 and support on clipboard functions, to Huub
  146. Linthorst for date and time routines, to Richard Smedley for SafeOPL and to
  147. Joachim Maier for support with the German 5mx.
  148.  
  149. KNOWN ISSUES
  150. ContactC was written on the UK 5mx, and tested on the UK and German 5mx.
  151. All known issues originate from the Contact.opx library, version 1.00. It is
  152. yet unknown when EPOC will have the opx debugged.
  153. ò The contents of the "Job title" field are ignored in searches.
  154. ò Fields in contacts that were imported from other vCard applications may not
  155. be recognised. These will be pasted as "û failed û", where the û has
  156. character code 150. Known failures involve address fields, following
  157. synchronisation with MS Outlook and MS Schedule.
  158.  
  159. FEEDBACK
  160. Please mail your findings to:        Frans Franken
  161.                 ContactC@franken.demon.nl
  162. Latest version and more at:        http://www.franken.demon.nl
  163.