Using FoxPro Text Merge Feature with Multiple Databases

Last reviewed: April 29, 1996
Article ID: Q94349
The information in this article applies to:
  • Microsoft Visual FoxPro for Windows, version 3.0
  • Microsoft FoxPro for MS-DOS, versions 2.0, 2.5, 2.5a
  • Microsoft FoxPro for Windows, versions 2.5, 2.5a

SUMMARY

Documents developed with the Text Merge feature can use fields from two or more databases. The example below uses customer names and addresses from the FoxPro 2.x CUSTOMER.DBF sample database merged with form letters contained in memo fields from a second database (INVOICE.DBF).

MORE INFORMATION

NOTE: This example only works using the FoxPro 2.x sample files.

The memo field contains all text to be merged. Page spacing (top, bottom, and side margins) is controlled within the memo field. A memo field can appear similar to the following example:

   <<DATE()>>

   <<ALLTRIM(PROPER(CONTACT))>>
   <<ALLTRIM(PROPER(COMPANY))>>
   <<ALLTRIM(PROPER(ADDRESS))>>
   <<ALLTRIM(PROPER(CITY))>>, <<ALLTRIM(STATE)>> <<ALLTRIM(ZIP)>>

   Dear <<ALLTRIM(PROPER(CONTACT))>>:

   This area includes the body of a letter to be
   sent to the contact.

   Sincerely,


   Name

   ENDTEXT

The following program connects the information from the two databases. Work area 1 includes the database (INVOICE) with memo fields that contain form letters. Work area 2 includes a database (CUSTOMER) that contains names and addresses that should receive the letter. The program will execute from work area 2.

This example assumes that you have a customer database (CUSTOMER) with account status information and a database (INVOICE) with multiple form letters for different account statuses.

   SELECT 1
   USE INVOICE
   SELECT 2
   USE CUSTOMER
   CLEAR                               && Clear screen.
   SET TEXTMERGE ON                    && Enable evaluation of components.
   SET TALK OFF                        && Prevent printing of commands.
   SET TEXTMERGE DELIMITERS TO         && Set default delimiters.
   SET MEMOWIDTH TO 80                 && Set memo width for 80 columns.
   SCAN                                && Force top-down processing.
     FOR J=1 TO MEMLINES(invoice.memo)
        X="\"+MLINE(invoice.memo,J)  && Process each line in memo field.
        &X                        && Macro substitution.
     ENDFOR
   ENDSCAN

For more information about performing text merges, see the following article in the Microsoft Knowledge Base:

   ARTICLE-ID: Q97163
   TITLE     : General Text Merge Functionality


Additional reference words: VFoxWin 3.00 FoxDos FoxWin 2.00 form 2.50 2.x
mail text
merge
functionality 2.50a
KBCategory: kbprg
KBSubcategory: FxprgMacrosub


THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. MICROSOFT DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES SO THE FOREGOING LIMITATION MAY NOT APPLY.

Last reviewed: April 29, 1996
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.