Webservice: Document

---

Method #1: lock

locks an existing document with the given identifier

Request

Name		Type		Required		Multiple		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)
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: getResource

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

Request

Name		Type		Required		Multiple		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 #4: delete

deletes an existing document with the given identifier

Request

Name		Type		Required		Multiple		Description
sid		String		Y				identifier of the session
docId		Long		Y				Document ID

---

Method #5: copy

copies a document into a folder

Request

Name		Type		Required		Multiple		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)
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 #6: 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)
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)
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 #7: getContent

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

Request

Name		Type		Required		Multiple		Description
sid		String		Y				identifier of the session
docId		Long		Y				Document ID

Response

Name		Type		Required		Multiple		Description
		DataHandler		Y

---

Method #8: unlock

unlocks an existing document with the given identifier

Request

Name		Type		Required		Multiple		Description
sid		String		Y				identifier of the session
docId		Long		Y				identifier of the document

---

Method #9: rename

renames the title of an existing document with the given identifier

Request

Name		Type		Required		Multiple		Description
sid		String		Y				identifier of the session
docId		Long		Y				Document ID
name		String		Y

---

Method #10: link

creates a new link between two documents

Request

Name		Type		Required		Multiple		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		Multiple		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 #11: move

moves an existing document with the given identifier

Request

Name		Type		Required		Multiple		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: getVersion

gets a version of a document; returns the version

Request

Name		Type		Required		Multiple		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)
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 #13: getDocumentByCustomId

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

Request

Name		Type		Required		Multiple		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)
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: createDownloadTicket

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

Request

Name		Type		Required		Multiple		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 #15: getAccessControlList

retrieves the access control list

Request

Name		Type		Required		Multiple		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
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
storage		Int		Y				permission to handle the storage
readingreq		Int		Y				permission to send reading requests