home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / p / powerbase / !Powerbase / Resources / Docs / MailMerge < prev    next >
Text File  |  1997-06-17  |  8KB  |  158 lines
  1.         CH 9 − MAIL-MERGING WITH IMPRESSION AND OVATION
  2.         ===============================================
  3. Although the title refers to “Mail-Merging” the process to be described is
  4. more accurately termed “Data-Merging” as it is by no means limited to
  5. merging names and addresses into letters; any kind of textual data from a
  6. Powerbase application can be merged into any kind of document in Impression
  7. or Ovation or many other editors and wordprocessors. 
  8.  
  9. 9.1  Mail-merging with Ovation
  10. ==============================
  11. Ovation expects data for merging to be supplied as a CSV file (see Ch 8). An
  12. example file (OvationCSV) is supplied with this version of Powerbase. It was
  13. created from the Elements database and is intended to work with the sample
  14. Ovation document OmergeTest. Before attempting to create CSV files of your
  15. own you are recommended to read the Powerbase documentation on such files.
  16. The process for mail-merging with Ovation is described below. 
  17.  
  18. 9.1.1 Preparing an Ovation document for mail-merging
  19. ----------------------------------------------------
  20. Ovation has a very easy method of specifying where the merged data is to go
  21. into the document. Whenever you reach a point where you wish to insert a
  22. Powerbase field type Ctrl I.  A window headed “Merge tag” will appear
  23. inviting you to enter a number. The number required is the field number in
  24. the CSV record (which is not necessarily the field number in the Powerbase
  25. record). If, for instance, you wish to merge the second field from each line
  26. of your CSV file enter 2 and type Return. You will see that “[Merge2]” has
  27. been inserted into the text at the caret. Continue typing, inserting other
  28. fields as required. The fields do not need to be in numerical order (you can
  29. insert field 2 before you insert field 1) and the same field may be inserted
  30. many times. Styles and effects may also be applied to the Merge tags. Load
  31. MergeTest to see how this looks. 
  32.  
  33. 9.1.2 Merging the data from Powerbase
  34. -------------------------------------
  35. With MergeTest loaded open the main Ovation menu, go to the File submenu and
  36. choose Print. Select the Mail merge option button and drag OvationCSV to the
  37. writable icon to the right of the button. The pathname of the file will
  38. appear in the icon. Click on OK and the document will be printed once for
  39. each record in the CSV file, merging new data into the document each time.
  40. OvationCSV contains 10 records so if you just want to see the process in
  41. action without actually printing 10 sheets of paper set your printer manager
  42. to print to a file instead of to the printer itself. 
  43.  
  44. If you examine OvationCSV you will see that each field is enclosed in
  45. quotes. This is only necessary of the fields contain literal commas (see
  46. 8.1). Look at the first record, for example, and note the comma in
  47. “(Gr.aktis,aktinos; ray or beam)”. Without the quotes Ovation would
  48. interpret the comma as a field separator and the merging would get out of
  49. step for that record. 
  50.  
  51. 9.2  Mail-merging with Impression
  52. =================================
  53. The following description applies to Impression Publisher and Impression
  54. Style. The older ImpressionII is also supported. Powerbase and Impression
  55. are able to communicate directly with each other without the need for a CSV
  56. file. This task is performed by a module called ImpulseII which Computer
  57. Concepts have placed in the public domain to encourage its adoption as a
  58. standard means of transferring data between RISC OS applications. The
  59. ImpulseII module is included in the Resources directory inside the Powerbase
  60. application directory. 
  61.  
  62. 9.2.1 Preparing the Impression document 
  63. ---------------------------------------
  64. Since the merged data is not being supplied from a pre-generated CSV file
  65. Impression needs to request specifically each Powerbase field that it wants
  66. to merge into the document. It is probably best to create the document
  67. without worrying about the merged data at first, then insert the necessary
  68. commands afterwards. 
  69.  
  70. Wherever you want data from a Powerbase record to appear in the document
  71. proceed as follows:− 
  72.  
  73. (1)     Place the caret at the point where the data is to be inserted. 
  74.  
  75. (2)     Click MENU over the frame, go to the Utilities  submenu (Misc in
  76.         ImpressionII) and choose Merge command A dialogue box will appear. 
  77.  
  78. (3)     Type the following:−
  79.  
  80.         :Powerbase GetField NAME 
  81.  
  82.         This is on the understanding that your Powerbase record contains a
  83.         field whose tag is NAME and that you want the contents of that field
  84.         inserting into the Impression document at that point. Note the
  85.         spaces and the initial colon. These are essential. 
  86.  
  87. (4)     Click on Set or type Return. You will see “<NAME>” appear in the
  88.         text. 
  89.  
  90. (5)     Repeat for all the other Powerbase fields to be inserted in the
  91.         document. All take the form:− 
  92.  
  93.         :Powerbase GetField <tag>
  94.  
  95.         and in each case the tag, enclosed in angle brackets, will appear in
  96.         the text. All the data in a given document must come from the same
  97.         database. It might be easiest if you open the required database and
  98.         arrange the desktop so that you can see both the record window and
  99.         the Impression document. Clicking MENU over a field makes its tag
  100.         appear in the second menu item. 
  101.  
  102. (6)     Save the the document! 
  103.  
  104. 9.2.2 Merging the data
  105. ----------------------
  106. (1)     Make sure Impression has been “seen” by the filer. Impression
  107.         doesn’t need to actually be on the icon-bar at this point but it
  108.         doesn’t matter if it is. 
  109.  
  110. (2)     Open the Powerbase database. 
  111.  
  112. (3)     Drop the Impression document on the record window. If Impression
  113.         isn’t already running Powerbase will run it for you. The document
  114.         will be loaded and displayed. Finally Powerbase’s Data merge window
  115.         will appear. 
  116.  
  117. (4)     Clicking on Merge extracts data from the currently-displayed record
  118.         and inserts it in the specified places in the Impression document. 
  119.         If you wish to print the document containing the merged data click
  120.         on Print. (Your printer must be on-line and with a printer driver
  121.         active.)
  122.  
  123. (5)     The “browser” buttons on the keypad may be used to move about the
  124.         file and, every time a record is displayed, it will be merged into
  125.         the document, overwriting the data previously merged. A filter may
  126.         be used to place restrictions on which records are accessed during
  127.         browsing. The End merge button temporarily suspends merging and
  128.         allows normal use of the keypad.  You may also call up a specific
  129.         record using the keypad Search button and then merge the data into
  130.         the document by clicking on Merge again.  
  131.  
  132. (6)     If the Print all switch is selected Powerbase will proceed through
  133.         the database from whichever record you first merged, merging each
  134.         record in turn (or each matching record if a filter is in use) and
  135.         printing for each such record a copy of the document containing the
  136.         merged data.
  137.  
  138. Note that when the mouse pointer is moved over the Impression document with
  139. the merged data present it changes to a large red and blue cross which means
  140. that you cannot edit the document. Clicking SELECT over it has no effect;
  141. the caret doesn’t appear. If you click on Cancel in the Data merge window
  142. the merged data is removed from the document and normal editing is restored.
  143. If you do want to edit the document with merged data present then click on
  144. Edit. Note, however, that if you save the document in this state it will be
  145. saved with the specific data you have merged into it rather than with the
  146. commands to merge data.
  147.  
  148. Appendix A gives a full description of the Impulse commands or “methods”
  149. which Powerbase understands.
  150.  
  151. 9.3  Mail-merging with other programs
  152. =====================================
  153. If you use neither Impression nor Ovation you may still be able to use
  154. mail-merging with your wordprocessor, but you will need to read the manual
  155. carefully to find out how. It will almost certainly involve a CSV, or
  156. similar, file in conjunction with some method of “tagging” the document (as
  157. described above for Impression and Ovati