LogicalDOC API - Document

Method #1: lock

locks an existing document with the given identifier

Request

Name	Type	Required	Description

sid	String	Y	identifier of the session

docId	Long	Y	Document ID

Method #2: update

updates an existing document with the value object containing the document's metadata

Request

Name	Type	Required	Multiple	Description

sid	String	Y		identifier of the session

document	WSDocument	Y

id	Long	Y		unique identifier

fileSize	Long	Y

status	Int			0 = unlocked, 1 = checked out, 2 = locked

exportStatus	Int

version	String

fileVersion	String

date	String	Y		last publication date; format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'

publisher	String

publisherId	Long

creator	String

creatorId	Long

type	String	Y

lockUserId	Long

creation	String			the date when the document was created; format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'

fileName	String	Y

indexed	Int			0 = to index, 1 = indexed, 2 = skip indexing

signed	Int

stamped	Int			1 if the document contains at least one stamp

tags	String		Y	tags applied to the document

folderId	Long	Y		parent folder

templateId	Long			id of the template assigned to the document

customId	String			unique custom identifier

immutable	Int			0 = not immutable, 1 = immutable

digest	String

exportName	String

exportId	Long

docRef	Long			used for aliases, refers to another document

docRefType	String			if used, defines the reference type (use pdf for the PDF Conversion)

deleteUserId	Long			user that has deleted the document

attributes	WSAttribute		Y	array of attributes

name	String	Y		name of the attribute

stringValue	String

intValue	Long

doubleValue	Double

dateValue	String			the date value; format must be 'yyyy-MM-dd'

type	Int	Y		0 = String, 1 = int, 2 = double, 3 = date, 4 = user (intValue represents the user's id), 5 = boolean (intValue must be 0 or 1), 6 = folder (intValue represents the folders's id, 7 = document (intValue represents the document's id), 8 = section

mandatory	Int	Y

hidden	Int	Y

readonly	Int	Y

position	Int

label	String

editor	Int	Y		0 = free, 1 = preset

setId	Long			Id of the attribute set

multiple	Int	Y		0 = single value, 1 = one or more values

parent	String			The reference attribute name, used for multi value attributes

dependsOn	String			Name of another attribute on which the value of this attribute also depends, used for managing linked presets

stringValues	String			Read only. In case of multiple string values, contains the values separated by a comma

validation	String			Optional validation script

initialization	String			Optional initialization script

language	String			language of the document; See specification

summary	String			contains the snippet search text

score	Integer			full text search score

icon	String

comment	String

lastModified	String

rating	Integer

workflowStatus	String			current workflow's status where the document is in

workflowStatusDisplay	String			current workflow's status display informations

color	String			optional color assigned to the document

published	Int			if it is not set to 1, the document is marked as not published

startPublishing	String

stopPublishing	String

pages	Int			number of pages (default 1)

nature	Int			0 = document, 1 = form

formId	Long			the last modified date; format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'

passwordProtected	Integer			indicates whether the document is protected by a password

ocrTemplateId	Long			identifier of the Zonal OCR template to use to process this document

ocrd	Int			indicates if the document has been processed by the zonal OCR: 0 = to process, 1 = processed

barcodeTemplateId	Long			identifier of the barcode template to use to process this document

barcoded	Int			indicates if the document has been processed by the barcode processor: 0 = to process, 1 = processed

Method #3: list

gets the documents in a specific folder

Request

Name	Type	Required	Description

sid	String	Y	identifier of the session

folderId	Long	Y

fileName	String		file name filter

sort	String	Y	Optional sort criteria (eg date asc)

page	Integer	Y	Optional page number

max	Integer	Y	Optional maximum number of elements per page

Response

Name	Type	Required	Multiple	Description

document	WSDocument	Y	Y

id	Long	Y		unique identifier

fileSize	Long	Y

status	Int			0 = unlocked, 1 = checked out, 2 = locked

exportStatus	Int

version	String

fileVersion	String

date	String	Y		last publication date; format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'

publisher	String

publisherId	Long

creator	String

creatorId	Long

type	String	Y

lockUserId	Long

creation	String			the date when the document was created; format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'

fileName	String	Y

indexed	Int			0 = to index, 1 = indexed, 2 = skip indexing

signed	Int

stamped	Int			1 if the document contains at least one stamp

tags	String		Y	tags applied to the document

folderId	Long	Y		parent folder

templateId	Long			id of the template assigned to the document

customId	String			unique custom identifier

immutable	Int			0 = not immutable, 1 = immutable

digest	String

exportName	String

exportId	Long

docRef	Long			used for aliases, refers to another document

docRefType	String			if used, defines the reference type (use pdf for the PDF Conversion)

deleteUserId	Long			user that has deleted the document

attributes	WSAttribute		Y	array of attributes

name	String	Y		name of the attribute

stringValue	String

intValue	Long

doubleValue	Double

dateValue	String			the date value; format must be 'yyyy-MM-dd'

type	Int	Y		0 = String, 1 = int, 2 = double, 3 = date, 4 = user (intValue represents the user's id), 5 = boolean (intValue must be 0 or 1), 6 = folder (intValue represents the folders's id, 7 = document (intValue represents the document's id), 8 = section

mandatory	Int	Y

hidden	Int	Y

readonly	Int	Y

position	Int

label	String

editor	Int	Y		0 = free, 1 = preset

setId	Long			Id of the attribute set

multiple	Int	Y		0 = single value, 1 = one or more values

parent	String			The reference attribute name, used for multi value attributes

dependsOn	String			Name of another attribute on which the value of this attribute also depends, used for managing linked presets

stringValues	String			Read only. In case of multiple string values, contains the values separated by a comma

validation	String			Optional validation script

initialization	String			Optional initialization script

language	String			language of the document; See specification

summary	String			contains the snippet search text

score	Integer			full text search score

icon	String

comment	String

lastModified	String

rating	Integer

workflowStatus	String			current workflow's status where the document is in

workflowStatusDisplay	String			current workflow's status display informations

color	String			optional color assigned to the document

published	Int			if it is not set to 1, the document is marked as not published

startPublishing	String

stopPublishing	String

pages	Int			number of pages (default 1)

nature	Int			0 = document, 1 = form

formId	Long			the last modified date; format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'

passwordProtected	Integer			indicates whether the document is protected by a password

ocrTemplateId	Long			identifier of the Zonal OCR template to use to process this document

ocrd	Int			indicates if the document has been processed by the zonal OCR: 0 = to process, 1 = processed

barcodeTemplateId	Long			identifier of the barcode template to use to process this document

barcoded	Int			indicates if the document has been processed by the barcode processor: 0 = to process, 1 = processed

Method #4: getResource

gets the content of a resource associated to the given document; returns the raw content of the file

Request

Name	Type	Required	Description

sid	String	Y	identifier of the session

docId	Long	Y	the document id

fileVersion	String	Y	the file version to retrieve, eg: '1.0', '2.3'

suffix	String	Y	suffix specification(it cannot be empty, use 'conversion.pdf' to get the PDF conversion)

Response

Name		Type		Required		Multiple		Description

		DataHandler		Y

Method #5: unlock

unlocks an existing document with the given identifier

Request

Name	Type	Required	Description

sid	String	Y	identifier of the session

docId	Long	Y	identifier of the document

Method #6: delete

deletes an existing document with the given identifier

Request

Name	Type	Required	Description

sid	String	Y	identifier of the session

docId	Long	Y	Document ID

Method #7: copy

copies a document into a folder

Request

Name	Type	Required	Description

sid	String	Y	identifier of the session

docId	Long	Y	Document ID

folderId	Long	Y	identifier of the new document's folder

links	Boolean	Y	if the links must be copied too

notes	Boolean	Y	if the notes and annotations must be copied too

security	Boolean	Y	if the security settings must be copied too

Response

Name	Type	Required	Multiple	Description

document	WSDocument	Y

id	Long	Y		unique identifier

fileSize	Long	Y

status	Int			0 = unlocked, 1 = checked out, 2 = locked

exportStatus	Int

version	String

fileVersion	String

date	String	Y		last publication date; format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'

publisher	String

publisherId	Long

creator	String

creatorId	Long

type	String	Y

lockUserId	Long

creation	String			the date when the document was created; format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'

fileName	String	Y

indexed	Int			0 = to index, 1 = indexed, 2 = skip indexing

signed	Int

stamped	Int			1 if the document contains at least one stamp

tags	String		Y	tags applied to the document

folderId	Long	Y		parent folder

templateId	Long			id of the template assigned to the document

customId	String			unique custom identifier

immutable	Int			0 = not immutable, 1 = immutable

digest	String

exportName	String

exportId	Long

docRef	Long			used for aliases, refers to another document

docRefType	String			if used, defines the reference type (use pdf for the PDF Conversion)

deleteUserId	Long			user that has deleted the document

attributes	WSAttribute		Y	array of attributes

name	String	Y		name of the attribute

stringValue	String

intValue	Long

doubleValue	Double

dateValue	String			the date value; format must be 'yyyy-MM-dd'

type	Int	Y		0 = String, 1 = int, 2 = double, 3 = date, 4 = user (intValue represents the user's id), 5 = boolean (intValue must be 0 or 1), 6 = folder (intValue represents the folders's id, 7 = document (intValue represents the document's id), 8 = section

mandatory	Int	Y

hidden	Int	Y

readonly	Int	Y

position	Int

label	String

editor	Int	Y		0 = free, 1 = preset

setId	Long			Id of the attribute set

multiple	Int	Y		0 = single value, 1 = one or more values

parent	String			The reference attribute name, used for multi value attributes

dependsOn	String			Name of another attribute on which the value of this attribute also depends, used for managing linked presets

stringValues	String			Read only. In case of multiple string values, contains the values separated by a comma

validation	String			Optional validation script

initialization	String			Optional initialization script

language	String			language of the document; See specification

summary	String			contains the snippet search text

score	Integer			full text search score

icon	String

comment	String

lastModified	String

rating	Integer

workflowStatus	String			current workflow's status where the document is in

workflowStatusDisplay	String			current workflow's status display informations

color	String			optional color assigned to the document

published	Int			if it is not set to 1, the document is marked as not published

startPublishing	String

stopPublishing	String

pages	Int			number of pages (default 1)

nature	Int			0 = document, 1 = form

formId	Long			the last modified date; format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'

passwordProtected	Integer			indicates whether the document is protected by a password

ocrTemplateId	Long			identifier of the Zonal OCR template to use to process this document

ocrd	Int			indicates if the document has been processed by the zonal OCR: 0 = to process, 1 = processed

barcodeTemplateId	Long			identifier of the barcode template to use to process this document

barcoded	Int			indicates if the document has been processed by the barcode processor: 0 = to process, 1 = processed

Method #8: create

creates a new document; the user can completely customize the document through a value object containing the document's metadata; returns the newly created document.

Request

Name	Type	Required	Multiple	Description

sid	String	Y		identifier of the session

document	WSDocument	Y

id	Long	Y		unique identifier

fileSize	Long	Y

status	Int			0 = unlocked, 1 = checked out, 2 = locked

exportStatus	Int

version	String

fileVersion	String

date	String	Y		last publication date; format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'

publisher	String

publisherId	Long

creator	String

creatorId	Long

type	String	Y

lockUserId	Long

creation	String			the date when the document was created; format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'

fileName	String	Y

indexed	Int			0 = to index, 1 = indexed, 2 = skip indexing

signed	Int

stamped	Int			1 if the document contains at least one stamp

tags	String		Y	tags applied to the document

folderId	Long	Y		parent folder

templateId	Long			id of the template assigned to the document

customId	String			unique custom identifier

immutable	Int			0 = not immutable, 1 = immutable

digest	String

exportName	String

exportId	Long

docRef	Long			used for aliases, refers to another document

docRefType	String			if used, defines the reference type (use pdf for the PDF Conversion)

deleteUserId	Long			user that has deleted the document

attributes	WSAttribute		Y	array of attributes

name	String	Y		name of the attribute

stringValue	String

intValue	Long

doubleValue	Double

dateValue	String			the date value; format must be 'yyyy-MM-dd'

type	Int	Y		0 = String, 1 = int, 2 = double, 3 = date, 4 = user (intValue represents the user's id), 5 = boolean (intValue must be 0 or 1), 6 = folder (intValue represents the folders's id, 7 = document (intValue represents the document's id), 8 = section

mandatory	Int	Y

hidden	Int	Y

readonly	Int	Y

position	Int

label	String

editor	Int	Y		0 = free, 1 = preset

setId	Long			Id of the attribute set

multiple	Int	Y		0 = single value, 1 = one or more values

parent	String			The reference attribute name, used for multi value attributes

dependsOn	String			Name of another attribute on which the value of this attribute also depends, used for managing linked presets

stringValues	String			Read only. In case of multiple string values, contains the values separated by a comma

validation	String			Optional validation script

initialization	String			Optional initialization script

language	String			language of the document; See specification

summary	String			contains the snippet search text

score	Integer			full text search score

icon	String

comment	String

lastModified	String

rating	Integer

workflowStatus	String			current workflow's status where the document is in

workflowStatusDisplay	String			current workflow's status display informations

color	String			optional color assigned to the document

published	Int			if it is not set to 1, the document is marked as not published

startPublishing	String

stopPublishing	String

pages	Int			number of pages (default 1)

nature	Int			0 = document, 1 = form

formId	Long			the last modified date; format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'

passwordProtected	Integer			indicates whether the document is protected by a password

ocrTemplateId	Long			identifier of the Zonal OCR template to use to process this document

ocrd	Int			indicates if the document has been processed by the zonal OCR: 0 = to process, 1 = processed

barcodeTemplateId	Long			identifier of the barcode template to use to process this document

barcoded	Int			indicates if the document has been processed by the barcode processor: 0 = to process, 1 = processed

content	DataHandler	Y		the raw content of the file

Response

Name	Type	Required	Multiple	Description

document	WSDocument	Y

id	Long	Y		unique identifier

fileSize	Long	Y

status	Int			0 = unlocked, 1 = checked out, 2 = locked

exportStatus	Int

version	String

fileVersion	String

date	String	Y		last publication date; format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'

publisher	String

publisherId	Long

creator	String

creatorId	Long

type	String	Y

lockUserId	Long

creation	String			the date when the document was created; format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'

fileName	String	Y

indexed	Int			0 = to index, 1 = indexed, 2 = skip indexing

signed	Int

stamped	Int			1 if the document contains at least one stamp

tags	String		Y	tags applied to the document

folderId	Long	Y		parent folder

templateId	Long			id of the template assigned to the document

customId	String			unique custom identifier

immutable	Int			0 = not immutable, 1 = immutable

digest	String

exportName	String

exportId	Long

docRef	Long			used for aliases, refers to another document

docRefType	String			if used, defines the reference type (use pdf for the PDF Conversion)

deleteUserId	Long			user that has deleted the document

attributes	WSAttribute		Y	array of attributes

name	String	Y		name of the attribute

stringValue	String

intValue	Long

doubleValue	Double

dateValue	String			the date value; format must be 'yyyy-MM-dd'

type	Int	Y		0 = String, 1 = int, 2 = double, 3 = date, 4 = user (intValue represents the user's id), 5 = boolean (intValue must be 0 or 1), 6 = folder (intValue represents the folders's id, 7 = document (intValue represents the document's id), 8 = section

mandatory	Int	Y

hidden	Int	Y

readonly	Int	Y

position	Int

label	String

editor	Int	Y		0 = free, 1 = preset

setId	Long			Id of the attribute set

multiple	Int	Y		0 = single value, 1 = one or more values

parent	String			The reference attribute name, used for multi value attributes

dependsOn	String			Name of another attribute on which the value of this attribute also depends, used for managing linked presets

stringValues	String			Read only. In case of multiple string values, contains the values separated by a comma

validation	String			Optional validation script

initialization	String			Optional initialization script

language	String			language of the document; See specification

summary	String			contains the snippet search text

score	Integer			full text search score

icon	String

comment	String

lastModified	String

rating	Integer

workflowStatus	String			current workflow's status where the document is in

workflowStatusDisplay	String			current workflow's status display informations

color	String			optional color assigned to the document

published	Int			if it is not set to 1, the document is marked as not published

startPublishing	String

stopPublishing	String

pages	Int			number of pages (default 1)

nature	Int			0 = document, 1 = form

formId	Long			the last modified date; format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'

passwordProtected	Integer			indicates whether the document is protected by a password

ocrTemplateId	Long			identifier of the Zonal OCR template to use to process this document

ocrd	Int			indicates if the document has been processed by the zonal OCR: 0 = to process, 1 = processed

barcodeTemplateId	Long			identifier of the barcode template to use to process this document

barcoded	Int			indicates if the document has been processed by the barcode processor: 0 = to process, 1 = processed

Method #9: getContent

gets the content of an existing document with the given identifier; returns the raw content of the file

Request

Name	Type	Required	Description

sid	String	Y	identifier of the session

docId	Long	Y	Document ID

Response

Name		Type		Required		Multiple		Description

		DataHandler		Y

Method #10: rename

renames the title of an existing document with the given identifier

Request

Name	Type	Required	Description

sid	String	Y	identifier of the session

docId	Long	Y	Document ID

name	String	Y

Method #11: move

moves an existing document with the given identifier

Request

Name	Type	Required	Description

sid	String	Y	identifier of the session

docId	Long	Y	Document ID

folderId	Long	Y	identifier of the new document's folder

Method #12: link

creates a new link between two documents

Request

Name	Type	Required	Description

sid	String	Y	identifier of the session

doc1	Long	Y	ID of document 1

doc2	Long	Y	ID of document 2

type	String		type of the link (use 'pdf' to point to the pdf conversion)

Response

Name	Type	Required	Description

link	WSLink	Y

id	Long	Y	unique identifier

type	String		just a string indicating the meaning of the link

doc1	Long	Y	itentifier of document 1

doc2	Long	Y	itentifier of document 2

Method #13: getVersion

gets a version of a document; returns the version

Request

Name	Type	Required	Description

sid	String	Y	identifier of the session

docId	Long	Y	the document id

version	String	Y	the version number

Response

Name	Type	Required	Multiple	Description

version	WSDocument	Y

id	Long	Y		unique identifier

fileSize	Long	Y

status	Int			0 = unlocked, 1 = checked out, 2 = locked

exportStatus	Int

version	String

fileVersion	String

date	String	Y		last publication date; format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'

publisher	String

publisherId	Long

creator	String

creatorId	Long

type	String	Y

lockUserId	Long

creation	String			the date when the document was created; format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'

fileName	String	Y

indexed	Int			0 = to index, 1 = indexed, 2 = skip indexing

signed	Int

stamped	Int			1 if the document contains at least one stamp

tags	String		Y	tags applied to the document

folderId	Long	Y		parent folder

templateId	Long			id of the template assigned to the document

customId	String			unique custom identifier

immutable	Int			0 = not immutable, 1 = immutable

digest	String

exportName	String

exportId	Long

docRef	Long			used for aliases, refers to another document

docRefType	String			if used, defines the reference type (use pdf for the PDF Conversion)

deleteUserId	Long			user that has deleted the document

attributes	WSAttribute		Y	array of attributes

name	String	Y		name of the attribute

stringValue	String

intValue	Long

doubleValue	Double

dateValue	String			the date value; format must be 'yyyy-MM-dd'

type	Int	Y		0 = String, 1 = int, 2 = double, 3 = date, 4 = user (intValue represents the user's id), 5 = boolean (intValue must be 0 or 1), 6 = folder (intValue represents the folders's id, 7 = document (intValue represents the document's id), 8 = section

mandatory	Int	Y

hidden	Int	Y

readonly	Int	Y

position	Int

label	String

editor	Int	Y		0 = free, 1 = preset

setId	Long			Id of the attribute set

multiple	Int	Y		0 = single value, 1 = one or more values

parent	String			The reference attribute name, used for multi value attributes

dependsOn	String			Name of another attribute on which the value of this attribute also depends, used for managing linked presets

stringValues	String			Read only. In case of multiple string values, contains the values separated by a comma

validation	String			Optional validation script

initialization	String			Optional initialization script

language	String			language of the document; See specification

summary	String			contains the snippet search text

score	Integer			full text search score

icon	String

comment	String

lastModified	String

rating	Integer

workflowStatus	String			current workflow's status where the document is in

workflowStatusDisplay	String			current workflow's status display informations

color	String			optional color assigned to the document

published	Int			if it is not set to 1, the document is marked as not published

startPublishing	String

stopPublishing	String

pages	Int			number of pages (default 1)

nature	Int			0 = document, 1 = form

formId	Long			the last modified date; format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'

passwordProtected	Integer			indicates whether the document is protected by a password

ocrTemplateId	Long			identifier of the Zonal OCR template to use to process this document

ocrd	Int			indicates if the document has been processed by the zonal OCR: 0 = to process, 1 = processed

barcodeTemplateId	Long			identifier of the barcode template to use to process this document

barcoded	Int			indicates if the document has been processed by the barcode processor: 0 = to process, 1 = processed

Method #14: getAliases

gets the aliases of the given document; returns an array of WSDocument that are aliases

Request

Name	Type	Required	Description

sid	String	Y	identifier of the session

docId	Long	Y	Document ID

Response

Name	Type	Required	Multiple	Description

aliases	WSDocument	Y	Y

id	Long	Y		unique identifier

fileSize	Long	Y

status	Int			0 = unlocked, 1 = checked out, 2 = locked

exportStatus	Int

version	String

fileVersion	String

date	String	Y		last publication date; format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'

publisher	String

publisherId	Long

creator	String

creatorId	Long

type	String	Y

lockUserId	Long

creation	String			the date when the document was created; format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'

fileName	String	Y

indexed	Int			0 = to index, 1 = indexed, 2 = skip indexing

signed	Int

stamped	Int			1 if the document contains at least one stamp

tags	String		Y	tags applied to the document

folderId	Long	Y		parent folder

templateId	Long			id of the template assigned to the document

customId	String			unique custom identifier

immutable	Int			0 = not immutable, 1 = immutable

digest	String

exportName	String

exportId	Long

docRef	Long			used for aliases, refers to another document

docRefType	String			if used, defines the reference type (use pdf for the PDF Conversion)

deleteUserId	Long			user that has deleted the document

attributes	WSAttribute		Y	array of attributes

name	String	Y		name of the attribute

stringValue	String

intValue	Long

doubleValue	Double

dateValue	String			the date value; format must be 'yyyy-MM-dd'

type	Int	Y		0 = String, 1 = int, 2 = double, 3 = date, 4 = user (intValue represents the user's id), 5 = boolean (intValue must be 0 or 1), 6 = folder (intValue represents the folders's id, 7 = document (intValue represents the document's id), 8 = section

mandatory	Int	Y

hidden	Int	Y

readonly	Int	Y

position	Int

label	String

editor	Int	Y		0 = free, 1 = preset

setId	Long			Id of the attribute set

multiple	Int	Y		0 = single value, 1 = one or more values

parent	String			The reference attribute name, used for multi value attributes

dependsOn	String			Name of another attribute on which the value of this attribute also depends, used for managing linked presets

stringValues	String			Read only. In case of multiple string values, contains the values separated by a comma

validation	String			Optional validation script

initialization	String			Optional initialization script

language	String			language of the document; See specification

summary	String			contains the snippet search text

score	Integer			full text search score

icon	String

comment	String

lastModified	String

rating	Integer

workflowStatus	String			current workflow's status where the document is in

workflowStatusDisplay	String			current workflow's status display informations

color	String			optional color assigned to the document

published	Int			if it is not set to 1, the document is marked as not published

startPublishing	String

stopPublishing	String

pages	Int			number of pages (default 1)

nature	Int			0 = document, 1 = form

formId	Long			the last modified date; format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'

passwordProtected	Integer			indicates whether the document is protected by a password

ocrTemplateId	Long			identifier of the Zonal OCR template to use to process this document

ocrd	Int			indicates if the document has been processed by the zonal OCR: 0 = to process, 1 = processed

barcodeTemplateId	Long			identifier of the barcode template to use to process this document

barcoded	Int			indicates if the document has been processed by the barcode processor: 0 = to process, 1 = processed

Method #15: getVersionContent

gets the content of a specific version of a document; returns the raw content of the file

Request

Name	Type	Required	Description

sid	String	Y	identifier of the session

docId	Long	Y	the document id

version	String	Y	the version to retrieve, eg: '1.0', '2.3'

Response

Name		Type		Required		Multiple		Description

		DataHandler		Y

Method #16: replaceFile

replaces the file associated to a given version

Request

Name	Type	Required	Description

sid	String	Y	identifier of the session

docId	Long	Y	the document id

fileVersion	String	Y

comment	String	Y

content	DataHandler	Y

Method #17: getVersions

gets the versions' history of a document; returns an array of versions

Request

Name	Type	Required	Description

sid	String	Y	identifier of the session

docId	Long	Y	the document id

Response

Name	Type	Required	Multiple	Description

version	WSDocument	Y	Y

id	Long	Y		unique identifier

fileSize	Long	Y

status	Int			0 = unlocked, 1 = checked out, 2 = locked

exportStatus	Int

version	String

fileVersion	String

date	String	Y		last publication date; format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'

publisher	String

publisherId	Long

creator	String

creatorId	Long

type	String	Y

lockUserId	Long

creation	String			the date when the document was created; format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'

fileName	String	Y

indexed	Int			0 = to index, 1 = indexed, 2 = skip indexing

signed	Int

stamped	Int			1 if the document contains at least one stamp

tags	String		Y	tags applied to the document

folderId	Long	Y		parent folder

templateId	Long			id of the template assigned to the document

customId	String			unique custom identifier

immutable	Int			0 = not immutable, 1 = immutable

digest	String

exportName	String

exportId	Long

docRef	Long			used for aliases, refers to another document

docRefType	String			if used, defines the reference type (use pdf for the PDF Conversion)

deleteUserId	Long			user that has deleted the document

attributes	WSAttribute		Y	array of attributes

name	String	Y		name of the attribute

stringValue	String

intValue	Long

doubleValue	Double

dateValue	String			the date value; format must be 'yyyy-MM-dd'

type	Int	Y		0 = String, 1 = int, 2 = double, 3 = date, 4 = user (intValue represents the user's id), 5 = boolean (intValue must be 0 or 1), 6 = folder (intValue represents the folders's id, 7 = document (intValue represents the document's id), 8 = section

mandatory	Int	Y

hidden	Int	Y

readonly	Int	Y

position	Int

label	String

editor	Int	Y		0 = free, 1 = preset

setId	Long			Id of the attribute set

multiple	Int	Y		0 = single value, 1 = one or more values

parent	String			The reference attribute name, used for multi value attributes

dependsOn	String			Name of another attribute on which the value of this attribute also depends, used for managing linked presets

stringValues	String			Read only. In case of multiple string values, contains the values separated by a comma

validation	String			Optional validation script

initialization	String			Optional initialization script

language	String			language of the document; See specification

summary	String			contains the snippet search text

score	Integer			full text search score

icon	String

comment	String

lastModified	String

rating	Integer

workflowStatus	String			current workflow's status where the document is in

workflowStatusDisplay	String			current workflow's status display informations

color	String			optional color assigned to the document

published	Int			if it is not set to 1, the document is marked as not published

startPublishing	String

stopPublishing	String

pages	Int			number of pages (default 1)

nature	Int			0 = document, 1 = form

formId	Long			the last modified date; format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'

passwordProtected	Integer			indicates whether the document is protected by a password

ocrTemplateId	Long			identifier of the Zonal OCR template to use to process this document

ocrd	Int			indicates if the document has been processed by the zonal OCR: 0 = to process, 1 = processed

barcodeTemplateId	Long			identifier of the barcode template to use to process this document

barcoded	Int			indicates if the document has been processed by the barcode processor: 0 = to process, 1 = processed

Method #18: uploadResource

uploads a new resource attached to the given document. If the resource already exists it is overwritten

Request

Name	Type	Required	Description

sid	String	Y	identifier of the session

docId	Long	Y	the document id

fileVersion	String		the specific file version

suffix	String	Y	suffix specification(it cannot be empty, use 'conversion.pdf' to put the PDF conversion)

content	DataHandler	Y	raw content of the file

Method #19: getRecentDocuments

lists of last modified documents by current user

Request

Name	Type	Required	Description

sid	String	Y	identifier of the session

maxHits	Integer		max number of returned records

Response

Name	Type	Required	Multiple	Description

document	WSDocument	Y	Y

id	Long	Y		unique identifier

fileSize	Long	Y

status	Int			0 = unlocked, 1 = checked out, 2 = locked

exportStatus	Int

version	String

fileVersion	String

date	String	Y		last publication date; format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'

publisher	String

publisherId	Long

creator	String

creatorId	Long

type	String	Y

lockUserId	Long

creation	String			the date when the document was created; format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'

fileName	String	Y

indexed	Int			0 = to index, 1 = indexed, 2 = skip indexing

signed	Int

stamped	Int			1 if the document contains at least one stamp

tags	String		Y	tags applied to the document

folderId	Long	Y		parent folder

templateId	Long			id of the template assigned to the document

customId	String			unique custom identifier

immutable	Int			0 = not immutable, 1 = immutable

digest	String

exportName	String

exportId	Long

docRef	Long			used for aliases, refers to another document

docRefType	String			if used, defines the reference type (use pdf for the PDF Conversion)

deleteUserId	Long			user that has deleted the document

attributes	WSAttribute		Y	array of attributes

name	String	Y		name of the attribute

stringValue	String

intValue	Long

doubleValue	Double

dateValue	String			the date value; format must be 'yyyy-MM-dd'

type	Int	Y		0 = String, 1 = int, 2 = double, 3 = date, 4 = user (intValue represents the user's id), 5 = boolean (intValue must be 0 or 1), 6 = folder (intValue represents the folders's id, 7 = document (intValue represents the document's id), 8 = section

mandatory	Int	Y

hidden	Int	Y

readonly	Int	Y

position	Int

label	String

editor	Int	Y		0 = free, 1 = preset

setId	Long			Id of the attribute set

multiple	Int	Y		0 = single value, 1 = one or more values

parent	String			The reference attribute name, used for multi value attributes

dependsOn	String			Name of another attribute on which the value of this attribute also depends, used for managing linked presets

stringValues	String			Read only. In case of multiple string values, contains the values separated by a comma

validation	String			Optional validation script

initialization	String			Optional initialization script

language	String			language of the document; See specification

summary	String			contains the snippet search text

score	Integer			full text search score

icon	String

comment	String

lastModified	String

rating	Integer

workflowStatus	String			current workflow's status where the document is in

workflowStatusDisplay	String			current workflow's status display informations

color	String			optional color assigned to the document

published	Int			if it is not set to 1, the document is marked as not published

startPublishing	String

stopPublishing	String

pages	Int			number of pages (default 1)

nature	Int			0 = document, 1 = form

formId	Long			the last modified date; format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'

passwordProtected	Integer			indicates whether the document is protected by a password

ocrTemplateId	Long			identifier of the Zonal OCR template to use to process this document

ocrd	Int			indicates if the document has been processed by the zonal OCR: 0 = to process, 1 = processed

barcodeTemplateId	Long			identifier of the barcode template to use to process this document

barcoded	Int			indicates if the document has been processed by the barcode processor: 0 = to process, 1 = processed

Method #20: getDocuments

gets document metadata of a collection of existing documents with the given identifiers; returns an array of WSDocument

Request

Name	Type	Required	Multiple	Description

sid	String	Y		identifier of the session

docIds	Long	Y	Y

Response

Name	Type	Required	Multiple	Description

documents	WSDocument	Y	Y

id	Long	Y		unique identifier

fileSize	Long	Y

status	Int			0 = unlocked, 1 = checked out, 2 = locked

exportStatus	Int

version	String

fileVersion	String

date	String	Y		last publication date; format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'

publisher	String

publisherId	Long

creator	String

creatorId	Long

type	String	Y

lockUserId	Long

creation	String			the date when the document was created; format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'

fileName	String	Y

indexed	Int			0 = to index, 1 = indexed, 2 = skip indexing

signed	Int

stamped	Int			1 if the document contains at least one stamp

tags	String		Y	tags applied to the document

folderId	Long	Y		parent folder

templateId	Long			id of the template assigned to the document

customId	String			unique custom identifier

immutable	Int			0 = not immutable, 1 = immutable

digest	String

exportName	String

exportId	Long

docRef	Long			used for aliases, refers to another document

docRefType	String			if used, defines the reference type (use pdf for the PDF Conversion)

deleteUserId	Long			user that has deleted the document

attributes	WSAttribute		Y	array of attributes

name	String	Y		name of the attribute

stringValue	String

intValue	Long

doubleValue	Double

dateValue	String			the date value; format must be 'yyyy-MM-dd'

type	Int	Y		0 = String, 1 = int, 2 = double, 3 = date, 4 = user (intValue represents the user's id), 5 = boolean (intValue must be 0 or 1), 6 = folder (intValue represents the folders's id, 7 = document (intValue represents the document's id), 8 = section

mandatory	Int	Y

hidden	Int	Y

readonly	Int	Y

position	Int

label	String

editor	Int	Y		0 = free, 1 = preset

setId	Long			Id of the attribute set

multiple	Int	Y		0 = single value, 1 = one or more values

parent	String			The reference attribute name, used for multi value attributes

dependsOn	String			Name of another attribute on which the value of this attribute also depends, used for managing linked presets

stringValues	String			Read only. In case of multiple string values, contains the values separated by a comma

validation	String			Optional validation script

initialization	String			Optional initialization script

language	String			language of the document; See specification

summary	String			contains the snippet search text

score	Integer			full text search score

icon	String

comment	String

lastModified	String

rating	Integer

workflowStatus	String			current workflow's status where the document is in

workflowStatusDisplay	String			current workflow's status display informations

color	String			optional color assigned to the document

published	Int			if it is not set to 1, the document is marked as not published

startPublishing	String

stopPublishing	String

pages	Int			number of pages (default 1)

nature	Int			0 = document, 1 = form

formId	Long			the last modified date; format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'

passwordProtected	Integer			indicates whether the document is protected by a password

ocrTemplateId	Long			identifier of the Zonal OCR template to use to process this document

ocrd	Int			indicates if the document has been processed by the zonal OCR: 0 = to process, 1 = processed

barcodeTemplateId	Long			identifier of the barcode template to use to process this document

barcoded	Int			indicates if the document has been processed by the barcode processor: 0 = to process, 1 = processed

Method #21: checkinDocument

checks in an existing document to create a new version and also updates the metadata

Request

Name	Type	Required	Multiple	Description

sid	String	Y		identifier of the session

docId	Long	Y		the document id

comment	String	Y

filename	String	Y

release	Boolean	Y		true if this is a new release(eg: 2.0) rather than a subversion(eg: 1.1)

docVO	WSDocument	Y		optional, contains the metadata to update during the checkin

id	Long	Y		unique identifier

fileSize	Long	Y

status	Int			0 = unlocked, 1 = checked out, 2 = locked

exportStatus	Int

version	String

fileVersion	String

date	String	Y		last publication date; format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'

publisher	String

publisherId	Long

creator	String

creatorId	Long

type	String	Y

lockUserId	Long

creation	String			the date when the document was created; format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'

fileName	String	Y

indexed	Int			0 = to index, 1 = indexed, 2 = skip indexing

signed	Int

stamped	Int			1 if the document contains at least one stamp

tags	String		Y	tags applied to the document

folderId	Long	Y		parent folder

templateId	Long			id of the template assigned to the document

customId	String			unique custom identifier

immutable	Int			0 = not immutable, 1 = immutable

digest	String

exportName	String

exportId	Long

docRef	Long			used for aliases, refers to another document

docRefType	String			if used, defines the reference type (use pdf for the PDF Conversion)

deleteUserId	Long			user that has deleted the document

attributes	WSAttribute		Y	array of attributes

name	String	Y		name of the attribute

stringValue	String

intValue	Long

doubleValue	Double

dateValue	String			the date value; format must be 'yyyy-MM-dd'

type	Int	Y		0 = String, 1 = int, 2 = double, 3 = date, 4 = user (intValue represents the user's id), 5 = boolean (intValue must be 0 or 1), 6 = folder (intValue represents the folders's id, 7 = document (intValue represents the document's id), 8 = section

mandatory	Int	Y

hidden	Int	Y

readonly	Int	Y

position	Int

label	String

editor	Int	Y		0 = free, 1 = preset

setId	Long			Id of the attribute set

multiple	Int	Y		0 = single value, 1 = one or more values

parent	String			The reference attribute name, used for multi value attributes

dependsOn	String			Name of another attribute on which the value of this attribute also depends, used for managing linked presets

stringValues	String			Read only. In case of multiple string values, contains the values separated by a comma

validation	String			Optional validation script

initialization	String			Optional initialization script

language	String			language of the document; See specification

summary	String			contains the snippet search text

score	Integer			full text search score

icon	String

comment	String

lastModified	String

rating	Integer

workflowStatus	String			current workflow's status where the document is in

workflowStatusDisplay	String			current workflow's status display informations

color	String			optional color assigned to the document

published	Int			if it is not set to 1, the document is marked as not published

startPublishing	String

stopPublishing	String

pages	Int			number of pages (default 1)

nature	Int			0 = document, 1 = form

formId	Long			the last modified date; format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'

passwordProtected	Integer			indicates whether the document is protected by a password

ocrTemplateId	Long			identifier of the Zonal OCR template to use to process this document

ocrd	Int			indicates if the document has been processed by the zonal OCR: 0 = to process, 1 = processed

barcodeTemplateId	Long			identifier of the barcode template to use to process this document

barcoded	Int			indicates if the document has been processed by the barcode processor: 0 = to process, 1 = processed

content	DataHandler	Y

Method #22: createThumbnail

creates the thumbail of the given document; if the thumbnail was already created, nothing will happen

Request

Name	Type	Required	Description

sid	String	Y	identifier of the session

docId	Long	Y	the document id

fileVersion	String		the specific file version

type	String		the thumbnail type(eg: thumbnail, tile, mobile, thumbXXX)

Method #23: createViewTicket

creates a new view ticket to the original document or it's PDF conversion

Request

Name	Type	Required	Description

sid	String	Y	identifier of the session

docId	Long	Y	the document id

suffix	String		can be null or 'conversion.pdf'

expireHours	Integer		expiration time expressed in hours

expireDate	String		exact expiration date expressed in the format yyyy-MM-dd

maxDownloads	Integer		maximum number of downloads allowed

maxViews	Integer		maximum number of views allowed

Response

Name		Type		Required		Multiple		Description

ticket		String		Y

Method #24: unsetPassword

removes the password protection from the document

Request

Name	Type	Required	Description

sid	String	Y	identifier of the session

docId	Long	Y	the document id

currentPassword	String	Y

Method #25: deleteVersion

deletes a version of a document with the given identifiers

Request

Name	Type	Required	Description

sid	String	Y	identifier of the session

docId	Long	Y	the document id

version	String	Y	the version to retrieve, eg: '1.0', '2.3'

Response

Name		Type		Required		Multiple		Description

latestVersion		String		Y

Method #26: getExtractedText

gets the document's text stored in the full-text index

Request

Name	Type	Required	Description

sid	String	Y	identifier of the session

docId	Long	Y	the document id

Response

Name		Type		Required		Multiple		Description

text		String		Y

Method #27: rateDocument

rates the given document

Request

Name	Type	Required	Description

sid	String	Y	identifier of the session

docId	Long	Y	the document id

vote	Int	Y

Response

Name	Type	Required	Description

rating	WSRating	Y

docId	Long	Y	the referenced document

userId	Long	Y	id of the user that rated the document

username	String	Y	name of the user that rated the document

date	Date	Y

vote	Int	Y

Method #28: getDocument

gets the metadata of an existing document with the given identifier; returns the document's representation

Request

Name	Type	Required	Description

sid	String	Y	identifier of the session

docId	Long	Y	Document ID

Response

Name	Type	Required	Multiple	Description

document	WSDocument	Y

id	Long	Y		unique identifier

fileSize	Long	Y

status	Int			0 = unlocked, 1 = checked out, 2 = locked

exportStatus	Int

version	String

fileVersion	String

date	String	Y		last publication date; format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'

publisher	String

publisherId	Long

creator	String

creatorId	Long

type	String	Y

lockUserId	Long

creation	String			the date when the document was created; format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'

fileName	String	Y

indexed	Int			0 = to index, 1 = indexed, 2 = skip indexing

signed	Int

stamped	Int			1 if the document contains at least one stamp

tags	String		Y	tags applied to the document

folderId	Long	Y		parent folder

templateId	Long			id of the template assigned to the document

customId	String			unique custom identifier

immutable	Int			0 = not immutable, 1 = immutable

digest	String

exportName	String

exportId	Long

docRef	Long			used for aliases, refers to another document

docRefType	String			if used, defines the reference type (use pdf for the PDF Conversion)

deleteUserId	Long			user that has deleted the document

attributes	WSAttribute		Y	array of attributes

name	String	Y		name of the attribute

stringValue	String

intValue	Long

doubleValue	Double

dateValue	String			the date value; format must be 'yyyy-MM-dd'

type	Int	Y		0 = String, 1 = int, 2 = double, 3 = date, 4 = user (intValue represents the user's id), 5 = boolean (intValue must be 0 or 1), 6 = folder (intValue represents the folders's id, 7 = document (intValue represents the document's id), 8 = section

mandatory	Int	Y

hidden	Int	Y

readonly	Int	Y

position	Int

label	String

editor	Int	Y		0 = free, 1 = preset

setId	Long			Id of the attribute set

multiple	Int	Y		0 = single value, 1 = one or more values

parent	String			The reference attribute name, used for multi value attributes

dependsOn	String			Name of another attribute on which the value of this attribute also depends, used for managing linked presets

stringValues	String			Read only. In case of multiple string values, contains the values separated by a comma

validation	String			Optional validation script

initialization	String			Optional initialization script

language	String			language of the document; See specification

summary	String			contains the snippet search text

score	Integer			full text search score

icon	String

comment	String

lastModified	String

rating	Integer

workflowStatus	String			current workflow's status where the document is in

workflowStatusDisplay	String			current workflow's status display informations

color	String			optional color assigned to the document

published	Int			if it is not set to 1, the document is marked as not published

startPublishing	String

stopPublishing	String

pages	Int			number of pages (default 1)

nature	Int			0 = document, 1 = form

formId	Long			the last modified date; format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'

passwordProtected	Integer			indicates whether the document is protected by a password

ocrTemplateId	Long			identifier of the Zonal OCR template to use to process this document

ocrd	Int			indicates if the document has been processed by the zonal OCR: 0 = to process, 1 = processed

barcodeTemplateId	Long			identifier of the barcode template to use to process this document

barcoded	Int			indicates if the document has been processed by the barcode processor: 0 = to process, 1 = processed

Method #29: listDocuments

gets the documents in a specific folder

Request

Name	Type	Required	Description

sid	String	Y	identifier of the session

folderId	Long	Y

fileName	String		file name filter

Response

Name	Type	Required	Multiple	Description

document	WSDocument	Y	Y

id	Long	Y		unique identifier

fileSize	Long	Y

status	Int			0 = unlocked, 1 = checked out, 2 = locked

exportStatus	Int

version	String

fileVersion	String

date	String	Y		last publication date; format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'

publisher	String

publisherId	Long

creator	String

creatorId	Long

type	String	Y

lockUserId	Long

creation	String			the date when the document was created; format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'

fileName	String	Y

indexed	Int			0 = to index, 1 = indexed, 2 = skip indexing

signed	Int

stamped	Int			1 if the document contains at least one stamp

tags	String		Y	tags applied to the document

folderId	Long	Y		parent folder

templateId	Long			id of the template assigned to the document

customId	String			unique custom identifier

immutable	Int			0 = not immutable, 1 = immutable

digest	String

exportName	String

exportId	Long

docRef	Long			used for aliases, refers to another document

docRefType	String			if used, defines the reference type (use pdf for the PDF Conversion)

deleteUserId	Long			user that has deleted the document

attributes	WSAttribute		Y	array of attributes

name	String	Y		name of the attribute

stringValue	String

intValue	Long

doubleValue	Double

dateValue	String			the date value; format must be 'yyyy-MM-dd'

type	Int	Y		0 = String, 1 = int, 2 = double, 3 = date, 4 = user (intValue represents the user's id), 5 = boolean (intValue must be 0 or 1), 6 = folder (intValue represents the folders's id, 7 = document (intValue represents the document's id), 8 = section

mandatory	Int	Y

hidden	Int	Y

readonly	Int	Y

position	Int

label	String

editor	Int	Y		0 = free, 1 = preset

setId	Long			Id of the attribute set

multiple	Int	Y		0 = single value, 1 = one or more values

parent	String			The reference attribute name, used for multi value attributes

dependsOn	String			Name of another attribute on which the value of this attribute also depends, used for managing linked presets

stringValues	String			Read only. In case of multiple string values, contains the values separated by a comma

validation	String			Optional validation script

initialization	String			Optional initialization script

language	String			language of the document; See specification

summary	String			contains the snippet search text

score	Integer			full text search score

icon	String

comment	String

lastModified	String

rating	Integer

workflowStatus	String			current workflow's status where the document is in

workflowStatusDisplay	String			current workflow's status display informations

color	String			optional color assigned to the document

published	Int			if it is not set to 1, the document is marked as not published

startPublishing	String

stopPublishing	String

pages	Int			number of pages (default 1)

nature	Int			0 = document, 1 = form

formId	Long			the last modified date; format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'

passwordProtected	Integer			indicates whether the document is protected by a password

ocrTemplateId	Long			identifier of the Zonal OCR template to use to process this document

ocrd	Int			indicates if the document has been processed by the zonal OCR: 0 = to process, 1 = processed

barcodeTemplateId	Long			identifier of the barcode template to use to process this document

barcoded	Int			indicates if the document has been processed by the barcode processor: 0 = to process, 1 = processed

Method #30: createAlias

creates a new document alias for the given document inside a specified folder

Request

Name	Type	Required	Description

sid	String	Y	identifier of the session

docId	Long	Y	the original document's id

folderId	Long	Y

type	String		type of the alias (use 'pdf' to create an alias to the PDF conversion)

Response

Name	Type	Required	Multiple	Description

document	WSDocument	Y

id	Long	Y		unique identifier

fileSize	Long	Y

status	Int			0 = unlocked, 1 = checked out, 2 = locked

exportStatus	Int

version	String

fileVersion	String

date	String	Y		last publication date; format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'

publisher	String

publisherId	Long

creator	String

creatorId	Long

type	String	Y

lockUserId	Long

creation	String			the date when the document was created; format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'

fileName	String	Y

indexed	Int			0 = to index, 1 = indexed, 2 = skip indexing

signed	Int

stamped	Int			1 if the document contains at least one stamp

tags	String		Y	tags applied to the document

folderId	Long	Y		parent folder

templateId	Long			id of the template assigned to the document

customId	String			unique custom identifier

immutable	Int			0 = not immutable, 1 = immutable

digest	String

exportName	String

exportId	Long

docRef	Long			used for aliases, refers to another document

docRefType	String			if used, defines the reference type (use pdf for the PDF Conversion)

deleteUserId	Long			user that has deleted the document

attributes	WSAttribute		Y	array of attributes

name	String	Y		name of the attribute

stringValue	String

intValue	Long

doubleValue	Double

dateValue	String			the date value; format must be 'yyyy-MM-dd'

type	Int	Y		0 = String, 1 = int, 2 = double, 3 = date, 4 = user (intValue represents the user's id), 5 = boolean (intValue must be 0 or 1), 6 = folder (intValue represents the folders's id, 7 = document (intValue represents the document's id), 8 = section

mandatory	Int	Y

hidden	Int	Y

readonly	Int	Y

position	Int

label	String

editor	Int	Y		0 = free, 1 = preset

setId	Long			Id of the attribute set

multiple	Int	Y		0 = single value, 1 = one or more values

parent	String			The reference attribute name, used for multi value attributes

dependsOn	String			Name of another attribute on which the value of this attribute also depends, used for managing linked presets

stringValues	String			Read only. In case of multiple string values, contains the values separated by a comma

validation	String			Optional validation script

initialization	String			Optional initialization script

language	String			language of the document; See specification

summary	String			contains the snippet search text

score	Integer			full text search score

icon	String

comment	String

lastModified	String

rating	Integer

workflowStatus	String			current workflow's status where the document is in

workflowStatusDisplay	String			current workflow's status display informations

color	String			optional color assigned to the document

published	Int			if it is not set to 1, the document is marked as not published

startPublishing	String

stopPublishing	String

pages	Int			number of pages (default 1)

nature	Int			0 = document, 1 = form

formId	Long			the last modified date; format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'

passwordProtected	Integer			indicates whether the document is protected by a password

ocrTemplateId	Long			identifier of the Zonal OCR template to use to process this document

ocrd	Int			indicates if the document has been processed by the zonal OCR: 0 = to process, 1 = processed

barcodeTemplateId	Long			identifier of the barcode template to use to process this document

barcoded	Int			indicates if the document has been processed by the barcode processor: 0 = to process, 1 = processed

Method #31: setPassword

protects with a password the given document

Request

Name	Type	Required	Description

sid	String	Y	identifier of the session

docId	Long	Y	the document id

password	String	Y

Method #32: promoteVersion

promotes an old version to the current default one

Request

Name	Type	Required	Description

sid	String	Y	identifier of the session

docId	Long	Y	the document id

version	String	Y

Method #33: getAccessControlList

retrieves the access control list

Request

Name	Type	Required	Description

sid	String	Y	identifier of the session

docId	Long	Y

Response

Name	Type	Required	Multiple	Description

	WSAccessControlEntry	Y	Y

groupId	Long	Y		unique identifier of a group

userId	Long	Y		unique identifier of a user

read	Int	Y		permission to read

preview	Int	Y		permission to preview

write	Int	Y		permission to edit

download	Int	Y		permission to download

add	Int	Y		permission to add child elements

security	Int	Y		permission to change security policies

delete	Int	Y		permission to delete

rename	Int	Y		permission to rename

immutable	Int	Y		permission to mark a document as immutable

iimport	Int	Y		permission to import

export	Int	Y		permission to export

sign	Int	Y		permission to digitally sign

archive	Int	Y		permission to archive

workflow	Int	Y		permission to handle the workflow

calendar	Int	Y		permission to handle calendar events

subscription	Int	Y		permission to handle events subscription

password	Int	Y		permission to put a password

print	Int	Y		permission to print

move	Int	Y		permission to move

email	Int	Y		permission to send emails

automation	Int	Y		permission to handle the automation

store	Int	Y		permission to handle the store

readingreq	Int	Y		permission to send reading requests

customid	Int	Y		permission to edit the Custom ID

Method #34: createDownloadTicket

creates a new download ticket to the original document or it's PDF conversion

Request

Name	Type	Required	Description

sid	String	Y	identifier of the session

docId	Long	Y	the document id

suffix	String		can be null or 'conversion.pdf'

expireHours	Integer		expiration time expressed in hours

expireDate	String		exact expiration date expressed in the format yyyy-MM-dd

maxDownloads	Integer		maximum number of downloads allowed

Response

Name		Type		Required		Multiple		Description

ticket		String		Y

Method #35: getDocumentByCustomId

gets document metadata of an existing document with the given custom identifier

Request

Name	Type	Required	Description

sid	String	Y	identifier of the session

customId	String	Y

Response

Name	Type	Required	Multiple	Description

document	WSDocument	Y

id	Long	Y		unique identifier

fileSize	Long	Y

status	Int			0 = unlocked, 1 = checked out, 2 = locked

exportStatus	Int

version	String

fileVersion	String

date	String	Y		last publication date; format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'

publisher	String

publisherId	Long

creator	String

creatorId	Long

type	String	Y

lockUserId	Long

creation	String			the date when the document was created; format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'

fileName	String	Y

indexed	Int			0 = to index, 1 = indexed, 2 = skip indexing

signed	Int

stamped	Int			1 if the document contains at least one stamp

tags	String		Y	tags applied to the document

folderId	Long	Y		parent folder

templateId	Long			id of the template assigned to the document

customId	String			unique custom identifier

immutable	Int			0 = not immutable, 1 = immutable

digest	String

exportName	String

exportId	Long

docRef	Long			used for aliases, refers to another document

docRefType	String			if used, defines the reference type (use pdf for the PDF Conversion)

deleteUserId	Long			user that has deleted the document

attributes	WSAttribute		Y	array of attributes

name	String	Y		name of the attribute

stringValue	String

intValue	Long

doubleValue	Double

dateValue	String			the date value; format must be 'yyyy-MM-dd'

type	Int	Y		0 = String, 1 = int, 2 = double, 3 = date, 4 = user (intValue represents the user's id), 5 = boolean (intValue must be 0 or 1), 6 = folder (intValue represents the folders's id, 7 = document (intValue represents the document's id), 8 = section

mandatory	Int	Y

hidden	Int	Y

readonly	Int	Y

position	Int

label	String

editor	Int	Y		0 = free, 1 = preset

setId	Long			Id of the attribute set

multiple	Int	Y		0 = single value, 1 = one or more values

parent	String			The reference attribute name, used for multi value attributes

dependsOn	String			Name of another attribute on which the value of this attribute also depends, used for managing linked presets

stringValues	String			Read only. In case of multiple string values, contains the values separated by a comma

validation	String			Optional validation script

initialization	String			Optional initialization script

language	String			language of the document; See specification

summary	String			contains the snippet search text

score	Integer			full text search score

icon	String

comment	String

lastModified	String

rating	Integer

workflowStatus	String			current workflow's status where the document is in

workflowStatusDisplay	String			current workflow's status display informations

color	String			optional color assigned to the document

published	Int			if it is not set to 1, the document is marked as not published

startPublishing	String

stopPublishing	String

pages	Int			number of pages (default 1)

nature	Int			0 = document, 1 = form

formId	Long			the last modified date; format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'

passwordProtected	Integer			indicates whether the document is protected by a password

ocrTemplateId	Long			identifier of the Zonal OCR template to use to process this document

ocrd	Int			indicates if the document has been processed by the zonal OCR: 0 = to process, 1 = processed

barcodeTemplateId	Long			identifier of the barcode template to use to process this document

barcoded	Int			indicates if the document has been processed by the barcode processor: 0 = to process, 1 = processed

Method #36: setAccessControlList

sets the Access Control List

Request

Name	Type	Required	Multiple	Description

sid	String	Y		identifier of the session

docId	Long	Y

acl	WSAccessControlEntry	Y	Y	the complete Access Control List

groupId	Long	Y		unique identifier of a group

userId	Long	Y		unique identifier of a user

read	Int	Y		permission to read

preview	Int	Y		permission to preview

write	Int	Y		permission to edit

download	Int	Y		permission to download

add	Int	Y		permission to add child elements

security	Int	Y		permission to change security policies

delete	Int	Y		permission to delete

rename	Int	Y		permission to rename

immutable	Int	Y		permission to mark a document as immutable

iimport	Int	Y		permission to import

export	Int	Y		permission to export

sign	Int	Y		permission to digitally sign

archive	Int	Y		permission to archive

workflow	Int	Y		permission to handle the workflow

calendar	Int	Y		permission to handle calendar events

subscription	Int	Y		permission to handle events subscription

password	Int	Y		permission to put a password

print	Int	Y		permission to print

move	Int	Y		permission to move

email	Int	Y		permission to send emails

automation	Int	Y		permission to handle the automation

store	Int	Y		permission to handle the store

readingreq	Int	Y		permission to send reading requests

customid	Int	Y		permission to edit the Custom ID

Method #37: checkout

checks out an existing document with the given identifier

Request

Name	Type	Required	Description

sid	String	Y	identifier of the session

docId	Long	Y	the document id

Method #38: checkin

checks in an existing document to create a new version

Request

Name	Type	Required	Description

sid	String	Y	identifier of the session

docId	Long	Y	the document id

comment	String	Y

filename	String	Y

release	Boolean	Y	true if this is a new release(eg: 2.0) rather than a subversion(eg: 1.1)

content	DataHandler	Y

Method #39: deleteNote

deletes a note, only the author or the administrator can delete the note

Request

Name	Type	Required	Description

sid	String	Y	identifier of the session

noteId	Long	Y

Method #40: createPdf

creates the PDF conversion of the given document; if the conversion was already created, nothing will happen

Request

Name	Type	Required	Description

sid	String	Y	identifier of the session

docId	Long	Y	the document id

fileVersion	String		the specific file version

Method #41: isRead

tests if a document is readable

Request

Name	Type	Required	Description

sid	String	Y	identifier of the session

docId	Long	Y

Response

Name		Type		Required		Multiple		Description

		Boolean		Y

Method #42: isDownload

tests if a folder is writable

Request

Name	Type	Required	Description

sid	String	Y	identifier of the session

docId	Long	Y

Response

Name		Type		Required		Multiple		Description

		Boolean		Y

Method #43: saveNote

adds/modifies a note for the given document

Request

Name	Type	Required	Description

sid	String	Y	identifier of the session

docId	Long	Y	the document id

note	WSNote	Y

id	Long	Y	unique identifier

docId	Long	Y	the referenced document

fileVersion	String	Y	the specific file version

userId	Long	Y	id of the user that created the note

username	String	Y	name of the user that created the note

fileName	String	Y	name of the document's file

date	Date	Y	when the note has been creates

message	String	Y	the text of the note

page	Int	Y	in which page the note was placed, 0 stays for no page

opacity	Int	Y	the opacity

color	String	Y	the background color

left	Double	Y	left position(0..1)

top	Double	Y	top position(0..1)

width	Double	Y	width(0..1)

height	Double	Y	height(0..1)

lineOpacity	Int	Y	the opacity of the line

lineColor	String	Y	the color of the line

rotation	Double	Y	rotation(-90, +90)

lineWidth	Int	Y	the width of the line

shape	String	Y	shape (square, circle, line, arrow, thickarrow, comment, label)

Response

Name	Type	Required	Description

note	WSNote	Y

id	Long	Y	unique identifier

docId	Long	Y	the referenced document

fileVersion	String	Y	the specific file version

userId	Long	Y	id of the user that created the note

username	String	Y	name of the user that created the note

fileName	String	Y	name of the document's file

date	Date	Y	when the note has been creates

message	String	Y	the text of the note

page	Int	Y	in which page the note was placed, 0 stays for no page

opacity	Int	Y	the opacity

color	String	Y	the background color

left	Double	Y	left position(0..1)

top	Double	Y	top position(0..1)

width	Double	Y	width(0..1)

height	Double	Y	height(0..1)

lineOpacity	Int	Y	the opacity of the line

lineColor	String	Y	the color of the line

rotation	Double	Y	rotation(-90, +90)

lineWidth	Int	Y	the width of the line

shape	String	Y	shape (square, circle, line, arrow, thickarrow, comment, label)

Method #44: unprotect

unprotects a document that is password protected. If the given password is right, the document remains unprotected for the duration of the session.

Request

Name	Type	Required	Description

sid	String	Y	identifier of the session

docId	Long	Y	the document id

password	String	Y

Response

Name		Type		Required		Multiple		Description

unprotect		Boolean		Y

Method #45: isGranted

tests if the current user has a specific permission on a document

Request

Name	Type	Required	Description

sid	String	Y	identifier of the session

docId	Long	Y

permission	String	Y	the permissions' integer representation

Response

Name		Type		Required		Multiple		Description

		Boolean		Y

Method #46: upload

creates a new document or updates an existing one; returns the newly created document's ID

Request

Name	Type	Required	Description

sid	String	Y	identifier of the session

docId	Long	Y	id of the document to update

folderId	Long		the folder's id, used in case of creation

release	Boolean	Y	true if this is a major release(eg: 2.0) rather than a minor release(eg: 1.12)

filename	String		used in case of creation

language	String	Y

content	DataHandler	Y	raw content of the file

Response

Name		Type		Required		Multiple		Description

docId		Long		Y

Method #47: isWrite

tests if a folder is writable

Request

Name	Type	Required	Description

sid	String	Y	identifier of the session

docId	Long	Y

Response

Name		Type		Required		Multiple		Description

		Boolean		Y

Method #48: getNotes

gets the notes for the given document

Request

Name	Type	Required	Description

sid	String	Y	identifier of the session

docId	Long	Y	the document id

Response

Name	Type	Required	Multiple	Description

note	WSNote	Y	Y

id	Long	Y		unique identifier

docId	Long	Y		the referenced document

fileVersion	String	Y		the specific file version

userId	Long	Y		id of the user that created the note

username	String	Y		name of the user that created the note

fileName	String	Y		name of the document's file

date	Date	Y		when the note has been creates

message	String	Y		the text of the note

page	Int	Y		in which page the note was placed, 0 stays for no page

opacity	Int	Y		the opacity

color	String	Y		the background color

left	Double	Y		left position(0..1)

top	Double	Y		top position(0..1)

width	Double	Y		width(0..1)

height	Double	Y		height(0..1)

lineOpacity	Int	Y		the opacity of the line

lineColor	String	Y		the color of the line

rotation	Double	Y		rotation(-90, +90)

lineWidth	Int	Y		the width of the line

shape	String	Y		shape (square, circle, line, arrow, thickarrow, comment, label)

Method #49: getRatings

gets all the ratings of the given document

Request

Name	Type	Required	Description

sid	String	Y	identifier of the session

docId	Long	Y	the document id

Response

Name	Type	Required	Multiple	Description

rating	WSRating	Y	Y

docId	Long	Y		the referenced document

userId	Long	Y		id of the user that rated the document

username	String	Y		name of the user that rated the document

date	Date	Y

vote	Int	Y

Method #50: restore

restores a deleted document

Request

Name	Type	Required	Description

sid	String	Y	identifier of the session

docId	Long	Y	the document id

folderId	Long	Y	id of the folder in which the document must be restored

Method #51: getLinks

gets all the links of a specific document; returns an array of links

Request

Name	Type	Required	Description

sid	String	Y	identifier of the session

docId	Long	Y	the document id

Response

Name	Type	Required	Multiple	Description

link	WSLink	Y	Y

id	Long	Y		unique identifier

type	String			just a string indicating the meaning of the link

doc1	Long	Y		itentifier of document 1

doc2	Long	Y		itentifier of document 2

Method #52: sendEmail

sends a set of documents as mail attachments

Request

Name	Type	Required	Multiple	Description

sid	String	Y		identifier of the session

docIds	Long	Y	Y

recipients	String	Y		comma separated list of email addresses

subject	String	Y

message	String	Y

Method #53: addNote

adds a new note for the given document

Request

Name	Type	Required	Description

sid	String	Y	identifier of the session

docId	Long	Y	the document id

note	String	Y

Response

Name	Type	Required	Description

note	WSNote	Y

id	Long	Y	unique identifier

docId	Long	Y	the referenced document

fileVersion	String	Y	the specific file version

userId	Long	Y	id of the user that created the note

username	String	Y	name of the user that created the note

fileName	String	Y	name of the document's file

date	Date	Y	when the note has been creates

message	String	Y	the text of the note

page	Int	Y	in which page the note was placed, 0 stays for no page

opacity	Int	Y	the opacity

color	String	Y	the background color

left	Double	Y	left position(0..1)

top	Double	Y	top position(0..1)

width	Double	Y	width(0..1)

height	Double	Y	height(0..1)

lineOpacity	Int	Y	the opacity of the line

lineColor	String	Y	the color of the line

rotation	Double	Y	rotation(-90, +90)

lineWidth	Int	Y	the width of the line

shape	String	Y	shape (square, circle, line, arrow, thickarrow, comment, label)

Method #54: deleteLink

removes an existing link

Request

Name	Type	Required	Description

sid	String	Y	identifier of the session

id	Long	Y	identifier of the link

Method #55: reindex

re-indexes(or indexes from scratch) a document

Request

Name	Type	Required	Description

sid	String	Y	identifier of the session

docId	Long	Y	the document id

content	String		the content to be used (if null the file is parsed)

Index	Method	Request(s)	Response	Description

1	lock	sid docId		locks an existing document with the given identifier

2	update	sid document		updates an existing document with the value object containing the document's metadata

3	list	sid folderId fileName sort page max	document	gets the documents in a specific folder

4	getResource	sid docId fileVersion suffix		gets the content of a resource associated to the given document; returns the raw content of the file

5	unlock	sid docId		unlocks an existing document with the given identifier

6	delete	sid docId		deletes an existing document with the given identifier

7	copy	sid docId folderId links notes security	document	copies a document into a folder

8	create	sid document content	document	creates a new document; the user can completely customize the document through a value object containing the document's metadata; returns the newly created document.

9	getContent	sid docId		gets the content of an existing document with the given identifier; returns the raw content of the file

10	rename	sid docId name		renames the title of an existing document with the given identifier

11	move	sid docId folderId		moves an existing document with the given identifier

12	link	sid doc1 doc2 type	link	creates a new link between two documents

13	getVersion	sid docId version	version	gets a version of a document; returns the version

14	getAliases	sid docId	aliases	gets the aliases of the given document; returns an array of WSDocument that are aliases

15	getVersionContent	sid docId version		gets the content of a specific version of a document; returns the raw content of the file

16	replaceFile	sid docId fileVersion comment content		replaces the file associated to a given version

17	getVersions	sid docId	version	gets the versions' history of a document; returns an array of versions

18	uploadResource	sid docId fileVersion suffix content		uploads a new resource attached to the given document. If the resource already exists it is overwritten

19	getRecentDocuments	sid maxHits	document	lists of last modified documents by current user

20	getDocuments	sid docIds	documents	gets document metadata of a collection of existing documents with the given identifiers; returns an array of WSDocument

21	checkinDocument	sid docId comment filename release docVO content		checks in an existing document to create a new version and also updates the metadata

22	createThumbnail	sid docId fileVersion type		creates the thumbail of the given document; if the thumbnail was already created, nothing will happen

23	createViewTicket	sid docId suffix expireHours expireDate maxDownloads maxViews	ticket	creates a new view ticket to the original document or it's PDF conversion

24	unsetPassword	sid docId currentPassword		removes the password protection from the document

25	deleteVersion	sid docId version	latestVersion	deletes a version of a document with the given identifiers

26	getExtractedText	sid docId	text	gets the document's text stored in the full-text index

27	rateDocument	sid docId vote	rating	rates the given document

28	getDocument	sid docId	document	gets the metadata of an existing document with the given identifier; returns the document's representation

29	listDocuments	sid folderId fileName	document	gets the documents in a specific folder

30	createAlias	sid docId folderId type	document	creates a new document alias for the given document inside a specified folder

31	setPassword	sid docId password		protects with a password the given document

32	promoteVersion	sid docId version		promotes an old version to the current default one

33	getAccessControlList	sid docId		retrieves the access control list

34	createDownloadTicket	sid docId suffix expireHours expireDate maxDownloads	ticket	creates a new download ticket to the original document or it's PDF conversion

35	getDocumentByCustomId	sid customId	document	gets document metadata of an existing document with the given custom identifier

36	setAccessControlList	sid docId acl		sets the Access Control List

37	checkout	sid docId		checks out an existing document with the given identifier

38	checkin	sid docId comment filename release content		checks in an existing document to create a new version

39	deleteNote	sid noteId		deletes a note, only the author or the administrator can delete the note

40	createPdf	sid docId fileVersion		creates the PDF conversion of the given document; if the conversion was already created, nothing will happen

41	isRead	sid docId		tests if a document is readable

42	isDownload	sid docId		tests if a folder is writable

43	saveNote	sid docId note	note	adds/modifies a note for the given document

44	unprotect	sid docId password	unprotect	unprotects a document that is password protected. If the given password is right, the document remains unprotected for the duration of the session.

45	isGranted	sid docId permission		tests if the current user has a specific permission on a document

46	upload	sid docId folderId release filename language content	docId	creates a new document or updates an existing one; returns the newly created document's ID

47	isWrite	sid docId		tests if a folder is writable

48	getNotes	sid docId	note	gets the notes for the given document

49	getRatings	sid docId	rating	gets all the ratings of the given document

50	restore	sid docId folderId		restores a deleted document

51	getLinks	sid docId	link	gets all the links of a specific document; returns an array of links

52	sendEmail	sid docIds recipients subject message		sends a set of documents as mail attachments

53	addNote	sid docId note	note	adds a new note for the given document

54	deleteLink	sid id		removes an existing link

55	reindex	sid docId content		re-indexes(or indexes from scratch) a document

Webservice: Document

documents handling and CRUD operations

Method #1: lock

Request

Method #2: update

Request

Method #3: list

Request

Response

Method #4: getResource

Request

Response

Method #5: unlock

Request

Method #6: delete

Request

Method #7: copy

Request

Response

Method #8: create

Request

Response

Method #9: getContent

Request

Response

Method #10: rename

Request

Method #11: move

Request

Method #12: link

Request

Response

Method #13: getVersion

Request

Response

Method #14: getAliases

Request

Response

Method #15: getVersionContent

Request

Response

Method #16: replaceFile

Request

Method #17: getVersions

Request

Response

Method #18: uploadResource

Request

Method #19: getRecentDocuments

Request

Response

Method #20: getDocuments

Request

Response

Method #21: checkinDocument

Request

Method #22: createThumbnail

Request

Method #23: createViewTicket

Request

Response

Method #24: unsetPassword

Request

Method #25: deleteVersion

Request

Response

Method #26: getExtractedText

Request

Response

Method #27: rateDocument

Request

Response

Method #28: getDocument

Request

Response

Method #29: listDocuments

Request

Response

Method #30: createAlias

Request