org.bonitasoft.engine.core.document.api

Interface DocumentService

All Known Implementing Classes:

DocumentServiceImpl

public interface DocumentService

Since:

6.0

Author:

Nicolas Chabanoles, Matthieu Chaffotte, Baptiste Mesta

Field Summary

Fields

Modifier and Type	Field and Description
static String	DOCUMENT
static String	DOCUMENTMAPPING
static String	SUPERVISED_BY

Method Summary

Modifier and Type	Method and Description
void	archive(SDocumentMapping documentMapping, long archiveDate) archive the specific document mapping in the archive date
SMappedDocument	attachDocumentToProcessInstance(SDocument document, long processInstanceId, String name, String description) Save a document
SMappedDocument	attachDocumentToProcessInstance(SDocument document, long processInstanceId, String name, String description, int index) Save a document
void	deleteArchivedDocuments(List<Long> processInstanceId) delete archived documents mapping and documents links to a set of processes
void	deleteContentOfArchivedDocument(long archivedDocumentId) Remove the content of an archived document while keeping it's metadata.
void	deleteDocument(SLightDocument document)
void	deleteDocumentsFromProcessInstance(Long processInstanceId) Delete documents from a specified process instance
String	generateDocumentURL(String name, String contentStorageId)
SAMappedDocument	getArchivedDocument(long archivedProcessDocumentId) Retrieve an archived document
SAMappedDocument	getArchivedVersionOfProcessDocument(long documentId) Get the archived version corresponding to a document
SLightDocument	getDocument(long documentId) Get document by its id
byte[]	getDocumentContent(String documentId) Get document content by document id
List<SMappedDocument>	getDocumentList(String documentName, long processInstanceId, int fromIndex, int numberOfResult) Get a list of document.
List<SMappedDocument>	getDocumentList(String documentName, long processInstanceId, long time) Get a list of document at a given time.
List<SMappedDocument>	getDocumentsOfProcessInstance(long processInstanceId, int fromIndex, int numberPerPage, String field, OrderByType order) Get a list of documents for specific process instance, this can be used for pagination
SMappedDocument	getMappedDocument(long mappingId) Get document with mapping by its mapping id
SMappedDocument	getMappedDocument(long processInstanceId, String documentName) Get document with mapping by its name in the specific process instance
SMappedDocument	getMappedDocument(long processInstanceId, String documentName, long time) Get name specified document archived in a certain time in the process instance
long	getNumberOfArchivedDocuments(QueryOptions queryOptions) Get total number of archived documents according to the query criteria
long	getNumberOfArchivedDocumentsSupervisedBy(long userId, QueryOptions queryOptions) Get total number of archived documents for the specific supervisor
long	getNumberOfDocuments(QueryOptions queryOptions) Get total number of document according to the query criteria
long	getNumberOfDocumentsOfProcessInstance(long processInstanceId) Get total number of documents in the specific process instance
long	getNumberOfDocumentsSupervisedBy(long userId, QueryOptions queryOptions) Get total number of documents for the specific supervisor
void	removeCurrentVersion(long processInstanceId, String documentName) Remove the document with the specified process instance and name
void	removeCurrentVersion(SMappedDocument document) Remove this document.
void	removeDocument(SMappedDocument mappedDocument)
List<SAMappedDocument>	searchArchivedDocuments(QueryOptions queryOptions) Search all archived documents according to the query criteria.
List<SAMappedDocument>	searchArchivedDocumentsSupervisedBy(long userId, QueryOptions queryOptions) Search all archived documents for the specific supervisor
List<SMappedDocument>	searchDocuments(QueryOptions queryOptions) Search all documents according to the query criteria
List<SMappedDocument>	searchDocumentsSupervisedBy(long userId, QueryOptions queryOptions) Search all documents for the specific supervisor
SMappedDocument	updateDocument(long documentId, SDocument sDocument) update the document having the documentId with this new version
SMappedDocument	updateDocument(SDocumentMapping documentToUpdate, SDocument sDocument)
void	updateDocumentIndex(SMappedDocument mappedDocument, int index) update the index of a document inside the list
void	updateDocumentOfList(SMappedDocument mappedDocument, SDocument document, int index)

Field Detail

DOCUMENT

static final String DOCUMENT

See Also:

Constant Field Values

DOCUMENTMAPPING

static final String DOCUMENTMAPPING

See Also:

Constant Field Values

SUPERVISED_BY

static final String SUPERVISED_BY

See Also:

Constant Field Values

Method Detail

attachDocumentToProcessInstance

SMappedDocument attachDocumentToProcessInstance(SDocument document,
                                                long processInstanceId,
                                                String name,
                                                String description)
                                         throws org.bonitasoft.engine.commons.exceptions.SObjectCreationException

Save a document

Parameters:

document - the document to store

processInstanceId - the process instance id to attach the document to

name -

description -

Returns:

The document image from database

Throws:

org.bonitasoft.engine.commons.exceptions.SObjectCreationException - when the storage has failed

attachDocumentToProcessInstance

SMappedDocument attachDocumentToProcessInstance(SDocument document,
                                                long processInstanceId,
                                                String name,
                                                String description,
                                                int index)
                                         throws org.bonitasoft.engine.commons.exceptions.SObjectCreationException,
                                                org.bonitasoft.engine.commons.exceptions.SObjectAlreadyExistsException

Save a document

Parameters:

document - the document to store

processInstanceId - the process instance id to attach the document to

name -

description -

index - the index in the list of document

Returns:

The document image from database

Throws:

org.bonitasoft.engine.commons.exceptions.SObjectCreationException - when the storage has failed

org.bonitasoft.engine.commons.exceptions.SObjectAlreadyExistsException

removeCurrentVersion

void removeCurrentVersion(SMappedDocument document)
                   throws org.bonitasoft.engine.commons.exceptions.SObjectModificationException

Remove this document.

this archive and delete mapping on the process, i.e. the content of the document itself will be kept in database, use deleteContentOfArchivedDocument(long) to delete the content

Parameters:

document - the document mapping to remove

Throws:

org.bonitasoft.engine.commons.exceptions.SObjectModificationException

removeCurrentVersion

void removeCurrentVersion(long processInstanceId,
                          String documentName)
                   throws org.bonitasoft.engine.commons.exceptions.SObjectNotFoundException,
                          org.bonitasoft.engine.commons.exceptions.SObjectModificationException

Remove the document with the specified process instance and name

this archive and delete mapping on the process, i.e. the content of the document itself will be kept in database, use deleteContentOfArchivedDocument(long) to delete the content

Parameters:

processInstanceId - id of the process having the document

documentName - name of the document

Throws:

org.bonitasoft.engine.commons.exceptions.SObjectNotFoundException

org.bonitasoft.engine.commons.exceptions.SObjectModificationException

getDocumentContent

byte[] getDocumentContent(String documentId)
                   throws org.bonitasoft.engine.commons.exceptions.SObjectNotFoundException

Get document content by document id

Parameters:

documentId - identifier of the document

Returns:

document content

Throws:

org.bonitasoft.engine.commons.exceptions.SObjectNotFoundException

getMappedDocument

SMappedDocument getMappedDocument(long mappingId)
                           throws org.bonitasoft.engine.commons.exceptions.SObjectNotFoundException,
                                  SBonitaReadException

Get document with mapping by its mapping id

Parameters:

mappingId - identifier of the mapping of the document

Returns:

an SDocumentMapping object with id corresponding to the parameter

Throws:

org.bonitasoft.engine.commons.exceptions.SObjectNotFoundException

SBonitaReadException

getDocument

SLightDocument getDocument(long documentId)
                    throws org.bonitasoft.engine.commons.exceptions.SObjectNotFoundException,
                           SBonitaReadException

Get document by its id

Parameters:

documentId - identifier of document

Returns:

an SDocumentMapping object with id corresponding to the parameter

Throws:

org.bonitasoft.engine.commons.exceptions.SObjectNotFoundException

SBonitaReadException

getMappedDocument

SMappedDocument getMappedDocument(long processInstanceId,
                                  String documentName)
                           throws org.bonitasoft.engine.commons.exceptions.SObjectNotFoundException,
                                  SBonitaReadException

Get document with mapping by its name in the specific process instance

Parameters:

processInstanceId - identifier of process instance

documentName - name of process document

Returns:

the corresponding SDocumentMapping object

Throws:

org.bonitasoft.engine.commons.exceptions.SObjectNotFoundException

SBonitaReadException

getDocumentsOfProcessInstance

List<SMappedDocument> getDocumentsOfProcessInstance(long processInstanceId,
                                                    int fromIndex,
                                                    int numberPerPage,
                                                    String field,
                                                    OrderByType order)
                                             throws SBonitaReadException

Get a list of documents for specific process instance, this can be used for pagination

Parameters:

processInstanceId - identifier of process instance

fromIndex - Index of the record to be retrieved from. First record has index 0

numberPerPage - Number of result we want to get. Maximum number of result returned

order -

field -

Returns:

a list of SDocumentMapping objects

Throws:

SBonitaReadException

getNumberOfDocumentsOfProcessInstance

long getNumberOfDocumentsOfProcessInstance(long processInstanceId)
                                    throws SBonitaReadException

Get total number of documents in the specific process instance

Parameters:

processInstanceId - identifier of process instance

Returns:

number of documents in the process instance

Throws:

SBonitaReadException

getMappedDocument

SMappedDocument getMappedDocument(long processInstanceId,
                                  String documentName,
                                  long time)
                           throws org.bonitasoft.engine.commons.exceptions.SObjectNotFoundException,
                                  SBonitaReadException

Get name specified document archived in a certain time in the process instance

Parameters:

processInstanceId - identifier of process instance

documentName - name of document

time - the archived time of document

Returns:

an SDocumentMapping object archived in the specific time or not archived

Throws:

org.bonitasoft.engine.commons.exceptions.SObjectNotFoundException

SBonitaReadException

getNumberOfDocuments

long getNumberOfDocuments(QueryOptions queryOptions)
                   throws SBonitaReadException

Get total number of document according to the query criteria

Parameters:

queryOptions - a QueryOptions object containing some query conditions

Returns:

number of document satisfied to the query criteria

Throws:

SBonitaReadException

searchDocuments

List<SMappedDocument> searchDocuments(QueryOptions queryOptions)
                               throws SBonitaReadException

Search all documents according to the query criteria

Parameters:

queryOptions - a QueryOptions object containing some query conditions

Returns:

a list of SDocumentMapping objects

Throws:

SBonitaReadException

getNumberOfDocumentsSupervisedBy

long getNumberOfDocumentsSupervisedBy(long userId,
                                      QueryOptions queryOptions)
                               throws SBonitaReadException

Get total number of documents for the specific supervisor

Parameters:

userId - identifier of supervisor user

queryOptions - a QueryOptions object containing some query conditions

Returns:

number of documents for the specific supervisor

Throws:

SBonitaReadException

searchDocumentsSupervisedBy

List<SMappedDocument> searchDocumentsSupervisedBy(long userId,
                                                  QueryOptions queryOptions)
                                           throws SBonitaReadException

Search all documents for the specific supervisor

Parameters:

userId - identifier of supervisor user

queryOptions - a QueryOptions object containing some query conditions

Returns:

a list of SDocumentMapping objects

Throws:

SBonitaReadException

getNumberOfArchivedDocuments

long getNumberOfArchivedDocuments(QueryOptions queryOptions)
                           throws SBonitaReadException

Get total number of archived documents according to the query criteria

Parameters:

queryOptions - a QueryOptions object containing some query conditions

Returns:

number of archived documents

Throws:

SBonitaReadException

removeDocument

void removeDocument(SMappedDocument mappedDocument)
             throws org.bonitasoft.engine.commons.exceptions.SObjectModificationException

Throws:

org.bonitasoft.engine.commons.exceptions.SObjectModificationException

searchArchivedDocuments

List<SAMappedDocument> searchArchivedDocuments(QueryOptions queryOptions)
                                        throws SBonitaReadException

Search all archived documents according to the query criteria.

Parameters:

queryOptions - a QueryOptions object containing some query conditions

Returns:

a list of SADocumentMapping objects

Throws:

SBonitaReadException

getNumberOfArchivedDocumentsSupervisedBy

long getNumberOfArchivedDocumentsSupervisedBy(long userId,
                                              QueryOptions queryOptions)
                                       throws SBonitaReadException

Get total number of archived documents for the specific supervisor

Parameters:

userId - identifier of supervisor user

queryOptions - a QueryOptions object containing some query conditions

Returns:

number of archived documents for the specific supervisor

Throws:

SBonitaReadException

searchArchivedDocumentsSupervisedBy

List<SAMappedDocument> searchArchivedDocumentsSupervisedBy(long userId,
                                                           QueryOptions queryOptions)
                                                    throws SBonitaReadException

Search all archived documents for the specific supervisor

Parameters:

userId - identifier of supervisor user

queryOptions - a QueryOptions object containing some query conditions

Returns:

a list of SADocumentMapping objects

Throws:

SBonitaReadException

getArchivedVersionOfProcessDocument

SAMappedDocument getArchivedVersionOfProcessDocument(long documentId)
                                              throws org.bonitasoft.engine.commons.exceptions.SObjectNotFoundException

Get the archived version corresponding to a document

Parameters:

documentId - identifier of process document

Returns:

the archive of the corresponding document

Throws:

org.bonitasoft.engine.commons.exceptions.SObjectNotFoundException - when the document does not exist

generateDocumentURL

String generateDocumentURL(String name,
                           String contentStorageId)

getArchivedDocument

SAMappedDocument getArchivedDocument(long archivedProcessDocumentId)
                              throws org.bonitasoft.engine.commons.exceptions.SObjectNotFoundException

Retrieve an archived document

Parameters:

archivedProcessDocumentId - the id of the archived document

Returns:

the corresponding archive

Throws:

org.bonitasoft.engine.commons.exceptions.SObjectNotFoundException - when the archive does not exist

deleteDocument

void deleteDocument(SLightDocument document)
             throws org.bonitasoft.engine.commons.exceptions.SObjectModificationException

Throws:

org.bonitasoft.engine.commons.exceptions.SObjectModificationException

deleteDocumentsFromProcessInstance

void deleteDocumentsFromProcessInstance(Long processInstanceId)
                                 throws SBonitaReadException,
                                        org.bonitasoft.engine.commons.exceptions.SObjectModificationException

Delete documents from a specified process instance

Parameters:

processInstanceId -

Throws:

org.bonitasoft.engine.commons.exceptions.SObjectModificationException

SBonitaReadException

Since:

6.1

deleteArchivedDocuments

void deleteArchivedDocuments(List<Long> processInstanceId)
                      throws SBonitaReadException,
                             SRecorderException

delete archived documents mapping and documents links to a set of processes

Parameters:

processInstanceId - ids of the source process instances

Throws:

SBonitaReadException

SRecorderException

archive

void archive(SDocumentMapping documentMapping,
             long archiveDate)
      throws org.bonitasoft.engine.commons.exceptions.SObjectModificationException

archive the specific document mapping in the archive date

Parameters:

documentMapping - document mapping will be archived

archiveDate - the archive time

Throws:

org.bonitasoft.engine.commons.exceptions.SObjectModificationException

Since:

6.4.0

updateDocumentOfList

void updateDocumentOfList(SMappedDocument mappedDocument,
                          SDocument document,
                          int index)
                   throws org.bonitasoft.engine.commons.exceptions.SObjectModificationException

Parameters:

mappedDocument - the document to update

document - the new content

index - the new index

Throws:

org.bonitasoft.engine.commons.exceptions.SObjectModificationException

Since:

6.4.0

updateDocumentIndex

void updateDocumentIndex(SMappedDocument mappedDocument,
                         int index)
                  throws org.bonitasoft.engine.commons.exceptions.SObjectModificationException

update the index of a document inside the list

Parameters:

mappedDocument - the document to update

index - the new index

Throws:

org.bonitasoft.engine.commons.exceptions.SObjectModificationException

Since:

6.4.0

getDocumentList

List<SMappedDocument> getDocumentList(String documentName,
                                      long processInstanceId,
                                      int fromIndex,
                                      int numberOfResult)
                               throws SBonitaReadException

Get a list of document. if there is no document in the list returns an empty list

Parameters:

documentName - the name of the document list

processInstanceId - the id of the process instance that contains the list

fromIndex - pagination parameter

numberOfResult - pagination parameter

Returns:

the list of document

Throws:

SBonitaReadException

Since:

6.4.0

updateDocument

SMappedDocument updateDocument(SDocumentMapping documentToUpdate,
                               SDocument sDocument)
                        throws org.bonitasoft.engine.commons.exceptions.SObjectModificationException

Parameters:

documentToUpdate - the document mapping to udpate

sDocument - the value to set th emapping with

Returns:

the updated document mapping

Throws:

SRecorderException

org.bonitasoft.engine.commons.exceptions.SObjectModificationException

getDocumentList

List<SMappedDocument> getDocumentList(String documentName,
                                      long processInstanceId,
                                      long time)
                               throws SBonitaReadException

Get a list of document at a given time. if there is no document in the list returns an empty list.

elements are taken from archive and from non archived mapping if the process is still running

Parameters:

documentName - the name of the document list

processInstanceId - the id of the process instance that contains the list

time - time when the list was like that

Returns:

the list of document

Throws:

SBonitaReadException

Since:

6.4.0

deleteContentOfArchivedDocument

void deleteContentOfArchivedDocument(long archivedDocumentId)
                              throws org.bonitasoft.engine.commons.exceptions.SObjectNotFoundException,
                                     SBonitaReadException,
                                     SRecorderException

Remove the content of an archived document while keeping it's metadata.

After calling this method you will not be able to retrieve the content of the document since it will be erased from the database. This method can be useful for keeping history of a document without overloading the database.

Parameters:

documentId - the id of the archived document to remove content on

Throws:

org.bonitasoft.engine.commons.exceptions.SObjectNotFoundException

SBonitaReadException

SRecorderException

Since:

6.4.0

updateDocument

SMappedDocument updateDocument(long documentId,
                               SDocument sDocument)
                        throws org.bonitasoft.engine.commons.exceptions.SObjectNotFoundException,
                               org.bonitasoft.engine.commons.exceptions.SObjectModificationException,
                               SBonitaReadException

update the document having the documentId with this new version

Parameters:

documentId - the id of the document to update

sDocument - the new version of the document @return

Throws:

org.bonitasoft.engine.commons.exceptions.SObjectNotFoundException

org.bonitasoft.engine.commons.exceptions.SObjectModificationException

SBonitaReadException