ExportDocToXPS

The ExportDocToXPS command uses the Microsoft Word export filter to produce a XPS file directly from a Microsoft Word document.

Note

This command only is available for Word documents and requires Microsoft Office 2007 or Microsoft Office 2010 and the optional PDF/XPS add-in.

The ExportDocToXPS command provides a number of optional parameters which affect the way in which the XPS document is generated. If no optional parameters are provided ITP/Server will use sensible defaults.

It is possible to set a global default for some of the optional parameters. These global defaults can be set in the [Configuration] section of the dp.ini file. Refer to the description of the parameters below to see if these have a corresponding global setting.

Syntax

ExportDocToXPS
   Src(<text>)
   Dest(<text>)
   OptimiseForPrint(True or False)
   IncludeProperties(True or False)
   ExportBookmarks(<number>)
   BitmapFonts(True or False)
   KeepIRM(True or False)
   AccessibilityInfo(True or False)
   TimeOut(<number>);

Parameters

Src: Required.
The Microsoft Word document that ITP/Server will convert to the XPS format.

Dest: Required.
The resulting XPS document.

OptimiseForPrint: Optional.
Indicates if the resulting XPS document should be optimised for printing (True) or for screen reading (False). This parameter defaults to False when omitted but the default value can be changed using the following setting in the dp.ini file:

ExportDocToXPS.OptimiseForPrint=(Y or N)

IncludeProperties: Optional.
Indicates whether or not some document properties (author, title, etc.) from the Microsoft Word document should be copied into the XPS document. This parameter defaults to False when omitted.

ExportBookmarks: Optional.
Indicates whether or not a bookmark table should be added to the XPS document.

Supported values are:

0 No bookmarks are generated.
1 Bookmarks are generated based on the Heading styles in the Word document.
2 Bookmarks are generated based on bookmarks in the Word document.

This parameter defaults to 0 when omitted.

BitmapFonts: Optional.
If font licenses do not permit a font to be embedded in the XPS document this setting indicates how the font is handled.
True, a bitmap of the text is included in the XPS document.
False, the font is referred but not included. It is up to the viewer/printer to select an appropriate (substitute) font.

This parameter defaults to True when omitted but the default value can be changed using the following setting in the dp.ini file:

ExportDocToXPS.FontBitmaps=(Y or N)

KeepIRM: Optional.
Indicates whether or not IRM information should be copied from the Microsoft Word document into the XPS document.

AccessibilityInfo: Optional.
Indicates whether or not structure information is embedded in the XPS document to facilitate screen readers.

This parameter defaults to True when omitted.

TimeOut: Optional.
The time-out for this command in seconds. If the WordProcessor exceeds this time-out the process is terminated and ITP/Server will report a runtime error.
If this parameter is omitted the appropriate default time-out value for either batch or interactive jobs is used. A time-out value of 0 disables the time-out.
This feature is currently only supported for Microsoft Word.