From the Help facility:
Field codes: IncludeText field
Show All
Hide All
{ INCLUDETEXT "FileName" [Bookmark ] [Switches ] }
Inserts the text and graphics contained in the named document. You can
insert the entire document or a portion of the document. If the document is
a Microsoft Word document, you can insert only the portion referred to by a
bookmark (bookmark: A location or selection of text in a file that you name
for reference purposes. Bookmarks identify a location within your file that
you can later refer or link to.), or if the document is an XML (Extensible
Markup Language (XML): A condensed form of Standard Generalized Markup
Language (SGML) that enables developers to create customized tags that offer
flexibility in organizing and presenting information.) file, you can insert
only the fragment referred to by an XPath expression. This field (field: A
set of codes that instructs Microsoft Word to insert text, graphics, page
numbers, and other material into a document automatically. For example, the
DATE field inserts the current date.) was formerly called the INCLUDE field.
Notes
XML features, except for saving files as XML documents, are available only
in Microsoft Office Professional Edition 2003 and Microsoft Office Word
2003.
If the source document is a Word document, you can edit the inserted text
resulting from the INCLUDETEXT field and save the changes back to the source
document. Edit the inserted text, and then press CTRL+SHIFT+F7.
The INCLUDETEXT field doesn't make use of OLE (OLE: A program-integration
technology that you can use to share information between programs. All
Office programs support OLE, so you can share information through linked and
embedded objects.).
Security Because field codes can be visible to anyone reading your
document, be sure that the information you place in field codes is not
information that you want kept private.
Instructions
"FileName"
The name and location of the document. If the location includes a long file
name with spaces, enclose it in quotation marks. Replace single backslashes
with double backslashes to specify the path (path: The route that the
operating system uses to locate a folder or file; for example, C:\House
finances\March.doc.), for example:
"C:\\My Documents\\Manual.doc"
Bookmark
The name of a bookmark that refers to the portion of the Microsoft Word
document you want to include.
Switches
\!
Prevents Word from updating fields in the inserted text unless the fields
are first updated in the source document.
\c ClassName
Here are file format converters provided with Word and their corresponding
class names:
WordPerfect version 6.x
WordPerfect6x
WordPerfect 5.x for Windows
WrdPrfctWin
\n
Specifies a namespace mapping for XPath queries. This switch is required if
the \x switch refers to an element by name in an XML file that declares a
namespace.
\t
Specifies an XSLT for formatting XML data.
\x
Specifies the XPath for returning a fragment of data in an XML file.
Examples
This field inserts the portion of the file referred to by the Summary
bookmark:
{ INCLUDETEXT "C:\\Winword\\Port Development RFP" Summary }
This field inserts the Name element of the XML document Resume.xml and
applies the XSLT Display.xsl to it:
{ INCLUDETEXT "C:\\Resume.xml" \n xmlns:a=\"resume-schema\" \t
"C:\\display.xsl" \x a:Resume/a:Name
--
Hope this helps.
Please reply to the newsgroup unless you wish to avail yourself of my
services on a paid consulting basis.
Doug Robbins - Word MVP
