home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 4 / DATAFILE_PDCD4.iso / utilities / utilsp / powerbase / !Importer / !Help < prev    next >
Text File  |  1991-05-08  |  3KB  |  101 lines
  1. > !Help
  2.  
  3. Importer
  4. ========
  5.  
  6. Copyright 1991 Computer Concepts Limited
  7.  
  8. A simple mail-merge database for Impression.
  9.  
  10.  
  11. Importer uses Impression's new mail-merge facilities to take data from a
  12. simple text file and merge it into an Impression document.  To use Importer
  13. you should have:
  14.  
  15. * Impression Version 2.10 or later.
  16.  
  17. * An Impression document with merge commands embedded in the text.  The merge
  18. commands should read something like ":Importer GetField n" where n is the
  19. number of the field in a record.
  20.  
  21. * A text file (as produced by !Edit or TWIN) containing the data you want to
  22. merge.  The text file should be made up of a number of records.  Each record
  23. is separated by two linefeed characters (ASCII 10).  The fields within the
  24. records are separated by single linefeed characters.  Comments may be placed
  25. in the text file by starting the line with a semicolon.
  26.  
  27. Here is an example datafile containing two records, each with five fields...
  28.  
  29. ;> NamesData
  30. ;
  31. ;  Names and addresses.
  32. ;
  33. Mr. J. Bloggs
  34. 17 Acacia Avenue
  35. Thingsville
  36. Aardvarkshire
  37. AA7 1AQ
  38.  
  39. Mr. O. MacGregor
  40. Eeyih-eeyih-Oh Farm
  41. Nr. Chigley
  42. Trumptonshire
  43. TU3 9OO
  44.  
  45.  
  46. To start a mail merge operation, run !Importer and load the document into
  47. Impression.  Drop the Impression document (from the "Save document" menu
  48. option) onto the Importer window. Next drop the datafile onto the !Importer
  49. window. Importer will now tell you how many records there are in the datafile
  50. and you should immediately see the contents of the first record merged into
  51. the Impression document. Click "Print" to print the document, "Save" to save
  52. the document in the merged state or "Next" to move on to the next record.
  53.  
  54.  
  55.  
  56.  
  57. A message to the hackers.
  58. -------------------------
  59. !Importer is written in BASIC so that you can see how to write Impulse tasks.
  60. Feel free to use the Impulse module to implement new Impulse tasks - it is a
  61. public domain program.  The Impulse system will continue to develop.  It is
  62. hoped that Impulse messages will be sent across networks to allow tasks on
  63. different machines to communicate.  A scripting language is also planned
  64. which would effectively make any methods implemented by Impulse tasks
  65. keywords in the language.
  66.  
  67. If you are writing a new Impulse server you should put a table like the one
  68. below in your !Help file so that other users can see what methods your server
  69. provides and what they do.  The layout of the table is important - it may be
  70. read by an object browser one day!
  71.  
  72.  
  73. {
  74. ServerName: Importer
  75. Methods:
  76.         GetField <integer>
  77.         GetDateTime [<string>]
  78.         GetData <string>
  79.  
  80. Descriptions:
  81. GetField <integer>
  82. GetField returns the contents of one field from a record to the caller.  The integer should be in the range 1 to 16, if it is outside this then field 1 will be returned.
  83.  
  84. GetDateTime [<string>]
  85. This method returns the time and/or date in the format specified by the optional string parameter.  The format string is exactly that described in the PRMs pp550-552.  If the format string is not present then GetDateTime returns the date using the default format string "%DY%ST %MO %CE%YR".
  86.  
  87. GetData <string>
  88. This method returns data which depends on the evaluation of the string parameter as a BASIC string expression.  This one is for hackers only!
  89. }
  90.  
  91.  
  92. Please send any queries or comments to:
  93.         Technical Support Dept.
  94.         Computer Concepts
  95.         Gaddesden Place
  96.         Hemel Hempstead
  97.         Herts           HP2 6EX
  98. or phone:
  99.         0442 63933
  100.  
  101.