Show/Hide Toolbars

Therefore Web API Programming Interface 1.0

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

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

 

Returns file streams of existing Thereforeâ„¢ document and converts them into the desired format.

 

 

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

 

Element Name

Element Type

Restrictions

Description

â–  parameters

 

 


â–¡ ConversionOptions

 

mandatory nillable

Sets the options for converting the files.

â–  AnnotationMode

 

 

restriction enum (xs:string)

- Default (0)

- Merge (1)

- Hide (2)

Sets the annotation mode.

â–¡ CertificateName

xs:string

nillable

Sets the name of the certificate for signing the file.

â–  ConvertTo

 

 

restriction enum (xs:string)

- Original (0)

- SingleTIFF (1)

- SinglePDF (2)

- MultipageTIFF (3)

- MultipagePDF (4)

- SearchablePDF (5)

- SearchablePDFA (6)

- Jpeg (50)

Sets the conversion file format. Notes for multipage conversion types: - In the CreateDocument, AddStreamToDocument, and SubmitCreateDocumentBatch methods, the conversion type will be applied to all the specified streams together. - In the UpdateDocument and SubmitUpdateDocumentBatch methods, the conversion type will be applied to all the new streams together. But for updated streams this will be done on a one by one basis.

â–  SignatureMode

 

 

restriction enum (xs:string)

- NoSignature (0)

- SignatureOnly (1)

- SignatureAndTimestamp (2)

Sets the signature mode.

â–¡ TimeStampPwd

xs:string

nillable

Sets the password for the user for the timestamp server.

â–¡ TimeStampServer

xs:string

nillable

Sets the name of the timestamp server for signing the file.

â–¡ TimeStampUser

xs:string

nillable

Sets the user for the timestamp server.

â–¡ MultipageStreamName

xs:string

nillable

Sets the name of the multipage result stream. Specifies a stream name to be used instead of default one (given by conversion server). Use it with multipage conversion types (see the ConvertTo parameter). Value will be ignored for a single page TIFF/PDF, JPEG, and Original conversion types. For the GetConvertedDocStreams, GetConvertedDocStreamsRaw methods set desired file name without extension or null for default name (default is document title).

â–  DocNo

xs:int

mandatory

Sets the number of the document to get streams for.

â–¡ StreamNos

 

mandatory nillable

Sets stream ids of the streams to get. If the list is empty ALL streams of the document will be converted.

≡ StreamNo

xs:int

list


â–  ArchiveConvertedFiles

xs:boolean

 

Set to true to archive (.zip) files after conversion if any. Default is false.

â–¡ CustomArchiveFileName

xs:string

nillable

Set desired file name without extension or null for default name. For a single document default is the document title. For multiple documents default is 'Document'.

â–  VersionNo

xs:int

 

Sets document version number. By default or if set to 0 it means to use the latest document version.

â–  IsFileDataBase64JSONNeeded

xs:boolean

 

Set to true to return file data in the response in the FileDataBase64JSON property (as a Base64 encoded string).

 

 

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

 

Element Name

Element Type

Restrictions

Description

â–  parameters

 

 


â–¡ Streams

 

nillable

Gets list of requested streams converted into the desired format.

≡ WSStreamInfoWithData

 

list nillable


â–¡ FileData

xs:base64Binary

nillable

Gets or sets binary data of the file. It uses a base64 encoded string in XML messages and a byte array in JSON messages. If both FileData and FileDataBase64JSON are set the value in FileDataBase64JSON gets ignored.

â–¡ FileName

xs:string

mandatory nillable

Gets or sets the name of the stream file.

â–¡ StreamNo

xs:int

nillable

Gets or sets the number of the stream. Note: For document conversion result it always returns null (method GetConvertedDocStreams).

â–¡ FileDataBase64JSON

xs:string

nillable

Gets or sets binary data of the file as a base64 encoded string (for both XML and JSON encoded messages). If both FileData and FileDataBase64JSON are set the value in FileDataBase64JSON gets ignored.

 

 

 

Legend:

 

â– 

Not nillable element.

â–¡

Nillable element.

≡

List of elements.

Bold

Mandatory element.

 

 

© 2023 Therefore Corporation, all rights reserved.