Host

String

BSTR

Required. A string that contains the name of the server running ITP/OnLine Server. The name can be specified either in (IPv4) Internet Protocol dotted address notation (a.b.c.d) or as a resolvable host name.

127.0.0.1 (localhost)

Port

String

BSTR

Required. A string that contains the port to connect to ITP/OnLine Server. The port can be specified either in numerical format or as a resolvable port name (TCP/IP service name).

-

JobID

String

BSTR

Required. A string that contains the Job Identifier for this job.

-

UserID

String

BSTR

Optional. The user who is doing this request. If not set, the api will pass the user who it is running under.

User who the api is running under.

ApplicationID

String

Optional. Additional accounting information.

-

SessionID

String

This identifier will be initialized by ITP/OnLine Server during a "Start" call. If a single COM instance is used to manage a complete model run, this will automatically ensure that Continue/Cancel/Finish calls pass the right session id. Else, the user of this api is responsible for remembering this value, and setting it before issuing one of these subsequent calls. Refer to Run an interactive ITP Model for more details.

-

Environment

String

Optional. The environment that the model runs in. If not set, the default environment will be used (if configured).

-

DBUserID

String

Optional. Database User ID

-

DBPassword

String

Optional. Database password for the given DBUser. The implementation will always store and pass this value in encrypted form. If set, these credentials will initially be passed to the Start and the Continue call. They will override any credentials that have been set in the Connection Configuration file.

-

History

Boolean

Optional. If set to True, return a list of all interact answers (in XML format) together with the final document

False

Info

String

Required. This property contains the path to the file in which all XML data will be returned. Its contents will depend on the call, and on the return value of the call.

Refer to Return values

for more info on the return values of the info property.

-

Result

String

The UNC path that the final document will be stored at. It contains the last value that was passed as a Result argument to the Start method.
If this UNC path is a location accessible from the machine on which the COM API is installed, the API will retrieve the document from ITP/OnLine Server and store it at this location. Ensure that the API is able to write to this location. Also see the DocumentOnServer property for alternative use.

-

Preview

String

Optional. The UNC path that the previews will be stored at. A preview is an intermediate result document, as it is at the moment of an interact. Also see Result. If no preview filename is specified, no previews will be generated. It is allowed to use the same UNC path for both the preview and the final document.

-

Data

String

Optional. The UNC path to an XML data file. Also see Result.

This XML data can be passed as an input file to ITP/Server. Only used with the ITP XML File Connection.

If the Data property is not set and the ITP Model needs an XML data file, an XML Form will be send out with an INTERACT. In this INTERACT the user is asked to select the XML data file.

-

ResultOverwrite

Boolean

Optional. Specifies whether existing result documents may be overwritten.

True

ResultFormat

String

Optional. The format of the final document. Can be either "NATIVE" or "PDF" (case insensitive). Default is "NATIVE", which means that the word processor format of the model itself gets generated.

"NATIVE"

PreviewFormat

String

Optional. The format of the previews. Can be either "NATIVE" or "PDF" (case insensitive).

"NATIVE"

ResultOnServer

Boolean

If True, the Result is relative to the ITP/OnLine Server machine. For example, a local path on the ITP/OnLine Server machine. In that case, ITP/OnLine Server is responsible for storing the result document at that location. The final document will not be transferred to the COM API then. If this value is False, the final document will be transferred and stored from the machine where the COM API has been installed.

False

PreviewOnServer

Boolean

Optional. See ResultOnServer

False

DataOnServer

Boolean

Optional. See ResultOnServer. If True, the API will not transmit any XML data file.

False

FileExtension

String

Read only. Contains the extension of the result document. Possible values are;

unknown: Unable to determine the type of the file.
doc: Microsoft Word document.
docx: Microsoft Word Open XML document.
ps: PostScript file.
pdf: PDF document.
sxw: OpenOffice.org/ StarOffice document.
odt:
OpenOffice.org 2.2 document
lwp: WordPro document.
wpd: WordPerfect document.

False

ProcessPreviewParams*

String

BSTR

Optional. A string that will be passed to the ProcessPreview exit point. This can be used freely to pass information to the exit point, for example to specify which action it should take.

-

ProcessResultParams*

String

BSTR

Optional. A string that will be passed to the ProcessResult exit point. This can be used freely to pass information to the exit point, for example to specify which action it should take.

-

FormVersion**

String

BSTR

Optional. The maximum feature level that is supported by the client of the API. This allows clients to protect themselves against new features in the INTERACT XMLs returned by ITP/Server. Instead of sending back an XML with these features, ITP/Server will return an error

"0"