CLIPFORM lets you specify both the source of data (in Microsoft Outlook) as well as the output destination.

Source

The source is specified using the Source= directive, which should appear as a separate line at the beginning of the CLIPFORM template.  If the Source= directive is omitted, then CLIPFORM will extract data from all items currently selected in the topmost Outlook explorer window.

The format for the Source= directive is shown below:

Source=outlook://Store/Folder/Subfolder

For example, the following extracts data from all Outlook items in the Contacts folder contained in Personal Folders:

Source=outlook://Personal Folders/Contacts

You can specify a folder in the default Outlook folders more simply, as follows:

Source=outlook:Folder

For example, the following extracts data from all Outlook items in the default Inbox folder:

Source=outlook:Inbox

This works for any folder that is a top-level folder in the default Outlook message store (.PST or .OST file).

You can also specify a folder by using its unique MAPI entry ID:

Source=000000008A83C9E58B02A343AB8C847ED9407C22E2800000

This is useful in two cases: (1) the user may move or rename the file after the template is written; or (2) ClipForm is unable to find the folder.  The MAPI entry ID is written to the CLIPFORM.LOG file each time ClipForm is run.  Also, if ClipForm is unable to find a match for the folder specified, it will automatically place the MAPI entry ID for the currently displayed Outlook folder in the CLIPFORM.LOG file.

Output

Extracted data is output to the location specified by the Output= directive.  You may include any valid file name to save the output as a file.  This is useful for creating text files, HTML or RTF files, or merge files.  Note, you must specify the full path to the file, though you may use either DOS (c:\path\file) or UNC (\\computer\share) naming.

If the Output= directive does not specify a file, it is treated as an e-mail address, and an e-mail message will be created, addressed to the person named.  This may be a proper e-mail address (e.g. name@domain.com); otherwise it is treated as a display name.

Examples:

Output=c:\My Documents\report.htm

Output=\\MyServer\MyShare\report.txt

Output=Bill Gates

Output=joe.doakes@mydomain.com 

Note: the first two of these are treated as file names, and the last two are treated as e-mail recipients.  Note that the third will not work unless there is a corresponding entry in your e-mail address books with this display name.

   Copyright © 1997-2002, Walter E. Heindl, SOFTWARE