home *** CD-ROM | disk | FTP | other *** search
/ APDL Public Domain 1 / APDL_PD1A.iso / database / powerbase / docs / mailmerge < prev    next >
Encoding:
Text File  |  1995-08-21  |  7.2 KB  |  151 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 spaces and
  85. 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 arrange
  98. the desktop so that you can see both the record window and the Impression
  99. document. Clicking MENU over a field makes its tag appear in the second menu
  100. 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 doesn’t
  108. 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 will be
  114. loaded and displayed. Finally Powerbase’s Data merge window will appear. 
  115.  
  116. (4)     The Data merge window features the familiar Query panel into which
  117. you may enter a search formula. Clicking on Merge or typing RETURN then
  118. extracts data from the first matching record and inserts it in the specified
  119. places in the Impression document. If no search formula was entered the
  120. merged record will be the first in the current subfile. 
  121.  
  122. (5)     Buttons are provided for Next, Previous, First and Last record. 
  123. These work just like the corresponding keypad buttons and the Impression
  124. document displays the merged data in each case. 
  125.  
  126. (6)     Clicking on Print will print the Impression document in its
  127. displayed state, i.e. with the currently merged data. If you select the
  128. Print all switch before clicking on Merge a whole series of hard copies will
  129. be produced, one for each matching record. 
  130.  
  131. Note that when the mouse pointer is moved over the Impression document with
  132. the merged data present it changes to a large red and blue cross which means
  133. that you cannot edit the document. Clicking SELECT over it has no effect;
  134. the caret doesn’t appear. If you click on Cancel in the Data merge window
  135. the merged data is removed from the document and normal editing is restored.
  136. If you do want to edit the document with merged data present then click on
  137. Edit. Note, however, that if you save the document in this state it will be
  138. saved with the specific data you have merged into it rather than with the
  139. commands to merge data.
  140.  
  141. A full description of the Impulse commands or “methods” which Powerbase
  142. understands will be found in Appendix A.
  143.  
  144. 9.3  Mail-merging with other programs
  145.  
  146. If you use neither Impression nor Ovation you may still be able to use
  147. mail-merging with your wordprocessor, but you will need to read the manual
  148. carefully to find out how. It will almost certainly involve a CSV, or
  149. similar, file in conjunction with some method of “tagging” the document (as
  150. described above for Impression and Ovation) to specify where in it the data
  151. is to be merged.