Field codes: IncludeText field

{ 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 

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.

ShowInstructions

"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.

ShowSwitches

\!

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.

ShowExamples

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 }

 
 
Applies to:
Word 2003