ITP/Server will instruct the appropriate word processor to open 'Document' and run the specified macro. ITP/Server will automatically choose the right word processor by inspecting the contents of Document. The extension of Document does not matter. The format of Document should be one of the document formats that ITP/Server recognizes; see the description of the parameter Document below.
The effect of the parameters depends on the macro interface that the word processor offers:
Word Processor |
Macro |
Description |
|
|---|---|---|---|
Word |
macro |
Word will execute macro from the currently loaded templates and documents. |
|
OpenOffice.org |
URI |
OpenOffice.org will execute the specified macro. |
|
|
|||
|
The macro must save and close any opened document (including the 'Document') before terminating.
Interaction with the user is not possible, and the macro must provide non-interactive error handling.
RunMacro
Document(<text>)
Macro(<text>)
Arg1(<text>)
Arg2(<text>)
...
Arg10(<text>)
TimeOut(<number>);
Document: Required.
The word processor document that ITP/Server will load is required. Currently supported word processor formats are Microsoft Word and OpenOffice.org.
This document is loaded before the macro is started. The macro should save and close this document.
Macro: Required.
The name of the macro that will be run.
Arg1: Optional.
First parameter for the macro.
Arg2 through Arg10: Optional.
Second through tenth parameter for the macro.
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.