home *** CD-ROM | disk | FTP | other *** search
/ Die PSION Power-CD 2 / PsionPowerCD2.iso / PSION-Power-CD / software / Doku / contactx_r.txt < prev    next >
Text File  |  2001-01-18  |  8KB  |  154 lines
  1. ContactX
  2. Contacts book searcher
  3.  
  4.  
  5. PURPOSE
  6. ContactX provides easy searching through contacts databases, while creating
  7. and maintaining databases and backup files.
  8.  
  9. SETUP
  10. ContactX runs under Macro5, ⌐ Pascal Nicolas.
  11. Install SYSTINFO.SIS and CNTOPX.SIS, and copy ContactC.opo to the Macros
  12. folder. Create one or more new contacts files, e.g. by converting data type
  13. files to contacts (using DataContact, ⌐ Pascal Nicolas), and place these
  14. files in a folder on C or D disk. This will be the search folder. If you
  15. don't have any new files then copy the supplied "Developers.cdb" for
  16. demonstration.
  17. On first run the program will prompt you to indicate the search folder. The
  18. existing Contacts dbase will be saved to this folder as "My contacts.cdb"; if
  19. a file with this name already exists it will be replaced.
  20. Optionally check the 'Keep backups' box, hit OK and select a folder for
  21. storage of backup files (this can be the same as the search folder).
  22. A directory C:\System\Apps\ContactX\ will be created, including a
  23. ContactX.ini file. This concludes the initialisation.
  24.  
  25. USAGE
  26. On running ContactX a text entry box is presented. If you wish to change data
  27. search folder or backup folder press Files (Ctrl+F). Enter any text referring
  28. to first name, last name or company name and hit OK, or alternatively enter a
  29. text string and choose Ctrl+A for search in all fields.
  30. If matching contacts are found in only one database, this database is copied
  31. to Contacts and the search result is presented. If a match appears in more
  32. than one file, you will be prompted to select the preferred database. Hit Esc
  33. to search again.
  34. A search with no entry text allows to select any .cdb file in the search
  35. folder, or to update in case there is only one file.
  36. The Contacts database, if exchanged and if modified, will be stored to the
  37. data search folder under its representative name, replacing the earlier
  38. version or moving it to the backup folder if opted. Please note that backups
  39. may be overwritten by files with identical names from different source
  40. folders.
  41. In the file selector dialog, choose Ctrl+R to restore earlier versions of the
  42. selected database. If there are backups you get more restore options.
  43. If ContactX quits while the message "Contacts in use" is displayed, then not
  44. all applications (clients) calling upon the Contacts database were closed
  45. within reasonable time. If this persists on rerunning ContactX, then manually
  46. detach (close) the clients that are still open.
  47. The 'All text' search function is different from the option in Contacts, and
  48. more powerful. Besides scanning name fields as in the normal search function,
  49. it checks the combined presence of text strings in all fields and searches
  50. through the loaded database. Use it if you have scattered information on the
  51. aimed contact, entering * to separate text that may appear in different
  52. fields (such as "john*london*@").
  53.  
  54. CONTACTS FILE EXPORT
  55. As of version 2.90, ContactX features the option to export matching contacts
  56. to a new contacts file. This allows to:
  57. ò view only the matching contacts in the Contacts window, which often is
  58. impossible whithin the existing file(s);
  59. ò import a list of selected contacts into other applications like Word, Data
  60. or spreadsheets (via Malcolm Bryant's freeware "C2F" program).
  61. The export feature is always invoked by choosing the 'All text' option, if a
  62. search string is entered which contains an * preceded by text (such as
  63. "John*London" or "John*"). The new contacts file will be written to the
  64. search folder, where it will be available for further manipulation just like
  65. the existing files.
  66.  
  67. HISTORY
  68. Version    Bytes    Date    Modifications
  69. 3.65    14792    18 jan 2001    ò    searching not skipped after changing folders
  70. 3.60    14798    15 jan 2001    ò    credit line removed from 'About'ò    detects read-only
  71. contacts files
  72. 3.55    14496    06 jan 2001    ò    recent flaw on 'All text' search fixed
  73. 3.50    14512    08 nov 2000    ò    final amendments
  74. 3.45    14444    01 nov 2000    ò    name search with * allowed
  75. 3.40    14370    29 oct 2000    ò    bug with single book fixed
  76. 3.35    14370    20 oct 2000    ò    allows contacts files in System folder if
  77. visibleò    all contacts files on C or D disk enabled
  78. 3.25    12941    01 jul 2000    ò    code synchronised with ContactC 1.00
  79.             ò    skips searching on identical search request
  80. 3.20    12786    08 apr 2000    ò    restore messaging completed
  81. 3.15    12781    15 mar 2000    ò    language independent on 5mx and Revo
  82. 3.05    12691    05 mar 2000    ò    closes & reopens common Contacts clients
  83.             ò    tested OK on the UK Revo
  84. 3.00    12300    01 mar 2000    ò    single book handling upgraded
  85.             ò    restores source folder if not found
  86. 2.90    12145    18 feb 2000    ò    matching contacts exported to new database
  87.             ò    general control and protection enhancements
  88.             ò    unique match searching in loaded Contacts.cdb
  89.             ò    clipboard not affected if no search text
  90. 2.80    7203    20 jan 2000    ò    'About' added
  91.             ò    backup control added
  92.             ò    all text search refined
  93. 2.65    6848    18 dec 1999    ò    fully language independent
  94. 2.62    6773    03 dec 1999    ò    book selector width restrained
  95. 2.52    6773    30 oct 1999    ò    unique match forwarding in all text search
  96. 2.50    6510    23 oct 1999    ò    multiple field search added in all text search
  97. 2.42    6261    21 oct 1999    ò    long names allowed
  98.             ò    proper comma handling in book selector
  99.             ò    tabs treated as spaces in name search
  100. 2.40    5948    11 oct 1999    ò    code synchronised with ContactW 1.20
  101.             ò    book selector changed
  102.             ò    search string ends up in clipboard
  103.             ò    boosted search for single words
  104. 2.30    6073    07 oct 1999    ò    Contacts.cdb on D disk enabled
  105. 2.20    5989    04 oct 1999    ò    fixed flaw in search routine
  106. 2.10    5936    02 oct 1999    ò    name search algorithm upgraded
  107.             ò    initiation facilitated
  108.             ò    not released
  109. 2.00    5049    30 sep 1999    ò    searches for text within contacts databases
  110.             ò    manages/compresses contacts files
  111.             ò    optionally maintains/restores backups
  112.             ò    not released
  113. 1.10    1731    22 sep 1999    ò    code refined; no operational changes
  114.             ò    not released
  115. 1.00    1698    10 sep 1999    ò    first public release
  116.             ò    added 'about' and directions at initial startup
  117. 1.00b1    1475    03 sep 1999    ò    first beta release
  118.  
  119. COPYRIGHT
  120. All rights reserved by the author.
  121.  
  122. DISCLAIMER
  123. The author waives responsibility for any adverse consequence of using this
  124. program;
  125. running it is allowed under the condition that the user accepts the full risk
  126. of use.
  127.  
  128. CREDITS
  129. To Pascal Nicolas for Macro5, to Richard Smedley for SafeOPL, to Joachim
  130. Maier for support with the German 5mx and to Julian Brooks for support with
  131. the UK Revo.
  132.  
  133. KNOWN ISSUES
  134. ContactX was written on the UK 5mx, and tested on the UK and German 5mx and
  135. UK Revo.
  136. All known issues originate from the Contact.opx library, version 1.00. It is
  137. yet unknown when EPOC will have the opx debugged.
  138. ò The contents of the "Job title" field are ignored in searches.
  139. ò When exporting, fields in contacts that were imported from other vCard
  140. applications may not be recognised. These will be passed as "û failed û",
  141. where the û has character code 150. Known failures involve address fields,
  142. following synchronisation with MS Outlook and MS Schedule. Set the sync path
  143. to a fixed database in the search folder to avoid accidental mixing with
  144. other contacts that may be momentarily loaded.
  145. ò Per contact, no more than two fields with contents larger than 255
  146. characters can be written to a new contacts file; the remaining will be
  147. passed as "û failed û".
  148. ò The "PO box" fields are not copied to the new contacts file.
  149.  
  150. FEEDBACK
  151. Please mail your findings to:        Frans Franken
  152.                 ContactX@franken.demon.nl
  153. Latest version and more at:        http://www.franken.demon.nl
  154.