home *** CD-ROM | disk | FTP | other *** search
/ Liren Large Software Subsidy 5 / 05.iso / a / a108 / 6.ddi / WGREADME.TXT < prev   
Encoding:
Text File  |  1994-03-10  |  10.8 KB  |  275 lines
  1.                       WGREADME.TXT
  2. **********************************************************
  3.   Microsoft(R) FoxPro(R) Version 2.6 Professional Edition
  4.  
  5.                  WorkGroup Extensions 
  6.  
  7.     (C)1994 Microsoft Corporation. All Rights Reserved.
  8. **********************************************************
  9.  
  10. =========
  11. CONTENTS
  12. =========
  13.  
  14. Part   Description
  15. ----   -----------
  16.  1     Introduction
  17.  2     Installation
  18.  3     Notes About Sample Applications
  19.  4     Distributing Applications to Users
  20.  5     Using MAPI in Interactive Mode       
  21. ----------------------------------------------------------
  22.  
  23.  
  24. =====================
  25. Part 1: Introduction
  26. =====================
  27. This Readme contains details about installing and using the 
  28. FoxPro MAPI functions in FOXMAPI.FLL to integrate Microsoft 
  29. FoxPro for Windows with Microsoft Mail and Microsoft 
  30. Schedule+. For information on specific functions, see the 
  31. Help file (FOXMAPI.HLP) located in the WRKEXTS directory.  
  32. The Help file can also be accessed by selecting FoxPro MAPI 
  33. Help... from the Mail menu sample program.
  34.  
  35. Before you begin using the FoxPro MAPI routines, it is 
  36. recommended that you review the "FoxPro Environmental 
  37. Considerations" Help topic.
  38. ----------------------------------------------------------
  39.  
  40.  
  41. =====================
  42. Part 2: Installation
  43. =====================
  44.  
  45. Installing the Professional Edition of FoxPro 2.6
  46. -------------------------------------------------
  47. The Professional Edition of FoxPro 2.6 includes the
  48. following kits:
  49.  
  50. Distribution Kit
  51. Connectivity Kit
  52. Library Construction Kit
  53. WorkGroup Extensions (FoxPro for Windows only) 
  54.  
  55. To install the Professional Edition of FoxPro, first install
  56. the main FoxPro product, then follow the installation 
  57. instructions included with each individual kit.  The order 
  58. in which the kits are installed does not matter.
  59. ----------------------------------------------------------
  60.  
  61. Installing the WorkGroup Extensions
  62. -----------------------------------
  63. To install the WorkGroup Extensions, follow the steps below. 
  64. It is recommended that you keep a backup copy of all files
  65. on the installation floppy disk.
  66.  
  67. 1. Create a new subdirectory of your main FoxPro directory 
  68.    and name the subdirectory WRKEXTS.
  69.  
  70. 2. Copy the following files from the floppy disk to the
  71.    WRKEXTS directory:
  72.  
  73.    FOXMAPI.FLL
  74.    FOXMAPI.HLP
  75.    REQUIRED.DBF
  76.    README.TXT
  77.    TO_PRINT.RTF
  78.   
  79. 3. Copy the following subdirectories and their contents from 
  80.    the floppy disk to the WRKEXTS directory:
  81.     
  82.    LIBS
  83.    SAMPLES
  84.     
  85. 4. Copy the following files from the subdirectory LIBS to 
  86.    the Microsoft Windows system directory (usually called 
  87.    WINDOWS\SYSTEM):
  88.  
  89.    MAPI.DLL
  90.    SPLUS.DLL
  91. ----------------------------------------------------------
  92.  
  93.  
  94. ========================================
  95. Part 3: Notes about Sample Applications
  96. ========================================
  97. The FoxPro sample programs and applications are distributed 
  98. solely to provide examples and guidelines for using the 
  99. FOXMAPI library calls. Microsoft is not responsible for the 
  100. code contained in any of the sample files and does not 
  101. provide support for these files.
  102.  
  103. The sample programs contain examples of all 12 MAPI 
  104. functions contained in the FoxPro MAPI library, FOXMAPI.FLL. 
  105.  
  106. The Library Routines in MAPILIB.PRG
  107. -----------------------------------
  108. All the sample programs access library routines contained in 
  109. the MAPILIB program file, and error routines contained in 
  110. MAPIERR.PRG. Both the MAPILIB.PRG and the MAPIERR.PRG files 
  111. are intended to be used with any of your applications that 
  112. use of the FOXMAPI library. You can modify MAPILIB.PRG and 
  113. MAPIERR.ERR to suit your own needs, and can distribute them 
  114. with your applications.
  115.  
  116. Each of the sample applications use a common log on routine
  117. in MAPILIB which checks to see if there is an active MS Mail 
  118. session running, and then uses it for transactions.  For 
  119. information about how to run multiple sessions of MS Mail, 
  120. see the Help file.
  121.  
  122. The Mail Menu
  123. -------------
  124. This simple Mail menu can be added to any FoxPro application 
  125. by running the program MAILMENU.PRG, located in the 
  126. \MAILMENU subdirectory. The Mail menu provides options to 
  127. send and read mail messages, and to access the FoxPro MAPI 
  128. Help file. The MAILMENU.PRG program is actually generated 
  129. code from the MAILMENU.MNX menu file.
  130.  
  131. All 12 MAPI calls are included in the two main programs used 
  132. in this sample application, READMAIL.PRG and SENDMAIL.PRG. 
  133. The majority of the calls are contained in the READMAIL 
  134. program which goes through and polls your MS Mail Inbox 
  135. messages. You should review this code closely as it contains 
  136. several tricks for successfully handing MS Mail messages in 
  137. FoxPro.
  138. ----------------------------------------------------------    
  139.  
  140. Bulk Mailing Application
  141. ------------------------
  142. The bulk mailing sample application shows a common use of 
  143. FoxPro and MAPI, and is located in the BULK subdirectory.  
  144. This application allows you to create  mail messages and 
  145. send them to a list of recipients contained in the FoxPro 
  146. table, MEMBERS.DBF. The content of the message includes a 
  147. simple text message and additional information matched to 
  148. each recipient, extracted from another FoxPro table, 
  149. SALES.DBF.
  150.  
  151. Note: The FoxPro tables contain place holder MS Mail names and 
  152. addressees. Running the application without modifying these 
  153. names and addresses produces an "Unknown Recipient" error. To 
  154. run the application, you should use names and addresses 
  155. contained in your MS Mail system.
  156.  
  157. Using this sample application you can send two types of mail 
  158. messages to a list of people contained in a FoxPro table: 
  159. General and Personal.  
  160.  
  161. If you select the General radio button, a single message is 
  162. sent to all mail addresses contained in the table.  All names 
  163. are included in To box, and the Send Note dialog appears to 
  164. confirm the mailing.
  165.  
  166. If you select the Personalized radio button, each recipient 
  167. receives an individual copy of the message. Only one name is 
  168. included in the To box, and the Send Note dialog is 
  169. suppressed. This mailing takes more time since a message is 
  170. sent for each individual in the listing. In the code of the 
  171. personalized mailing, notice how you can set flags to 
  172. suppress the MAPI SendNote dialog.
  173. ----------------------------------------------------------
  174.  
  175. Project File Updater Application
  176. --------------------------------
  177. The Project File Updater application shows a simple 
  178. multi-user project manager, using MAPI. It allows developers,
  179. each working on specific files of a common project, to update 
  180. each other's local projects with current files through a MAPI 
  181. message. In addition, a button is provided to poll for new 
  182. files which may have been sent by someone.
  183.     
  184. This sample program illustrates two MAPI uses: how to send 
  185. files to others, and how to send a MAPI message which does 
  186. not get detected by MS Mail.
  187.  
  188. The interface provides a popup menu with all the developers 
  189. working on the project. The developer names and files they 
  190. are working with are located in two tables. Being a 
  191. developer, you would select your name from the popup, and 
  192. all the files assigned to you are placed in a list box. Use 
  193. the Move button to select files to update to the other 
  194. developer's machines. 
  195.  
  196. The Mail Files button creates a message with only the 
  197. updated files. No text is added to the message. For purposes 
  198. of identifying these mail messages, the subject field is 
  199. stamped with 'Project Files' and message type field is 
  200. stamped as 'IPC.ProjectUpdater'. The IPC type will not be 
  201. detected by the MS Mail client (it will not appear in the 
  202. Inbox).
  203.  
  204. The Receive Files button polls through the mail looking for 
  205. files stamped with a type "IPC.ProjectUpdater" and subject 
  206. "Project Files". A cursor table is created showing a list of 
  207. these files. Note: Files are not actually updated (i.e., 
  208. overwritten) in the sample program.
  209.  
  210. Note: The FoxPro table contains place holder MS Mail names 
  211. and addressees. Running the application without modifying 
  212. these names and addresses produces an "Unknown Recipient" 
  213. error.  To run the application, you should use names and 
  214. addresses contained in your MS Mail system.
  215. ----------------------------------------------------------
  216.  
  217. Schedule+ Sample Programs
  218. -------------------------
  219. The SPLUS directory includes sample code for calling 
  220. Schedule+ functions. FoxPro functions for both MAPI and 
  221. Schedule+ are in the single file, FOXMAPI.FLL.
  222. ----------------------------------------------------------
  223.  
  224. ===========================================
  225. Part 4: Distributing Applications to Users
  226. ===========================================
  227. For information about distributing applications to users, 
  228. see the topic "Distributing Your WorkGroup Applications" 
  229. in the Help file.
  230.  
  231. To help you distribute applications, compressed versions of 
  232. the MAPI.DLL and SPLUS.DLL libraries are included with the 
  233. WorkGroup Extensions in the LIBS subdirectory. These files 
  234. are named MAPI.DL_ and SPLUS.DL_.
  235.  
  236. The compressed MAPI.DL_ library is the United States version
  237. 3.02, and the SPLUS.DL_ library is version 1.0a.  If you use 
  238. updated or international versions of these files, or you 
  239. later receive updated versions, distribute your updated or 
  240. new international files to your users.
  241.  
  242. The MAPI.DL_ and SPLUS.L_ files are provided for the 
  243. convenience of you and your users. Each user must have a 
  244. valid client license for Microsoft Mail, Microsoft Schedule+, 
  245. or Microsoft Windows for WorkGroups.  You cannot distribute 
  246. these libraries to unlicensed users.
  247.  
  248. Distributing Library Files outside of the United States
  249. -------------------------------------------------------
  250. You can distribute the library file MAPI.DLL from the 
  251. WorkGroup Extensions only to users who use either the U.S. 
  252. version of the Microsoft Mail client for Windows, or the U.S. 
  253. version of Microsoft Windows for WorkGroups.  You can obtain 
  254. non-U.S. versions of MAPI.DLL from non-U.S. versions of 
  255. Microsoft Mail and Windows for WorkGroups.  You can use the 
  256. SPLUS.DLL library with any language version of Microsoft 
  257. Schedule+.
  258. ----------------------------------------------------------
  259.  
  260.  
  261. =======================================
  262. Part 5: Using MAPI in Interactive Mode 
  263. =======================================
  264. If you type a MAPI command into the FoxPro Command Window or 
  265. use the keyboard to select a button that calls a MAPI 
  266. command, and that particular MAPI command brings up a MS
  267. Mail dialogue box (i.e. MPSendNote), the cursor may not 
  268. appear. However, the cursor will appear if the code is run
  269. programmatically.
  270. ----------------------------------------------------------
  271.  
  272.                      ===================
  273.                      END OF WGREADME.TXT
  274.                      ===================
  275.