Show/Hide Toolbars

Therefore Web API Programming Interface 1.0

REST URL (POST) https://tenant.thereforeonline.com/theservice/v0001/restun/StartViewingSession

SOAP Action (POST) http://schemas.therefore.net/webservices/interop/v0001/messages/IThereforeService/StartViewingSession

 

Starts a viewing session for a specified document stream or for a file from the upload session. Also creates a thumbnail if required.

 

 

Input Message: http://schemas.therefore.net/webservices/interop/v0001/messages/IThereforeService/StartViewingSession

 

Element Name

Element Type

Restrictions

Description

â–  parameters

 

 


â–¡ DocNo

xs:int

nillable

The number of the document to be viewed or 0 if a newly uploaded document should be viewed

â–¡ VersionNo

xs:int

nillable

The version of the document to be viewed or 0 if a newly uploaded document should be viewed

â–¡ StreamNo

xs:int

nillable

The StreamNo of an document to be viewed or 0 if a newly uploaded document should be viewed

â–¡ UploadSessionId

xs:string

nillable

GUID string template:

[\da-fA-F]{8}-[\da-fA-F]{4}-[\da-fA-F]{4}-[\da-fA-F]{4}-[\da-fA-F]{12}

The upload session guid to be viewed or null/undefined if an existing document should be viewed

â–¡ SizeInPixels

xs:int

nillable

Sets the size of the thumbnail in pixels. Nil or 0 (zero) value means that no thumbnail file should be created.

â–¡ ConversionOptions

 

nillable

Conversion options that should be applied to the document when converting to HTML.

â–¡ RenderWordComments

xs:boolean

nillable

Enables rendering of review comments in Word documents.

â–¡ Password

xs:string

nillable

Password for encrypted files.

 

 

Output Message: http://schemas.therefore.net/webservices/interop/v0001/messages/IThereforeService/StartViewingSessionResponse

 

Element Name

Element Type

Restrictions

Description

â–  parameters

 

 


â–¡ DocProperties

 

mandatory nillable

Document properties of the loaded file.

â–¡ PageSizes

 

mandatory nillable

Width and height for every page of the file

≡ ArrayOfint

 

list nillable


≡ int

xs:int

list


â–¡ TabNames

 

nillable

Tab names for document types with tabbed-viewing.

≡ string

xs:string

list nillable


â–¡ ThumbnailFileData

xs:base64Binary

nillable

Gets binary data of the thumbnail file. Nothing is returned if the thumbnail can not be obtained for a given document. It uses a base64 encoded string in XML messages and a byte array in JSON messages.

 

 

 

Legend:

 

â– 

Not nillable element.

â–¡

Nillable element.

≡

List of elements.

Bold

Mandatory element.

 

 

© 2023 Therefore Corporation, all rights reserved.